Limits
Summary
Every size, count, length, time window and rate in Talewright, with its exact
value, grouped by feature. When a request goes past a limit, the last column
says what the API answers; Errors explains each code.
Units: 1 KiB is 1,024 bytes, 1 MiB is 1,024 KiB and 1 GiB is 1,024 MiB.
Lengths are counted in characters after trimming, unless a row says bytes.
Accounts and sessions
| Limit | Value | Past the limit |
| Password length | 12 to 128 characters | 422 VALIDATION_FAILED on password or newPassword |
Password sent at sign-in or as currentPassword | 1 to 1,024 bytes | 422 VALIDATION_FAILED |
| Email address length | 1 to 320 characters, one @, no spaces | 422 VALIDATION_FAILED on email |
| Full name | 1 to 200 characters | 422 VALIDATION_FAILED on fullName |
| Session lifetime | 30 days | The session ends; sign in again |
| Live sessions per account | No limit | |
| "Last seen" of a session | Refreshed at most once a minute | |
| Browser name kept for a session | The first 512 characters | |
| Email verification link | Works for 24 hours, once | 400 TOKEN_INVALID |
| Password reset link | Works for 1 hour, once | 400 TOKEN_INVALID |
| Email change confirmation link | Works for 24 hours, once | 400 TOKEN_INVALID |
| Sign-up browser binding | 30 days | The verification link asks for a new password |
| An unverified account that holds nothing | Kept 30 days from sign-up, checked about once an hour | It is removed like a deleted account |
Feedback
| Limit | Value | Past the limit |
| Message of a report | 1 to 5,000 characters; line breaks allowed | 422 VALIDATION_FAILED on message |
| Context of a report | Up to 16 KiB as JSON; only the known fields | 422 VALIDATION_FAILED on context |
Page (route) and browser (userAgent) in the context | Up to 500 characters each | 422 VALIDATION_FAILED on context.route or context.userAgent |
| App version in the context | Up to 100 characters | 422 VALIDATION_FAILED on context.appVersion |
| Language in the context | Up to 35 characters | 422 VALIDATION_FAILED on context.language |
| Recent actions in the context | Up to 20, each name 1 to 200 characters | 422 VALIDATION_FAILED on context.recentActions |
| Images on one report | Up to 5 | 422 VALIDATION_FAILED on attachments |
| Size of one image | Up to 5 MiB, which is 5,242,880 bytes | 413 PAYLOAD_TOO_LARGE with details.limitBytes (5242880) |
| Image types | PNG, JPEG, WebP and GIF, judged by the bytes | 415 UNSUPPORTED_MEDIA_TYPE |
| Body of a report | Up to 35,018,076 bytes: five images of the largest size as base64, and 64 KiB for the rest | 413 PAYLOAD_TOO_LARGE with details.limitBytes |
| Reports sent by one person | 10 in 1 hour, refused ones included | 429 RATE_LIMITED |
See Giving feedback.
Crash reports
| Limit | Value | Past the limit |
message of a report | 1 byte to 1 KiB | 422 VALIDATION_FAILED on message |
stack of a report | Up to 8 KiB | 422 VALIDATION_FAILED on stack |
route of a report | Up to 512 bytes | 422 VALIDATION_FAILED on route |
release of a report | Up to 128 bytes | 422 VALIDATION_FAILED on release |
| Body of a report | Up to 64 KiB | 413 PAYLOAD_TOO_LARGE with details.limitBytes |
| Reports sent by one person | 10 in 1 minute, refused ones included | 429 RATE_LIMITED |
See Crash reports.
Organizations and workspaces
| Limit | Value | Past the limit |
| Organization name | 1 to 200 characters | 422 VALIDATION_FAILED on name |
| Workspace name | 1 to 200 characters, unique in its organization ignoring case | 422 VALIDATION_FAILED on name; 409 CONFLICT NAME_TAKEN when taken |
| Live workspaces per organization | At least 1, no upper limit | 409 CONFLICT LAST_WORKSPACE |
| Owners per live organization | At least 1, no upper limit | 409 SOLE_OWNER |
| Organizations per account | No limit | |
| A deleted organization stays restorable | 30 days | Then it is purged for good |
| A deleted workspace stays restorable | 30 days | Then it is purged for good |
Members and invitations
| Limit | Value | Past the limit |
| Members per organization | No limit | |
| Members per workspace | No limit | |
| Workspace memberships per member | No limit | |
| Workspaces named in one invitation | Up to 100 | 422 VALIDATION_FAILED on workspaceIDs |
| Pending invitations per address and organization | 1 (inviting again resends it) | |
| Invitation link | Works for 7 days, once | 400 TOKEN_INVALID |
| Invitations sent by one person | 50 an hour | 429 RATE_LIMITED |
| Invitations sent for one organization | 200 an hour | 429 RATE_LIMITED |
Organization export
| Limit | Value | Past the limit |
| Exports being built per organization | 1 (asking again returns it) | |
| A pending export is marked failed | After 24 hours | State failed |
| A ready export is kept | 7 days (168 hours) | State expired |
| Download link of a ready export | Valid for at most 15 minutes, never past the export's expiry | Read the export again for a fresh link |
Files
| Limit | Value | Past the limit |
| File name | 1 to 200 characters, no / or \; need not be unique | 422 VALIDATION_FAILED on name, or on fileName for an upload |
| Alt text | Up to 1,000 characters on one line: no line breaks, tabs or other control characters | 422 VALIDATION_FAILED on altText |
| Description | Up to 2,000 characters; line breaks and tabs are allowed | 422 VALIDATION_FAILED on description |
| Caption | Up to 500 characters; line breaks and tabs are allowed | 422 VALIDATION_FAILED on caption |
| Tags on one file | Up to 50 | 422 VALIDATION_FAILED on tags |
| Tag name | 1 to 50 characters once normalized (trimmed, single spaces, lower case); no comma and no control characters | 422 VALIDATION_FAILED on tags, or on name for a rename; for a comma the message is "a tag cannot contain a comma" |
| Search words in one query | The first 10 words are used | |
| Duplicates named on a file or an upload | Up to 10 | |
| Files in one status change | 1 to 100 | 422 VALIDATION_FAILED on fileIDs |
| Files in one field change | 1 to 100 | 422 VALIDATION_FAILED on fileIDs |
| Files, versions per file, tags per workspace or organization folder, favorites | No limit | |
Folders
| Limit | Value | Past the limit |
| Folder name | 1 to 200 characters, no /, unique among its siblings ignoring case | 422 VALIDATION_FAILED on name; 409 CONFLICT NAME_TAKEN |
| Folder depth | At most 16 levels | 422 VALIDATION_FAILED on parentID |
| Folders in a workspace or organization folder, files in a folder | No limit | |
| Subfolders and files shown in one public folder gallery | 1,000 of each, by name | The rest are not shown |
Uploads
| Limit | Value | Past the limit |
| Size of one file | 1 byte to 50 GiB, which is 53,687,091,200 bytes, on every plan. The limit is a setting of the service; a refusal states the one in force | 413 PAYLOAD_TOO_LARGE with details.limitBytes (53687091200). The app says "Rejected: Larger than the 50 GiB limit" |
| Size of an image, PDF, Word, Excel or Figma file | Up to 2 GiB, which is 2,147,483,648 bytes: checking it opens the whole file | 413 PAYLOAD_TOO_LARGE with details.limitBytes (2147483648). The app says "Rejected: Larger than the 2 GiB limit" |
| Part size | 16 MiB; the last part holds the rest. Larger only past 156 GiB, to stay within 10,000 parts | |
| Parts of one upload | Up to 10,000 | |
| Part addresses per request | 1 to 100; the start answers the first 100 | 422 VALIDATION_FAILED on partNumbers |
| Part address | Valid for 15 minutes, or until the upload expires | 403 from the storage; ask for a new address |
| Completing an upload | Within 24 hours of its start (expiresAt), plus 5 minutes | 409 CONFLICT EXPIRED |
| A pending upload expires | 5 minutes after its expiresAt, 24 hours after it was started | State expired; its parts are discarded |
| Malware scan | The first 100 MiB of a file | The rest of a larger file is not scanned; the version's scannedBytes says how much was |
| Versions made by one upload | At most 1 | |
| Image size (JPEG, PNG, GIF, WebP, AVIF, SVG, HEIC, HEIF, Photoshop) | Up to 100 million pixels and 16,384 pixels a side | Upload rejected with MEDIA_INVALID |
| PDF pages | Up to 500. A PDF has no pixel limit | Upload rejected with MEDIA_INVALID |
| Video frame size | Up to 16,384 pixels a side | Upload rejected with MEDIA_INVALID |
sha256 | 64 hex digits, with or without the sha256: prefix | 422 VALIDATION_FAILED on sha256 |
| File size up to which the web app computes the SHA-256 before uploading | 256 MiB | Larger files upload without the early duplicate hint |
Trash
| Limit | Value | Past the limit |
| A trashed file or folder stays restorable | 30 days (purgeAfter) | Then it is purged for good |
Statuses and fields
| Limit | Value | Past the limit |
| Status name | 1 to 60 characters, unique in its workspace or organization folder ignoring case | 422 VALIDATION_FAILED on name; 409 CONFLICT NAME_TAKEN |
| Statuses per workspace or organization folder | Up to 50 | 422 VALIDATION_FAILED on statuses: "a file space has at most 50 statuses". The app says "A workspace or the organization folder can have up to 50 statuses. Delete one to add another." |
| Default statuses | At most 1 per workspace or organization folder, and it never allows public use | 409 CONFLICT DEFAULT_ALLOWS_PUBLIC |
| Field name | 1 to 60 characters, unique in its workspace or organization folder ignoring case | 422 VALIDATION_FAILED on name; 409 CONFLICT NAME_TAKEN |
| Fields per workspace or organization folder | Up to 50 | 422 VALIDATION_FAILED on fields: "a file space has at most 50 fields". The app says "A workspace or the organization folder can have up to 50 custom fields. Delete one to add another." |
| Choices (options) per select field | Up to 100, unique in the field | 422 VALIDATION_FAILED on choices: "a field has at most 100 choices". The app says "A field can have up to 100 options. Delete one to add another." A name already used in the field: 409 CONFLICT NAME_TAKEN |
| Choice name | 1 to 60 characters | 422 VALIDATION_FAILED |
| Text field value | Up to 2,000 characters | 422 VALIDATION_FAILED on fields |
| Date field value | YYYY-MM-DD | 422 VALIDATION_FAILED on fields |
| Rows in the status counts of one workspace, organization folder or folder | One per status, so up to 50; not paged | |
Downloading and delivery
| Limit | Value | Past the limit |
| Signed URL of a file version | Valid for 10 minutes | 403 on the files host; ask for a new one |
Thumbnail (thumb) | WebP that fits 320 pixels | |
Preview (preview) | WebP that fits 1,600 pixels | |
| Playback rendition of a video | MP4, at most 1,920 by 1,080 (or 1,080 by 1,920) | |
| Playback rendering | Up to 30 minutes and 2 GiB of output | playbackStatus failed |
| Video poster frame | Taken 10% into the video, at most 3 seconds in | |
| ZIP download link | Valid for 10 minutes | 403 on the files host |
| Files in one ZIP download | Up to 10,000 | 422 VALIDATION_FAILED on fileIDs |
| Bytes in one ZIP download | Up to 20 GiB | 413 PAYLOAD_TOO_LARGE with details.limitBytes |
| Byte ranges in one request | 1 | Several ranges are ignored |
| Browser cache of a public link | 60 seconds | |
| Original behind an image variant, in bytes | Up to 64 MiB; an SVG up to 2 MiB | 422 VALIDATION_FAILED on image: "Image source exceeds 64 MiB"; for an SVG "The image source cannot be decoded" |
| Original behind an image variant, in pixels | Up to 16,384 pixels a side and 100 million pixels | 422 VALIDATION_FAILED on image: "Image source exceeds 16,384 pixels a side or 100 million pixels" |
| One image variant | Up to 24 million pixels and 16 MiB | 422 VALIDATION_FAILED on image: "The resulting image is too large" |
Size of a fit=cover variant | The requested shape; smaller, in the same shape, when the original is smaller than the box | |
| Time to render one image variant (decoding and resizing together) | 15 seconds | 503 UNAVAILABLE with reason IMAGE_RENDER_TIMED_OUT and Retry-After (30 seconds) |
| Wait for a render to start | 5 seconds | 503 UNAVAILABLE with reason IMAGE_SERVICE_UNAVAILABLE and Retry-After |
| Variants not yet rendered, being sent to the resizer at once | 8, holding up to 128 MiB of originals | 503 UNAVAILABLE with reason IMAGE_SERVICE_UNAVAILABLE and Retry-After (1 second) |
| Image variant widths, heights, qualities and formats | Listed in Image delivery | 422 VALIDATION_FAILED on options |
Library proposals (Suggestions)
| Limit | Value | Past the limit |
| Items in one proposal | 1 to 500 | 422 VALIDATION_FAILED on items |
| Summary | 1 to 500 characters | 422 VALIDATION_FAILED on summary |
| Rationale of an item | Optional; when given, 1 to 2,000 characters on one line. A blank one is refused | 422 VALIDATION_FAILED on rationale |
| A proposal stays open | 14 days, while an item is pending. One fully decided before then is closed and stays so | State expired; 409 CONFLICT CLOSED |
| Copies named in one duplicate group | Up to 20; fileCount gives the full number | |
| Page size of a duplicate group list | 1 to 100, default 50 | 422 VALIDATION_FAILED on limit |
Credentials (API keys)
| Limit | Value | Past the limit |
| Key name | 1 to 100 characters | 422 VALIDATION_FAILED on name |
| Organizations per key | Exactly 1 | |
| Workspaces per key | 1 to 20, all different | 422 VALIDATION_FAILED on workspaceIDs |
| Scopes per key | At least 1 of the 4 | 422 VALIDATION_FAILED on scopes |
| Lifetime | 30, 90 (default), 180 or 365 days | 422 VALIDATION_FAILED on expiresInDays |
| Rotation overlap | 0 (default) to 24 hours | 422 VALIDATION_FAILED on overlapHours |
| Keys created by one member | 20 in 24 hours | 429 RATE_LIMITED |
| "Last used" of a credential | Refreshed at most once a minute | |
| An expired key or connected app stays listed, in its member's list and in Key management | 30 days after it expired | Both lists drop it |
| Token shape | ak1_, 12 characters, _, 43 characters (60 in all) | 401 UNAUTHENTICATED INVALID_TOKEN |
Connected apps (OAuth)
| Limit | Value | Past the limit |
| Time to answer a consent request | 10 minutes, once, only by the first account that opened it | "This request has ended"; 404 NOT_FOUND |
| Authorization code | 60 seconds, one attempt | invalid_grant |
| Access token | 60 minutes, never past the app's expiry | 401 UNAUTHENTICATED INVALID_TOKEN |
| Refresh token | 30 days without a refresh, never past the app's expiry; each works once | invalid_grant |
| Connected app lifetime | 30, 90 (default), 180 or 365 days | 422 VALIDATION_FAILED on expiresInDays |
| Workspaces per connected app | 1 to 20 | 422 VALIDATION_FAILED on workspaceIDs |
| Working connections per member, app and organization | 10; connecting again adds one and ends none | 409 CONFLICT CONNECTION_LIMIT at consent, invalid_grant at the exchange |
state parameter | Up to 500 characters | invalid_request, without the state |
| PKCE code challenge | 43 base64url characters, method S256 | invalid_request |
| PKCE code verifier | 43 to 128 unreserved characters | invalid_request |
| App name shown | The first 100 characters | |
| An app's client metadata document | At most 16 KiB, fetched within 5 seconds, 1 to 20 redirect addresses | "This app cannot connect" (invalid_client) |
| Body of a token or revocation request | Up to 16 KiB | invalid_request |
| Discovery documents | May be cached for 5 minutes | |
The REST API
| Limit | Value | Past the limit |
| JSON request body | Up to 3 MiB; a feedback report takes more, see Feedback | 413 PAYLOAD_TOO_LARGE |
| Time for one request | 30 seconds | 503 TIMEOUT |
Page size (limit) | 1 to 100, default 50 | 422 VALIDATION_FAILED on limit |
requestID in a create | 1 to 64 letters, digits, - or _ | 422 VALIDATION_FAILED on requestID |
A requestID is remembered | 24 hours | After that it counts as new |
x-request-id you send | Up to 128 letters, digits, -, _, . or : | It is replaced by a generated one |
| Readiness check | Each dependency must answer within 2 seconds | 503 |
MCP
| Limit | Value | Past the limit |
| Request body | Up to 3 MiB plus 64 KiB for the JSON-RPC envelope | The request is refused |
| A tool's answer | Up to 8 MiB | isError PAYLOAD_TOO_LARGE |
| Tools or resource templates per list page | 100 | Follow nextCursor |
| Tools in the catalog | 63, fewer when the credential holds fewer scopes | |
| Resource templates | 7 | |
| Client name and version kept for "last client" | The first 200 characters each | |
| Tool and template lists may be cached | 5 minutes | |
Rates
Every rate limit counts in a fixed window. The window starts at the first
attempt. Attempts refused inside it do not extend it. Past the limit the answer
is 429 RATE_LIMITED with Retry-After and details.retryAfterSeconds. No
other rate limit headers are sent: there is no remaining-quota header.
A client address is one IPv4 address, or one IPv6 /64 network.
| What is counted | Limit | Window |
| Sign-in attempts for one email from one client address | 10 | 15 minutes |
| Sign-in attempts from one client address | 100 | 15 minutes |
| Failed sign-ins for one email from all addresses together | 100 | 15 minutes |
| Sign-up requests for one email, from all client addresses together | 10 | 15 minutes |
| Sign-up requests from one client address | 100 | 15 minutes |
| Requests for a new verification link for one email, from all client addresses together | 10 | 15 minutes |
| Requests for a new verification link from one client address | 100 | 15 minutes |
| Password reset requests for one email, from all client addresses together | 10 | 15 minutes |
| Password reset requests from one client address | 100 | 15 minutes |
| Email verification, password reset confirmation and email change confirmation, each from one client address | 100 | 15 minutes |
| Current-password checks for one account (password change, email change and account deletion together) | 10 | 15 minutes |
| Email change requests for one account | 10 | 15 minutes |
| "This address already has an account" email | 1 per address | 15 minutes |
| Invitations by one inviter | 50 | 1 hour |
| Invitations for one organization | 200 | 1 hour |
| API keys created by one member | 20 | 24 hours |
| Feedback reports sent by one person, refused ones included | 10 | 1 hour |
| Crash reports sent by one person, refused ones included | 10 | 1 minute |
| Requests with one credential, REST and MCP together | 600 | 1 minute |
| Requests with all credentials of one organization, REST and MCP together | 3,000 | 1 minute |
| Failed bearer authentications from one client address | 100 | 15 minutes |
Requests to the OAuth endpoints (/oauth/authorize, /oauth/token, /oauth/revoke) from one client address | 100 | 15 minutes |
- Only sign-in counts an email per client address. Sign-up, new
verification links and password reset requests count an email across all
client addresses together, so asking from another address does not get
around them.
- Sign-up, new verification links, password reset requests and each kind of
confirmation keep their own counts. Using up one does not use up another.
- A successful sign-in clears the count for that email and client address.
The count for the client address as a whole stays.
- A password reset clears two sign-in counts: the failed sign-ins for the
email from all client addresses together, and the sign-in count for the
email from the client address that completed the reset. The sign-in
counts for the email from other client addresses stay until their 15
minutes end.
- A correct current password clears the count of current-password checks
for the account.
- Once an address has used up its failed bearer authentications, a valid key
from that address is refused too until the window ends.
- Each MCP
POST counts once against the credential and organization limits,
whatever it does.
- Requests made in a browser session are not counted against the credential
limits.
Questions and answers
How big a file can I upload?
Up to 50 GiB, which is 53,687,091,200 bytes, on every plan; images, PDFs,
Word, Excel and Figma files up to 2 GiB. The refusal names the limit in
details.limitBytes.
How many requests can my agent make?
600 a minute with one credential, and 3,000 a minute across all credentials of
the organization. REST calls and MCP requests count together.
Is there a header that tells me how much quota I have left?
No. Only a refusal says anything: Retry-After on the 429.
How long do I have to copy a new API key?
Until you close the dialog. The key is shown once and never again.
How long does a signed URL work?
10 minutes. Trashing or restoring the file stops it sooner.
How long can I restore something from the trash?
30 days. The file's purgeAfter gives the exact time.
How long can I restore a deleted workspace or organization?
30 days. purgeAfter gives the exact time.
How long does a requestID protect a create from running twice?
24 hours.
Why did my retry with a new address still get 429?
Some limits count per email or per account, not per address: sign-up, new
verification links and password reset requests count an email across all
client addresses. Wait for Retry-After.
Can the limits be raised?
Not from the app or the API.
Related pages