Rate limiting
Calls to our GraphQL API are rate limited to provide equitable access to the API for everyone and to prevent abuse. We are going to be evolving these limits as we gather more information, and encourage your feedback. Any changes to limits will be announced in our Slack community's API announcements channel.
We use the leaky bucket algorithm for our rate limiters, which means that your tokens are refilled with a constant rate of LIMIT_AMOUNT / LIMIT_PERIOD.
If you require higher limits, you can request them by contacting Linear support and providing details of your use case and the reason for higher limits.
You can monitor your API usage through the new API response headers.
Header Name
Description
X-RateLimit-Requests-Limit
The maximum number of API requests you're permitted to make per hour.
X-RateLimit-Requests-Remaining
The number of API requests remaining in the current rate limit window.
X-RateLimit-Requests-Reset
The time at which the current rate limit window resets in UTC epoch seconds.

Limits

API keys

Requests authenticated using our API key, you can make up to 2,500 requests per hour. Requests are associated with the authenticated user, which means all requests by the same user share the same quota of 2,500 requests per hour when they authenticate with different API keys owned by the same user.

OAuth apps

For requests authenticated using OAuth, you can make up to 2,500 requests per hour. Requests are associated with the authenticated user, regardless of the OAuth application making the requests.

Unauthenticated requests

Unauthenticated requests are limited to 60 requests per hour. These requests are associated with the originating IP address instead of the user making the request.
Last modified 1mo ago
Copy link
Contents
Limits