# Errors and messages: questions and answers

What every error code, reason and message in Talewright means, why you got
it and what to do next. The codes are owned by [Errors](../reference/errors.md);
the messages of the app are owned by the page of each feature.

## Reading an error

### What does an error from the Talewright API look like?

Every error from `/v1` is a JSON body with `error.code`, `error.message`,
`error.details` and `requestID`, sent with an HTTP status.

```json
{
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "name must not contain control characters",
    "details": { "field": "name" }
  },
  "requestID": "01928f3e-7c1a-7d2b-9a41-3f0c2d9e8b17"
}
```

More: [Errors, The error envelope](../reference/errors.md#the-error-envelope)

### Which field of an error should my code branch on?

`error.code` first, then `error.details.reason` when the code has reasons.
Never branch on `message`, and never on the HTTP status alone: four codes
share `409` and two share `503`.

More: [Errors, Every code](../reference/errors.md#every-code)

### Why should my code not read the error message?

Because its wording can change. `error.message` is English text for people.
The stable parts are `error.code` and `error.details`.

More: [Errors, Summary](../reference/errors.md#summary)

### Is `error.details` ever missing from an error?

No. `details` is always present. It is an object, or `null` when the code
has nothing to add.

More: [Errors, The error envelope](../reference/errors.md#the-error-envelope)

### What is the `requestID` in an error body?

It identifies the request that failed. The same value is in the
`x-request-id` response header, and audit events recorded during the request
carry it too.

More: [The REST API, Request IDs for tracing](../agents/rest-api.md#request-ids-for-tracing)

### What should I quote when I ask for help with an error?

The `requestID` from the error body, or the `x-request-id` response header.
Every response carries that header, successful ones included.

More: [The REST API, Request IDs for tracing](../agents/rest-api.md#request-ids-for-tracing)

### Which error codes can the API answer?

Twenty: `UNAUTHENTICATED`, `INVALID_CREDENTIALS`, `FORBIDDEN`,
`EMAIL_NOT_VERIFIED`, `SIGNUP_CLOSED`, `NOT_FOUND`, `METHOD_NOT_ALLOWED`,
`VALIDATION_FAILED`, `TOKEN_INVALID`, `STALE_FILE_VERSION`,
`STALE_LOCK_VERSION`, `CONFLICT`, `SOLE_OWNER`, `PAYLOAD_TOO_LARGE`,
`UNSUPPORTED_MEDIA_TYPE`, `RANGE_NOT_SATISFIABLE`, `RATE_LIMITED`,
`INTERNAL`, `UNAVAILABLE` and `TIMEOUT`.

More: [Errors, Every code](../reference/errors.md#every-code)

### Which errors can every operation answer?

`500 INTERNAL` and `503 TIMEOUT`. Every operation can answer them, whatever
else it documents.

More: [Errors, The error envelope](../reference/errors.md#the-error-envelope)

### Which error codes share the HTTP status `409`?

Four: `STALE_FILE_VERSION`, `STALE_LOCK_VERSION`, `CONFLICT` and
`SOLE_OWNER`. That is why code must branch on `error.code`, not on the
status.

More: [Errors, Every code](../reference/errors.md#every-code)

### Which error codes share the HTTP status `503`?

Two: `UNAVAILABLE` and `TIMEOUT`. `UNAVAILABLE` carries a `details.reason`;
`TIMEOUT` has `details` `null`.

More: [Errors, Every code](../reference/errors.md#every-code)

### Which error codes share the HTTP status `401`?

Two: `UNAUTHENTICATED` and `INVALID_CREDENTIALS`. `INVALID_CREDENTIALS` is
answered only by sign-in, for a wrong email or password. Everything else
about a missing or bad session or token is `UNAUTHENTICATED`.

More: [Errors, Every code](../reference/errors.md#every-code)

### Which error codes share the HTTP status `403`?

Three: `FORBIDDEN`, `EMAIL_NOT_VERIFIED` and `SIGNUP_CLOSED`.

More: [Errors, Every code](../reference/errors.md#every-code)

### What is the difference between an error `code` and a `details.reason`?

The `code` names the kind of failure and decides the HTTP status. The
`reason` narrows it down for the codes that have several causes:
`UNAUTHENTICATED`, `FORBIDDEN`, `CONFLICT` and `UNAVAILABLE`.

More: [Errors, Every code](../reference/errors.md#every-code)

### In what order does the API refuse a request that is wrong in several ways?

`404` first, then `403` for the role, then `422` for validation. A request
for something you cannot reach never tells you that its input was also
invalid.

More: [Errors, `NOT_FOUND` (404)](../reference/errors.md#not_found-404)

### Which errors add a response header?

- `UNAUTHENTICATED` with `INVALID_TOKEN`, and `FORBIDDEN` with
  `INSUFFICIENT_SCOPE`: `WWW-Authenticate`.
- `METHOD_NOT_ALLOWED`: `Allow`.
- `RANGE_NOT_SATISFIABLE`: `Content-Range: bytes */<size>`.
- `RATE_LIMITED`: `Retry-After`.
- `UNAVAILABLE` with `IMAGE_SERVICE_UNAVAILABLE` or `IMAGE_RENDER_TIMED_OUT`:
  `Retry-After`.

More: [Errors, Every code](../reference/errors.md#every-code)

### Which errors may my script retry?

`429`, after waiting `Retry-After` seconds, and `500` or `503`, after a
brief wait and with the same body. For a create, send the same `requestID`
again. Give up after a few tries.

More: [The REST API, Worked example](../agents/rest-api.md#worked-example)

### Which errors should my script never repeat unchanged?

`403`, `404`, `422` and `409`: the request is wrong for the current state.
After `409 STALE_LOCK_VERSION`, read the thing again and rebuild the change
before sending it. After `401` with a key, stop: the key is no longer valid.

More: [The REST API, Worked example](../agents/rest-api.md#worked-example)

### Does an error ever contain a secret?

No. Messages and details hold IDs, counts, field names and reasons. They
never hold tokens, passwords, signed URLs or file content.

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

### Is an error message safe to show to a person?

Yes. `error.message` is English text that is safe to show to a person.

More: [Errors, The error envelope](../reference/errors.md#the-error-envelope)

### What language are error messages in?

English.

More: [Errors, The error envelope](../reference/errors.md#the-error-envelope)

### Does a refused request leave a trace in the audit trail?

No. A request that is refused and changes nothing records nothing. A `403`,
`404`, `409` or `422` that changes nothing leaves no event.

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

### How do I match an error to an audit event?

By request ID. The `requestID` of a response is the request ID of the events
that request recorded. A refused request recorded none.

More: [Audit trail, What an event holds](../reference/audit-trail.md#what-an-event-holds)

### Do the OAuth endpoints answer with the same error body as the API?

No. They follow the OAuth standards: a redirect with an `error` parameter,
or JSON `{"error": "...", "error_description": "..."}`. The one exception is
the rate limit, which answers `429 RATE_LIMITED` in the ordinary error body.

More: [Errors, OAuth errors](../reference/errors.md#oauth-errors)

### Is an upload that fails verification an HTTP error?

No. The upload's `state` becomes `rejected` and its `rejectReason` says why.
Read the upload to see it.

More: [Errors, Refused uploads](../reference/errors.md#refused-uploads)

### What does the web app do when an answer is `UNAUTHENTICATED`?

It sends the person to sign-in.

More: [Errors, `UNAUTHENTICATED` (401)](../reference/errors.md#unauthenticated-401)

## `UNAUTHENTICATED` and `INVALID_CREDENTIALS` (401)

### What does `UNAUTHENTICATED` mean?

No valid session or bearer token came with the request. The HTTP status is
`401`. `details` is `null`, or holds the reason `INVALID_TOKEN` or
`AMBIGUOUS_CREDENTIALS`.

More: [Errors, `UNAUTHENTICATED` (401)](../reference/errors.md#unauthenticated-401)

### When is `details` `null` in an `UNAUTHENTICATED` error?

When nothing was presented at all: a browser-only operation was called
without a live session cookie, or `/mcp` or `GET /v1/credential` was called
without a bearer token. The message is "Authentication required".

More: [Errors, `UNAUTHENTICATED` (401)](../reference/errors.md#unauthenticated-401)

### What does the reason `INVALID_TOKEN` mean?

The bearer token did not authenticate. The message is "The bearer token is
invalid, expired or revoked". Check the token, then create a new key or
reconnect the app.

More: [Errors, `UNAUTHENTICATED` (401)](../reference/errors.md#unauthenticated-401)

### Why do I get `INVALID_TOKEN` for a key that worked before?

One of these happened:

- The key expired or was revoked.
- Its member left the organization, was removed from it or deleted their
  account.
- Its member changed or reset their password, which revokes every key.
- Its organization was deleted.

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

### Why does `INVALID_TOKEN` not say whether the key expired or was revoked?

On purpose. One answer covers every cause, so the response never says
which. A malformed, unknown, expired and revoked token all look the same.

More: [Errors, `UNAUTHENTICATED` (401)](../reference/errors.md#unauthenticated-401)

### Why do I get `INVALID_TOKEN` when I send a connected app's access token to `/v1`?

Access tokens of connected apps (`at1_...`) work at `/mcp` only. At the REST
API they answer `401 UNAUTHENTICATED` with reason `INVALID_TOKEN`. Use an
API key for REST.

More: [Connected apps, Where the tokens work](../agents/connected-apps.md#where-the-tokens-work)

### Why do I get `INVALID_TOKEN` when I send a refresh token as a bearer token?

A refresh token (`rt1_...`) works only at the token endpoint. Sent as a
bearer token anywhere, it answers `401`.

More: [Connected apps, Where the tokens work](../agents/connected-apps.md#where-the-tokens-work)

### Why do I get `INVALID_TOKEN` when I send my key with `Authorization: Basic`?

The key must be sent with the `Bearer` scheme: `Authorization: Bearer
ak1_...`. Any other scheme answers `401 UNAUTHENTICATED` with reason
`INVALID_TOKEN`.

More: [Credentials and scopes, Edge cases](../agents/credentials.md#edge-cases)

### Why does a key I just created answer `401`?

Check three things: the whole key was copied (60 characters, starting
`ak1_`), it is sent as `Authorization: Bearer <key>`, and no cookie is sent
with it.

More: [Credentials and scopes, Questions and answers](../agents/credentials.md#questions-and-answers)

### Why does a key answer `401 INVALID_TOKEN` while its organization is deleted?

A deleted organization's credentials stop working. If an owner restores the
organization within 30 days, the key works again.

More: [Credentials and scopes, When the member's access changes](../agents/credentials.md#when-the-members-access-changes)

### What does the reason `AMBIGUOUS_CREDENTIALS` mean?

A request to `/v1` carried a session cookie and a bearer token together.
The message is "Send either a session cookie or a bearer token, not both".
Send one of the two. A script should send no cookies.

More: [Errors, `UNAUTHENTICATED` (401)](../reference/errors.md#unauthenticated-401)

### Why do I get `AMBIGUOUS_CREDENTIALS` on an operation that needs no sign-in?

It is the one check such an operation still makes. An operation that needs
no sign-in ignores the `Authorization` header, but a bearer token sent
together with a session cookie is refused there too.

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)

### Does `/mcp` answer `AMBIGUOUS_CREDENTIALS` for a key sent with a cookie?

No. At `/mcp` cookies are ignored and the key is used.

More: [Credentials and scopes, Edge cases](../agents/credentials.md#edge-cases)

### What does the `WWW-Authenticate` header say on a `401`?

- For `INVALID_TOKEN`: `Bearer error="invalid_token"`.
- At `/mcp` without a token: `Bearer resource_metadata="https://app.usetalewright.com/.well-known/oauth-protected-resource/mcp"`.
- At `/mcp` with an invalid token: `error="invalid_token"` and the same
  `resource_metadata`.

More: [Errors, `UNAUTHENTICATED` (401)](../reference/errors.md#unauthenticated-401)

### Does a `401 INVALID_TOKEN` answer count against my address?

Yes. Each one counts as a failed authentication of the client address. After
100 of them in 15 minutes, every bearer request from that address answers
`429` until the window ends, valid keys included.

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

### Why does a browser session get `401` on `GET /v1/credential`?

That operation describes a bearer credential, and a session has none. A
session calling it gets `401 UNAUTHENTICATED`. Use `GET /v1/me` in a
session.

More: [The REST API, Edge cases](../agents/rest-api.md#edge-cases)

### Why does `/mcp` answer `401` although I am signed in to Talewright in my browser?

A browser session is not a way in to the MCP server. Cookies are ignored
there, so a cookie alone answers `401`. Send an API key or a connected
app's access token.

More: [MCP, Authentication](../agents/mcp.md#authentication)

### Why does an invalid key on a browser-only operation get `401` and not `403 SESSION_REQUIRED`?

The token is checked first. Only a valid credential learns that an operation
is browser only. A token that does not authenticate answers `INVALID_TOKEN`
before anything else about the operation is checked.

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)

### Why does an invalid key get no error on an operation that needs no sign-in?

Such an operation ignores the `Authorization` header, whatever it holds.
Nothing is authenticated and nothing is counted, and the operation answers
as for anyone.

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)

### What does `INVALID_CREDENTIALS` mean?

The email or the password is wrong at sign-in. The status is `401`, the
message is "Email or password is incorrect" and `details` is `null`. Check
both, or reset the password.

More: [Errors, `INVALID_CREDENTIALS` (401)](../reference/errors.md#invalid_credentials-401)

### Why does sign-in answer `INVALID_CREDENTIALS` for an email that has no account?

Sign-in answers the same for an unknown email and for a wrong password, so
the answer does not reveal whether an address has an account.

More: [Errors, `INVALID_CREDENTIALS` (401)](../reference/errors.md#invalid_credentials-401)

### What is the difference between `UNAUTHENTICATED` and `INVALID_CREDENTIALS`?

`INVALID_CREDENTIALS` is the answer of sign-in to a wrong email or password.
`UNAUTHENTICATED` is the answer of any other operation that got no valid
session or bearer token.

More: [Errors, Every code](../reference/errors.md#every-code)

### What is the difference between `UNAUTHENTICATED` and `FORBIDDEN`?

`UNAUTHENTICATED` (`401`) means the request did not prove who it is.
`FORBIDDEN` (`403`) means you are known, but may not do this.

More: [Errors, Every code](../reference/errors.md#every-code)

### What is the difference between `INVALID_TOKEN` and `TOKEN_INVALID`?

`INVALID_TOKEN` is a reason of `UNAUTHENTICATED` and is about API keys and
access tokens. `TOKEN_INVALID` is a code of its own and is about emailed
links.

More: [Glossary, Words that are easy to mix up](../reference/glossary.md#words-that-are-easy-to-mix-up)

## `FORBIDDEN` (403)

### What does `FORBIDDEN` mean?

You are known, but may not do this. The HTTP status is `403`. `details` is
`null`, or holds one of four reasons: `SESSION_REQUIRED`,
`HUMAN_APPROVAL_REQUIRED`, `INSUFFICIENT_SCOPE` or `MAKES_FILES_PUBLIC`.

More: [Errors, `FORBIDDEN` (403)](../reference/errors.md#forbidden-403)

### What does `403 FORBIDDEN` with `details` `null` mean?

The message is "Forbidden", and one of these is true:

- Your role does not allow the action, for example a member changing files
  of the organization folder (the API's library), managing members, or
  renaming or deleting a tag.
- A changing request sent an `Origin` header that is not the app's own, or
  a session cookie without an `Origin` header.
- A member asked for the `files:approve` scope on a key or at consent.
- An invitation was accepted by an account with another email address.
- A request to `/mcp` sent an `Origin` header that is not allowed.

More: [Errors, `FORBIDDEN` (403)](../reference/errors.md#forbidden-403)

### What does the reason `SESSION_REQUIRED` mean?

A bearer token called an operation that only a browser session may call.
The message is "This operation needs a person signed in with a browser". Do
it in the web app.

More: [Errors, `FORBIDDEN` (403)](../reference/errors.md#forbidden-403)

### Why do I get `SESSION_REQUIRED` although my key holds every scope?

Scopes do not open browser-only operations. Managing credentials, members,
sharing and permanent deletion need a person signed in with a browser,
whatever the key's scopes and its member's role.

More: [Errors, `FORBIDDEN` (403)](../reference/errors.md#forbidden-403)

### Which kinds of operation answer `SESSION_REQUIRED` to a credential?

Three groups of browser-only operations:

- Credential control: signing out, your account and sessions, API keys,
  connected apps, consent to an app, and oversight of credentials.
- Access control: organizations, workspaces, members, invitations, changes
  to the statuses and fields of a workspace or the organization folder
  (reading them is open to `files:read`), general access of files and
  folders, exports.
- Permanent deletion: deleting a trashed file or folder for good, and
  emptying the trash.

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

### What does the reason `HUMAN_APPROVAL_REQUIRED` mean?

A bearer token tried to apply a library proposal. The message is "Approvals
need a person signed in with a browser". A person applies the proposal in
the web app, under "Suggestions".

More: [Errors, `FORBIDDEN` (403)](../reference/errors.md#forbidden-403)

### What is the difference between `SESSION_REQUIRED` and `HUMAN_APPROVAL_REQUIRED`?

Both mean a bearer token cannot do this. `HUMAN_APPROVAL_REQUIRED` is the
answer for applying a library proposal: the step where a person reviews
what an agent prepared. Everything else that is browser only answers
`SESSION_REQUIRED`.

More: [Errors, `FORBIDDEN` (403)](../reference/errors.md#forbidden-403)

### What does the reason `INSUFFICIENT_SCOPE` mean?

The credential lacks the scope the operation needs. The message is "This
credential does not have the scope this operation needs". Create a
credential with that scope, or do something that needs less.

More: [Errors, `FORBIDDEN` (403)](../reference/errors.md#forbidden-403)

### What does `details.requiredScopes` hold in an `INSUFFICIENT_SCOPE` error?

The scope the operation needs, as a list, for example `["files:approve"]`.

More: [Errors, `FORBIDDEN` (403)](../reference/errors.md#forbidden-403)

### Which header comes with `INSUFFICIENT_SCOPE`?

`WWW-Authenticate: Bearer error="insufficient_scope", scope="<scope>"`,
naming the missing scope.

More: [Errors, `FORBIDDEN` (403)](../reference/errors.md#forbidden-403)

### Why do I get `INSUFFICIENT_SCOPE` on a move although my key holds `files:write`?

The move would make files public: a file with an allowing status going into
a public folder, or a folder going under a public folder. Through a
credential that needs `files:approve` in addition to `files:write`.
`details.requiredScopes` is `["files:approve"]` and nothing changed.

More: [Credentials and scopes, `files:approve`](../agents/credentials.md#filesapprove)

### Why do I get `INSUFFICIENT_SCOPE` when I restore a file from the trash?

Either the credential lacks `files:write`, or the restore would make public
a file that was not public when it went to the trash and the credential
lacks `files:approve`.

More: [Trash and restore, The restore rule](../files/trash.md#the-restore-rule)

### Why does an MCP agent not get `INSUFFICIENT_SCOPE` for a tool outside its scopes?

Over MCP a missing scope hides the whole tool. It is not listed, and calling
it answers the JSON-RPC error `-32602` "Unknown tool". `INSUFFICIENT_SCOPE`
still reaches MCP callers for moves that would make files public.

More: [Errors, `FORBIDDEN` (403)](../reference/errors.md#forbidden-403)

### What does the reason `MAKES_FILES_PUBLIC` mean?

A move, a restore or an applied proposal would make files public, and the
person, or the member a credential acts for, is not an owner or admin. The
message is "This would make files public; only an owner or admin can do
that". Nothing changed.

More: [Errors, `FORBIDDEN` (403)](../reference/errors.md#forbidden-403)

### What does `details.becomePublic` hold in a `MAKES_FILES_PUBLIC` error?

The number of files that would have become public.

More: [Errors, `FORBIDDEN` (403)](../reference/errors.md#forbidden-403)

### What do I do after `MAKES_FILES_PUBLIC`?

Ask an owner or admin to do it, or choose a destination that is not public.
Do not retry: the answer stays the same while your role does.

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

### What is the difference between `MAKES_FILES_PUBLIC` and `VISIBILITY_CHANGE`?

`MAKES_FILES_PUBLIC` (`403`) is final for you: only an owner or admin may
make files public. `VISIBILITY_CHANGE` (`409`) asks for confirmation: show
the counts to a person, then repeat the request with
`confirmVisibilityChange: true`.

More: [Sharing and public links, Moves and restores that change access](../files/sharing.md#moves-and-restores-that-change-access)

### What is the difference between `INSUFFICIENT_SCOPE` and `MAKES_FILES_PUBLIC` on a move?

`INSUFFICIENT_SCOPE` is about the credential: it lacks `files:approve`.
`MAKES_FILES_PUBLIC` is about the member: they are not an owner or admin.

More: [Credentials and scopes, `files:approve`](../agents/credentials.md#filesapprove)

### Why do I get `403 FORBIDDEN` when my script sends an `Origin` header?

A request that changes something and sends an `Origin` header must name the
app's own origin, `https://app.usetalewright.com`. Any other origin is
refused, with or without a session. A script should leave the header out.

More: [The REST API, Signing in with an API key](../agents/rest-api.md#signing-in-with-an-api-key)

### Why does `/mcp` answer `403 FORBIDDEN` to a request from a web page?

A request to `/mcp` that carries an `Origin` header is refused, even when
the header names the Talewright app itself. Browsers send that header.
MCP is for command-line and server-side clients, which do not.

More: [MCP, Transport](../agents/mcp.md#transport)

### Why does a key with `files:approve` get `403 FORBIDDEN` on a status change?

Its member is no longer an owner or admin there. Holding the scope is not
enough: each use checks the member's role at that moment, the effective
role in the workspace for workspace files and the organization role for
organization folder files.

More: [Credentials and scopes, `files:approve`](../agents/credentials.md#filesapprove)

### Why does a member's key get `403 FORBIDDEN` when it changes an organization folder file?

A credential acts with its member's role, and a member cannot change the
organization folder. Members read the organization folder; owners and admins
change it.

More: [Credentials and scopes, What a credential reaches](../agents/credentials.md#what-a-credential-reaches)

### Why do I get `403 FORBIDDEN` when I rename or delete a tag?

Renaming and deleting a tag changes every file that carries it, so it needs
an owner or admin of that workspace or organization folder: for a workspace,
its owners and admins or the organization's; for the organization folder,
the organization's. A plain member gets `403 FORBIDDEN`, in the app and
through a key with `files:write` alike. Putting tags on a file and taking
them off still works for whoever may change the file. In the app the region
"Tags" says "Only owners and admins rename and delete tags here."

More: [Fields and tags](../files/fields-and-tags.md)

### Why does creating a key with `files:approve` answer `403 FORBIDDEN`?

Only someone whose effective role is owner or admin in every workspace the
key lists can give it `files:approve`. If one listed workspace is one where
you are a plain member, creating the key is refused.

More: [Credentials and scopes, `files:approve`](../agents/credentials.md#filesapprove)

### Why does a member get `403 FORBIDDEN` when opening Key management?

Only owners and admins of an organization list its members' API keys and
connected apps. The page says "Only owners and admins of this organization
see its members' API keys."

More: [Credentials and scopes, Key management (owners and admins)](../agents/credentials.md#key-management-owners-and-admins)

### Why does accepting an invitation answer `403 FORBIDDEN`?

The signed-in account has another email address than the invited one. Sign
in with the invited address.

More: [Invitations, Errors](../organizations/invitations.md#errors)

## `EMAIL_NOT_VERIFIED` and `SIGNUP_CLOSED` (403)

### What does `EMAIL_NOT_VERIFIED` mean?

The action needs a verified email address. The status is `403`, the message
is "Verify your email address first" and `details` is `null`.

More: [Errors, `EMAIL_NOT_VERIFIED` (403)](../reference/errors.md#email_not_verified-403)

### Which actions answer `EMAIL_NOT_VERIFIED`?

Deleting an organization and deleting a workspace. Through a credential
also setting file statuses, and making files public by a move or a restore,
when the credential's member has not verified their email. Deleting your own
account never answers it.

More: [Errors, `EMAIL_NOT_VERIFIED` (403)](../reference/errors.md#email_not_verified-403)

### Why does my agent get `EMAIL_NOT_VERIFIED` on a status change that I can make in the browser?

Setting statuses through a credential needs the member's email to be
verified. In a browser session the same file action needs none.

More: [Roles and permissions, Extra conditions](../reference/permissions.md#extra-conditions)

### Why do I get `403 FORBIDDEN` and not `EMAIL_NOT_VERIFIED` although my email is unverified?

`EMAIL_NOT_VERIFIED` is checked after the role check. If your role does not
allow the action, you get `FORBIDDEN` first.

More: [Errors, `EMAIL_NOT_VERIFIED` (403)](../reference/errors.md#email_not_verified-403)

### What do I do after `EMAIL_NOT_VERIFIED`?

Open the verification link in the email you received, or use "Resend
verification email" in the app. Then repeat the action.

More: [Errors, `EMAIL_NOT_VERIFIED` (403)](../reference/errors.md#email_not_verified-403)

### When does the API answer `SIGNUP_CLOSED`?

Sign-up is closed to this address. The status is `403` and the message is
"Sign-up is by invitation". It is answered at sign-up while sign-up is
closed, for an address that is not admitted and brings no live invitation
to that address.

More: [Errors, `SIGNUP_CLOSED` (403)](../reference/errors.md#signup_closed-403)

### Why does `SIGNUP_CLOSED` not say whether the address already has an account?

The answer is the same whether or not the address has an account, so
sign-up does not reveal who is registered.

More: [Errors, `SIGNUP_CLOSED` (403)](../reference/errors.md#signup_closed-403)

### What do I do after `SIGNUP_CLOSED`?

Sign up from the invitation link you received, or sign in if you have an
account. Without an invitation, ask an owner or admin of the organization
for one.

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

## `NOT_FOUND` (404) and `METHOD_NOT_ALLOWED` (405)

### What does `NOT_FOUND` mean?

The thing does not exist, or you cannot reach it. The status is `404`, the
message is "Not found" and `details` is `null`.

More: [Errors, `NOT_FOUND` (404)](../reference/errors.md#not_found-404)

### Which situations answer `NOT_FOUND`?

An unknown ID, a malformed ID in a path, an ID in another organization or
workspace, an ID a credential's workspaces do not cover, a deleted
organization or workspace, a purged file, a status or field managed under a
workspace or organization folder it does not belong to, and an unknown path.
All of these look the same on purpose.

More: [Errors, `NOT_FOUND` (404)](../reference/errors.md#not_found-404)

### Why do I get `404 NOT_FOUND` for something I know exists?

Because you cannot reach it with what you presented. A workspace outside a
credential's list, a file in another organization and an unknown ID answer
the same `404`.

More: [Errors, `NOT_FOUND` (404)](../reference/errors.md#not_found-404)

### Why does the API answer `404` and not `403` for a workspace my key does not list?

So that an answer never reveals whether something exists elsewhere. Someone
who cannot reach an organization or a workspace gets `404` for everything
in it.

More: [The REST API, Tenancy](../agents/rest-api.md#tenancy)

### Why do I get `404 NOT_FOUND` for an ID with a typo?

A malformed ID answers the same `404` as a well-formed ID that does not
exist. It is not a validation error.

More: [The REST API, Edge cases](../agents/rest-api.md#edge-cases)

### What does the API answer for a path that does not exist?

`404 NOT_FOUND` in the ordinary error body.

More: [The REST API, Edge cases](../agents/rest-api.md#edge-cases)

### Why does my key suddenly get `404` for a workspace it lists?

Its member was removed from that workspace, or the workspace was deleted.
The key loses the workspace at its next request and cannot tell it from an
unknown one. The other workspaces keep working.

More: [Credentials and scopes, When the member's access changes](../agents/credentials.md#when-the-members-access-changes)

### Why do I get `NOT_FOUND` when I read an upload that a colleague started?

An upload belongs to whoever started it. Nobody else can read, complete or
cancel it, so it answers `NOT_FOUND` to everyone else.

More: [MCP, Edge cases](../agents/mcp.md#edge-cases)

### Why do I get `404 NOT_FOUND` when I open another member's key activity?

A member reads the activity of their own credentials only. Another member's
credential answers `404`, the same as an unknown one. Owners and admins
read any credential's activity in their organization.

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

### Why do I get `404 NOT_FOUND` when I revoke or rotate an API key?

The key is unknown, another member's or already revoked. For rotation, also
when it is expired. Revoking a key twice answers `404` the second time.

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

### Why does the consent screen's request answer `404 NOT_FOUND`?

The request to connect is unknown, already answered, older than 10 minutes,
or was first opened by another account. Start again from the app.

More: [Connected apps, Errors](../agents/connected-apps.md#errors)

### Why do I get `404` when I restore something from the trash?

The item is unknown or out of reach, it was deleted for good, or its 30
days are over. It cannot be restored.

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

### What do I do after `NOT_FOUND` with a credential?

Check the ID and that the credential covers its workspace. Call
`workspaces_list`, or `GET /v1/workspaces`, to see what the credential
reaches now.

More: [Errors, `NOT_FOUND` (404)](../reference/errors.md#not_found-404)

### What does `METHOD_NOT_ALLOWED` mean?

The path exists but not with this HTTP method. The status is `405`, the
message is "This method is not allowed on this path" and `details` is
`null`.

More: [Errors, `METHOD_NOT_ALLOWED` (405)](../reference/errors.md#method_not_allowed-405)

### Why does `GET /mcp` answer `405 METHOD_NOT_ALLOWED`?

The MCP endpoint accepts only `POST`. `GET`, `DELETE` and any other method
answer `405` with the header `Allow: POST`.

More: [MCP, Transport](../agents/mcp.md#transport)

## `VALIDATION_FAILED` (422)

### What does `VALIDATION_FAILED` mean?

The request is malformed or a value breaks a rule. The status is `422`. The
message says what is wrong, and `details.field` names the input that
failed, when one input did.

More: [Errors, `VALIDATION_FAILED` (422)](../reference/errors.md#validation_failed-422)

### What does `details.field` hold in a `VALIDATION_FAILED` error?

The name of the input that failed, such as `name`, `tags` or `limit`. Over
MCP it names the tool argument.

More: [Errors, `VALIDATION_FAILED` (422)](../reference/errors.md#validation_failed-422)

### Why is `details` `null` in a `VALIDATION_FAILED` error?

The request as a whole is malformed, so no single input is named: a body
that is not valid JSON, a missing required property, a value of the wrong
type, an unknown enum value or an invalid query parameter.

More: [Errors, `VALIDATION_FAILED` (422)](../reference/errors.md#validation_failed-422)

### Which values can `details.field` take for files and folders?

For files: `name`, `altText`, `description`, `caption`, `tags`, `folderID`,
`fields`, `fileIDs`, `field`, `status`, `root` and `trash`. For folders:
`name` and `parentID`. For uploads: `fileName`, `sizeBytes`, `sha256`,
`folderID` and `baseVersionID`.

More: [Errors, `VALIDATION_FAILED` (422)](../reference/errors.md#validation_failed-422)

### Which values can `details.field` take for accounts, organizations and credentials?

- Accounts: `email`, `password`, `newPassword`, `currentPassword`,
  `newEmail`, `fullName`.
- Organizations and workspaces: `name`, `workspaceName`, `confirmName`,
  `workspaceIDs`.
- Credentials and connected apps: `name`, `organizationID`, `workspaceIDs`,
  `scopes`, `expiresInDays`, `overlapHours`.

More: [Errors, `VALIDATION_FAILED` (422)](../reference/errors.md#validation_failed-422)

### Why was a name with a line break at its end refused instead of trimmed?

Text must not contain control characters. `"Name\n"` is refused, not
trimmed to `Name`. Spaces around a name are trimmed before its length is
checked; control characters are not removed for you.

More: [Errors, `VALIDATION_FAILED` (422)](../reference/errors.md#validation_failed-422)

### Why does my alt text answer `VALIDATION_FAILED` on `altText` for a line break?

Alt text is one line. Descriptions, captions and text field values allow
line breaks and tabs; alt text allows neither, nor any other control
character.

More: [Errors, `VALIDATION_FAILED` (422)](../reference/errors.md#validation_failed-422)

### What does "name must not contain control characters" mean?

The `name` you sent holds a control character, such as a tab or a line
break. Remove it and send the name again.

More: [Errors, The error envelope](../reference/errors.md#the-error-envelope)

### What does "a tag cannot contain a comma" mean?

A tag holds no comma. The message comes with `VALIDATION_FAILED` on `tags`
when the tag is set on a file or named in an `add_tag` or `remove_tag` item
of a suggestion, and on `name` when a tag is renamed to it.

More: [Errors, `VALIDATION_FAILED` (422)](../reference/errors.md#validation_failed-422)

### What does "each tag must be 1 to 50 characters" mean?

A tag in the list is empty, longer than 50 characters or holds a control
character. `details.field` is `tags`. Correct the list and send it again.

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

### What does "a file has at most 50 tags" mean?

The `tags` list you sent has more than 50 tags. A file carries at most 50.

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

### What does "a file space has at most 50 statuses" mean?

The workspace or organization folder already has 50 statuses, and a 51st was
added. Each workspace and the organization folder counts its own. The answer
is `VALIDATION_FAILED` on `statuses`, not on `name`. Delete a status there
to add another.

More: [Errors, `VALIDATION_FAILED` (422)](../reference/errors.md#validation_failed-422)

### What does "a file space has at most 50 fields" mean?

The workspace or organization folder already has 50 custom fields, and a
51st was added. Each workspace and the organization folder counts its own.
The answer is `VALIDATION_FAILED` on `fields`. Delete a field there to add
another.

More: [Errors, `VALIDATION_FAILED` (422)](../reference/errors.md#validation_failed-422)

### What does "a field has at most 100 choices" mean?

A select field would get its 101st choice. The answer is
`VALIDATION_FAILED` on `choices`. Delete a choice to add another.

More: [Errors, `VALIDATION_FAILED` (422)](../reference/errors.md#validation_failed-422)

### What does "only select fields have choices" mean?

Choices were sent for a field that is not a select field. The answer is
`VALIDATION_FAILED` on `choices`. Only select fields have choices.

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

### What does "name 1 to 100 files" mean?

A status or field change named no files, or more than 100. The answer is
`VALIDATION_FAILED` on `fileIDs`. Send 1 to 100 files in one request.

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

### What does "current password is incorrect" mean?

The `currentPassword` sent to change the password, change the email address
or delete the account is wrong. It is `422 VALIDATION_FAILED` on
`currentPassword`, not a `401`. Enter the current password, or reset it if
it is lost.

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

### What does "newPassword must be 12 to 128 characters" mean?

The new password is shorter than 12 or longer than 128 characters.
`details.field` is `newPassword`. Choose another password; a reset link
stays usable.

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

### What does "newPassword must differ from the current password" mean?

The new password is the same as the current one. Choose a different
password.

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

### What does "newEmail must be an email address of at most 320 characters" mean?

The new address of an email change is not a well-formed email address, or
is too long. `details.field` is `newEmail`.

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

### What does "newEmail is already the account's email" mean?

You asked to change your email address to the one the account already has.
Enter a different address.

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

### What does "email must be 1 to 320 characters" mean?

The `email` sent at sign-in, in a password reset request or when asking for
a new verification link is empty or longer than 320 characters.

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

### What does "email must not contain control characters" mean?

The `email` holds a control character, such as a tab or a line break.
Remove it and send the address again.

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

### What does "email must be an email address of at most 320 characters" mean?

The `email` sent at sign-up is not a well-formed email address, or is
longer than 320 characters. Correct it and send the sign-up again.

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

### What does "password must be 12 to 128 characters" mean?

The password chosen at sign-up is shorter than 12 or longer than 128
characters. `details.field` is `password`.

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

### What does "password must be 1 to 1024 bytes" mean?

The `password` sent at sign-in is empty or longer than 1,024 bytes. Sign-in
checks only that; the 12 to 128 character rule applies when a password is
chosen.

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

### What does "fullName must be 1 to 200 characters" mean?

The name of the account is empty or longer than 200 characters.
`details.field` is `fullName`. A name with a control character answers
"fullName must not contain control characters".

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

### What does "newPassword is required to verify from another browser than the one that signed up" mean?

The verification link was opened in another browser than the one that
created the account, and no new password came with it. Send the same token
again with a valid `newPassword`. The link is still usable.

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

### What does "confirmName must be the organization's name" mean?

Deleting an organization needs its exact current name as `confirmName`. It
was missing or different. Type the current name exactly.

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

### What does "confirmName must be the workspace's name" mean?

Deleting a workspace needs its exact current name as `confirmName`. It was
missing or different. Type the current name exactly.

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

### Why do I get `VALIDATION_FAILED` on `cursor`?

The `cursor` is not one a list gave you. A cursor is opaque: do not build
or change one. Pass the `nextCursor` of the previous page unchanged.

More: [The REST API, Paging](../agents/rest-api.md#paging)

### Why do I get `VALIDATION_FAILED` on `limit`?

`limit` must be 1 to 100. `limit=0` and `limit=101` are both refused. Left
out, it is 50.

More: [The REST API, Paging](../agents/rest-api.md#paging)

### Why do I get `VALIDATION_FAILED` on `requestID`?

A `requestID` is 1 to 64 letters, digits, `-` or `_`. Anything else is
refused. Over MCP the create tools also refuse a missing `requestID`, and
nothing is created.

More: [The REST API, Safe retries with `requestID`](../agents/rest-api.md#safe-retries-with-requestid)

### Why does moving a file to the trash answer `VALIDATION_FAILED`?

`expectedLockVersion` was left out. A move to the trash is a `DELETE` that
takes the `lockVersion` you read as the query parameter
`expectedLockVersion`.

More: [The REST API, Lock versions](../agents/rest-api.md#lock-versions)

### Why does creating an API key answer `VALIDATION_FAILED` on `workspaceIDs`?

A key lists 1 to 20 different workspaces. No workspace, more than 20, or
the same workspace twice is refused.

More: [Credentials and scopes, Edge cases](../agents/credentials.md#edge-cases)

### Why do I get `VALIDATION_FAILED` on `scopes`?

The list is empty or names a scope that does not exist. The four scopes
are `workspace:read`, `files:read`, `files:write` and `files:approve`. At
consent, a scope the app did not ask for is refused too.

More: [Connected apps, Errors](../agents/connected-apps.md#errors)

### Why do I get `VALIDATION_FAILED` on `expiresInDays`?

A key or a connected app lasts 30, 90, 180 or 365 days. Any other number is
refused. Left out, it is 90.

More: [Credentials and scopes, Request bodies](../agents/credentials.md#request-bodies)

### Why do I get `VALIDATION_FAILED` on `overlapHours`?

When rotating a key, `overlapHours` must be 0 to 24. Left out, it is 0 and
the old secret stops at once.

More: [Credentials and scopes, Request bodies](../agents/credentials.md#request-bodies)

### Why does inviting someone answer `VALIDATION_FAILED` on `workspaceIDs`?

The invitation names more than 100 workspaces, or one that is not a live
workspace of the organization.

More: [Invitations, Errors](../organizations/invitations.md#errors)

### Why do I get `VALIDATION_FAILED` on `fields` when I set a field value?

A key is not a field ID (including `status`), a field or choice is unknown
or belongs to another workspace, the organization folder or another
organization, a value is of the wrong kind, or a text is over 2,000
characters. A file only takes values of its own workspace's or organization
folder's fields: an organization folder field on a workspace's file is
refused too. Read the field list of the same workspace or organization
folder and send the value its kind takes.

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

### Why do I get `VALIDATION_FAILED` on `field` when I filter files?

The `field` filter is malformed, or names an unknown field, a field of
another workspace or organization folder, or a choice that is not the
field's. Use `{fieldID}:{choiceID}` or `{fieldID}:none` with a field of the
workspace or organization folder you list.

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

### Why do I get `VALIDATION_FAILED` on `fieldIDs` or `choiceIDs`?

A reorder must name every field, or every choice of the field, exactly
once. Read the list again and send all of them.

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

### Why do I get `VALIDATION_FAILED` on `parentID`?

The parent is not a live folder of the same workspace or organization
folder, or the folder would nest deeper than 16 levels.

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

### Why does a file search answer `VALIDATION_FAILED` when I send `folderID` and `under` together?

Only one of `folderID`, `root` and `under` may be given. `details.field`
names the field. An unknown `type`, `sort`, `status` or `field` is refused
the same way.

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

### Why does a trash listing of folders answer `VALIDATION_FAILED`?

`trash` was sent together with `parentID`. The trashed folders are one
list; they are not listed inside a parent.

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

### Why does starting an upload answer `VALIDATION_FAILED`?

`fileName`, `sizeBytes`, `sha256` or `folderID` breaks its rule, a
replacement was sent with `folderID`, or only one of `targetFileID` and
`baseVersionID` was given. `details.field` names the field.

More: [Uploading, Errors](../files/uploading.md#errors)

### Why do I get `VALIDATION_FAILED` on `items` when I create a proposal?

A proposal holds 1 to 500 items. An item that names a file which is not live
in that workspace or organization folder, or a `baseLockVersion` below 1, is
refused too.

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

### Why do I get `VALIDATION_FAILED` on `payload`?

An item's payload does not fit its action, or `folderPath` names more than
16 folders. Send the payload the action takes, such as `{"tag": name}` for
`add_tag`.

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

### Why do I get `VALIDATION_FAILED` on `rationale`?

The rationale is blank, over 2,000 characters or holds a control character.
Correct it, or leave it out: a blank one is refused.

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

### Why do I get `VALIDATION_FAILED` on `summary`?

A proposal's summary is blank, over 500 characters or holds a control
character.

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

### Why do I get `VALIDATION_FAILED` on `statusIDs`?

A reorder of the statuses must name every status of that workspace or
organization folder exactly once. Read the list again and send all of them.

More: [Statuses, Errors](../files/statuses.md#errors)

### Why do I get `VALIDATION_FAILED` on `statusID` when I set a status?

The status is unknown, or belongs to another workspace, the organization
folder or another organization. Each workspace and the organization folder
has its own statuses, and a file only takes one of its own: an organization
folder status sent for a workspace's files is refused, even when both have a
status of that name. Read the statuses of the same workspace or organization
folder and send one of their IDs.

More: [Statuses, Errors](../files/statuses.md#errors)

### Why do I get `VALIDATION_FAILED` when I set general access?

`visibility` is missing or is not `restricted` or `public`.

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

### Why does an MCP tool answer `VALIDATION_FAILED` for an argument I added?

A tool that takes no body refuses an argument it does not have, naming it
in `details.field`. A missing required argument is refused the same way,
before any request runs.

More: [MCP, Tool arguments](../agents/mcp.md#tool-arguments)

### What does the app show when a text is refused for a control character?

"Remove the tab or other character that cannot be saved." under the name,
description, caption or alt text that holds it. In practice this is a tab
pasted into "Name" or "Alt text".

More: [Folders, moving and finding, Editing a file's details](../files/organizing.md#editing-a-files-details)

## `TOKEN_INVALID` (400)

### What does `TOKEN_INVALID` mean?

An emailed link is unknown, expired, used or replaced. The status is `400`
and the message is "This link is invalid or has expired". It covers email
verification, password reset, email change and invitation links.

More: [Errors, `TOKEN_INVALID` (400)](../reference/errors.md#token_invalid-400)

### Which causes does `TOKEN_INVALID` cover?

A link that is unknown, expired, already used, replaced by a newer link,
revoked, or that belongs to a deleted organization. One code covers every
cause, so the answer does not say which.

More: [Errors, `TOKEN_INVALID` (400)](../reference/errors.md#token_invalid-400)

### Is `TOKEN_INVALID` about my API key?

No. It is about emailed links only. A bad API key answers
`UNAUTHENTICATED` with reason `INVALID_TOKEN`.

More: [Errors, `TOKEN_INVALID` (400)](../reference/errors.md#token_invalid-400)

### What do I do after `TOKEN_INVALID`?

Ask for a new link: a new verification email, a new password reset, a new
email change or a new invitation.

More: [Errors, `TOKEN_INVALID` (400)](../reference/errors.md#token_invalid-400)

### What does the app show for `TOKEN_INVALID`?

"Link expired or invalid", on the page the link opened.

More: [Errors, `TOKEN_INVALID` (400)](../reference/errors.md#token_invalid-400)

## `STALE_LOCK_VERSION` and `STALE_FILE_VERSION` (409)

### What does `STALE_LOCK_VERSION` mean?

The file or folder changed since you read it. A change sent an
`expectedLockVersion` that is no longer current. The status is `409`, the
message is "This changed since you opened it" and nothing was changed.

More: [Errors, `STALE_LOCK_VERSION` (409)](../reference/errors.md#stale_lock_version-409)

### What does `details.currentLockVersion` hold in a `STALE_LOCK_VERSION` error?

The current lock version of the file or folder, a whole number.

More: [Errors, `STALE_LOCK_VERSION` (409)](../reference/errors.md#stale_lock_version-409)

### What do I do after `STALE_LOCK_VERSION`?

Read the file or folder again, apply your change to what you now see, and
send it with the new `lockVersion` as `expectedLockVersion`.

More: [The REST API, Lock versions](../agents/rest-api.md#lock-versions)

### Why do I get `STALE_LOCK_VERSION` when I retry a change that timed out?

The first attempt went through. A repeat of a change that already went
through gets `STALE_LOCK_VERSION`, so it is never applied twice. Read the
file or folder: it already has your change.

More: [MCP, Safe retries](../agents/mcp.md#safe-retries)

### Why do I get `STALE_LOCK_VERSION` although nobody edited the file?

A file's `lockVersion` also moves when the file is trashed or restored,
when one of its tags is renamed or deleted, and when a field or choice it
had is deleted.

More: [The REST API, Lock versions](../agents/rest-api.md#lock-versions)

### Does uploading a new version of a file cause `STALE_LOCK_VERSION`?

No. A file's `lockVersion` does not move when the file gets a new version.
A newer version shows as `STALE_FILE_VERSION` to someone replacing the
file.

More: [The REST API, Lock versions](../agents/rest-api.md#lock-versions)

### Why do changes to many files at once never answer `STALE_LOCK_VERSION`?

Setting a status or a field on up to 100 files takes no lock version. It
sets one value and is safe to repeat.

More: [The REST API, Lock versions](../agents/rest-api.md#lock-versions)

### What does `STALE_FILE_VERSION` mean?

The file got a newer version since the one you based a replacement on. An
upload that replaces a file named a `baseVersionID` that is no longer the
file's current version. The status is `409` and the message is "This file
changed since you opened it".

More: [Errors, `STALE_FILE_VERSION` (409)](../reference/errors.md#stale_file_version-409)

### What does `details.currentVersionID` hold in a `STALE_FILE_VERSION` error?

The ID of the file's current version.

More: [Errors, `STALE_FILE_VERSION` (409)](../reference/errors.md#stale_file_version-409)

### What do I do after `STALE_FILE_VERSION`?

Read the file again, decide whether your replacement still applies, and
start the upload again with the current version as `baseVersionID`.

More: [Errors, `STALE_FILE_VERSION` (409)](../reference/errors.md#stale_file_version-409)

### What is the difference between `STALE_FILE_VERSION` and `STALE_LOCK_VERSION`?

`STALE_FILE_VERSION` is about bytes: someone uploaded a newer version.
`STALE_LOCK_VERSION` is about details: someone renamed, moved, tagged or
otherwise changed the file or folder.

More: [Errors, `STALE_FILE_VERSION` (409)](../reference/errors.md#stale_file_version-409)

## `CONFLICT` (409)

### What does `CONFLICT` mean?

The request conflicts with the current state. The status is `409`.
`details.reason` names the conflict, with 21 possible values, or `details`
is `null` and the message says what happened.

More: [Errors, `CONFLICT` (409)](../reference/errors.md#conflict-409)

### Which reasons can a `CONFLICT` error carry?

`NAME_TAKEN`, `CYCLE`, `IN_TRASH`, `NOT_IN_TRASH`, `NOT_PENDING`,
`OBJECT_MISSING`, `EXPIRED`, `DIFFERENT_TYPE`, `REQUEST_REUSED`,
`STATUS_BLOCKS_PUBLIC`, `VISIBILITY_CHANGE`, `DEFAULT_ALLOWS_PUBLIC`,
`LAST_WORKSPACE`, `CONNECTION_LIMIT`, `CLOSED`, `ITEM_DECIDED`, `PREVIEW_PENDING`,
`PREVIEW_FAILED`, `NO_PREVIEW`, `PLAYBACK_PENDING`, `PLAYBACK_FAILED` and
`NO_PLAYBACK`.

More: [Errors, `CONFLICT` (409)](../reference/errors.md#conflict-409)

### When is `details` `null` in a `CONFLICT` error?

In four cases, told apart by the message: "another account uses this email
address", "this address belongs to a member of the organization", "you are
already a member of this organization" and "an export just finished;
request again".

More: [Errors, `CONFLICT` (409)](../reference/errors.md#conflict-409)

### What does `CONFLICT` with reason `NAME_TAKEN` mean?

The name is in use. A sibling folder has it, ignoring case. Or a tag, a
file status, a file field or a choice of the same field has it. Or a
workspace is created, renamed or restored while a live workspace of the
organization has it. Choose another name, or rename the other one first.

More: [Errors, `CONFLICT` (409)](../reference/errors.md#conflict-409)

### Which messages come with `NAME_TAKEN`?

- "a workspace with this name already exists" when creating or renaming a
  workspace.
- "A workspace has this name now; rename it, then restore this one" when
  restoring a workspace.
- "Another status has that name" for a status.
- "Another field has that name", "Another choice has that name" and "Two
  choices have the same name" for fields and choices.
- "That name is already taken here" for a tag renamed to another tag's
  name.

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

### Why does `NAME_TAKEN` come back for a name that differs only in capital letters?

Folder names are unique among siblings ignoring case, workspace names are
unique ignoring case too, and status and field names are unique ignoring
case within one workspace or the organization folder. `Press` and `press`
are the same name.

More: [Errors, `CONFLICT` (409)](../reference/errors.md#conflict-409)

### What does `CONFLICT` with reason `CYCLE` mean?

A folder was moved into itself or into a folder below it. Choose another
destination.

More: [Errors, `CONFLICT` (409)](../reference/errors.md#conflict-409)

### What does `CONFLICT` with reason `IN_TRASH` mean?

A trashed file or folder was changed, trashed again, given a status or a
field value, made public, replaced by an upload or asked for a signed URL.
For a file the message is "The file is in the trash; restore it first".
Restore it first.

More: [Errors, `CONFLICT` (409)](../reference/errors.md#conflict-409)

### Why does a batch of 100 files fail with `IN_TRASH` for one trashed file?

Batches are all or nothing. One trashed file refuses the whole status or
field change and nothing changes. Restore the file, or leave it out of the
batch.

More: [Errors, `CONFLICT` (409)](../reference/errors.md#conflict-409)

### What does `CONFLICT` with reason `NOT_IN_TRASH` mean?

A live file or folder was restored or deleted for good. It is also the
answer for a file or folder that went to the trash along with a folder: it
restores and is deleted for good only with that folder.

More: [Errors, `CONFLICT` (409)](../reference/errors.md#conflict-409)

### Why does restoring a trashed file answer `NOT_IN_TRASH`?

A folder took the file to the trash. Such a file is not a trash item of its
own. Restore the folder that took it along.

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

### What is the difference between `IN_TRASH` and `NOT_IN_TRASH`?

`IN_TRASH` refuses an action that needs a live item, such as a rename, on
something in the trash. `NOT_IN_TRASH` refuses an action that needs a
trashed item, a restore or a permanent deletion, on something that is live
or that went to the trash inside a folder.

More: [Errors, `CONFLICT` (409)](../reference/errors.md#conflict-409)

### What does `CONFLICT` with reason `NOT_PENDING` mean?

An upload that is no longer pending was cancelled, or a cancelled upload
was completed. Only a pending upload can be cancelled. Start a new upload
if you still need one.

More: [Errors, `CONFLICT` (409)](../reference/errors.md#conflict-409)

### What does `CONFLICT` with reason `OBJECT_MISSING` mean?

An upload was completed after its parts were gone. The message is "The
upload's parts are gone; start a new upload". Start a new upload.

More: [Uploading, Errors](../files/uploading.md#errors)

### What does `CONFLICT` with reason `PARTS_MISSING` mean?

An upload was completed before every part arrived. `details.partNumbers`
names the missing parts. The upload stays pending: send them, then complete
again.

More: [Uploading, Errors](../files/uploading.md#errors)

### What does `CONFLICT` with reason `PART_MISMATCH` mean?

Completing named an `ETag` or a size the storage does not hold for the parts
`details.partNumbers` names. Send those parts again and complete with the
new `ETag`s.

More: [Uploading, Errors](../files/uploading.md#errors)

### What does `CONFLICT` with reason `EXPIRED` mean?

An upload was completed after it expired. The message is "The upload
expired; start a new one". Start a new upload.

More: [Uploading, Errors](../files/uploading.md#errors)

### What does `CONFLICT` with reason `DIFFERENT_TYPE` mean?

A replacement upload is of another file type than the file's current
version. Replace the file with one of the same type, or upload it as a new
file.

More: [Errors, `CONFLICT` (409)](../reference/errors.md#conflict-409)

### What does `CONFLICT` with reason `REQUEST_REUSED` mean?

A `requestID` was repeated with a different body, or in another workspace,
within 24 hours. Use a new `requestID` for a new request. To retry, repeat
the exact request.

More: [Errors, `CONFLICT` (409)](../reference/errors.md#conflict-409)

### Do I get `REQUEST_REUSED` when I correct a create that was refused?

No. A `requestID` is remembered only when the create went through. A
create that was refused, for example with `422 VALIDATION_FAILED`,
remembers nothing: the same `requestID` can be sent again with a corrected
body.

More: [The REST API, Safe retries with `requestID`](../agents/rest-api.md#safe-retries-with-requestid)

### Does another member's use of the same `requestID` cause `REQUEST_REUSED` for me?

No. A `requestID` is yours. Another member using the same string is not
affected by it, and neither are you by theirs.

More: [The REST API, Safe retries with `requestID`](../agents/rest-api.md#safe-retries-with-requestid)

### What does `CONFLICT` with reason `STATUS_BLOCKS_PUBLIC` mean?

A file was made public while it has no status, or a status that does not
allow public use. An owner or admin first sets a status that allows public
use.

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

### What does `CONFLICT` with reason `VISIBILITY_CHANGE` mean?

A move or a status change would start or stop public links, and the request
did not confirm it. Nothing changed. Show the counts to a person, then
repeat the request with `confirmVisibilityChange: true`.

More: [Errors, `CONFLICT` (409)](../reference/errors.md#conflict-409)

### What do `details.becomePublic`, `details.stopPublic` and `details.publicVia` hold in a `VISIBILITY_CHANGE` error?

`becomePublic` and `stopPublic` count the files whose public link would
start or stop. `publicVia` is `{id, name}` of the folder that shares the
destination, or `null`.

More: [Errors, `CONFLICT` (409)](../reference/errors.md#conflict-409)

### Why does setting a status answer `VISIBILITY_CHANGE`?

The status allows public use and a file in the batch sits in a public
folder, so the change would make it public. Setting a status never makes a
file public by itself otherwise. Repeat the request with
`confirmVisibilityChange: true` to go ahead.

More: [Statuses, Status changes that change access](../files/statuses.md#status-changes-that-change-access)

### Why does moving a file out of a public folder answer `VISIBILITY_CHANGE`?

The move would stop the file's public link. Stopping a link needs
`confirmVisibilityChange: true` and no extra scope.

More: [MCP, Edge cases](../agents/mcp.md#edge-cases)

### What does `CONFLICT` with reason `DEFAULT_ALLOWS_PUBLIC` mean?

A status change would leave the default status allowing public use. The
message is "The status new uploads get cannot allow public use". Keep the
default a status that does not allow public use.

More: [Statuses, Errors](../files/statuses.md#errors)

### What does `CONFLICT` with reason `LAST_WORKSPACE` mean?

The organization's only live workspace was being deleted. Create another
workspace first, or delete the organization.

More: [Workspaces, The last workspace rule](../organizations/workspaces.md#the-last-workspace-rule)

### What does `CONFLICT` with reason `CONNECTION_LIMIT` mean?

An app's request to connect was allowed while you already hold 10 working
connections to that app in that organization. The request stays open.
Disconnect one under Settings, Connected apps, then allow again.

More: [Connected apps, Several connections per app](../agents/connected-apps.md#several-connections-per-app)

### What does `CONFLICT` with reason `CLOSED` mean?

A library proposal that is closed or expired was applied or rejected. The
message is "This suggestion is closed or expired". Create a new proposal.

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

### What does `CONFLICT` with reason `ITEM_DECIDED` mean?

A selected item of a library proposal was already applied, rejected or
marked stale. The message is "Some selected items were already decided".
Nothing was applied or rejected. Read the proposal again and select only
pending items.

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

### What does `CONFLICT` with reason `PREVIEW_PENDING` mean?

A `thumb` or `preview` signed URL was asked for while the preview is still
being rendered. Try again shortly. `previewStatus` on the file says when it
is `ready`.

More: [Errors, `CONFLICT` (409)](../reference/errors.md#conflict-409)

### What does `CONFLICT` with reason `PREVIEW_FAILED` mean?

No preview could be rendered for the file. Use the `original` variant.

More: [Errors, `CONFLICT` (409)](../reference/errors.md#conflict-409)

### What does `CONFLICT` with reason `NO_PREVIEW` mean?

The file's type has no preview, or the file embeds none. Asking for a
`thumb` of a font answers it, for example. Use the `original` variant.

More: [Errors, `CONFLICT` (409)](../reference/errors.md#conflict-409)

### What does `CONFLICT` with reason `PLAYBACK_PENDING` mean?

A `playback` signed URL was asked for while the video's playback rendition
is still being rendered. Try again shortly, or use `original`.

More: [Errors, `CONFLICT` (409)](../reference/errors.md#conflict-409)

### What does `CONFLICT` with reason `PLAYBACK_FAILED` mean?

No playback rendition could be rendered for the video. Use the `original`
variant.

More: [Errors, `CONFLICT` (409)](../reference/errors.md#conflict-409)

### What does `CONFLICT` with reason `NO_PLAYBACK` mean?

The file needs no playback rendition: the original plays as it is, or the
file is not a video. Use the `original` variant.

More: [Errors, `CONFLICT` (409)](../reference/errors.md#conflict-409)

### What is the difference between `PREVIEW_PENDING`, `PREVIEW_FAILED` and `NO_PREVIEW`?

`PREVIEW_PENDING` is temporary: the preview is being rendered, so try again
shortly. `PREVIEW_FAILED` and `NO_PREVIEW` are final: no preview will
come, so use `original`.

More: [Errors, `CONFLICT` (409)](../reference/errors.md#conflict-409)

### Why does confirming an email change answer "another account uses this email address"?

Another account took the address after the change was requested and before
it was confirmed. The link stays usable, but the change cannot go through.
Start a change to another address.

More: [Password and email address, When the new address belongs to another account](../accounts/password-and-email.md#when-the-new-address-belongs-to-another-account)

### What does "this address belongs to a member of the organization" mean?

An address that already belongs to a member was invited. There is nothing
to do: they are already a member.

More: [Invitations, Errors](../organizations/invitations.md#errors)

### What does "you are already a member of this organization" mean?

An invitation was accepted by someone who is already a member. The link
stays usable and nothing changes.

More: [Invitations, Errors](../organizations/invitations.md#errors)

### What does "an export just finished; request again" mean?

An export was requested at the moment the pending one finished. Request the
export again.

More: [Export, Errors](../organizations/export.md#errors)

## `SOLE_OWNER` (409)

### When does the API answer `SOLE_OWNER`?

The action would leave an organization without an owner. The status is
`409` and the message is "Transfer ownership or delete the organization
first". It is answered when the only owner leaves, is removed or is
demoted, or deletes their account.

More: [Errors, `SOLE_OWNER` (409)](../reference/errors.md#sole_owner-409)

### What do I do after `SOLE_OWNER`?

Make someone else an owner first, or delete the organization.
`details.organizationIDs` lists the live organizations that would be left
without an owner.

More: [Errors, `SOLE_OWNER` (409)](../reference/errors.md#sole_owner-409)

### What does the app say when an action would leave an organization without an owner?

"{organization} needs another owner first. Make another member an owner,
then try again."

More: [Members and roles, Messages when something is refused](../organizations/members-and-roles.md#messages-when-something-is-refused)

## `PAYLOAD_TOO_LARGE` (413), `UNSUPPORTED_MEDIA_TYPE` (415) and `RANGE_NOT_SATISFIABLE` (416)

### What does `PAYLOAD_TOO_LARGE` mean?

A body, a file or an answer is over a size limit. The status is `413`.
There are four cases: an upload that declares too many bytes, a ZIP
download that would be too large, a JSON request body over 3 MiB, and an
MCP tool answer over 8 MiB.

More: [Errors, `PAYLOAD_TOO_LARGE` (413)](../reference/errors.md#payload_too_large-413)

### What does `details.limitBytes` hold in a `PAYLOAD_TOO_LARGE` error?

The limit that was passed, in bytes. It is given for an upload over the
upload limit and for a ZIP download over the archive limit. For an upload
it is 53687091200, which is 50 GiB, or 2147483648, which is 2 GiB, for an
image, PDF, Word, Excel or Figma file.

More: [Errors, `PAYLOAD_TOO_LARGE` (413)](../reference/errors.md#payload_too_large-413)

### When is `details` `null` in a `PAYLOAD_TOO_LARGE` error?

For a JSON request body over 3 MiB, and for an MCP tool answer over 8 MiB.

More: [Errors, `PAYLOAD_TOO_LARGE` (413)](../reference/errors.md#payload_too_large-413)

### What does "The answer is larger than MCP returns; read it over REST" mean?

An MCP tool's answer is over 8 MiB, so it is refused with
`PAYLOAD_TOO_LARGE`. Ask for a smaller page with `limit`, or read it over
REST.

More: [MCP, Tool results](../agents/mcp.md#tool-results)

### Why does a ZIP download answer `PAYLOAD_TOO_LARGE`?

The ZIP would hold more than 20 GiB. `details.limitBytes` holds the limit.
Download fewer files at once.

More: [Downloading, Errors](../files/downloading.md#errors)

### What does `UNSUPPORTED_MEDIA_TYPE` mean?

The file type or the request's content type is not accepted. The status is
`415`. Either an upload's file extension is outside the list of accepted
types or its `contentType` does not match the extension, or a request with
a JSON body did not send `Content-Type: application/json`.

More: [Errors, `UNSUPPORTED_MEDIA_TYPE` (415)](../reference/errors.md#unsupported_media_type-415)

### Why does my `POST` with a JSON body answer `415`?

It did not send `Content-Type: application/json`. Bodies are JSON and need
that header.

More: [The REST API, Edge cases](../agents/rest-api.md#edge-cases)

### Why does starting an upload answer `UNSUPPORTED_MEDIA_TYPE`?

The extension of `fileName` is not an accepted type, or `contentType` does
not match it. Send the real type, an empty `contentType`, or
`application/octet-stream` to go by the extension.

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

### What does `RANGE_NOT_SATISFIABLE` mean?

A `Range` request for a file's bytes starts past the end of the content.
The status is `416` and the message is "The requested range is not
satisfiable". Ask for bytes that exist.

More: [Errors, `RANGE_NOT_SATISFIABLE` (416)](../reference/errors.md#range_not_satisfiable-416)

### What does `details.sizeBytes` hold in a `RANGE_NOT_SATISFIABLE` error?

The size of the content in bytes. The header `Content-Range: bytes
*/<size>` gives the same number.

More: [Errors, `RANGE_NOT_SATISFIABLE` (416)](../reference/errors.md#range_not_satisfiable-416)

## `RATE_LIMITED` (429)

### What does `RATE_LIMITED` mean?

Too many attempts in the current time window. The status is `429` and the
message is "Too many attempts; try again later". Wait, then retry.

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

### What does `details.retryAfterSeconds` hold in a `RATE_LIMITED` error?

The whole seconds until the window ends, at least 1. The `Retry-After`
header gives the same number.

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

### Can I retry sooner than `Retry-After` says?

It does not help. Refused attempts do not extend the window, but they are
not served either. Wait exactly `details.retryAfterSeconds`.

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

### Does an attempt made while I am rate limited make the wait longer?

No. Windows are fixed. A window starts at the first attempt, and attempts
refused inside it do not extend it.

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

### Why does a valid API key get `429 RATE_LIMITED` on its first request?

The client address used up its failed bearer authentications: 100 in 15
minutes. After that every bearer request from that address is refused
until the window ends, valid keys included.

More: [Credentials and scopes, Rate limits](../agents/credentials.md#rate-limits)

### Why does my key get `429` although it made few requests itself?

All credentials of one organization share a limit of 3,000 requests a
minute, REST and MCP together. Other keys and connected apps of the
organization can use it up.

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

### Why did trying from another network still answer `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 together. Wait for `Retry-After`.

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

### Why does creating an API key answer `429 RATE_LIMITED`?

One member may create 20 keys in 24 hours. The app says "You can create 20
keys a day. Try again {when}."

More: [Credentials and scopes, Edge cases](../agents/credentials.md#edge-cases)

### Can my own work in the browser cause `RATE_LIMITED` for my API key?

No. Requests made in a browser session are not counted against the
credential and organization limits.

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

### Does a `429` answer tell me which limit I passed or what is left?

No. It carries `Retry-After` and `details.retryAfterSeconds` and nothing
else. No header tells you the limit, how much is left or when the window
resets.

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

## `INTERNAL` (500), `UNAVAILABLE` and `TIMEOUT` (503)

### What does `INTERNAL` mean?

Something failed unexpectedly on our side. The status is `500`, the message
is "Internal server error" and `details` is always `null`. The cause is
never in the answer.

More: [Errors, `INTERNAL` (500)](../reference/errors.md#internal-500)

### What do I do after `INTERNAL`?

Retry once. If it persists, report the `requestID`.

More: [Errors, `INTERNAL` (500)](../reference/errors.md#internal-500)

### What does "The operation answered <status>" mean in an MCP tool error?

The tool call failed and its answer was not JSON. The result carries the
code `INTERNAL` with that message, where `<status>` is the HTTP status the
operation answered.

More: [Errors, `INTERNAL` (500)](../reference/errors.md#internal-500)

### What does `UNAVAILABLE` mean?

Something the request depends on is not available right now. The status is
`503` and the message is "Temporarily unavailable; try again shortly".
`details.reason` says what: `UPLOADS_DISABLED`, `EMAIL_UNAVAILABLE`,
`IMAGE_SERVICE_UNAVAILABLE`, `IMAGE_RENDER_TIMED_OUT` or
`STORAGE_CONTENDED`.

More: [Errors, `UNAVAILABLE` (503)](../reference/errors.md#unavailable-503)

### What does `UNAVAILABLE` with reason `UPLOADS_DISABLED` mean?

New uploads are switched off for now. Try again later. Existing files still
read.

More: [Errors, `UNAVAILABLE` (503)](../reference/errors.md#unavailable-503)

### What does `UNAVAILABLE` with reason `EMAIL_UNAVAILABLE` mean?

The request needs to send an email, and email cannot be sent right now.
Nothing was created, changed or stored. Try again later.

More: [Errors, `UNAVAILABLE` (503)](../reference/errors.md#unavailable-503)

### Which actions can answer `EMAIL_UNAVAILABLE`?

Those that would send an email, for example sign-up, a password or email
address request that sends one, sending an invitation, and making someone
an owner. The change the email belongs to does not happen.

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

### What does `UNAVAILABLE` with reason `IMAGE_SERVICE_UNAVAILABLE` mean?

An image variant was requested while the image service is busy or cannot be
reached. `Retry-After` gives the seconds to wait, at least 1. Originals are
not affected.

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

### What does `UNAVAILABLE` with reason `IMAGE_RENDER_TIMED_OUT` mean?

Decoding and resizing an image variant took longer than 15 seconds.
`Retry-After` is 30 seconds. Retry after that. If it keeps failing, ask for
a smaller width.

More: [Errors, `UNAVAILABLE` (503)](../reference/errors.md#unavailable-503)

### What does `UNAVAILABLE` with reason `STORAGE_CONTENDED` mean?

Storing content collided with a concurrent removal of the same content
three times in a row. Retry the request.

More: [Errors, `UNAVAILABLE` (503)](../reference/errors.md#unavailable-503)

### Which `UNAVAILABLE` reasons carry a `Retry-After` header?

`IMAGE_SERVICE_UNAVAILABLE` and `IMAGE_RENDER_TIMED_OUT`. The other three
reasons carry none.

More: [Errors, Every code](../reference/errors.md#every-code)

### What does `TIMEOUT` mean?

The request ran past its time limit. A request has 30 seconds; a step
inside it that runs past its own limit answers the same code. The status is
`503`, the message is "The request did not finish in time; try again" and
the work is stopped.

More: [Errors, `TIMEOUT` (503)](../reference/errors.md#timeout-503)

### Can I retry after `TIMEOUT` or `INTERNAL`?

Yes. A create that takes a `requestID` is safe to retry with the same
`requestID`. A change that takes `expectedLockVersion` is safe to retry
too: if the first attempt went through, the retry answers
`STALE_LOCK_VERSION`.

More: [Errors, `TIMEOUT` (503)](../reference/errors.md#timeout-503)

### What is the difference between `TIMEOUT` and `UNAVAILABLE`?

`TIMEOUT` means the request itself ran too long. `UNAVAILABLE` means
something the request depends on, such as email or the image service, is
not available right now. Both are `503` and both can be retried.

More: [Errors, Every code](../reference/errors.md#every-code)

## Refused uploads

### Where do I read why an upload was rejected?

In the upload's `rejectReason`. Read the upload: its `state` is `rejected`
and `rejectReason` holds one of ten values. In the app the upload tray
shows the reason on the file's row.

More: [Errors, Refused uploads](../reference/errors.md#refused-uploads)

### Which reject reasons can an upload end with?

`OBJECT_MISSING`, `SIZE_MISMATCH`, `DIGEST_MISMATCH`, `TYPE_NOT_ALLOWED`,
`TYPE_MISMATCH`, `MEDIA_INVALID`, `MALWARE`, `STALE_FILE_VERSION`,
`IN_TRASH` and `INGEST_FAILED`.

More: [Errors, Refused uploads](../reference/errors.md#refused-uploads)

### What does the reject reason `OBJECT_MISSING` mean?

No bytes were found for the upload. Start again and send every part before
completing.

More: [Uploading, Errors](../files/uploading.md#errors)

### What does the reject reason `SIZE_MISMATCH` mean?

The bytes that arrived are not the declared `sizeBytes`. Declare exactly
the number of bytes you send.

More: [Errors, Refused uploads](../reference/errors.md#refused-uploads)

### What does the reject reason `DIGEST_MISMATCH` mean?

The bytes do not have the `sha256` you declared. Declare the right digest,
or none.

More: [Errors, Refused uploads](../reference/errors.md#refused-uploads)

### What does the reject reason `TYPE_NOT_ALLOWED` mean?

The content of the file is of a type that is not accepted, whatever its
name says. See the accepted types.

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

### What does the reject reason `TYPE_MISMATCH` mean?

The content is of another accepted type than the file name claims. Give
the file its real extension and upload it again.

More: [Uploading, Errors](../files/uploading.md#errors)

### What does the reject reason `MEDIA_INVALID` mean?

The image, PDF or video does not open, or is over its limits. Export the
file again from its source, or make it smaller.

More: [Uploading, Errors](../files/uploading.md#errors)

### What does the reject reason `MALWARE` mean?

The scan found malware in the file. Do not upload the file.

More: [Errors, Refused uploads](../reference/errors.md#refused-uploads)

### Why did my replacement upload end `rejected` with `STALE_FILE_VERSION`?

The file being replaced got a newer version while your upload was on its
way. Start again from the current version.

More: [Errors, Refused uploads](../reference/errors.md#refused-uploads)

### Why did my replacement upload end `rejected` with `IN_TRASH`?

The file being replaced was moved to the trash while your upload was on its
way. Restore it, then start again.

More: [Errors, Refused uploads](../reference/errors.md#refused-uploads)

### What does the reject reason `INGEST_FAILED` mean?

Verification could not be finished and gave up. It may pass another time:
upload the file again.

More: [Errors, Refused uploads](../reference/errors.md#refused-uploads)

### What is the difference between `TYPE_NOT_ALLOWED` and `TYPE_MISMATCH`?

`TYPE_NOT_ALLOWED`: the content is no accepted type at all.
`TYPE_MISMATCH`: the content is an accepted type, but not the one the file
name claims.

More: [Uploading, Errors](../files/uploading.md#errors)

### What is the difference between `UNSUPPORTED_MEDIA_TYPE` and `TYPE_NOT_ALLOWED`?

`UNSUPPORTED_MEDIA_TYPE` is an HTTP error when the upload is started: the
extension or the declared `contentType` is not accepted. `TYPE_NOT_ALLOWED`
is a reject reason after the bytes were checked: their real content is not
an accepted type.

More: [Uploading, Errors](../files/uploading.md#errors)

### What is the difference between `CONFLICT` `OBJECT_MISSING` and the reject reason `OBJECT_MISSING`?

The `409 CONFLICT` answers a `complete` call made before the bytes arrived,
and the upload stays pending. The reject reason ends the upload: no bytes
were found during verification, and a new upload is needed.

More: [Uploading, Errors](../files/uploading.md#errors)

### Which rejected uploads are worth trying again unchanged?

Only `INGEST_FAILED`. The app offers "Retry" on a rejected row only for
"Rejected: Could not be checked": trying the same bytes again for any other
reason would be refused again.

More: [Uploading, Cancel and retry](../files/uploading.md#cancel-and-retry)

### Does a rejected upload show in a key's activity?

Yes. An upload through a key shows `upload.created`, `upload.completed`
and, when verification refused it, `upload.rejected`, which notes the
reject reason.

More: [Audit trail, Credential activity](../reference/audit-trail.md#credential-activity)

## OAuth errors

### What does "This app cannot connect" mean?

Talewright refused the app itself or the address it wants to return to,
before anyone was asked for consent. The screen gives a reason and says
"Nothing was shared with it." Nothing is sent to the app.

More: [Errors, Errors shown to the person](../reference/errors.md#errors-shown-to-the-person)

### What does "Talewright does not accept this app yet." mean?

The app's client ID is not one Talewright accepts. The OAuth error is
`unauthorized_client`. Use an accepted app, or connect the client with an
API key.

More: [Connected apps, Which apps can connect](../agents/connected-apps.md#which-apps-can-connect)

### What does "The app's description could not be read, or does not describe it." mean?

The app's client metadata document could not be fetched or is not valid.
The OAuth error is `invalid_client`. Only the app's developer can fix it.

More: [Connected apps, The client metadata document](../agents/connected-apps.md#the-client-metadata-document)

### What does "The app asked to return somewhere its description does not list." mean?

The `redirect_uri` is missing, is not `https` or loopback `http`, or is not
listed in the app's document. The error is `invalid_redirect_uri`. Only the
app's developer can fix it.

More: [Errors, Errors shown to the person](../reference/errors.md#errors-shown-to-the-person)

### What does the OAuth error `unauthorized_client` mean?

Talewright does not accept the app that asked to connect: its client ID is
not one of the accepted ones. Nothing is sent to the app. The browser shows
"This app cannot connect" with "Talewright does not accept this app yet."

More: [Errors, Errors shown to the person](../reference/errors.md#errors-shown-to-the-person)

### What does the OAuth error `invalid_redirect_uri` mean?

The address the app wants to return to was refused: the `redirect_uri` is
missing, is not `https` or loopback `http`, or is not listed in the app's
document. Nothing is sent to the app, and the browser shows "This app cannot
connect".

More: [Errors, Errors shown to the person](../reference/errors.md#errors-shown-to-the-person)

### What does "The app's request is incomplete." mean?

The request to connect has no `client_id`. The OAuth error is
`invalid_request`. Only the app's developer can fix it.

More: [Errors, Errors shown to the person](../reference/errors.md#errors-shown-to-the-person)

### What does "This request has ended" mean?

The request to connect is older than 10 minutes, already answered, unknown,
or was first opened by another account. The screen adds "Requests last 10
minutes, are answered once and stay with the account that opened them first.
Start again from the app."

More: [Connected apps, The consent screen](../agents/connected-apps.md#the-consent-screen)

### What does the OAuth error `access_denied` mean?

The person chose "Deny" on the consent screen. Nothing is connected and
there is nothing to fix.

More: [Errors, Errors sent back to the app](../reference/errors.md#errors-sent-back-to-the-app)

### What does the OAuth error `unsupported_response_type` mean?

The authorization request's `response_type` is not `code`. Talewright
supports only the authorization code flow.

More: [Errors, Errors sent back to the app](../reference/errors.md#errors-sent-back-to-the-app)

### What does the OAuth error `invalid_target` mean?

The `resource` parameter is missing or is not the MCP endpoint. At the
token endpoint the description is "resource must be this server's MCP
endpoint". Send the MCP endpoint's URL exactly as the discovery document
gives it.

More: [Connected apps, The authorization request](../agents/connected-apps.md#the-authorization-request)

### What does the OAuth error `invalid_scope` mean on the authorization request?

The `scope` parameter names a scope that does not exist. The four scopes
are `workspace:read`, `files:read`, `files:write` and `files:approve`.

More: [Errors, Errors sent back to the app](../reference/errors.md#errors-sent-back-to-the-app)

### What does the OAuth error `invalid_request` mean on the authorization request?

The request is malformed in one of these ways: a parameter is given twice,
`state` is longer than 500 characters, `code_challenge` is missing or not
43 base64url characters, or `code_challenge_method` is not `S256`.

More: [Errors, Errors sent back to the app](../reference/errors.md#errors-sent-back-to-the-app)

### Which parameters come with an OAuth error sent back to the app?

`error`, `state` and `iss`, as query parameters on the app's
`redirect_uri`. A `state` longer than 500 characters is not sent back.

More: [Errors, Errors sent back to the app](../reference/errors.md#errors-sent-back-to-the-app)

### What do the token endpoint's errors look like?

`POST /oauth/token` and `POST /oauth/revoke` answer JSON
`{"error": "...", "error_description": "..."}` with `Cache-Control:
no-store`.

More: [Errors, Token endpoint errors](../reference/errors.md#token-endpoint-errors)

### What does the OAuth error `invalid_grant` mean?

The code or the refresh token cannot be used: it is unknown, used, expired
or another app's, or the member no longer reaches what they granted. The
status is `400`. Start again from the app.

More: [Connected apps, Errors](../agents/connected-apps.md#errors)

### What does "The code is unknown, used or expired" mean?

The authorization code cannot be exchanged. A code works for 60 seconds and
for one attempt, and the first attempt uses it up whether it succeeds or
not. Start again from the app.

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

### What does "The code was issued to another client" mean?

The `client_id` of the token request is not the app the code was issued
to. A code works only for the app that asked for it.

More: [Errors, Token endpoint errors](../reference/errors.md#token-endpoint-errors)

### What does "redirect_uri differs from the authorization request's" mean?

The token request must send the same `redirect_uri` as the authorization
request did. It sent another one, and the answer is `invalid_grant`.

More: [Connected apps, The token request](../agents/connected-apps.md#the-token-request)

### What does "code_verifier does not match the code_challenge" mean?

The PKCE check failed: the `code_verifier` in the token request is not the
one whose `S256` challenge was sent in the authorization request.

More: [Errors, Token endpoint errors](../reference/errors.md#token-endpoint-errors)

### What does "The authorization ended during its exchange" mean?

While the code was being exchanged, the same code arrived a second time, or
the member changed or reset their password, left or was removed from the
organization, or deleted their account. The answer is `invalid_grant` and
nothing is connected. A code works for one attempt.

More: [Errors, Token endpoint errors](../reference/errors.md#token-endpoint-errors)

### What does "The member is gone" mean?

The account that allowed the app was deleted before the code was
exchanged. The answer is `invalid_grant` and nothing is connected.

More: [Errors, Token endpoint errors](../reference/errors.md#token-endpoint-errors)

### What does "The member no longer reaches what they granted" mean?

Between "Allow" and the exchange of the code, the member lost a workspace
they chose. When the code is exchanged, Talewright checks again that the
member still reaches the chosen workspaces. If not, the exchange is refused
and no app is connected.

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

### What does "The member may no longer grant approval scopes" mean?

The member granted `files:approve` but is no longer owner or admin in each
chosen workspace when the code is exchanged. The exchange is refused with
`invalid_grant`.

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

### What does "The refresh token is unknown, spent or expired" mean?

The refresh token cannot be exchanged. Each refresh token works once, stops
after 30 days without a refresh, and never outlives the connected app. The
app must ask the person again.

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

### What does "The refresh token was issued to another client" mean?

Another app presented the refresh token. A token works only for the app it
was issued to. The answer is `invalid_grant`, and the connection the token
belongs to is not affected.

More: [Connected apps, Edge cases](../agents/connected-apps.md#edge-cases)

### What does "The refresh token was already used; the grant is revoked" mean?

A refresh token that was already used was presented again. The connected
app is revoked at once. The app must ask the person again.

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

### What does "A refresh cannot change the scopes: omit scope or repeat the granted scopes exactly" mean?

A refresh asked for other scopes than the connected app holds, fewer ones
included. The error is `invalid_scope`. The refresh token is not used up:
try again without `scope`.

More: [Connected apps, Edge cases](../agents/connected-apps.md#edge-cases)

### What does the OAuth error `invalid_client` mean at the token endpoint?

The request has no `client_id`, or it sent a secret. The status is `401`
with `WWW-Authenticate: Bearer error="invalid_client"`.

More: [Errors, Token endpoint errors](../reference/errors.md#token-endpoint-errors)

### What does "Clients are public: send client_id and no secret" mean?

The token request carried an `Authorization` header or a `client_secret`.
Apps have no secret. Send `client_id` as a form field and nothing else to
identify the app.

More: [Connected apps, The token request](../agents/connected-apps.md#the-token-request)

### What does "client_id is required" mean?

The token request has no `client_id` form field. The error is
`invalid_client`.

More: [Errors, Token endpoint errors](../reference/errors.md#token-endpoint-errors)

### What does the OAuth error `unsupported_grant_type` mean?

`grant_type` is neither `authorization_code` nor `refresh_token`. The
description reads "Only authorization_code and refresh_token are
supported".

More: [Errors, Token endpoint errors](../reference/errors.md#token-endpoint-errors)

### What does the OAuth error `server_error` mean?

The token could not be issued because of a failure on our side. The status
is `500` and the description is "The token could not be issued".

More: [Errors, Token endpoint errors](../reference/errors.md#token-endpoint-errors)

### What does "The body must be application/x-www-form-urlencoded" mean?

The token or revocation request did not send a form body. These endpoints
take `application/x-www-form-urlencoded`, not JSON.

More: [Connected apps, The token request](../agents/connected-apps.md#the-token-request)

### What does "The body is too large" mean at the token endpoint?

The form body is over 16 KiB. The error is `invalid_request`.

More: [Errors, Token endpoint errors](../reference/errors.md#token-endpoint-errors)

### What does "The body is not UTF-8" mean?

The form body of a token or revocation request is not valid UTF-8 text.
The error is `invalid_request`.

More: [Errors, Token endpoint errors](../reference/errors.md#token-endpoint-errors)

### What does "A parameter is repeated" mean?

A form field was sent more than once. Each field of a token request may be
sent once. The error is `invalid_request`.

More: [Connected apps, The token request](../agents/connected-apps.md#the-token-request)

### What does "grant_type is required" mean?

The token request has no `grant_type`. Send `authorization_code` to
exchange a code, or `refresh_token` to refresh.

More: [Connected apps, The token request](../agents/connected-apps.md#the-token-request)

### What does "code is required" mean?

A token request with `grant_type` `authorization_code` has no `code`. Send
the code from the redirect.

More: [Connected apps, The token request](../agents/connected-apps.md#the-token-request)

### What does "redirect_uri is required" mean?

A token request that exchanges a code has no `redirect_uri`. Send the same
address as in the authorization request.

More: [Connected apps, The token request](../agents/connected-apps.md#the-token-request)

### What does "code_verifier is required" mean?

A token request that exchanges a code has no `code_verifier`. PKCE is
required: send the verifier whose challenge the authorization request
carried.

More: [Connected apps, The token request](../agents/connected-apps.md#the-token-request)

### What does "code_verifier must be 43 to 128 unreserved characters" mean?

The PKCE verifier is too short, too long or holds a character outside the
unreserved set. The error is `invalid_request`.

More: [Connected apps, The token request](../agents/connected-apps.md#the-token-request)

### What does "refresh_token is required" mean?

A token request with `grant_type` `refresh_token` has no `refresh_token`.
Send the current refresh token.

More: [Connected apps, The token request](../agents/connected-apps.md#the-token-request)

### What does "token and client_id are required" mean?

A revocation request lacks one of its two form fields. `POST
/oauth/revoke` takes `token` and `client_id`.

More: [Connected apps, Revoking](../agents/connected-apps.md#revoking)

### Does `POST /oauth/revoke` answer an error for a token it does not know?

No. It answers `200` for any token, known or not. A token of that app
revokes its connection; any other token changes nothing.

More: [Connected apps, Revoking](../agents/connected-apps.md#revoking)

### Why do the OAuth endpoints answer `429 RATE_LIMITED`?

Every `/oauth/` endpoint counts requests per client address: 100 in 15
minutes for `/oauth/authorize`, `/oauth/token` and `/oauth/revoke`
together. Past that they answer `429` in the ordinary error body, with
`Retry-After`.

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

## MCP errors

### Which kinds of failure does an agent see over MCP?

Three:

- A tool ran and failed: a normal tool result with `isError: true`.
- The request never reached a tool: an HTTP error (`401`, `403`, `405` or
  `429`).
- The MCP request itself is wrong: a JSON-RPC error.

More: [Errors, MCP errors](../reference/errors.md#mcp-errors)

### What does `isError: true` in an MCP tool result mean?

The tool ran and failed. The result's `structuredContent` is the error
envelope, and its text content is the same JSON. Every code and reason of
the API can appear there.

More: [MCP, Tool results](../agents/mcp.md#tool-results)

### What does the JSON-RPC error `-32602` mean?

The MCP request named something the server cannot use: an unknown tool or
one outside the credential's scopes ("Unknown tool: <name>"), an invalid
list cursor ("Invalid cursor"), a resource address that is unknown or
outside the credential's reach, or a `2026-07-28` style request without its
client capabilities.

More: [Errors, MCP errors](../reference/errors.md#mcp-errors)

### Why does calling a tool answer "Unknown tool" and not a `403`?

Calling a tool that is not on the credential's list answers the same error
as a tool that does not exist. The tool list follows the credential's
scopes, so a tool whose scope it lacks is unknown to it.

More: [MCP, Which tools a credential sees](../agents/mcp.md#which-tools-a-credential-sees)

### What does the JSON-RPC error `-32601` mean?

The client called a method the server does not serve, such as
`prompts/list` or `completion/complete`. The server offers tools and
resources, nothing else.

More: [Errors, MCP errors](../reference/errors.md#mcp-errors)

### What does the JSON-RPC error `-32022` mean?

A request in the `2026-07-28` style named a protocol version the server
does not support. The HTTP status is `400`, and the answer lists the
supported versions.

More: [MCP, Protocol versions](../agents/mcp.md#protocol-versions)

### What does the JSON-RPC error `-32020` mean?

The request's `Mcp-Method` header disagrees with its body. The HTTP status
is `400`.

More: [Errors, MCP errors](../reference/errors.md#mcp-errors)

### Why can an agent not tell a missing resource from one it may not read?

On purpose. An address the credential cannot reach and an address that does
not exist answer the same JSON-RPC error, `-32602`.

More: [MCP, Resources](../agents/mcp.md#resources)

### What does a failed MCP resource read carry?

A JSON-RPC error whose `data` is the error envelope.

More: [Errors, MCP errors](../reference/errors.md#mcp-errors)

### Why does `/mcp` answer an HTTP error instead of a tool result?

The request never reached a tool: no token or a bad one (`401
UNAUTHENTICATED`), an `Origin` header (`403 FORBIDDEN`), a method other
than `POST` (`405 METHOD_NOT_ALLOWED`), or too many requests (`429
RATE_LIMITED`). The body is the ordinary error envelope.

More: [MCP, Errors](../agents/mcp.md#errors)

### Which `CONFLICT` reasons can an MCP tool answer?

`NAME_TAKEN`, `CYCLE`, `IN_TRASH`, `NOT_IN_TRASH`, `NOT_PENDING`,
`OBJECT_MISSING`, `EXPIRED`, `DIFFERENT_TYPE`, `REQUEST_REUSED`,
`VISIBILITY_CHANGE`, `CLOSED`, `ITEM_DECIDED`, `PREVIEW_PENDING`,
`PREVIEW_FAILED`, `NO_PREVIEW`, `PLAYBACK_PENDING`, `PLAYBACK_FAILED` and
`NO_PLAYBACK`.

More: [MCP, Errors](../agents/mcp.md#errors)

### Why does a create tool answer `VALIDATION_FAILED` on `requestID` over MCP when REST accepts the same call?

Over MCP `requestID` is required on the six create tools; over REST it is
optional. Without it nothing is created.

More: [MCP, Edge cases](../agents/mcp.md#edge-cases)

### Why does a listed organization folder tool answer `FORBIDDEN` for a member's agent?

Listing follows scopes, not roles. A member's credential with `files:write`
lists the `library_` tools that change things, but members only read the
organization folder, so calling one answers `FORBIDDEN`.

More: [MCP, Edge cases](../agents/mcp.md#edge-cases)

### What should an agent do when a tool result is `FORBIDDEN`?

Stop and tell the person. The member's role does not allow the action, the
credential lacks `files:approve` for a change that would make files public,
or the member is not an owner or admin.

More: [MCP, Errors](../agents/mcp.md#errors)

## Errors on the files host

### Do errors on `https://files.talewrightusercontent.com` look like API errors?

Yes. Refusals on the files host use the API's error envelope. None is
cached: every one carries `Cache-Control: no-store`.

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

### Why does a signed link answer `403`?

The link is altered, expired, or was stopped because the file was trashed,
restored or deleted. A signed link works for 10 minutes. Ask the API for a
new one.

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

### Why does a ZIP download link answer `403`?

The link is altered, expired or was stopped. A ZIP link works for 10
minutes. Ask for the ZIP again.

More: [Downloading, Errors](../files/downloading.md#errors)

### Why does a public link answer `404`?

The file is restricted, trashed, blocked by its status, deleted or unknown.
All of these look the same. Check the file's `public` and `publicURL` in
the API, or ask the owner whether the file is still shared.

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

### Why does an image variant address answer `404`?

The file behind it is not public any more, or it is not one of the eight
image types a variant can be made from.

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

### Why does the files host answer `405 METHOD_NOT_ALLOWED`?

It serves `GET` and `HEAD`. Any other method is refused, and `OPTIONS` is
answered only on a public link or its variant. Use `GET`.

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

### Why does a download answer `416` on the files host?

A byte range starts at or past the end of the content. `details.sizeBytes`
and `Content-Range: bytes */{size}` give the size. Ask for a range inside
it.

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

### What does "Invalid image options" mean?

The options part of an image variant address breaks a rule. The answer is
`422 VALIDATION_FAILED` and `details.field` is `options`.

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

### What does "Image addresses have no query" mean?

An image variant address has a `?`. Options go in the path, after
`/_img/`. `details.field` is `image`.

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

### What does "Source must be a file delivery path" mean?

What follows the options in a variant address is not a signed link's or a
public link's path. Resize a file's link, not a gallery or a ZIP.
`details.field` is `image`.

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

### What does "Image source exceeds 64 MiB" mean?

The original behind the variant is larger than 64 MiB, so no variant is
made. Use the original, or upload a smaller master.

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

### What does "Image source exceeds 16,384 pixels a side or 100 million pixels" mean?

The original behind the variant is over one of those limits. Use the
original link, or upload a smaller master.

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

### What does "The image source cannot be decoded" mean?

The original is damaged, or it is an SVG outside the rules, for example one
over 2 MiB. Use the original link, or replace the file.

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

### What does "The resulting image is too large" mean?

The variant would pass 24 million pixels or 16 MiB. Ask for a smaller `w`,
set an `h`, or use WebP instead of PNG.

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

### Why does a public link to a trashed file answer `404` while my signed link answers `403`?

They are two kinds of address. A public link to a trashed file answers
`404`, like any file that is not public. A temporary link made before the
trash was stopped, and a stopped link answers `403`.

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

## Messages in the app: signing in and your account

### Why does the sign-in page say "Email or password is incorrect."?

The email has no account or the password is wrong. The page shows the same
words for both. Check both, or use "Forgot password?" to set a new
password.

More: [Sign-in and sessions, The sign-in page](../accounts/sign-in-and-sessions.md#the-sign-in-page)

### Why does the sign-in form say "Enter your password."?

The form checks the fields before it sends anything. "Enter your
password." shows for an empty password and "Enter a valid email address."
for an address that is not one.

More: [Sign-in and sessions, The sign-in page](../accounts/sign-in-and-sessions.md#the-sign-in-page)

### What does "Account deleted" with "Your sessions have ended." mean on the sign-in page?

The sign-in page opened after the account was deleted. Deleting an account
signs it out everywhere. The notice goes away when a sign-in attempt is
refused.

More: [Sign-in and sessions, The sign-in page](../accounts/sign-in-and-sessions.md#the-sign-in-page)

### What do "Could not load your sessions." and "Could not revoke the session. Try again." mean?

The sessions page could not read the list, or could not end the session you
chose. "Could not sign out other sessions. Try again." is the same for
"Sign out other sessions". Try again.

More: [Sign-in and sessions, The sessions page](../accounts/sign-in-and-sessions.md#the-sessions-page)

### What does "Use at least 12 characters." mean?

The password is shorter than 12 characters. A password has 12 to 128
characters. A longer one shows "Use 128 characters or fewer."

More: [Sign-up and email verification, The sign-up page](../accounts/sign-up.md#the-sign-up-page)

### What does "Too many attempts. Try again in 4 minutes." mean?

A limit on attempts was reached, for example on sign-ups, on wrong current
passwords or on requests for a link. The time in the message varies. Wait
that long; attempts made while limited do not make the wait longer.

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

### What does "Something went wrong. Try again." mean?

The request failed for a reason the page has no words of its own for. It
is not one of the refusals with its own message. Try again.

More: [Sign-up and email verification, The sign-up page](../accounts/sign-up.md#the-sign-up-page)

### What does "Too many requests. Try again in 4 minutes." mean?

You asked for a new verification email too often. The resend is limited
for the time the message gives. Any other failure of the resend reads
"Could not send the email. Try again."

More: [Sign-up and email verification, The reminder](../accounts/sign-up.md#the-reminder)

### Why does the app show an alert "Verify your email" when I try to delete something?

Deleting an organization or a workspace needs a verified email address. The
alert says, for example, "To delete this organization,
first open the link we sent to {address}." and has its own "Resend
verification email".

More: [Sign-up and email verification, The reminder](../accounts/sign-up.md#the-reminder)

### What does "Choose a password different from your current one." mean?

The new password is the same as the current one. Type a different new
password.

More: [Password and email address, Changing the password](../accounts/password-and-email.md#changing-the-password)

### What does "Could not cancel the email change. Try again." mean?

"Cancel change" failed, so the email change is still pending. Press it
again.

More: [Password and email address, Changing the email address](../accounts/password-and-email.md#changing-the-email-address-1)

### What does "Another owner is needed" mean?

You are the only owner of an organization, so your account cannot be
deleted yet. The alert names the organizations: "You are the only owner of
Acme. Make another member an owner, or delete the organization, before
deleting your account." If your email is not verified it adds "Deleting an
organization needs a verified email."

More: [Deleting an account, In the app](../accounts/delete-account.md#in-the-app)

## Messages in the app: organizations, workspaces and members

### What does "Enter a name, up to 200 characters." mean?

The organization or workspace name is empty or longer than 200 characters.

More: [Organizations, Creating another organization](../organizations/organizations.md#creating-another-organization)

### What does "Make another member an owner before leaving this organization." mean?

You are the only owner, so the leave button is disabled. An organization
always keeps at least one owner. Make another member an owner first.

More: [Organizations, Leaving in the app](../organizations/organizations.md#leaving-in-the-app)

### What does "Only owners can delete the organization." mean?

An admin or member opened the delete page by its address. They do not see
the link to it, and the page refuses them. Only owners delete an
organization.

More: [Deleting and restoring, Deleting the organization](../organizations/delete-and-restore.md#deleting-the-organization)

### What does "Another workspace already has this name." mean?

A live workspace of the organization has the name you typed. Workspace
names are unique in an organization, ignoring case. Choose another name.

More: [Workspaces, Creating a workspace](../organizations/workspaces.md#creating-a-workspace)

### What does "Verify your email before deleting a workspace." mean?

Your email address is not verified, so the "Delete workspace" button is
disabled. Deleting a workspace needs a verified email.

More: [Workspaces, Deleting a workspace in the app](../organizations/workspaces.md#deleting-a-workspace-in-the-app)

### What does "Could not restore the workspace. Try again." mean?

Restoring failed for a reason other than a taken name. A workspace that
someone else already restored, or whose 30 days ended, reports no failure:
the app reloads the lists.

More: [Workspaces, Restoring a workspace in the app](../organizations/workspaces.md#restoring-a-workspace-in-the-app)

### Why are the other roles disabled with "Make another member an owner first."?

The row is the only owner's. The only owner cannot be demoted, so the other
roles on that row are disabled until someone else is an owner.

More: [Members and roles, Changing a role](../organizations/members-and-roles.md#changing-a-role)

### What does "This address belongs to a member." mean?

The address you are inviting already belongs to a member of the
organization. There is nothing to send.

More: [Invitations, Inviting](../organizations/invitations.md#inviting)

### What does "The export failed. Start a new one." mean?

The export is in state `failed`: it could not be built. Start a new export.

More: [Export, In the app](../organizations/export.md#in-the-app)

### What does "Could not start the export. Try again." mean?

Starting the export failed. Press "Start export" again.

More: [Export, In the app](../organizations/export.md#in-the-app)

## Messages in the app: API keys and connected apps

### What does "Enter a name, up to 100 characters." mean?

The name of the API key is empty or longer than 100 characters.

More: [Credentials and scopes, Create a key](../agents/credentials.md#create-a-key)

### What does "Choose an organization you belong to." mean?

No organization is chosen for the key, or for the app you are connecting.

More: [Credentials and scopes, Create a key](../agents/credentials.md#create-a-key)

### What does "Choose 1 to 20 workspaces." mean?

No workspace is ticked, or more than 20 are. A key or a connected app
reaches 1 to 20 workspaces.

More: [Credentials and scopes, Create a key](../agents/credentials.md#create-a-key)

### What does "Choose at least one permission." mean?

No permission is ticked. A key or a connected app holds at least one scope.
On the consent screen it also shows when you untick everything the app
asked for.

More: [Credentials and scopes, Create a key](../agents/credentials.md#create-a-key)

### What does "Choose 30, 90, 180 or 365 days." mean?

The lifetime is not one of the four that exist.

More: [Credentials and scopes, Create a key](../agents/credentials.md#create-a-key)

### What does "You can create 20 keys a day. Try again {when}." mean?

You created 20 API keys in the last 24 hours, which is the limit for one
member. Wait until the time the message gives.

More: [Credentials and scopes, Create a key](../agents/credentials.md#create-a-key)

### What does "Could not copy. Select the key and copy it." mean?

The browser refused to copy the new key to the clipboard. Select the key in
the dialog and copy it by hand before you close it: the key is shown only
this once.

More: [Credentials and scopes, Create a key](../agents/credentials.md#create-a-key)

### Why is "Set file statuses" greyed out and marked "(owner or admin only)"?

You are not owner or admin in every workspace you ticked. Only then can a
key or a connected app be given `files:approve`.

More: [Credentials and scopes, Create a key](../agents/credentials.md#create-a-key)

### What does "Only owners and admins of this organization see its members' API keys." mean?

You opened Key management as a member. Only owners and admins of an
organization list every member's API keys and connected apps.

More: [Credentials and scopes, Key management (owners and admins)](../agents/credentials.md#key-management-owners-and-admins)

### What does "You have no workspace yet" mean on the consent screen?

Your account reaches no workspace, and an app reaches workspaces. You can
only press "Deny". Join or create an organization, then start again from
the app.

More: [Connected apps, The consent screen](../agents/connected-apps.md#the-consent-screen)

### What does "Could not open the request" mean on the consent screen?

The request to connect could not be read. The screen adds "Something went
wrong. Try again."

More: [Connected apps, The consent screen](../agents/connected-apps.md#the-consent-screen)

### What does "Could not load the activity." mean?

The activity of the API key or connected app could not be read. It does
not mean the credential did nothing: a credential that was never used shows
"Nothing has been done with it yet."

More: [Audit trail, In the app](../reference/audit-trail.md#in-the-app)

## Messages in the app: uploading

### What is the difference between "Rejected" and "Failed" in the upload tray?

"Rejected: {reason}" means the file was refused and was not added. "Failed:
{reason}" means something went wrong on the way, and "Retry" is offered.

More: [Uploading, The upload tray](../files/uploading.md#the-upload-tray)

### What does "Rejected: This type of file cannot be uploaded" mean?

The file's extension is not an accepted type, or the browser reports a type
that does not match the extension.

More: [Uploading, Reasons shown on a row](../files/uploading.md#reasons-shown-on-a-row)

### What does "Rejected: The file name is not allowed" mean?

The file's name is longer than 200 characters or otherwise breaks the
naming rule. Rename the file and upload it again.

More: [Uploading, Reasons shown on a row](../files/uploading.md#reasons-shown-on-a-row)

### What does "Rejected: The folder no longer exists" mean?

The folder the upload was going to was trashed or deleted. Choose another
folder and upload again.

More: [Uploading, Reasons shown on a row](../files/uploading.md#reasons-shown-on-a-row)

### What does "Rejected: The file or folder no longer exists" mean?

The workspace, the file being replaced or the folder is gone.

More: [Uploading, Reasons shown on a row](../files/uploading.md#reasons-shown-on-a-row)

### What does "Rejected: Only organization owners and admins can change the organization folder." mean?

You may not upload there. In the organization folder only owners and admins
of the organization upload. Upload into a workspace, or ask an owner or
admin.

More: [Uploading, Reasons shown on a row](../files/uploading.md#reasons-shown-on-a-row)

### What does "Rejected: Someone replaced this file first" mean?

Your replacement was based on a version that is no longer the file's
current one: someone else replaced the file first. Reload the file's page
and replace it again, on top of their version.

More: [Versions and history, When someone replaced the file first](../files/versions.md#when-someone-replaced-the-file-first)

### What does "Rejected: Replace it with a PNG file" mean?

The file you chose as a replacement is of another type than the file it
replaces. The message names the file's own type. Choose a file of that
type, or upload yours as a new file.

More: [Versions and history, Replacing a file](../files/versions.md#replacing-a-file-1)

### What does "Rejected: The file is in the trash" mean?

The file being replaced is in the trash. Restore it, then replace it.

More: [Uploading, Reasons shown on a row](../files/uploading.md#reasons-shown-on-a-row)

### What does "Rejected: You were signed out" mean?

Your session ended before the upload could be made. Sign in and upload
again.

More: [Uploading, Reasons shown on a row](../files/uploading.md#reasons-shown-on-a-row)

### What does "Rejected: Contains malware" mean?

The scan found malware in the file. The reject reason is `MALWARE`. Do not
upload the file.

More: [Uploading, Reasons shown on a row](../files/uploading.md#reasons-shown-on-a-row)

### What does "Rejected: Contents are not an allowed file type" mean?

The file's real content is of a type that is not accepted, whatever its
extension. The reject reason is `TYPE_NOT_ALLOWED`.

More: [Uploading, Reasons shown on a row](../files/uploading.md#reasons-shown-on-a-row)

### What does "Rejected: Contents do not match the file extension" mean?

The content is of another accepted type than the name claims. The reject
reason is `TYPE_MISMATCH`. Give the file its real extension.

More: [Uploading, Reasons shown on a row](../files/uploading.md#reasons-shown-on-a-row)

### What does "Rejected: Could not be opened, or too large to process" mean?

The image, PDF or video does not open, or is over its limits. The reject
reason is `MEDIA_INVALID`. Export the file again, or make it smaller.

More: [Uploading, Reasons shown on a row](../files/uploading.md#reasons-shown-on-a-row)

### What does "Rejected: Changed while uploading" mean?

The bytes that arrived are not the ones the app declared: their size or
their SHA-256 differs. The reject reason is `SIZE_MISMATCH` or
`DIGEST_MISMATCH`.

More: [Uploading, Reasons shown on a row](../files/uploading.md#reasons-shown-on-a-row)

### What does "Rejected: The file never arrived" mean?

Verification found no bytes for the upload. The reject reason is
`OBJECT_MISSING`. Upload the file again.

More: [Uploading, Reasons shown on a row](../files/uploading.md#reasons-shown-on-a-row)

### What does "Rejected: Could not be checked" mean?

Verification could not be finished. The reject reason is `INGEST_FAILED`.
It is the one rejected row that offers "Retry", because it may pass
another time.

More: [Uploading, Reasons shown on a row](../files/uploading.md#reasons-shown-on-a-row)

### What does "Failed: Uploads are paused. Try again later" mean?

Uploads are paused for everyone at the moment. Existing files still open.
Try again later.

More: [Uploading, Reasons shown on a row](../files/uploading.md#reasons-shown-on-a-row)

### What does "Failed: The upload expired" mean?

The upload was not completed within 24 hours of its start. Press "Retry"
to start a new upload of the same file.

More: [Uploading, Reasons shown on a row](../files/uploading.md#reasons-shown-on-a-row)

### What does "Failed: Connection lost" mean on an upload?

A part could not be sent, five tries in a row. Press "Retry", or wait for
the connection to come back: the upload resumes from the parts already
stored.

More: [Uploading, Reasons shown on a row](../files/uploading.md#reasons-shown-on-a-row)

### What does "Failed: The file never arrived" mean?

The upload was completed, but no bytes were found. Press "Retry".

More: [Uploading, Reasons shown on a row](../files/uploading.md#reasons-shown-on-a-row)

### What does "Failed: Storage refused the file" mean?

The storage did not accept the bytes. Press "Retry".

More: [Uploading, Reasons shown on a row](../files/uploading.md#reasons-shown-on-a-row)

### What does "Failed: Connection lost" mean?

The network dropped while the file was being sent. Press "Retry" once you
are back online.

More: [Uploading, Reasons shown on a row](../files/uploading.md#reasons-shown-on-a-row)

### What does "Failed: The upload could not continue" mean?

The upload ran into a conflict that has no message of its own. Press
"Retry".

More: [Uploading, Reasons shown on a row](../files/uploading.md#reasons-shown-on-a-row)

### What does "Failed: The server had a problem" mean?

An unexpected failure on our side. Press "Retry".

More: [Uploading, Reasons shown on a row](../files/uploading.md#reasons-shown-on-a-row)

### What does "Could not read the dropped folder." mean?

A folder you dropped onto the app could not be read, so nothing from it
was uploaded.

More: [Uploading, Where you upload](../files/uploading.md#where-you-upload)

### What does "Could not create {path}. {reason} Nothing in it was uploaded." mean?

While uploading a folder, one of its folders could not be created.
Everything inside that folder is skipped and the rest of the upload
continues. Reasons include "Folders nest at most 16 levels deep." and
"Enter a name of 1 to 200 characters without a slash."

More: [Uploading, Uploading a folder](../files/uploading.md#uploading-a-folder)

### What does "Preview unavailable" mean?

The file's type has no preview, or making the preview failed. A CSV, for
example, shows "Preview unavailable".

More: [Uploading, Previews in the app](../files/uploading.md#previews-in-the-app)

### What does "This video cannot play here. Download it instead." mean?

Playing the video failed twice. When playing fails, the player fetches a
fresh address once and continues where it stopped. If it fails again, the
page shows this message. Download the video to watch it.

More: [Uploading, Video in the app](../files/uploading.md#video-in-the-app)

## Messages in the app: folders, moving and details

### What does `A folder named "{name}" already exists here. Choose another name.` mean?

A folder of that name is already in the place where you are creating a
folder or moving one to. Sibling folders have unique names, ignoring case.

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

### What does "Folders nest at most 16 levels deep." mean?

Creating the folder there, or moving it there, would go past the depth
limit of 16 levels.

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

### What does "A folder cannot move into itself or one of its subfolders." mean?

The destination you chose is the folder itself or a folder inside it.
Choose another destination.

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

### What does "{name} changed since the list loaded. The list is up to date now; try again." mean?

Someone changed the item before your rename, move or trash arrived, so
yours was refused. The list refreshed by itself. Do it again.

More: [Folders, moving and finding, When someone else changed it first](../files/organizing.md#when-someone-else-changed-it-first)

### What does "This folder no longer exists." mean?

The item you are moving, or the destination, is gone.

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

### What does "Only organization owners and admins can change the organization folder." mean?

You are a member, and you tried to change something in the organization
folder. Members read the organization folder; only owners and
admins change it.

More: [The organization folder and suggestions, What a member sees in the organization folder](../files/library-and-suggestions.md#what-a-member-sees-in-the-organization-folder)

### What does "Some items could not move back. Move them by hand." mean?

You pressed "Undo" after a move, and some of the items could not be put
back where they were. Move those yourself.

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

### Why does it say "That would make 1 file public. Only an owner or admin can make files public."?

Your move, restore or "Undo" would give a file a public link, and you are
not an owner or admin. Nothing that would become public is moved or
restored. With several files it reads "That would make 3 files public.
...".

More: [Folders, moving and finding, When a move changes who can open files](../files/organizing.md#when-a-move-changes-who-can-open-files)

### What does "Change who can open these files?" mean?

Your move would start or stop public links, and the app asks once for the
whole move. It says what would happen, for example "3 files will become
public via Press kit." or "2 public links will stop working.", with
"Cancel" and "Move".

More: [Sharing and public links, Moving in the app](../files/sharing.md#moving-in-the-app)

### What does "Enter a name of 1 to 200 characters." mean?

The file name is blank or too long. For a folder the message reads "Enter a
name of 1 to 200 characters without a slash."

More: [Folders, moving and finding, Editing a file's details](../files/organizing.md#editing-a-files-details)

### What does "A description can be up to 2,000 characters." mean?

The description was refused because it is too long.

More: [Folders, moving and finding, Editing a file's details](../files/organizing.md#editing-a-files-details)

### What does "A caption can be up to 500 characters." mean?

The caption was refused because it is too long.

More: [Folders, moving and finding, Editing a file's details](../files/organizing.md#editing-a-files-details)

### What does "Alt text can be up to 1,000 characters." mean?

The alt text was refused because it is too long.

More: [Folders, moving and finding, Editing a file's details](../files/organizing.md#editing-a-files-details)

### What does "Remove the tab or other character that cannot be saved." mean?

The name, description, caption or alt text holds a control character that
is refused there, for example a tab pasted into "Name" or "Alt text".
Remove it and save again.

More: [Folders, moving and finding, Editing a file's details](../files/organizing.md#editing-a-files-details)

### What does "Use at most 50 tags of 1 to 50 characters each." mean?

The tags were refused: there are more than 50, or one is empty or longer
than 50 characters.

More: [Folders, moving and finding, Editing a file's details](../files/organizing.md#editing-a-files-details)

### What does "This file is in the trash." mean when I save details?

The file was moved to the trash, and a trashed file cannot be changed.
Restore it first.

More: [Folders, moving and finding, Editing a file's details](../files/organizing.md#editing-a-files-details)

### What does "Could not save the details. Try again." mean?

Saving failed for a reason other than a refused value, the trash or the
organization folder rule. Try again.

More: [Folders, moving and finding, Editing a file's details](../files/organizing.md#editing-a-files-details)

### What does "This file changed since you opened it. Reloading keeps your unsaved edits." mean?

Someone else changed the file after you opened its page, so your save was
not applied. Press "Reload latest". Fields you changed keep your text, and
fields you did not touch show the other person's values.

More: [Folders, moving and finding, When someone else changed it first](../files/organizing.md#when-someone-else-changed-it-first)

### Why are "Save details", "Replace file" and "Move to trash" disabled on a file's page?

The file changed since you opened it. Those buttons, "Save fields" and
"Move" stay disabled until you press "Reload latest".

More: [Folders, moving and finding, When someone else changed it first](../files/organizing.md#when-someone-else-changed-it-first)

## Messages in the app: fields and statuses

### What does "Could not load the fields." mean?

The table "Custom fields" on the settings page of a workspace or the
organization folder could not be read. Reload the page.

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

### What does "Enter a name of 1 to 60 characters." mean?

The name of a field or a status is blank or longer than 60 characters.

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

### What does "That name is taken." mean?

Another field of the same workspace or organization folder already has the
name. Field names are unique within one workspace or the organization
folder, ignoring case; two workspaces may each have a field of the same
name.

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

### What does "Use at most 100 options of 1 to 60 characters each." mean?

A select field got too many options, or one that is too long. A field has
at most 100 options, each 1 to 60 characters.

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

### What does "Could not change the field. Try again." mean?

A change to a field failed. For an option the row says "Could not change
the option. Try again."

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

### What does "A field or option changed. Reload and try again." mean?

A field or an option was deleted since the file's page loaded. Reload the
page and save again.

More: [Fields and tags, On a file's page](../files/fields-and-tags.md#on-a-files-page)

### What does "A selected file is in the trash. Clear the selection and try again." mean?

One of the files you selected went to the trash meanwhile. A status or a
field is set on all selected files or on none, so nothing changed.

More: [Statuses, Setting a status in the app](../files/statuses.md#setting-a-status-in-the-app)

### What does "A selected file no longer exists. The list is up to date now." mean?

One of the selected files was deleted for good or moved out of reach.
Nothing changed. Select again from the refreshed list.

More: [Statuses, Setting a status in the app](../files/statuses.md#setting-a-status-in-the-app)

### What does "That field or option no longer exists. Choose another." mean?

The field or the option you chose for the selection was deleted since the
page loaded.

More: [Fields and tags, Setting a field on a selection](../files/fields-and-tags.md#setting-a-field-on-a-selection)

### What does "Could not set the field. Try again." mean?

Setting the field on the selection failed for another reason than the
trash, a missing file, a deleted field or the organization folder rule.

More: [Fields and tags, Setting a field on a selection](../files/fields-and-tags.md#setting-a-field-on-a-selection)

### What does "A workspace or the organization folder can have up to 50 custom fields. Delete one to add another." mean?

The workspace or organization folder whose settings you have open already has 50
custom fields, which is the most it can have. Each workspace and the
organization folder counts its own.

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

### What does "A field can have up to 100 options. Delete one to add another." mean?

The select field already has 100 options, which is the most a field can
have.

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

### What does "A workspace or the organization folder can have up to 50 statuses. Delete one to add another." mean?

The workspace or organization folder whose settings you have open already
has 50 statuses, which is the most it can have. Each workspace and the
organization folder counts its own.

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

### What does "Could not load the statuses." mean?

The table "Statuses" on the settings page of a workspace or the organization
folder could not be read. The card "Statuses" in Files & Assets says "Could
not load statuses." in the same situation.

More: [Statuses, The status list in settings](../files/statuses.md#the-status-list-in-settings)

### Why is "Allow public use (not while used for new uploads)" disabled?

The status is the default status, the one new uploads get. The default
status never allows public use.

More: [Statuses, The "Manage" menu](../files/statuses.md#the-manage-menu)

### Why is "Use for new uploads (not while it allows public use)" disabled?

The status allows public use, and the status new uploads get never does.

More: [Statuses, The "Manage" menu](../files/statuses.md#the-manage-menu)

### What does "The status new uploads get cannot allow public use. The list is up to date now." mean?

Someone else changed the status list after your page loaded, and your
change would have left the default status allowing public use. It was
refused, and the list was refreshed.

More: [Statuses, The "Manage" menu](../files/statuses.md#the-manage-menu)

### What does "Could not change the status. Try again." mean?

A change to a status in the settings failed, and the service gave no
reason the app could show.

More: [Statuses, The "Manage" menu](../files/statuses.md#the-manage-menu)

### What does "Only owners and admins set statuses." mean?

Your role changed since the page loaded. Setting a file's status needs an
owner or admin.

More: [Statuses, Setting a status in the app](../files/statuses.md#setting-a-status-in-the-app)

### What does "That status no longer exists. Choose another." mean?

The status you chose was deleted since the page loaded.

More: [Statuses, Setting a status in the app](../files/statuses.md#setting-a-status-in-the-app)

### What does "Could not set the status. Try again." mean?

Setting the status failed for another reason than the trash, your role, a
missing file or a deleted status.

More: [Statuses, Setting a status in the app](../files/statuses.md#setting-a-status-in-the-app)

### What does "Could not count the files. Try again." mean?

Setting a status on a folder first asks, for example, `Set "Not approved"
on 14 files in Press?`. The files in the folder could not be counted for
that question.

More: [Statuses, Setting a status in the app](../files/statuses.md#setting-a-status-in-the-app)

## Messages in the app: sharing, trash and downloads

### What does "Cannot be public: status is "{status}"." mean?

The file cannot be made public while its status does not allow public use,
so "Sharing" shows no picker. An owner or admin first sets a status
that allows public use, for example with "Set status" beside the message.

More: [Sharing and public links, The General access control](../files/sharing.md#the-general-access-control)

### What does "Cannot be public: it has no status." mean?

The file has no status, and a file can be public only while its status
allows public use.

More: [Sharing and public links, The General access control](../files/sharing.md#the-general-access-control)

### What does "This file needs a status that allows public use. Set one, then share it." mean?

The file's status changed since the page loaded and no longer allows
public use, so making it public was refused.

More: [Sharing and public links, The General access control](../files/sharing.md#the-general-access-control)

### What does "Only owners and admins change who can open it." mean?

You tried to change general access, and your role does not allow it. Only
owners and admins make a file or folder public or restricted.

More: [Sharing and public links, The General access control](../files/sharing.md#the-general-access-control)

### What does "Could not change access. Try again." mean?

Changing general access failed for another reason than the status or your
role.

More: [Sharing and public links, The General access control](../files/sharing.md#the-general-access-control)

### What does "Could not copy. Select the link and copy it." mean?

The browser refused to copy the public link to the clipboard. Select the
link in the "Public link" box and copy it by hand.

More: [Sharing and public links, The General access control](../files/sharing.md#the-general-access-control)

### What does "The original contains location data that anyone with the link can read." mean?

The file's original holds location data, and its status allows public
use. It is a warning, not a refusal: anyone who opens the public link can
read that data in the original.

More: [Sharing and public links, Location data](../files/sharing.md#location-data)

### What does "1 public link stopped working until restored." mean?

You moved a public file, or a folder holding one, to the trash. Its public
link stopped. "Undo" is offered with the message.

More: [Sharing and public links, Trash and restore in the app](../files/sharing.md#trash-and-restore-in-the-app)

### What does "{name} changed since you opened it. It is up to date now; try again." mean?

Someone changed the item before your move to the trash arrived, so it was
not trashed. The item is refreshed. Try again.

More: [Trash and restore, Moving to the trash](../files/trash.md#moving-to-the-trash)

### What does "Could not delete {name}." mean?

Moving the item to the trash failed for a reason other than a change by
someone else or the organization folder rule.

More: [Trash and restore, Moving to the trash](../files/trash.md#moving-to-the-trash)

### What does "Some items could not be restored. Restore them from Trash." mean?

You pressed "Undo" after trashing, and some items could not be brought back
that way. Open Trash and restore them there.

More: [Trash and restore, Moving to the trash](../files/trash.md#moving-to-the-trash)

### What does "Could not load the trash." mean?

The Trash page could not read its list. Press "Retry".

More: [Trash and restore, The Trash page](../files/trash.md#the-trash-page)

### What does "{name} is no longer in the trash." mean?

Someone else restored the item, or it is not a trash item of its own: it
went to the trash with its folder and comes back with that folder.

More: [Trash and restore, Restoring in the app](../files/trash.md#restoring-in-the-app)

### What does "Could not change {name}. Try again." mean?

A restore from the Trash page failed for another reason. On the trashed
file's own page the message is "Could not restore the file."

More: [Trash and restore, Restoring in the app](../files/trash.md#restoring-in-the-app)

### What does "Only owners and admins can delete files permanently." mean?

A member's request to delete something for good was refused. Deleting a
trashed file or folder for good, and emptying the trash, need an owner or
admin.

More: [Trash and restore, Deleting for good in the app](../files/trash.md#deleting-for-good-in-the-app)

### What does "Could not empty the trash. Try again." mean?

Emptying the trash failed. Try again.

More: [Trash and restore, Deleting for good in the app](../files/trash.md#deleting-for-good-in-the-app)

### What does "Too large to download at once. Download fewer files." mean?

The files you chose add up to more than 20 GiB, the most one ZIP download
can hold.

More: [Downloading, Downloading a folder or a selection](../files/downloading.md#downloading-a-folder-or-a-selection)

### What does "Too many files to download at once. Download fewer files." mean?

You chose more than 10,000 files, the most one ZIP download can hold.

More: [Downloading, Downloading a folder or a selection](../files/downloading.md#downloading-a-folder-or-a-selection)

### What does "Could not download {name}. Try again." mean?

The ZIP could not be made for a reason other than its size or its number
of files, for example because an item was trashed in the meantime.

More: [Downloading, Downloading a folder or a selection](../files/downloading.md#downloading-a-folder-or-a-selection)

### What does "Could not load the history." mean?

The version history of the file could not be read. Press "Retry".

More: [Versions and history, History in the app](../files/versions.md#history-in-the-app)

## Messages in the app: suggestions

### What does "This suggestion is closed or expired, so nothing more applies." mean?

The suggestion closed or expired while you had its page open. Nothing more
can be applied or rejected.

More: [The organization folder and suggestions, Reviewing a suggestion](../files/library-and-suggestions.md#reviewing-a-suggestion)

### What does "Someone decided some of these items already. The list is up to date now." mean?

Somebody else applied or rejected one of the items you ticked first.
Nothing of your request was applied. Tick again and repeat.

More: [The organization folder and suggestions, Reviewing a suggestion](../files/library-and-suggestions.md#reviewing-a-suggestion)

### What does "Could not update the suggestion." mean?

The request failed for a reason that is not yours, for example a lost
connection. Other refusals show the reason the service gives.

More: [The organization folder and suggestions, Reviewing a suggestion](../files/library-and-suggestions.md#reviewing-a-suggestion)

### What does "This suggestion does not exist, or you do not have access to it." mean?

The address names no suggestion of this workspace or organization folder. Open
"Suggestions" and choose the suggestion from the list.

More: [The organization folder and suggestions, Reviewing a suggestion](../files/library-and-suggestions.md#reviewing-a-suggestion)

### What does "Could not load the suggestion." mean?

The suggestion's page could not be loaded. A list that cannot be loaded
says "Could not load the suggestions."

More: [The organization folder and suggestions, Reviewing a suggestion](../files/library-and-suggestions.md#reviewing-a-suggestion)

### What does "Organization owners and admins apply the organization folder's suggestions." mean?

You are a plain member looking at a suggestion for the organization folder.
Members read the organization folder; owners and admins apply or reject its
suggestions.

More: [The organization folder and suggestions, Reviewing a suggestion](../files/library-and-suggestions.md#reviewing-a-suggestion)

### What does "Changed since suggested" mean on an item of a suggestion?

The item's file changed after the suggestion was made, so the item was not
applied and changes nothing. In the API such an item is `stale`.

More: [The organization folder and suggestions, Changed since suggested](../files/library-and-suggestions.md#changed-since-suggested)
