Reference
Resources
All resources have a snowflake ID with an epoch of January 1, 2024. This is with the "exception" of share links, which do have a snowflake ID, but it is not exposed to clients (and we instead refer to the short alphanumeric code as the ID). This may change in the future for clarity.
Rate Limits
Upon encountering a rate limit, you will receive a 429 response with the following headers:
| Header | Description |
|---|---|
| Retry-After | Seconds until you should try again |
| X-RateLimit-Limit | How many requests can be made within the bucket that you are nearest to overflowing |
| X-RateLimit-Remaining | How many requests are remaining in this bucket |
| X-RateLimit-Name | The name of this bucket |
Buckets are scoped by the route and HTTP method. We have names for each API route that can be found below (these are what we use to define the buckets). There is also a global bucket that ticks up along with every other bucket. API routes with no bucket will still be subject to the global bucket for the method used.
Buckets
| Name | Routes |
|---|---|
share |
/share, /share/:id |
Last modified: 4 months ago