Short answer
You can now restrict a Linkbreakers API token to the resources it needs instead of giving it full access to your workspace. Pick read or read and write per resource when you create a token, or edit an existing one. Every endpoint declares the scope it requires, so agents and SDKs can ask for exactly the access they need.
What we shipped
Least-privilege tokens
Each token now has either full access or a list of scopes such as links:read, analytics:read or webhooks:write. A scoped token can only call the endpoints its scopes cover. Anything else is refused with a 403 that names the missing scope.
Your existing tokens are untouched: they keep full access, and full access keeps covering any scope we add later.
Scopes in the dashboard
On Dashboard → API Tokens, creating a secret key now asks for its access: full, or restricted to the resources you choose. The token list shows what each token can do, and Edit access changes it without issuing a new token.
Scopes machines can read
The scopes are published where tools look for them:
- The OpenAPI specification declares the scope each operation requires and lists every scope in an
oauth2security scheme GET /v1/api-scopesreturns every scope with its descriptionhttps://api.linkbreakers.com/.well-known/oauth-protected-resourceserves RFC 9728 metadata withscopes_supported
MCP clients connecting through OAuth can request the same scopes, and the token they receive is limited to them on both the MCP server and the REST API.
Read the full guide: API token scopes.
Frequently asked questions
Do I need to change anything?
No. Existing tokens keep full access. Restrict a token when you want to.
Which scope should I give an AI agent?
Only what its task needs. An agent that reports on campaigns needs links:read and analytics:read; it does not need to delete links or manage webhooks.
Does a write scope include reading?
Yes. links:write also allows everything links:read does.
About the Author
Laurent Schaffner
Founder & Engineer at Linkbreakers
Passionate about building tools that help businesses track and optimize their digital marketing efforts. Laurent founded Linkbreakers to make QR code analytics accessible and actionable for companies of all sizes.
Related Articles
Introducing credit-based QR code creation
QR code creation is now powered by platform credits, giving you more flexibility and a more generous free tier. Here's what changed and why.
Dark mode is here
You can now switch between light and dark mode across the entire platform. Your eyes will thank you.
Weekly and monthly email digests
You can now receive a periodic summary of your workspace activity by email. Choose between weekly or monthly digests to stay on top of your campaigns.
On this page
Need more help?
Can't find what you're looking for? Get in touch with our support team.
Contact Support