# 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](errors.md) 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](../accounts/feedback.md).

## 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](../accounts/crash-reports.md).

## 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](../files/image-delivery.md#limits) | `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](#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

- [Errors](errors.md)
- [The REST API](../agents/rest-api.md)
- [Credentials and scopes](../agents/credentials.md)
- [Connected apps](../agents/connected-apps.md)
- [Uploading](../files/uploading.md)

