Talewright Docs Open the app

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

LimitValuePast the limit
Password length12 to 128 characters422 VALIDATION_FAILED on password or newPassword
Password sent at sign-in or as currentPassword1 to 1,024 bytes422 VALIDATION_FAILED
Email address length1 to 320 characters, one @, no spaces422 VALIDATION_FAILED on email
Full name1 to 200 characters422 VALIDATION_FAILED on fullName
Session lifetime30 daysThe session ends; sign in again
Live sessions per accountNo limit
"Last seen" of a sessionRefreshed at most once a minute
Browser name kept for a sessionThe first 512 characters
Email verification linkWorks for 24 hours, once400 TOKEN_INVALID
Password reset linkWorks for 1 hour, once400 TOKEN_INVALID
Email change confirmation linkWorks for 24 hours, once400 TOKEN_INVALID
Sign-up browser binding30 daysThe verification link asks for a new password
An unverified account that holds nothingKept 30 days from sign-up, checked about once an hourIt is removed like a deleted account

Feedback

LimitValuePast the limit
Message of a report1 to 5,000 characters; line breaks allowed422 VALIDATION_FAILED on message
Context of a reportUp to 16 KiB as JSON; only the known fields422 VALIDATION_FAILED on context
Page (route) and browser (userAgent) in the contextUp to 500 characters each422 VALIDATION_FAILED on context.route or context.userAgent
App version in the contextUp to 100 characters422 VALIDATION_FAILED on context.appVersion
Language in the contextUp to 35 characters422 VALIDATION_FAILED on context.language
Recent actions in the contextUp to 20, each name 1 to 200 characters422 VALIDATION_FAILED on context.recentActions
Images on one reportUp to 5422 VALIDATION_FAILED on attachments
Size of one imageUp to 5 MiB, which is 5,242,880 bytes413 PAYLOAD_TOO_LARGE with details.limitBytes (5242880)
Image typesPNG, JPEG, WebP and GIF, judged by the bytes415 UNSUPPORTED_MEDIA_TYPE
Body of a reportUp to 35,018,076 bytes: five images of the largest size as base64, and 64 KiB for the rest413 PAYLOAD_TOO_LARGE with details.limitBytes
Reports sent by one person10 in 1 hour, refused ones included429 RATE_LIMITED

See Giving feedback.

Crash reports

LimitValuePast the limit
message of a report1 byte to 1 KiB422 VALIDATION_FAILED on message
stack of a reportUp to 8 KiB422 VALIDATION_FAILED on stack
route of a reportUp to 512 bytes422 VALIDATION_FAILED on route
release of a reportUp to 128 bytes422 VALIDATION_FAILED on release
Body of a reportUp to 64 KiB413 PAYLOAD_TOO_LARGE with details.limitBytes
Reports sent by one person10 in 1 minute, refused ones included429 RATE_LIMITED

See Crash reports.

Organizations and workspaces

LimitValuePast the limit
Organization name1 to 200 characters422 VALIDATION_FAILED on name
Workspace name1 to 200 characters, unique in its organization ignoring case422 VALIDATION_FAILED on name; 409 CONFLICT NAME_TAKEN when taken
Live workspaces per organizationAt least 1, no upper limit409 CONFLICT LAST_WORKSPACE
Owners per live organizationAt least 1, no upper limit409 SOLE_OWNER
Organizations per accountNo limit
A deleted organization stays restorable30 daysThen it is purged for good
A deleted workspace stays restorable30 daysThen it is purged for good

Members and invitations

LimitValuePast the limit
Members per organizationNo limit
Members per workspaceNo limit
Workspace memberships per memberNo limit
Workspaces named in one invitationUp to 100422 VALIDATION_FAILED on workspaceIDs
Pending invitations per address and organization1 (inviting again resends it)
Invitation linkWorks for 7 days, once400 TOKEN_INVALID
Invitations sent by one person50 an hour429 RATE_LIMITED
Invitations sent for one organization200 an hour429 RATE_LIMITED

Organization export

LimitValuePast the limit
Exports being built per organization1 (asking again returns it)
A pending export is marked failedAfter 24 hoursState failed
A ready export is kept7 days (168 hours)State expired
Download link of a ready exportValid for at most 15 minutes, never past the export's expiryRead the export again for a fresh link

Files

LimitValuePast the limit
File name1 to 200 characters, no / or \; need not be unique422 VALIDATION_FAILED on name, or on fileName for an upload
Alt textUp to 1,000 characters on one line: no line breaks, tabs or other control characters422 VALIDATION_FAILED on altText
DescriptionUp to 2,000 characters; line breaks and tabs are allowed422 VALIDATION_FAILED on description
CaptionUp to 500 characters; line breaks and tabs are allowed422 VALIDATION_FAILED on caption
Tags on one fileUp to 50422 VALIDATION_FAILED on tags
Tag name1 to 50 characters once normalized (trimmed, single spaces, lower case); no comma and no control characters422 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 queryThe first 10 words are used
Duplicates named on a file or an uploadUp to 10
Files in one status change1 to 100422 VALIDATION_FAILED on fileIDs
Files in one field change1 to 100422 VALIDATION_FAILED on fileIDs
Files, versions per file, tags per workspace or organization folder, favoritesNo limit

Folders

LimitValuePast the limit
Folder name1 to 200 characters, no /, unique among its siblings ignoring case422 VALIDATION_FAILED on name; 409 CONFLICT NAME_TAKEN
Folder depthAt most 16 levels422 VALIDATION_FAILED on parentID
Folders in a workspace or organization folder, files in a folderNo limit
Subfolders and files shown in one public folder gallery1,000 of each, by nameThe rest are not shown

Uploads

LimitValuePast the limit
Size of one file1 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 force413 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 fileUp to 2 GiB, which is 2,147,483,648 bytes: checking it opens the whole file413 PAYLOAD_TOO_LARGE with details.limitBytes (2147483648). The app says "Rejected: Larger than the 2 GiB limit"
Part size16 MiB; the last part holds the rest. Larger only past 156 GiB, to stay within 10,000 parts
Parts of one uploadUp to 10,000
Part addresses per request1 to 100; the start answers the first 100422 VALIDATION_FAILED on partNumbers
Part addressValid for 15 minutes, or until the upload expires403 from the storage; ask for a new address
Completing an uploadWithin 24 hours of its start (expiresAt), plus 5 minutes409 CONFLICT EXPIRED
A pending upload expires5 minutes after its expiresAt, 24 hours after it was startedState expired; its parts are discarded
Malware scanThe first 100 MiB of a fileThe rest of a larger file is not scanned; the version's scannedBytes says how much was
Versions made by one uploadAt most 1
Image size (JPEG, PNG, GIF, WebP, AVIF, SVG, HEIC, HEIF, Photoshop)Up to 100 million pixels and 16,384 pixels a sideUpload rejected with MEDIA_INVALID
PDF pagesUp to 500. A PDF has no pixel limitUpload rejected with MEDIA_INVALID
Video frame sizeUp to 16,384 pixels a sideUpload rejected with MEDIA_INVALID
sha25664 hex digits, with or without the sha256: prefix422 VALIDATION_FAILED on sha256
File size up to which the web app computes the SHA-256 before uploading256 MiBLarger files upload without the early duplicate hint

Trash

LimitValuePast the limit
A trashed file or folder stays restorable30 days (purgeAfter)Then it is purged for good

Statuses and fields

LimitValuePast the limit
Status name1 to 60 characters, unique in its workspace or organization folder ignoring case422 VALIDATION_FAILED on name; 409 CONFLICT NAME_TAKEN
Statuses per workspace or organization folderUp to 50422 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 statusesAt most 1 per workspace or organization folder, and it never allows public use409 CONFLICT DEFAULT_ALLOWS_PUBLIC
Field name1 to 60 characters, unique in its workspace or organization folder ignoring case422 VALIDATION_FAILED on name; 409 CONFLICT NAME_TAKEN
Fields per workspace or organization folderUp to 50422 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 fieldUp to 100, unique in the field422 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 name1 to 60 characters422 VALIDATION_FAILED
Text field valueUp to 2,000 characters422 VALIDATION_FAILED on fields
Date field valueYYYY-MM-DD422 VALIDATION_FAILED on fields
Rows in the status counts of one workspace, organization folder or folderOne per status, so up to 50; not paged

Downloading and delivery

LimitValuePast the limit
Signed URL of a file versionValid for 10 minutes403 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 videoMP4, at most 1,920 by 1,080 (or 1,080 by 1,920)
Playback renderingUp to 30 minutes and 2 GiB of outputplaybackStatus failed
Video poster frameTaken 10% into the video, at most 3 seconds in
ZIP download linkValid for 10 minutes403 on the files host
Files in one ZIP downloadUp to 10,000422 VALIDATION_FAILED on fileIDs
Bytes in one ZIP downloadUp to 20 GiB413 PAYLOAD_TOO_LARGE with details.limitBytes
Byte ranges in one request1Several ranges are ignored
Browser cache of a public link60 seconds
Original behind an image variant, in bytesUp to 64 MiB; an SVG up to 2 MiB422 VALIDATION_FAILED on image: "Image source exceeds 64 MiB"; for an SVG "The image source cannot be decoded"
Original behind an image variant, in pixelsUp to 16,384 pixels a side and 100 million pixels422 VALIDATION_FAILED on image: "Image source exceeds 16,384 pixels a side or 100 million pixels"
One image variantUp to 24 million pixels and 16 MiB422 VALIDATION_FAILED on image: "The resulting image is too large"
Size of a fit=cover variantThe 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 seconds503 UNAVAILABLE with reason IMAGE_RENDER_TIMED_OUT and Retry-After (30 seconds)
Wait for a render to start5 seconds503 UNAVAILABLE with reason IMAGE_SERVICE_UNAVAILABLE and Retry-After
Variants not yet rendered, being sent to the resizer at once8, holding up to 128 MiB of originals503 UNAVAILABLE with reason IMAGE_SERVICE_UNAVAILABLE and Retry-After (1 second)
Image variant widths, heights, qualities and formatsListed in Image delivery422 VALIDATION_FAILED on options

Library proposals (Suggestions)

LimitValuePast the limit
Items in one proposal1 to 500422 VALIDATION_FAILED on items
Summary1 to 500 characters422 VALIDATION_FAILED on summary
Rationale of an itemOptional; when given, 1 to 2,000 characters on one line. A blank one is refused422 VALIDATION_FAILED on rationale
A proposal stays open14 days, while an item is pending. One fully decided before then is closed and stays soState expired; 409 CONFLICT CLOSED
Copies named in one duplicate groupUp to 20; fileCount gives the full number
Page size of a duplicate group list1 to 100, default 50422 VALIDATION_FAILED on limit

Credentials (API keys)

LimitValuePast the limit
Key name1 to 100 characters422 VALIDATION_FAILED on name
Organizations per keyExactly 1
Workspaces per key1 to 20, all different422 VALIDATION_FAILED on workspaceIDs
Scopes per keyAt least 1 of the 4422 VALIDATION_FAILED on scopes
Lifetime30, 90 (default), 180 or 365 days422 VALIDATION_FAILED on expiresInDays
Rotation overlap0 (default) to 24 hours422 VALIDATION_FAILED on overlapHours
Keys created by one member20 in 24 hours429 RATE_LIMITED
"Last used" of a credentialRefreshed at most once a minute
An expired key or connected app stays listed, in its member's list and in Key management30 days after it expiredBoth lists drop it
Token shapeak1_, 12 characters, _, 43 characters (60 in all)401 UNAUTHENTICATED INVALID_TOKEN

Connected apps (OAuth)

LimitValuePast the limit
Time to answer a consent request10 minutes, once, only by the first account that opened it"This request has ended"; 404 NOT_FOUND
Authorization code60 seconds, one attemptinvalid_grant
Access token60 minutes, never past the app's expiry401 UNAUTHENTICATED INVALID_TOKEN
Refresh token30 days without a refresh, never past the app's expiry; each works onceinvalid_grant
Connected app lifetime30, 90 (default), 180 or 365 days422 VALIDATION_FAILED on expiresInDays
Workspaces per connected app1 to 20422 VALIDATION_FAILED on workspaceIDs
Working connections per member, app and organization10; connecting again adds one and ends none409 CONFLICT CONNECTION_LIMIT at consent, invalid_grant at the exchange
state parameterUp to 500 charactersinvalid_request, without the state
PKCE code challenge43 base64url characters, method S256invalid_request
PKCE code verifier43 to 128 unreserved charactersinvalid_request
App name shownThe first 100 characters
An app's client metadata documentAt most 16 KiB, fetched within 5 seconds, 1 to 20 redirect addresses"This app cannot connect" (invalid_client)
Body of a token or revocation requestUp to 16 KiBinvalid_request
Discovery documentsMay be cached for 5 minutes

The REST API

LimitValuePast the limit
JSON request bodyUp to 3 MiB; a feedback report takes more, see Feedback413 PAYLOAD_TOO_LARGE
Time for one request30 seconds503 TIMEOUT
Page size (limit)1 to 100, default 50422 VALIDATION_FAILED on limit
requestID in a create1 to 64 letters, digits, - or _422 VALIDATION_FAILED on requestID
A requestID is remembered24 hoursAfter that it counts as new
x-request-id you sendUp to 128 letters, digits, -, _, . or :It is replaced by a generated one
Readiness checkEach dependency must answer within 2 seconds503

MCP

LimitValuePast the limit
Request bodyUp to 3 MiB plus 64 KiB for the JSON-RPC envelopeThe request is refused
A tool's answerUp to 8 MiBisError PAYLOAD_TOO_LARGE
Tools or resource templates per list page100Follow nextCursor
Tools in the catalog63, fewer when the credential holds fewer scopes
Resource templates7
Client name and version kept for "last client"The first 200 characters each
Tool and template lists may be cached5 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 countedLimitWindow
Sign-in attempts for one email from one client address1015 minutes
Sign-in attempts from one client address10015 minutes
Failed sign-ins for one email from all addresses together10015 minutes
Sign-up requests for one email, from all client addresses together1015 minutes
Sign-up requests from one client address10015 minutes
Requests for a new verification link for one email, from all client addresses together1015 minutes
Requests for a new verification link from one client address10015 minutes
Password reset requests for one email, from all client addresses together1015 minutes
Password reset requests from one client address10015 minutes
Email verification, password reset confirmation and email change confirmation, each from one client address10015 minutes
Current-password checks for one account (password change, email change and account deletion together)1015 minutes
Email change requests for one account1015 minutes
"This address already has an account" email1 per address15 minutes
Invitations by one inviter501 hour
Invitations for one organization2001 hour
API keys created by one member2024 hours
Feedback reports sent by one person, refused ones included101 hour
Crash reports sent by one person, refused ones included101 minute
Requests with one credential, REST and MCP together6001 minute
Requests with all credentials of one organization, REST and MCP together3,0001 minute
Failed bearer authentications from one client address10015 minutes
Requests to the OAuth endpoints (/oauth/authorize, /oauth/token, /oauth/revoke) from one client address10015 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.