# Limits: questions and answers

Every size, count, length, time window and rate in Talewright as a question:
how much, how many, how long, and what happens past it. The values are in
[Limits](../reference/limits.md); each answer links to the section that owns
the number.

## Units and general rules

### Where do I find every limit of Talewright in one place?

On the [Limits](../reference/limits.md) page. It lists every size, count,
length, time window and rate with its exact value, grouped by feature, and
says what the API answers past each one.

More: [Limits, Summary](../reference/limits.md#summary)

### What do KiB, MiB and GiB mean in Talewright's limits?

1 KiB is 1,024 bytes, 1 MiB is 1,024 KiB and 1 GiB is 1,024 MiB. So 50 GiB
is 53,687,091,200 bytes.

More: [Limits, Summary](../reference/limits.md#summary)

### Does the app state the upload limit in MB or in MiB?

In GiB, as the API does: the limit of 50 GiB in "Larger than the 50 GiB
limit" is exactly 53,687,091,200 bytes. Sizes in listings are in MB and GB
of 1,000,000 and 1,000,000,000 bytes.

More: [Uploading, Size limits](../files/uploading.md#size-limits)

### Are length limits counted before or after trimming?

After trimming. Lengths are counted in characters once the spaces at both
ends are removed, unless a limit says bytes.

More: [Limits, Summary](../reference/limits.md#summary)

### Which length limits are counted in bytes and not in characters?

One: the password sent at sign-in or as `currentPassword`, which is 1 to
1,024 bytes. File sizes, request bodies and ZIP downloads are sizes in bytes
too. Every other length is counted in characters.

More: [Limits, Accounts and sessions](../reference/limits.md#accounts-and-sessions)

### Can a limit be raised for my organization?

No. Limits cannot be raised from the app or from the API.

More: [Limits, Questions and answers](../reference/limits.md#questions-and-answers)

### What does the API answer when a request goes past a limit?

It depends on the kind of limit:

- A length, a count or a format: `422 VALIDATION_FAILED`, with
  `details.field` naming the input.
- A size in bytes: `413 PAYLOAD_TOO_LARGE`.
- A rate: `429 RATE_LIMITED` with `Retry-After`.
- The 30 seconds of one request: `503 TIMEOUT`.
- An emailed link past its time: `400 TOKEN_INVALID`.

More: [Limits, Summary](../reference/limits.md#summary)

### Do responses carry a remaining-quota header for rate limits?

No. No header tells you the limit, how much is left or when the window
resets. Only a refusal says anything: `Retry-After` and
`details.retryAfterSeconds` on the `429`.

More: [Limits, Rates](../reference/limits.md#rates)

### Are the rate limit windows fixed or sliding?

Fixed. Every rate limit counts in a fixed window that starts at the first
attempt and ends after its length.

More: [Limits, Rates](../reference/limits.md#rates)

### Do attempts refused during a rate limit window make it longer?

No. Attempts refused inside a window do not extend it. They are not served
either, so retrying sooner gains nothing.

More: [Limits, Rates](../reference/limits.md#rates)

### What is the shortest wait a rate limit refusal can name?

1 second. `Retry-After` and `details.retryAfterSeconds` give the whole
seconds until the window ends, and they are always at least 1.

More: [Errors, RATE_LIMITED (429)](../reference/errors.md#rate_limited-429)

### Does a rate limit per client address count one IPv6 address or a whole network?

A whole /64 network. A client address is one IPv4 address, or one IPv6 /64
network.

More: [Limits, Rates](../reference/limits.md#rates)

### Which rate limits use a 1-minute, a 15-minute, a 1-hour or a 24-hour window?

- 1 minute: requests with one credential, and with all credentials of one
  organization.
- 15 minutes: sign-in, sign-up, verification links, password resets, emailed
  link confirmations, current-password checks, email change requests, failed
  bearer authentications and the OAuth endpoints.
- 1 hour: invitations.
- 24 hours: API keys created by one member.

More: [Limits, Rates](../reference/limits.md#rates)

### Does using up one kind of attempt limit use up another?

No. Sign-up, new verification links, password reset requests and each kind
of confirmation keep their own counts. Sign-up attempts do not use up
sign-in attempts.

More: [Limits, Rates](../reference/limits.md#rates)

### Do requests made in a browser session count against the credential rate limits?

No. The limits of 600 requests a minute per credential and 3,000 a minute per
organization count requests made with credentials only.

More: [Limits, Rates](../reference/limits.md#rates)

### Which rate limits count one email address across all client addresses?

Sign-up, requests for a new verification link and password reset requests.
Each allows 10 in 15 minutes for one email, counted across all client
addresses together, so asking from another address does not get around it.
Only sign-in counts an email per client address.

More: [Limits, Rates](../reference/limits.md#rates)

## Accounts and sessions

### What is the shortest password Talewright accepts?

12 characters. A shorter one answers `422 VALIDATION_FAILED` on `password`,
or on `newPassword` when you change or reset it.

More: [Limits, Accounts and sessions](../reference/limits.md#accounts-and-sessions)

### What is the longest password Talewright accepts?

128 characters. A longer one answers `422 VALIDATION_FAILED` on `password` or
`newPassword`.

More: [Limits, Accounts and sessions](../reference/limits.md#accounts-and-sessions)

### How many bytes can the password sent as `currentPassword` be?

1 to 1,024 bytes. The same holds for the password sent at sign-in. Outside
that the answer is `422 VALIDATION_FAILED`.

More: [Limits, Accounts and sessions](../reference/limits.md#accounts-and-sessions)

### What is the longest email address an account can have?

320 characters. The address must also have exactly one `@` and no spaces.
Anything else answers `422 VALIDATION_FAILED` on `email`.

More: [Limits, Accounts and sessions](../reference/limits.md#accounts-and-sessions)

### What is the longest full name an account can have?

200 characters, counted after trimming. The shortest is 1 character. Outside
that the answer is `422 VALIDATION_FAILED` on `fullName`.

More: [Limits, Accounts and sessions](../reference/limits.md#accounts-and-sessions)

### What happens when a session reaches its 30 days?

The session ends and you sign in again. The 30 days run from the session's
start and are not extended by use.

More: [Sign-in and sessions, Limits](../accounts/sign-in-and-sessions.md#limits)

### Is there a limit on how many sessions one account can have at once?

No. An account can have any number of live sessions.

More: [Limits, Accounts and sessions](../reference/limits.md#accounts-and-sessions)

### How often is a session's "Last active" time updated?

At most once a minute.

More: [Sign-in and sessions, Limits](../accounts/sign-in-and-sessions.md#limits)

### How many characters of a browser's `User-Agent` does a session keep?

The first 512 characters.

More: [Sign-in and sessions, Limits](../accounts/sign-in-and-sessions.md#limits)

### How many sessions does one page of the sessions list hold?

50 by default. Through the API a page holds 1 to 100.

More: [Sign-in and sessions, Limits](../accounts/sign-in-and-sessions.md#limits)

### How many times can one email verification link be used?

Once, within 24 hours. After that it answers `400 TOKEN_INVALID`.

More: [Limits, Accounts and sessions](../reference/limits.md#accounts-and-sessions)

### How many times can one password reset link be used?

Once, within 1 hour. After that it answers `400 TOKEN_INVALID`.

More: [Limits, Accounts and sessions](../reference/limits.md#accounts-and-sessions)

### How many times can one email change confirmation link be used?

Once, within 24 hours. After that it answers `400 TOKEN_INVALID`.

More: [Limits, Accounts and sessions](../reference/limits.md#accounts-and-sessions)

### Does an older emailed link still work after I ask for a new one?

No. A verification link, a password reset link and an email change
confirmation link each work once, and only the newest one works.

More: [Password and email address, Limits](../accounts/password-and-email.md#limits)

### What happens when the 30 days in which my sign-up browser is remembered are over?

The verification link asks for a new password. The browser that signed up
is remembered for 30 days.

More: [Limits, Accounts and sessions](../reference/limits.md#accounts-and-sessions)

### How long is the "Resend verification email" button disabled after a send?

30 seconds.

More: [Sign-up and email verification, Limits](../accounts/sign-up.md#limits)

### How many pending email changes can one account have?

1.

More: [Password and email address, Limits](../accounts/password-and-email.md#limits)

### Is there a waiting period before an account deletion takes effect?

No. There is no waiting period.

More: [Deleting an account, Limits](../accounts/delete-account.md#limits)

### Is there a time window in which a deleted account can be restored?

No. There is none. For comparison, a deleted organization stays restorable
for 30 days.

More: [Deleting an account, Limits](../accounts/delete-account.md#limits)

### How long until the email address of a deleted account can be used for a new account?

No time at all. The address is free at once.

More: [Deleting an account, Limits](../accounts/delete-account.md#limits)

## Organizations and workspaces

### What is the shortest name an organization or a workspace can have?

1 character, counted after trimming. The longest is 200 characters.

More: [Limits, Organizations and workspaces](../reference/limits.md#organizations-and-workspaces)

### What happens when an organization or workspace name is longer than 200 characters?

The answer is `422 VALIDATION_FAILED` on `name`, and nothing is saved.

More: [Limits, Organizations and workspaces](../reference/limits.md#organizations-and-workspaces)

### Do two workspaces count as having the same name when only the capitalization differs?

Yes. A workspace name is unique in its organization ignoring case. A name
that is taken answers `409 CONFLICT` with reason `NAME_TAKEN`.

More: [Limits, Organizations and workspaces](../reference/limits.md#organizations-and-workspaces)

### What is the smallest number of live workspaces an organization must keep?

1. Deleting the only live workspace answers `409 CONFLICT` with reason
`LAST_WORKSPACE`. There is no upper limit.

More: [Limits, Organizations and workspaces](../reference/limits.md#organizations-and-workspaces)

### Is there a limit on how many organizations one account can belong to?

No. Organizations per account have no limit.

More: [Limits, Organizations and workspaces](../reference/limits.md#organizations-and-workspaces)

### What happens when an action would leave an organization with no owner?

It is refused with `409 SOLE_OWNER`. A live organization has at least 1
owner, with no upper limit.

More: [Limits, Organizations and workspaces](../reference/limits.md#organizations-and-workspaces)

### Can the 30-day restore window of a deleted organization or workspace be shortened or skipped?

No. The shortest possible window is 30 days. It cannot be shortened or
skipped.

More: [Deleting and restoring, Limits](../organizations/delete-and-restore.md#limits)

### Can the 30-day restore window of a deleted organization or workspace be extended?

No. The longest possible window is 30 days. It can only be restarted, by
restoring and deleting again.

More: [Deleting and restoring, Limits](../organizations/delete-and-restore.md#limits)

### What happens to a deleted organization or workspace after its 30 days?

It is purged for good and cannot be restored.

More: [Limits, Organizations and workspaces](../reference/limits.md#organizations-and-workspaces)

### How many owners must confirm the deletion of an organization?

1.

More: [Deleting and restoring, Limits](../organizations/delete-and-restore.md#limits)

### How many organizations does one page of the organization list hold?

1 to 100, 50 by default.

More: [Organizations, Limits](../organizations/organizations.md#limits)

## Members and invitations

### Is there a limit on how many members an organization or a workspace can have?

No. Members per organization and members per workspace have no limit.

More: [Limits, Members and invitations](../reference/limits.md#members-and-invitations)

### What happens when I invite an address whose invitation is still pending?

The invitation is sent again. An address has at most 1 pending invitation
per organization.

More: [Limits, Members and invitations](../reference/limits.md#members-and-invitations)

### Is there a limit on how many workspaces one member can be added to?

No. Workspace memberships per member have no limit.

More: [Limits, Members and invitations](../reference/limits.md#members-and-invitations)

### How many organization roles can one member hold?

Exactly 1.

More: [Members and roles, Limits](../organizations/members-and-roles.md#limits)

### How many members does one page of a member list hold?

1 to 100, 50 by default. The same holds for a workspace's member list.

More: [Members and roles, Limits](../organizations/members-and-roles.md#limits)

### What happens when an invitation names more than 100 workspaces?

The answer is `422 VALIDATION_FAILED` on `workspaceIDs`. One invitation
names up to 100 workspaces.

More: [Limits, Members and invitations](../reference/limits.md#members-and-invitations)

### What is the smallest number of workspaces an invitation can name?

0. One invitation names 0 to 100 workspaces.

More: [Invitations, Limits](../organizations/invitations.md#limits)

### How many times does an invitation link work?

Once, within 7 days. After that it answers `400 TOKEN_INVALID`.

More: [Limits, Members and invitations](../reference/limits.md#members-and-invitations)

### Do the 7 days of an invitation start again when it is resent?

Yes. An invitation lasts 7 days from sending or resending.

More: [Invitations, Limits](../organizations/invitations.md#limits)

### Is the limit of 50 invitations an hour counted per organization or per person?

Per person. One person sends 50 invitations an hour, across all their
organizations.

More: [Invitations, Limits](../organizations/invitations.md#limits)

### Is the limit of 200 invitations an hour shared by all inviters of an organization?

Yes. One organization sends 200 invitations an hour, across all its
inviters.

More: [Invitations, Limits](../organizations/invitations.md#limits)

### What does the API answer past the hourly invitation limits?

`429 RATE_LIMITED`, with `Retry-After` and `details.retryAfterSeconds`.

More: [Limits, Members and invitations](../reference/limits.md#members-and-invitations)

### How many pending invitations does one page of the list hold?

1 to 100, 50 by default.

More: [Invitations, Limits](../organizations/invitations.md#limits)

## Organization export

### How many exports of one organization can be built at the same time?

1. Asking again while one is being built returns that export.

More: [Limits, Organization export](../reference/limits.md#organization-export)

### How long can an export stay pending before it is marked failed?

24 hours. Then its state is `failed`.

More: [Limits, Organization export](../reference/limits.md#organization-export)

### How many hours is a ready export kept?

168 hours, which is 7 days, from the moment it is ready. Then its state is
`expired`.

More: [Limits, Organization export](../reference/limits.md#organization-export)

### Can an export's download link outlive the export itself?

No. A download link is valid for at most 15 minutes, and never past the
export's expiry. Read the export again for a fresh link.

More: [Limits, Organization export](../reference/limits.md#organization-export)

### Is there a limit on how many exports an organization can request over time?

No. Exports per organization over time have no limit. Only one can be built
at a time.

More: [Export, Limits](../organizations/export.md#limits)

## Files

### What is the longest file name?

200 characters. A file name is 1 to 200 characters. Outside that the answer
is `422 VALIDATION_FAILED` on `name`.

More: [Limits, Files](../reference/limits.md#files)

### Is there a limit on how many files can share the same name?

No. File names need not be unique.

More: [Limits, Files](../reference/limits.md#files)

### Which characters can the name of an uploaded file not contain?

Control characters, `/` and `\`. The name is 1 to 200 characters.

More: [Uploading, Limits](../files/uploading.md#limits)

### What is the maximum length of alt text?

1,000 characters, on one line. Longer text answers `422 VALIDATION_FAILED`
on `altText`.

More: [Limits, Files](../reference/limits.md#files)

### Can alt text contain line breaks or tabs?

No. Alt text is one line: no line breaks, tabs or other control characters.
One of them answers `422 VALIDATION_FAILED` on `altText`.

More: [Limits, Files](../reference/limits.md#files)

### What is the maximum length of a file's description?

2,000 characters. Line breaks and tabs are allowed. Longer text answers `422
VALIDATION_FAILED` on `description`.

More: [Limits, Files](../reference/limits.md#files)

### What is the maximum length of a caption?

500 characters. Line breaks and tabs are allowed. Longer text answers `422
VALIDATION_FAILED` on `caption`.

More: [Limits, Files](../reference/limits.md#files)

### How many tags can one file have?

Up to 50. More answer `422 VALIDATION_FAILED` on `tags`.

More: [Limits, Files](../reference/limits.md#files)

### How long can a tag be?

1 to 50 characters. Outside that the answer is `422 VALIDATION_FAILED` on
`tags`, or on `name` when a tag is renamed.

More: [Limits, Files](../reference/limits.md#files)

### Is a tag's length counted before or after it is normalized?

After. A tag is normalized first (trimmed, single spaces, lower case), and
the result is 1 to 50 characters.

More: [Limits, Files](../reference/limits.md#files)

### Can a tag contain a comma?

No. A tag holds no comma and no control characters. One with a comma answers
`422 VALIDATION_FAILED` with the message "a tag cannot contain a comma".

More: [Limits, Files](../reference/limits.md#files)

### Is there a limit on how many tags a workspace or the organization folder can have?

No. Tags per workspace or organization folder have no limit. Only the tags
on one file are limited, to 50.

More: [Limits, Files](../reference/limits.md#files)

### How many tags can one `tag` filter name?

1.

More: [Fields and tags, Limits](../files/fields-and-tags.md#limits)

### How many tags does one page of a tag list hold?

1 to 100, 50 by default.

More: [Fields and tags, Limits](../files/fields-and-tags.md#limits)

### How many words of a search query are used?

The first 10. Words after the tenth are not used.

More: [Limits, Files](../reference/limits.md#files)

### How many duplicates does a file or an upload name at most?

Up to 10.

More: [Limits, Files](../reference/limits.md#files)

### How many files can one status change name?

1 to 100. Outside that the answer is `422 VALIDATION_FAILED` on `fileIDs`.

More: [Limits, Files](../reference/limits.md#files)

### How many files can one field change name?

1 to 100. Outside that the answer is `422 VALIDATION_FAILED` on `fileIDs`.

More: [Limits, Files](../reference/limits.md#files)

### Is there a limit on how many files a workspace or the organization folder can hold?

No. Files have no limit in number.

More: [Limits, Files](../reference/limits.md#files)

### Is there a limit on how many versions a file can have?

No. Versions per file have no limit.

More: [Limits, Files](../reference/limits.md#files)

### How long are earlier versions of a file kept?

As long as the file exists.

More: [Versions and history, Limits](../files/versions.md#limits)

### Is there a limit on how many favorites I can have?

No. Favorites have no limit.

More: [Limits, Files](../reference/limits.md#files)

### How many values can one file have for one field?

One per field.

More: [Fields and tags, Limits](../files/fields-and-tags.md#limits)

### How many statuses can one file have?

0 or 1.

More: [Statuses, Limits](../files/statuses.md#limits)

### How many files does one page of a file listing hold?

1 to 100, 50 by default.

More: [Folders, moving and finding, Limits](../files/organizing.md#limits)

### How many versions does one page of a file's history hold?

1 to 100, 50 by default.

More: [Versions and history, Limits](../files/versions.md#limits)

### How long does the app offer "Undo" after a move or a trash?

8 seconds.

More: [Folders, moving and finding, Limits](../files/organizing.md#limits)

### How many organization folders does an organization have?

1.

More: [The organization folder and suggestions, Limits](../files/library-and-suggestions.md#limits)

## Folders

### What is the longest folder name?

200 characters. A folder name is 1 to 200 characters. Outside that the
answer is `422 VALIDATION_FAILED` on `name`.

More: [Limits, Folders](../reference/limits.md#folders)

### Can a folder name contain a slash?

No. A folder name holds no `/` and no control characters.

More: [Limits, Folders](../reference/limits.md#folders)

### Can two folders in the same place differ only by capitalization?

No. A folder name is unique among its siblings ignoring case. A name that is
taken answers `409 CONFLICT` with reason `NAME_TAKEN`.

More: [Limits, Folders](../reference/limits.md#folders)

### How deep can folders be nested?

At most 16 levels. A folder at the top level is level 1.

More: [Folders, moving and finding, How deep folders nest](../files/organizing.md#how-deep-folders-nest)

### What happens when I create a folder at level 17?

The answer is `422 VALIDATION_FAILED` on `parentID`, with the message
"folders nest at most 16 levels deep".

More: [Folders, moving and finding, How deep folders nest](../files/organizing.md#how-deep-folders-nest)

### Do the folders inside a folder count toward the depth limit when I move it?

Yes. Moving a folder counts the folders inside it. A folder with three
levels below it cannot be moved into a folder at level 14.

More: [Folders, moving and finding, How deep folders nest](../files/organizing.md#how-deep-folders-nest)

### Does a file count as a level in the folder depth limit?

No. Files do not count as a level. A file can sit in a folder at level 16.

More: [Folders, moving and finding, How deep folders nest](../files/organizing.md#how-deep-folders-nest)

### Is there a limit on how many folders a workspace or the organization folder can have?

No. Folders in a workspace or organization folder have no limit in number.

More: [Limits, Folders](../reference/limits.md#folders)

### Is there a limit on how many files a folder can hold?

No. Files in a folder have no limit.

More: [Limits, Folders](../reference/limits.md#folders)

### How many subfolders and files does a public folder's gallery page show?

Up to 1,000 subfolders and up to 1,000 files, sorted by name. The rest are
not listed, but each file is still public at its own link.

More: [Sharing and public links, The gallery page](../files/sharing.md#the-gallery-page)

### How long can the name of a restored folder be when it gets a number?

200 characters, the number included.

More: [Trash and restore, Limits](../files/trash.md#limits)

## Uploads

### What is the maximum file size?

50 GiB, which is 53,687,091,200 bytes, on every plan. Images, PDFs, Word,
Excel and Figma files are at most 2 GiB. The app states both in GiB too.

More: [Limits, Uploads](../reference/limits.md#uploads)

### What is the smallest file I can upload?

1 byte. An empty file cannot be uploaded.

More: [Uploading, Size limits](../files/uploading.md#size-limits)

### What happens when I upload a file larger than 50 GiB?

Starting the upload answers `413 PAYLOAD_TOO_LARGE`, with the limit in bytes
in `details.limitBytes` (53687091200). The app says "Rejected: Larger than
the 50 GiB limit". An image, PDF, Word, Excel or Figma file over 2 GiB gets
the same answer with 2147483648 and "Rejected: Larger than the 2 GiB
limit".

More: [Limits, Uploads](../reference/limits.md#uploads)

### Is a file of exactly 53,687,091,200 bytes accepted?

Yes. The limit is 53,687,091,200 bytes. A file of 53,687,091,201 bytes is
refused.

More: [Uploading, Size limits](../files/uploading.md#size-limits)

### When is the size limit of an upload checked?

When the upload starts, before any byte is sent. The check uses the size you
declare.

More: [Uploading, Size limits](../files/uploading.md#size-limits)

### Is the upload size limit a fixed number?

No. It is a setting of the service, 53,687,091,200 bytes as described here,
the same on every plan for now. A refusal always states the limit in force,
in bytes, in `details.limitBytes`.

More: [Uploading, Size limits](../files/uploading.md#size-limits)

### How big can a replacement of a file be?

Up to 50 GiB, or 2 GiB for an image, PDF, Word, Excel or Figma file, the
same as any upload.

More: [Versions and history, Limits](../files/versions.md#limits)

### How many file types does Talewright accept?

35 types, with 42 file extensions.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### Which file extensions does an upload accept?

These 42, in any letter case:

- Images: `.jpg`, `.jpeg`, `.png`, `.gif`, `.webp`, `.avif`, `.svg`, `.ico`,
  `.heic`, `.heif`, `.hif`, `.psd`, `.psb`.
- Raw photos: `.dng`, `.cr2`, `.cr3`, `.nef`, `.arw`, `.raf`, `.orf`, `.rw2`.
- Design files: `.ai`, `.eps`, `.epsf`, `.indd`, `.fig`.
- Fonts: `.woff`, `.woff2`, `.ttf`, `.otf`.
- Video: `.mp4`, `.m4v`, `.webm`, `.mov`, `.qt`.
- Documents: `.pdf`, `.csv`, `.docx`, `.xlsx`, `.md`, `.markdown`.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### What happens when a file's extension is not on the accepted list?

Starting the upload answers `415 UNSUPPORTED_MEDIA_TYPE`. The extension of
`fileName` picks the type.

More: [Uploading, Accepted types](../files/uploading.md#accepted-types)

### How long is a part's address valid?

15 minutes, or until the upload expires when that is sooner. Its own
`expiresAt` says when it ends. Ask for a new one with `part-urls`.

More: [Uploading, Parts and their addresses](../files/uploading.md#parts-and-their-addresses)

### How large is one part of an upload?

16 MiB, except the last, which holds the rest. Only a file over 156 GiB
would need larger parts. An upload has at most 10,000 parts.

More: [Uploading, Parts and their addresses](../files/uploading.md#parts-and-their-addresses)

### What happens when I send a part after its address expired?

The `PUT` is refused with `403`.

More: [Uploading, Parts and their addresses](../files/uploading.md#parts-and-their-addresses)

### Does a part's `PUT` have to carry exactly the part's size?

Yes. A `PUT` with another length than the part's `sizeBytes` is refused with
`403`.

More: [Uploading, Parts and their addresses](../files/uploading.md#parts-and-their-addresses)

### How long after `expiresAt` can an upload still be completed?

5 minutes, for parts that finished just in time. After that completing
answers `409 CONFLICT` with reason `EXPIRED`.

More: [Uploading, Completing](../files/uploading.md#completing)

### When does a pending upload expire?

24 hours after it was started is its `expiresAt`; 5 minutes later its state
becomes `expired` and its parts are discarded.

More: [Uploading, Limits](../files/uploading.md#limits)

### How much of a file does the malware scan read?

The first 100 MiB. A larger file's version says how much in
`scannedBytes`, and its page shows "Malware scan" with "First 100 MiB".

More: [Uploading, Limits](../files/uploading.md#limits)

### How many versions can one upload make?

At most 1.

More: [Limits, Uploads](../reference/limits.md#uploads)

### What is the largest image, in pixels, that I can upload?

100 million pixels, and 16,384 pixels a side. This holds for JPEG, PNG, GIF,
WebP, AVIF, SVG, HEIC, HEIF and Photoshop files. A larger one is `rejected`
with `MEDIA_INVALID`.

More: [Limits, Uploads](../reference/limits.md#uploads)

### How many pages can an uploaded PDF have?

Up to 500. A PDF with more is `rejected` with `MEDIA_INVALID`.

More: [Limits, Uploads](../reference/limits.md#uploads)

### Is there a pixel limit for PDF pages?

No. A PDF has no pixel limit, only the limit of 500 pages.

More: [Limits, Uploads](../reference/limits.md#uploads)

### What is the largest frame size of a video I can upload?

16,384 pixels a side. A larger one is `rejected` with `MEDIA_INVALID`.

More: [Limits, Uploads](../reference/limits.md#uploads)

### What form must the `sha256` of an upload have?

64 hexadecimal digits, with or without the `sha256:` prefix. Anything else
answers `422 VALIDATION_FAILED` on `sha256`.

More: [Limits, Uploads](../reference/limits.md#uploads)

### How many files does the app upload at the same time?

3.

More: [Uploading, Limits](../files/uploading.md#limits)

### Up to what file size does the web app compute the SHA-256 before uploading?

256 MiB. A larger file uploads without the early duplicate hint.

More: [Limits, Uploads](../reference/limits.md#uploads)

### How large is a video's playback rendition at most?

1,920 by 1,080 pixels, or 1,080 by 1,920 for an upright video. It is an MP4.

More: [Limits, Downloading and delivery](../reference/limits.md#downloading-and-delivery)

### How long can preparing a video's playback rendition take?

Up to 30 minutes, and up to 2 GiB of output. Past either, the file's
`playbackStatus` is `failed`.

More: [Limits, Downloading and delivery](../reference/limits.md#downloading-and-delivery)

### Where in a video is the poster frame taken?

10% into the video, and at most 3 seconds in.

More: [Limits, Downloading and delivery](../reference/limits.md#downloading-and-delivery)

### How many uploads does one page of the upload list hold?

1 to 100, 50 by default.

More: [Uploading, Limits](../files/uploading.md#limits)

## Trash

### How long do files and folders stay in the trash?

30 days from the moment of trashing. The exact time is in `purgeAfter`.

More: [Limits, Trash](../reference/limits.md#trash)

### What happens to a trashed file or folder after 30 days?

It is purged for good and can no longer be restored.

More: [Limits, Trash](../reference/limits.md#trash)

### Is there a limit on how many items the trash can hold?

No. Items in the trash have no limit.

More: [Trash and restore, Limits](../files/trash.md#limits)

### How many items does one page of the trash listing hold?

1 to 100, 50 by default.

More: [Trash and restore, Limits](../files/trash.md#limits)

## Statuses and fields

### How many statuses can a workspace or the organization folder have?

Up to 50 each. Every workspace and the organization folder have their own
statuses.

More: [Limits, Statuses and fields](../reference/limits.md#statuses-and-fields)

### What happens when I add a 51st status?

The answer is `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."

More: [Limits, Statuses and fields](../reference/limits.md#statuses-and-fields)

### What is the smallest number of statuses a workspace or the organization folder can have?

0. A workspace or the organization folder has 0 to 50 statuses. Each starts with
three.

More: [Statuses, Limits](../files/statuses.md#limits)

### How long can a status name be?

1 to 60 characters, counted after trimming. Outside that the answer is `422
VALIDATION_FAILED` on `name`.

More: [Limits, Statuses and fields](../reference/limits.md#statuses-and-fields)

### Can two statuses have names that differ only by capitalization?

No. A status name is unique in its workspace or the organization folder ignoring
case. A name that
is taken answers `409 CONFLICT` with reason `NAME_TAKEN`.

More: [Limits, Statuses and fields](../reference/limits.md#statuses-and-fields)

### How many default statuses can a workspace or the organization folder have?

At most 1 each, and it never allows public use. A change that would leave the
default status allowing public use answers `409 CONFLICT` with reason
`DEFAULT_ALLOWS_PUBLIC`.

More: [Limits, Statuses and fields](../reference/limits.md#statuses-and-fields)

### Is there a limit on how many files one status can be on?

No.

More: [Statuses, Limits](../files/statuses.md#limits)

### Is the status list paged?

No. The status list is not paged: one answer holds every status.

More: [Statuses, Limits](../files/statuses.md#limits)

### How many custom fields can a workspace or the organization folder have?

Up to 50 each. Every workspace and the organization folder have their own
fields.

More: [Limits, Statuses and fields](../reference/limits.md#statuses-and-fields)

### What happens when I add a 51st custom field?

The answer is `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."

More: [Limits, Statuses and fields](../reference/limits.md#statuses-and-fields)

### How long can a field name be?

1 to 60 characters, counted after trimming, unique in its workspace or the
organization folder ignoring case. Outside the length the answer is `422
VALIDATION_FAILED` on `name`. A name that is taken answers `409 CONFLICT`
with reason `NAME_TAKEN`.

More: [Limits, Statuses and fields](../reference/limits.md#statuses-and-fields)

### How many options can a select or multi-select field have?

Up to 100.

More: [Limits, Statuses and fields](../reference/limits.md#statuses-and-fields)

### What happens when I add a 101st option to a field?

The answer is `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."

More: [Limits, Statuses and fields](../reference/limits.md#statuses-and-fields)

### How long can the name of a field's option be?

1 to 60 characters, counted after trimming.

More: [Limits, Statuses and fields](../reference/limits.md#statuses-and-fields)

### Can two options of one field have the same name?

No. An option's name is unique in its field ignoring case. A name already
used in the field answers `409 CONFLICT` with reason `NAME_TAKEN`.

More: [Limits, Statuses and fields](../reference/limits.md#statuses-and-fields)

### What is the longest value a text field can hold?

2,000 characters. A longer value answers `422 VALIDATION_FAILED` on
`fields`.

More: [Limits, Statuses and fields](../reference/limits.md#statuses-and-fields)

### Which format does a date field's value have?

`YYYY-MM-DD`, one date. Anything else answers `422 VALIDATION_FAILED` on
`fields`.

More: [Limits, Statuses and fields](../reference/limits.md#statuses-and-fields)

## Downloading and delivery

### How many minutes does a signed link to a file work?

10 minutes. Trashing or restoring the file stops it sooner.

More: [Limits, Downloading and delivery](../reference/limits.md#downloading-and-delivery)

### What happens when I use a signed link after its 10 minutes?

The files host answers `403`. Ask for a new signed link.

More: [Limits, Downloading and delivery](../reference/limits.md#downloading-and-delivery)

### How long is a ZIP download link valid?

10 minutes. After that the files host answers `403`.

More: [Limits, Downloading and delivery](../reference/limits.md#downloading-and-delivery)

### How many files can one ZIP download hold?

Up to 10,000. More answer `422 VALIDATION_FAILED` on `fileIDs`.

More: [Limits, Downloading and delivery](../reference/limits.md#downloading-and-delivery)

### How many bytes can one ZIP download hold?

Up to 20 GiB in all. More answer `413 PAYLOAD_TOO_LARGE`, with the limit in
`details.limitBytes`.

More: [Limits, Downloading and delivery](../reference/limits.md#downloading-and-delivery)

### Is there a limit on how many times a file can be downloaded?

No. Downloads of one file have no limit.

More: [Downloading, Limits](../files/downloading.md#limits)

### How many byte ranges can one download request ask for?

1. Several ranges in one request are ignored.

More: [Limits, Downloading and delivery](../reference/limits.md#downloading-and-delivery)

### How big is a thumbnail?

It is a WebP that fits 320 pixels.

More: [Limits, Downloading and delivery](../reference/limits.md#downloading-and-delivery)

### How big is a preview?

It is a WebP that fits 1,600 pixels.

More: [Limits, Downloading and delivery](../reference/limits.md#downloading-and-delivery)

### How long does a public link's cache last?

60 seconds in a browser (`max-age=60`). After that the browser asks again.

More: [Image delivery, Caching](../files/image-delivery.md#caching)

### How long may a CDN keep the answer of a public link?

Up to 1 year (`s-maxage=31536000`). The copies are dropped earlier when what
the link serves changes, for example when the file gets a new version or
stops being public.

More: [Image delivery, Caching](../files/image-delivery.md#caching)

### How long after a change can a browser still show the earlier file at a public link?

Up to 60 seconds. A reload that revalidates gets the current state.

More: [Image delivery, Caching](../files/image-delivery.md#caching)

### How long may a browser reuse a file it loaded from a signed link?

Until the link expires. The answer is private: shared caches may not keep
it.

More: [Image delivery, Caching](../files/image-delivery.md#caching)

### How long is a public folder's gallery page cached?

60 seconds, by browsers and by a CDN. A rename or a new file inside can take
a minute to show.

More: [Image delivery, Caching](../files/image-delivery.md#caching)

### How long is the redirect of an `f=auto` image address cached?

1 day on a public link (`max-age=86400`), and only by the browser that
asked. On a signed link it is kept for the rest of the link's lifetime.

More: [Image delivery, Limits](../files/image-delivery.md#limits)

### How long may a browser remember a preflight for the files host?

1 day (`Access-Control-Max-Age: 86400`).

More: [Image delivery, Limits](../files/image-delivery.md#limits)

### How long are refusals from the files host cached?

Not at all. Every refusal carries `Cache-Control: no-store`.

More: [Image delivery, Caching](../files/image-delivery.md#caching)

### Does a public link have an expiry?

No. A public link has no expiry. It works while the file is public.

More: [Sharing and public links, Limits](../files/sharing.md#limits)

### How many public links can one file have?

1, for the file's whole life.

More: [Sharing and public links, Limits](../files/sharing.md#limits)

### How many gallery addresses can one folder have?

1, for the folder's whole life.

More: [Sharing and public links, Limits](../files/sharing.md#limits)

### How long is the random part of a public link?

32 hexadecimal digits.

More: [Sharing and public links, Limits](../files/sharing.md#limits)

### How many general access settings are there?

2: "Restricted" and "Anyone with the link".

More: [Sharing and public links, Limits](../files/sharing.md#limits)

## Image variants

### Which widths can an image variant have?

320, 640, 960, 1280, 1600, 2048 and 2560 pixels. A width you ask for is
raised to the next of these. Without `w` the width is 1280.

More: [Image delivery, Limits](../files/image-delivery.md#limits)

### What is the widest image variant?

2,560 pixels. Anything above 2560 becomes 2560.

More: [Image delivery, Limits](../files/image-delivery.md#limits)

### Which heights can an image variant have?

0, which means no limit on height, or 320, 640, 960, 1280, 1600, 2048 and
2560 pixels. Without `h` the height is 0.

More: [Image delivery, Limits](../files/image-delivery.md#limits)

### Which quality levels can an image variant have?

60, 80 and 90. A quality you ask for is raised to the next of these, and
anything above 90 becomes 90. Without `q` the quality is 80.

More: [Image delivery, Limits](../files/image-delivery.md#limits)

### Which formats can an image variant have?

`avif`, `webp`, `jpeg` and `png`. `auto` redirects to `avif` or `webp`.
Without `f` the format is `webp`.

More: [Image delivery, Limits](../files/image-delivery.md#limits)

### How many different variants can one image have?

A small, fixed set: 7 widths, 7 heights or none, 3 qualities, 2 fits and 4
formats.

More: [Image delivery, Image variants](../files/image-delivery.md#image-variants)

### How long can the options part of a variant address be?

Up to 160 characters of letters, digits, `=` and `,`. Each number has 1 to 6
digits. A longer or malformed options part answers `422 VALIDATION_FAILED`
with the message "Invalid image options".

More: [Image delivery, Limits](../files/image-delivery.md#limits)

### Which file types have image variants?

JPEG, PNG, WebP, AVIF, GIF, SVG, HEIC and HEIF.

More: [Image delivery, Limits](../files/image-delivery.md#limits)

### What is the largest original, in bytes, that can be resized?

64 MiB, and 2 MiB for an SVG. A larger original answers `422
VALIDATION_FAILED` on `image`: "Image source exceeds 64 MiB". A larger SVG
answers "The image source cannot be decoded".

More: [Limits, Downloading and delivery](../reference/limits.md#downloading-and-delivery)

### What is the largest original, in pixels, that can be resized?

16,384 pixels a side and 100 million pixels. A larger one answers `422
VALIDATION_FAILED` on `image`: "Image source exceeds 16,384 pixels a side or
100 million pixels".

More: [Limits, Downloading and delivery](../reference/limits.md#downloading-and-delivery)

### How large can one image variant be?

Up to 24 million pixels and 16 MiB. A larger one answers `422
VALIDATION_FAILED` on `image`: "The resulting image is too large".

More: [Limits, Downloading and delivery](../reference/limits.md#downloading-and-delivery)

### When does a variant reach the limit of 24 million pixels?

Only for very tall pictures: more than 9,375 pixels high at the full width
of 2,560. `fit=cover` never reaches it.

More: [Image delivery, Image variants](../files/image-delivery.md#image-variants)

### How complex can an SVG be and still be resized?

At most 10,000 elements, nested at most 128 deep, in at most 2 MiB.

More: [Image delivery, Limits](../files/image-delivery.md#limits)

### Can an image variant be larger than the original?

No. A variant is scaled down, never up. An original 612 pixels wide asked
for at `w=640` comes out 612 pixels wide.

More: [Image delivery, Image variants](../files/image-delivery.md#image-variants)

### What size does a `fit=cover` variant have when the original is smaller than the box?

The requested shape, but smaller. The crop is the largest one of the box's
shape that the original holds without being enlarged.

More: [Limits, Downloading and delivery](../reference/limits.md#downloading-and-delivery)

### How long may rendering one image variant take?

15 seconds, for decoding and resizing together. Past that the answer is `503
UNAVAILABLE` with reason `IMAGE_RENDER_TIMED_OUT`.

More: [Limits, Downloading and delivery](../reference/limits.md#downloading-and-delivery)

### How long should I wait after an image render timed out?

30 seconds. That is the `Retry-After` of an `IMAGE_RENDER_TIMED_OUT` answer.

More: [Limits, Downloading and delivery](../reference/limits.md#downloading-and-delivery)

### How long does a request wait for an image render to start?

Up to 5 seconds. If its turn does not come, the answer is `503 UNAVAILABLE`
with reason `IMAGE_SERVICE_UNAVAILABLE` and a `Retry-After` of at least 1
second.

More: [Limits, Downloading and delivery](../reference/limits.md#downloading-and-delivery)

## Library proposals (Suggestions)

### How many items can one suggestion hold?

1 to 500. Outside that the answer is `422 VALIDATION_FAILED` on `items`.

More: [Limits, Library proposals (Suggestions)](../reference/limits.md#library-proposals-suggestions)

### How long can the summary of a suggestion be?

1 to 500 characters, on one line. Outside that the answer is `422
VALIDATION_FAILED` on `summary`.

More: [Limits, Library proposals (Suggestions)](../reference/limits.md#library-proposals-suggestions)

### How long can the rationale of a suggestion's item be?

1 to 2,000 characters on one line. It is optional, but a blank one is
refused with `422 VALIDATION_FAILED` on `rationale`.

More: [Limits, Library proposals (Suggestions)](../reference/limits.md#library-proposals-suggestions)

### How long does a suggestion stay open?

14 days from when it was made, while an item is still pending. Then its
state is `expired`, and applying or rejecting it answers `409 CONFLICT` with
reason `CLOSED`.

More: [Limits, Library proposals (Suggestions)](../reference/limits.md#library-proposals-suggestions)

### Does a fully decided suggestion expire after 14 days?

No. A suggestion whose items were all decided before then is `closed` and
stays so.

More: [Limits, Library proposals (Suggestions)](../reference/limits.md#library-proposals-suggestions)

### How soon after a suggestion expires do its pending items turn stale?

Within about an hour after the expiry.

More: [The organization folder and suggestions, Limits](../files/library-and-suggestions.md#limits)

### How many items can one apply or reject request name?

1 to 500, each once.

More: [The organization folder and suggestions, Limits](../files/library-and-suggestions.md#limits)

### How many folders can the `folderPath` of a move item name?

Up to 16. Each name is 1 to 200 characters, without `/`.

More: [The organization folder and suggestions, Limits](../files/library-and-suggestions.md#limits)

### How long can the name in a `rename` item be?

1 to 200 characters.

More: [The organization folder and suggestions, Limits](../files/library-and-suggestions.md#limits)

### How long can the alt text in a `set_alt_text` item be?

Up to 1,000 characters.

More: [The organization folder and suggestions, Limits](../files/library-and-suggestions.md#limits)

### How long can the tag in an `add_tag` or `remove_tag` item be?

1 to 50 characters once normalized, without a comma.

More: [The organization folder and suggestions, Limits](../files/library-and-suggestions.md#limits)

### How many suggestions does the app show in one list?

The 50 newest, and 50 more with each "Load more".

More: [The organization folder and suggestions, Limits](../files/library-and-suggestions.md#limits)

### How many suggestion cards show beside the file listing?

Up to 3.

More: [The organization folder and suggestions, Limits](../files/library-and-suggestions.md#limits)

### How many proposals does one page of the proposal list hold?

1 to 100, 50 by default.

More: [The organization folder and suggestions, Limits](../files/library-and-suggestions.md#limits)

## Credentials (API keys)

### How many API keys can I have?

There is no limit on how many keys you hold. The only limit is on creating
them: one member creates 20 keys in 24 hours.

More: [Limits, Credentials (API keys)](../reference/limits.md#credentials-api-keys)

### How many API keys can one member create in 24 hours?

20. The next one answers `429 RATE_LIMITED`, and the app says "You can
create 20 keys a day. Try again {when}."

More: [Limits, Credentials (API keys)](../reference/limits.md#credentials-api-keys)

### How long can an API key's name be?

1 to 100 characters. Outside that the answer is `422 VALIDATION_FAILED` on
`name`.

More: [Limits, Credentials (API keys)](../reference/limits.md#credentials-api-keys)

### How many organizations can one API key work in?

Exactly 1.

More: [Limits, Credentials (API keys)](../reference/limits.md#credentials-api-keys)

### What happens when an API key lists more than 20 workspaces, or one workspace twice?

Creating it answers `422 VALIDATION_FAILED` on `workspaceIDs`. A key lists 1
to 20 workspaces, all different.

More: [Limits, Credentials (API keys)](../reference/limits.md#credentials-api-keys)

### How many scopes must an API key hold at least?

1 of the 4. A key without a scope, or with an unknown one, answers `422
VALIDATION_FAILED` on `scopes`.

More: [Limits, Credentials (API keys)](../reference/limits.md#credentials-api-keys)

### Which lifetimes can an API key have?

30, 90, 180 or 365 days. The default is 90 days. Any other number answers
`422 VALIDATION_FAILED` on `expiresInDays`.

More: [Limits, Credentials (API keys)](../reference/limits.md#credentials-api-keys)

### What is the longest lifetime an API key can have?

365 days. There are no keys without an expiry.

More: [Credentials and scopes, Expiry](../agents/credentials.md#expiry)

### How long can the old secret of a rotated key keep working?

0 to 24 hours. The default is 0: the old secret stops at once. Any other
value answers `422 VALIDATION_FAILED` on `overlapHours`.

More: [Limits, Credentials (API keys)](../reference/limits.md#credentials-api-keys)

### How long does an expired API key stay in my list?

30 days after it expired, marked "Expired". Then it disappears. Key
management keeps it for the same 30 days.

More: [Credentials and scopes, Expiry](../agents/credentials.md#expiry)

### How many characters does an API key have?

60: `ak1_`, 12 characters, `_`, then 43 characters. A token of another shape
answers `401 UNAUTHENTICATED` with reason `INVALID_TOKEN`.

More: [Limits, Credentials (API keys)](../reference/limits.md#credentials-api-keys)

### How often is a credential's "Last used" time refreshed?

At most once a minute.

More: [Limits, Credentials (API keys)](../reference/limits.md#credentials-api-keys)

## Connected apps (OAuth)

### How long do I have to answer an app's request to connect?

10 minutes, and a request is answered once, by the account that opened it
first. After that the screen says "This request has ended" and the API
answers `404 NOT_FOUND`.

More: [Limits, Connected apps (OAuth)](../reference/limits.md#connected-apps-oauth)

### How long does an authorization code work?

60 seconds, for one attempt. After that the exchange answers
`invalid_grant`.

More: [Limits, Connected apps (OAuth)](../reference/limits.md#connected-apps-oauth)

### How long does a connected app's access token last?

60 minutes, and never past the connected app's expiry. After that it answers
`401 UNAUTHENTICATED` with reason `INVALID_TOKEN`.

More: [Limits, Connected apps (OAuth)](../reference/limits.md#connected-apps-oauth)

### How long does a refresh token last?

30 days without a refresh, and never past the connected app's expiry. After
that a refresh answers `invalid_grant`.

More: [Limits, Connected apps (OAuth)](../reference/limits.md#connected-apps-oauth)

### How many times can one refresh token be used?

Once. Each refresh gives a new refresh token and uses up the old one.

More: [Connected apps, The code and the tokens](../agents/connected-apps.md#the-code-and-the-tokens)

### Which lifetimes can a connected app have?

30, 90, 180 or 365 days. The default is 90 days. Any other number answers
`422 VALIDATION_FAILED` on `expiresInDays`.

More: [Limits, Connected apps (OAuth)](../reference/limits.md#connected-apps-oauth)

### What happens when a connected app is given more than 20 workspaces?

The decision answers `422 VALIDATION_FAILED` on `workspaceIDs`. A connected
app is given 1 to 20 workspaces.

More: [Limits, Connected apps (OAuth)](../reference/limits.md#connected-apps-oauth)

### How many connections can I have for one app and one organization?

10 working ones. Connecting the same app again for the same organization
adds a connection and ends none. Revoked and expired connections do not
count.

More: [Limits, Connected apps (OAuth)](../reference/limits.md#connected-apps-oauth)

### How long can the `state` parameter of an authorization request be?

Up to 500 characters. A longer one answers `invalid_request`, and the state
is not sent back.

More: [Limits, Connected apps (OAuth)](../reference/limits.md#connected-apps-oauth)

### How long must a PKCE code challenge be?

43 base64url characters, with the method `S256`. Anything else answers
`invalid_request`.

More: [Limits, Connected apps (OAuth)](../reference/limits.md#connected-apps-oauth)

### How long can a PKCE code verifier be?

43 to 128 unreserved characters. Anything else answers `invalid_request`.

More: [Limits, Connected apps (OAuth)](../reference/limits.md#connected-apps-oauth)

### How much of a connected app's name is shown?

The first 100 characters.

More: [Limits, Connected apps (OAuth)](../reference/limits.md#connected-apps-oauth)

### How big can an app's client metadata document be?

At most 16 KiB. It must be fetched within 5 seconds and list 1 to 20
redirect addresses. Otherwise the person sees "This app cannot connect"
(`invalid_client`).

More: [Limits, Connected apps (OAuth)](../reference/limits.md#connected-apps-oauth)

### How big can the body of a token or revocation request be?

Up to 16 KiB. A larger one answers `invalid_request`.

More: [Limits, Connected apps (OAuth)](../reference/limits.md#connected-apps-oauth)

### How long may the OAuth discovery documents be cached?

5 minutes.

More: [Limits, Connected apps (OAuth)](../reference/limits.md#connected-apps-oauth)

## The REST API

### What is the maximum size of a JSON request body?

3 MiB. A larger body answers `413 PAYLOAD_TOO_LARGE`.

More: [Limits, The REST API](../reference/limits.md#the-rest-api)

### How long can one API request run?

30 seconds. After that the answer is `503 TIMEOUT`.

More: [Limits, The REST API](../reference/limits.md#the-rest-api)

### What is the maximum `limit` of a list request?

100. A `limit` of 0 or 101 answers `422 VALIDATION_FAILED` on `limit`.

More: [Limits, The REST API](../reference/limits.md#the-rest-api)

### What is the page size of a list when I send no `limit`?

50.

More: [Limits, The REST API](../reference/limits.md#the-rest-api)

### How long can the `requestID` of a create be?

1 to 64 characters, each a letter, a digit, `-` or `_`. Anything else
answers `422 VALIDATION_FAILED` on `requestID`.

More: [Limits, The REST API](../reference/limits.md#the-rest-api)

### How long is a `requestID` remembered?

24 hours. After that it is forgotten and counts as new.

More: [Limits, The REST API](../reference/limits.md#the-rest-api)

### How long can an `x-request-id` that I send be?

Up to 128 characters, each a letter, a digit, `-`, `_`, `.` or `:`. Anything
else is replaced by a generated ID.

More: [Limits, The REST API](../reference/limits.md#the-rest-api)

### How long does the readiness check wait for each dependency?

2 seconds. If one does not answer in time, the check answers `503`.

More: [Limits, The REST API](../reference/limits.md#the-rest-api)

### How many operations does the REST API have?

172. A credential can call 82 of them, 78 need a person in a browser and 12
are open without sign-in.

More: [The REST API, Access classes](../agents/rest-api.md#access-classes)

### How many activity entries does one page hold?

1 to 100, 50 by default.

More: [Audit trail, Limits](../reference/audit-trail.md#limits)

## MCP

### What is the maximum size of an MCP request body?

3 MiB, plus 64 KiB for the JSON-RPC envelope. A larger request is refused.

More: [Limits, MCP](../reference/limits.md#mcp)

### What is the maximum size of an MCP tool's answer?

8 MiB. A larger answer is refused with `PAYLOAD_TOO_LARGE` as an `isError`
result. Ask for a smaller page.

More: [Limits, MCP](../reference/limits.md#mcp)

### How many tools does the MCP server have?

63. A credential that holds fewer scopes sees fewer.

More: [Limits, MCP](../reference/limits.md#mcp)

### How many tools fit on one page of the tool list?

100. All 65 tools fit on one page.

More: [Limits, MCP](../reference/limits.md#mcp)

### How many resource templates does the MCP server have?

7.

More: [Limits, MCP](../reference/limits.md#mcp)

### How long can one MCP tool call run?

30 seconds.

More: [MCP, Limits](../agents/mcp.md#limits)

### How long may an MCP client cache the tool and template lists?

5 minutes.

More: [Limits, MCP](../reference/limits.md#mcp)

### How much of an MCP client's name and version is kept as the "last client"?

The first 200 characters of each.

More: [Limits, MCP](../reference/limits.md#mcp)

## Rates

### What is the API rate limit?

600 requests a minute with one credential, and 3,000 a minute with all
credentials of one organization together. REST and MCP requests count
together. Past either the answer is `429 RATE_LIMITED` with `Retry-After`.

More: [Limits, Rates](../reference/limits.md#rates)

### Is the limit of 3,000 requests a minute counted per credential or per organization?

Per organization. It counts the requests of all credentials of one
organization together. One credential alone may make 600 a minute.

More: [Limits, Rates](../reference/limits.md#rates)

### How many requests a minute can a connected app make?

600 a minute per connection, and 3,000 a minute for all credentials of its
organization together. These are the same limits as for API keys.

More: [Connected apps, Rate limits](../agents/connected-apps.md#rate-limits)

### Do REST and MCP requests have separate rate limits?

No. They count together against the same limits.

More: [Limits, Rates](../reference/limits.md#rates)

### How much does one MCP request count against the rate limits?

Once. Each MCP `POST` counts once against the credential and organization
limits, whatever it does.

More: [Limits, Rates](../reference/limits.md#rates)

### When does the one-minute window of the credential limits start?

With the first request. It lasts one minute, and refused requests do not
extend it.

More: [The REST API, Rate limiting](../agents/rest-api.md#rate-limiting)

### How many failed bearer authentications are allowed from one client address?

100 in 15 minutes. After that every bearer request from that address
answers `429 RATE_LIMITED` until the window ends.

More: [Limits, Rates](../reference/limits.md#rates)

### Is a valid API key refused after too many failed authentications from the same address?

Yes. Once an address has used up its failed bearer authentications, a valid
key from that address is refused too until the window ends.

More: [Limits, Rates](../reference/limits.md#rates)

### Does a bad token sent to an operation that needs no sign-in count as a failed authentication?

No. Such an operation ignores the `Authorization` header: nothing is
authenticated and nothing is counted.

More: [The REST API, How a request with a bearer token is checked](../agents/rest-api.md#how-a-request-with-a-bearer-token-is-checked)

### How many requests can one client address make to the OAuth endpoints?

100 in 15 minutes, for `/oauth/authorize`, `/oauth/token` and
`/oauth/revoke` together. Past that they answer `429 RATE_LIMITED` with
`Retry-After`.

More: [Limits, Rates](../reference/limits.md#rates)

### Does an API key creation refused for an invalid field count toward the 20 a day?

No. The fields are checked first. A creation refused for its name, scopes,
workspaces or lifetime is not counted.

More: [Limits, Rates](../reference/limits.md#rates)

### How many sign-in attempts are allowed from one client address, whatever the email?

100 in 15 minutes. For one email from one client address the limit is 10 in
15 minutes.

More: [Limits, Rates](../reference/limits.md#rates)

### How many failed sign-ins for one email are allowed from all client addresses together?

100 in 15 minutes.

More: [Limits, Rates](../reference/limits.md#rates)

### Does a successful sign-in clear the sign-in count of the whole client address?

No. It clears the count for that email and client address. The count for
the client address as a whole stays.

More: [Limits, Rates](../reference/limits.md#rates)

### Which sign-in counts stay after a password reset?

The sign-in counts for the email from other client addresses. They stay
until their 15 minutes end. A reset clears the failed sign-ins for the email
from all addresses together, and the count for the email from the address
that completed the reset.

More: [Limits, Rates](../reference/limits.md#rates)

### What are the per-address limits on sign-up, verification link and password reset requests?

100 in 15 minutes each, from one client address. Each of the three keeps its
own count.

More: [Limits, Rates](../reference/limits.md#rates)

### Do email verification, password reset confirmation and email change confirmation share one attempt limit?

No. Each has its own limit of 100 attempts in 15 minutes from one client
address.

More: [Limits, Rates](../reference/limits.md#rates)

### How often is the "Someone tried to use your email on Talewright" email sent?

At most once per holder of the address in 15 minutes.

More: [Password and email address, Limits](../accounts/password-and-email.md#limits)

### What clears the count of wrong current passwords?

A correct current password. It clears the count of current-password checks
for the account. The limit is 10 checks in 15 minutes for one account,
counted for password change, email change and account deletion together.

More: [Limits, Rates](../reference/limits.md#rates)

### Is the limit on email change requests counted per account or per client address?

Per account: 10 email change requests in 15 minutes for one account.

More: [Limits, Rates](../reference/limits.md#rates)

### Do password reset or email change requests refused for a malformed field count toward their limits?

No. A request refused because a field is malformed is not counted.

More: [Password and email address, Limits](../accounts/password-and-email.md#limits)
