API errors

An API error response contains an error object with type, code, status, message, retryable, retry_key, request_id, details, and doc_url. doc_url links to the code’s section on this page.

Decide what to do from type and retryable. The type says what kind of problem it is. retryable says whether sending the request again can succeed (never, after_backoff, after_retry_after, or after_change), and retry_key says whether a retry keeps its idempotency key (same) or uses a new one (new). Base application logic on code; the English message can improve without changing the code or HTTP status.

In Python, these errors raise FlashdriveError subclasses, one per type; see SDK errors and retries. The CLI maps each type to an exit status; see CLI errors. When a message says to contact support, email support@evokoa.com with the request_id.

Error types

Every error names one of these types, and says in retryable and retry_key whether to retry and with which idempotency key. Handle a type, and look up a code here for its details.

Type	HTTP status	What to do
`auth`	401	Sign in again
`permission`	403	Ask for access
`not_found`	404	Check the identifier; also used for resources the caller may not see
`invalid`	400	Fix the request
`conflict`	409	Re-read and retry with a change
`precondition`	412	Re-read, then send the new ETag (428 when the header is missing)
`rate_limit`	429	Wait for Retry-After
`payment_required`	402	Add credit or a card
`quota`	409	Free space or raise a plan limit
`too_large`	413	Send smaller request content
`unavailable`	503	Retry after backoff (504 for upstream timeouts)
`upgrade`	426	Update the client (410 for a retired version)

Error codes

Each code below has its own section; the doc_url of an error links to it. Wording of a message can change; the code, type and status do not.

`agent_answer_replayed`

This answer was already written. Ask for a new answer to write another.

Type conflict, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key.

`agent_console_only`

Agent answers are available in the Console during the preview. API keys can use search.

Type permission, HTTP 403. Do not retry this request as it is.

`agent_quota_exhausted`

You’ve used today’s agent answers. They reset at 00:00 UTC, and search results stay available.

Type rate_limit, HTTP 429. Wait for the Retry-After seconds, then retry with the same idempotency key. Details: retry_after_seconds.

`agent_unavailable`

Agent answers are temporarily unavailable. Your search results are still available.

Type unavailable, HTTP 503. Retry after a short, growing delay, with the same idempotency key.

`already_accepted`

This invitation has already been accepted.

Type conflict, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key.

`already_exists`

A resource with these unique values already exists.

Type conflict, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key.

`already_member`

You are already a member of this organization.

Type conflict, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key.

`api_version_retired`

This API version or feature has been retired. Use the replacement in the documentation.

Type upgrade, HTTP 410. Do not retry this request as it is. Details: replacement, docs_url, sunset_at.

`auth_action_invalid`

Unknown action

Type invalid, HTTP 400. Do not retry this request as it is.

`auth_email_unavailable`

Authentication email is unavailable.

Type unavailable, HTTP 503. Retry after a short, growing delay, with the same idempotency key.

`auth_hook_unavailable`

Email processing unavailable

Type unavailable, HTTP 503. Retry after a short, growing delay, with the same idempotency key.

`auth_link_expired`

This link is expired or has already been used. Request a new email.

Type invalid, HTTP 400. Do not retry this request as it is.

`auth_password_invalid`

Use a password with at least 8 characters.

Type invalid, HTTP 400. Do not retry this request as it is.

`auth_protocol_method_not_allowed`

Method not allowed

Type invalid. Do not retry this request as it is.

`auth_protocol_unauthorized`

Unauthorized

Type auth. Do not retry this request as it is.

`auth_rate_limited`

Too many requests. Please try again later.

Type rate_limit, HTTP 429. Wait for the Retry-After seconds, then retry with the same idempotency key.

`auth_reauthentication_required`

Type auth, HTTP 401. Do not retry this request as it is.

`auth_request_failed`

The request could not be completed. Please try again.

Type unavailable, HTTP 503. Retry after a short, growing delay, with the same idempotency key.

`auth_terms_required`

The request is missing confirmation of acceptance of the terms.

Type invalid, HTTP 400. Do not retry this request as it is.

`authentication_unavailable`

Authentication is temporarily unavailable. Try again later.

Type unavailable, HTTP 503. Retry after a short, growing delay, with the same idempotency key.

`billing_account_inactive`

Billing changes are unavailable for this account. Contact support with the request ID.

Type conflict, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key.

`billing_enrollment_unavailable`

Billing setup cannot be completed right now. Check Billing for a pending setup request, or contact support.

Type conflict, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key.

`billing_legacy_account`

This account’s billing setup needs attention before you can continue. Contact support.

Type conflict, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key.

`billing_not_configured`

Billing is temporarily unavailable. Please try again later.

Type unavailable, HTTP 503. Retry after a short, growing delay, with the same idempotency key.

`billing_reconciliation_conflict`

We couldn’t confirm this billing update. Check its status in Billing before submitting another request. If this continues, contact support with the request ID.

Type conflict, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key.

`billing_reconciliation_required`

We couldn’t confirm this billing update. Check its status in Billing before submitting another request. If this continues, contact support with the request ID.

Type conflict, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key.

`billing_route_not_found`

The requested billing action could not be found.

Type not_found, HTTP 404. Do not retry this request as it is.

`billing_session_required`

Type permission, HTTP 403. Do not retry this request as it is.

`body_required`

Provide a request body.

Type invalid, HTTP 400. Do not retry this request as it is.

`body_timeout`

The request body took too long to arrive. Send the request again.

Type unavailable, HTTP 408. Retry after a short, growing delay, with the same idempotency key.

`body_too_large`

The request body exceeds this endpoint’s size limit.

Type too_large, HTTP 413. Do not retry this request as it is. Details: max_bytes.

`checksum_mismatch`

The uploaded content does not match the declared file size or checksum.

Type invalid, HTTP 400. Do not retry this request as it is. Details: field.

`cli_login_expired`

Type auth, HTTP 401. Do not retry this request as it is.

`cli_login_invalid`

Invalid login request.

Type invalid, HTTP 400. Do not retry this request as it is.

`cli_login_unavailable`

Browser login is not available on this server yet.

Type unavailable, HTTP 503. Do not retry this request as it is.

`cli_session_expired`

Your session has expired. Run flashdrive login to sign in again.

Type auth, HTTP 401. Do not retry this request as it is.

`cli_session_invalid`

Invalid session.

Type auth, HTTP 401. Do not retry this request as it is.

`cli_signin_failed`

Sign-in could not be completed. Run flashdrive login again.

Type auth, HTTP 401. Do not retry this request as it is.

`cli_signin_temporarily_unavailable`

Sign-in is temporarily unavailable. Try again shortly.

Type unavailable, HTTP 503. Retry after a short, growing delay, with the same idempotency key.

`client_required`

Send the Flashdrive-Client header, as name/version (for example my-app/1.0.0).

Type invalid, HTTP 400. Do not retry this request as it is. Details: field.

`client_upgrade_required`

This client version is no longer supported. Upgrade the client and retry.

Type upgrade, HTTP 426. Do not retry this request as it is. Details: client, version, minimum_version, latest_version.

`cursor_not_configured`

Pagination is temporarily unavailable. Contact support if this continues.

Type unavailable, HTTP 503. Retry after a short, growing delay, with the same idempotency key.

`cursor_reset`

This sync position can no longer be continued. List the drive again, then continue from a new cursor.

Type not_found, HTTP 410. Do not retry this request as it is.

`database_not_configured`

The service is not ready to process requests. Contact support.

Type unavailable, HTTP 503. Retry after a short, growing delay, with the same idempotency key.

`default_drive_in_use`

Choose another default drive before deleting this drive.

Type conflict, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key.

`default_drive_unavailable`

Choose an active drive in this workspace.

Type conflict, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key.

`drive_busy`

This drive has work in progress. Wait for it to finish, then retry deletion with the same request key.

Type conflict, HTTP 409. Wait for the Retry-After seconds, then retry with the same idempotency key. Details: retry_after_seconds.

`drive_limit_exceeded`

This drive has reached its document or storage limit. Use another drive or remove documents, then try again.

Type quota, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key.

`drive_not_empty`

Remove the drive’s contents before deleting it.

Type conflict, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key.

`drive_recovery_expired`

The one-hour recovery window for this drive has expired.

Type not_found, HTTP 410. Do not retry this request as it is.

`duplicate_external_id`

Each document in the batch must have a unique external_id.

Type invalid, HTTP 400. Do not retry this request as it is. Details: field.

`duplicate_name`

This name is already taken in this folder. Choose another name.

Type conflict, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key. Details: field, name.

`duplicate_workspace`

Include each workspace only once in the invitation.

Type invalid, HTTP 400. Do not retry this request as it is. Details: field.

`edit_not_text`

Text edits apply only to UTF-8 text files (txt, md, code). Write other files by bytes or upload a new version.

Type invalid, HTTP 400. Do not retry this request as it is.

`edit_text_not_found`

An edit’s old text does not occur in the file. Read the file again and copy the text exactly.

Type conflict, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key. Details: index.

`edit_text_not_unique`

An edit’s old text occurs more than once in the file. Include enough surrounding text to make it unique.

Type conflict, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key. Details: index, matches.

`edit_too_large`

The file is too large for a text edit. Write it by bytes or upload a new version.

Type too_large, HTTP 413. Do not retry this request as it is. Details: max_bytes.

`fair_use_limit_reached`

Your account has reached its fair-use activity limit. Contact support to review your limit or available credits.

Type permission, HTTP 403. Do not retry this request as it is.

`file_too_large`

Provide a non-empty file no larger than 1,000,000,000 bytes.

Type too_large, HTTP 413. Do not retry this request as it is. Details: field, max_bytes.

`folder_cycle`

A folder cannot be moved into itself or into one of its own subfolders.

Type conflict, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key. Details: field.

`folder_not_empty`

Remove or move the folder’s contents before deleting it.

Type conflict, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key.

`folder_not_found`

The requested folder could not be found.

Type not_found, HTTP 404. Do not retry this request as it is.

`folder_too_deep`

Folders nest at most 64 levels and a folder path holds at most 1,024 bytes. Choose a shallower place or shorter names.

Type invalid, HTTP 400. Do not retry this request as it is. Details: field.

`forbidden`

You don’t have permission to perform this action. Contact your organization administrator if you need access.

Type permission, HTTP 403. Do not retry this request as it is.

`full_text_search_off`

Keyword and pattern search is unavailable for this existing drive. Contact support with the request ID.

Type conflict, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key.

`git_epoch_retired`

This Git operation belongs to a retired session epoch. Keep its recovery files. Do not retry it with a new key or refreshed version.

Type conflict, HTTP 409. Do not retry this request as it is.

`human_session_required`

Type permission, HTTP 403. Do not retry this request as it is.

`idempotency_conflict`

This request key was already used with different details. Retry with the original details, or use a new key for a different request.

Type conflict, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key.

`idempotency_key_required`

Provide a request key containing 1–128 visible ASCII characters without spaces.

Type invalid, HTTP 400. Do not retry this request as it is. Details: min_length, max_length.

`import_revision_conflict`

A document in this import already exists, or changed after it was declared. In create mode use new external IDs; in replace mode declare each document’s current revision.

Type conflict, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key.

`insufficient_credits`

You don’t have enough available credits for this request. Add credits and try again.

Type payment_required, HTTP 402. Change the request, or the resource it names, then send it with a new idempotency key.

`intent_expired`

This content submission has expired. Check its status before starting a new submission.

Type conflict, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key.

`invalid_auto_topup_amount`

Choose a monthly auto-topup amount from $10 to $100,000 in $5 increments.

Type invalid, HTTP 400. Do not retry this request as it is.

`invalid_batch_size`

Submit between 1 and 1,000 documents per batch.

Type invalid, HTTP 400. Do not retry this request as it is. Details: field, min_items, max_items.

`invalid_billing_amount`

Enter a valid billing amount and try again.

Type invalid, HTTP 400. Do not retry this request as it is.

`invalid_billing_idempotency_key`

Provide an Idempotency-Key header containing 1–128 visible ASCII characters without spaces.

Type invalid, HTTP 400. Do not retry this request as it is.

`invalid_billing_path`

Billing is temporarily unavailable. Contact support if this continues.

Type unavailable, HTTP 503. Do not retry this request as it is.

`invalid_billing_scope`

This billing request does not match the selected organization or workspace. Check your selection and try again.

Type invalid, HTTP 400. Do not retry this request as it is.

`invalid_checksum`

Provide a SHA-256 checksum as 64 lowercase hexadecimal characters.

Type invalid, HTTP 400. Do not retry this request as it is. Details: field.

`invalid_credentials`

Authentication failed. Sign in again or provide a valid API key.

Type auth, HTTP 401. Do not retry this request as it is.

`invalid_credit_amount`

Choose an amount from $10 to $500 in $5 increments.

Type invalid, HTTP 400. Do not retry this request as it is.

`invalid_cursor`

This pagination cursor is invalid or no longer usable. Start from the first page.

Type invalid, HTTP 400. Do not retry this request as it is. Details: field.

`invalid_documents`

Provide documents as an array of document objects.

Type invalid, HTTP 400. Do not retry this request as it is. Details: field.

`invalid_drive_state`

Use state=deleted to list deleted drives, or omit state to list active drives.

Type invalid, HTTP 400. Do not retry this request as it is.

`invalid_email`

Enter a valid email address.

Type invalid, HTTP 400. Do not retry this request as it is. Details: field.

`invalid_expiry`

Provide a valid expiration date and time in the future.

Type invalid, HTTP 400. Do not retry this request as it is. Details: field.

`invalid_file`

The file could not be read. Open it in its original application, save a new copy, and upload that copy.

Type invalid. Do not retry this request as it is.

`invalid_filename`

Provide a filename without path separators or control characters.

Type invalid, HTTP 400. Do not retry this request as it is. Details: field, max_bytes.

`invalid_grants`

Provide valid workspace access assignments for this invitation.

Type invalid, HTTP 400. Do not retry this request as it is. Details: field, max_items.

`invalid_id`

Provide a valid UUID for this identifier.

Type invalid, HTTP 400. Do not retry this request as it is. Details: field.

`invalid_identity`

Your session is no longer valid. Sign in again.

Type auth, HTTP 401. Do not retry this request as it is.

`invalid_ingestion_mode`

Choose an ingestion mode enabled for this endpoint.

Type invalid, HTTP 400. Do not retry this request as it is. Details: field, allowed_values.

`invalid_json`

The request body is not valid JSON for this endpoint.

Type invalid, HTTP 400. Do not retry this request as it is. Details: field.

`invalid_limit`

Choose a page size between 1 and 100.

Type invalid, HTTP 400. Do not retry this request as it is. Details: field, min_items, max_items.

`invalid_metadata`

Provide metadata within the supported field, value-type, and size limits.

Type invalid, HTTP 400. Do not retry this request as it is. Details: field, max_items, max_bytes, allowed_values.

`invalid_name`

Enter a name between 1 and 120 characters.

Type invalid, HTTP 400. Do not retry this request as it is. Details: field, min_length, max_length.

`invalid_object`

Provide a JSON object for this value.

Type invalid, HTTP 400. Do not retry this request as it is. Details: field.

`invalid_payment_event`

invalid payment event.

Type invalid, HTTP 400. Do not retry this request as it is.

`invalid_payment_period`

Billing is temporarily unavailable. Contact support if this continues.

Type unavailable, HTTP 503. Retry after a short, growing delay, with the same idempotency key.

`invalid_reporting_period`

Provide valid UTC dates with an exclusive end date, spanning 1 to 90 days.

Type invalid, HTTP 400. Do not retry this request as it is. Details: field.

`invalid_revision`

Provide a positive document revision as a decimal string.

Type invalid, HTTP 400. Do not retry this request as it is. Details: field.

`invalid_role`

Choose a supported role or permission.

Type invalid, HTTP 400. Do not retry this request as it is. Details: field, allowed_values.

`invalid_search_idempotency_key`

Provide a request key containing 1–128 visible ASCII characters without spaces.

Type invalid, HTTP 400. Do not retry this request as it is.

`invalid_search_input`

Some search settings are invalid. Check your request and try again.

Type invalid, HTTP 400. Do not retry this request as it is.

`invalid_search_query`

Enter a valid search query and try again.

Type invalid, HTTP 400. Do not retry this request as it is.

`invalid_search_settlement`

We couldn’t confirm the outcome of this search. Retry with the same request key. If this continues, contact support with the request ID.

Type unavailable, HTTP 503. Retry after a short, growing delay, with the same idempotency key.

`invalid_storage_selection`

Choose a valid storage capacity and try again.

Type invalid, HTTP 400. Do not retry this request as it is.

`invalid_text`

Provide valid text within the permitted length.

Type invalid, HTTP 400. Do not retry this request as it is. Details: field, max_bytes.

`invalid_token`

This invitation token is invalid. Use the complete link from your invitation email.

Type invalid, HTTP 400. Do not retry this request as it is. Details: field.

`invalid_upload_batch`

Submit between 1 and 50 unique uploads per batch.

Type invalid, HTTP 400. Do not retry this request as it is. Details: min_items, max_items.

`invalid_utf8`

Encode the request content as valid UTF-8.

Type invalid, HTTP 400. Do not retry this request as it is. Details: field.

`invalid_webhook_signature`

invalid webhook signature.

Type invalid, HTTP 400. Do not retry this request as it is.

`invalid_workspace_storage_capacity`

Choose a storage capacity allowed for this action and try again.

Type invalid, HTTP 400. Do not retry this request as it is.

`invitation_expired`

This invitation has expired or is no longer pending. Ask an organization administrator for a new invitation.

Type not_found, HTTP 410. Do not retry this request as it is.

`invitation_rate_limit`

Too many invitations have been requested. Wait before trying again.

Type rate_limit, HTTP 429. Wait for the Retry-After seconds, then retry with the same idempotency key. Details: retry_after_seconds.

`invitation_unavailable`

This invitation is no longer available. Ask an organization administrator for a new invitation.

Type not_found, HTTP 404. Do not retry this request as it is.

`last_owner`

Assign another owner before removing or changing this owner’s role.

Type conflict, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key.

`method_not_allowed`

This endpoint does not support the requested HTTP method.

Type invalid, HTTP 405. Do not retry this request as it is.

`mount_lease_expired`

This mount lease is no longer valid. Local changes are kept. Mount the folder again to reconnect.

Type conflict, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key.

`mount_limit_reached`

The simultaneous mount limit is reached. Unmount another folder and try again. Local changes are kept.

Type quota, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key.

`no_extractable_text`

No readable text was found in this file. Upload a file containing selectable text.

Type invalid. Do not retry this request as it is.

`not_found`

The requested resource could not be found.

Type not_found, HTTP 404. Do not retry this request as it is.

`not_supported_on_this_drive`

This operation is not supported on this drive yet. Nothing was changed.

Type conflict, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key.

`organization_subscription_required`

This action is unavailable with the current billing setup. Check Billing or contact support with the request ID.

Type payment_required, HTTP 402. Change the request, or the resource it names, then send it with a new idempotency key.

`outbox_not_configured`

Invitation email delivery is unavailable. Contact support.

Type unavailable, HTTP 503. Retry after a short, growing delay, with the same idempotency key.

`passage_unavailable`

The requested search content is no longer available.

Type not_found, HTTP 404. Do not retry this request as it is.

`payment_mode_mismatch`

Billing is temporarily unavailable. Contact support if this continues.

Type unavailable, HTTP 503. Retry after a short, growing delay, with the same idempotency key.

`payment_provider_unavailable`

We couldn’t complete this billing request right now. Check its status in Billing before submitting another request.

Type unavailable, HTTP 503. Retry after a short, growing delay, with the same idempotency key.

`pdf_password_required`

This PDF requires a password. Save an unlocked copy in your PDF application and upload that copy.

Type invalid. Do not retry this request as it is.

`precondition_required`

Provide the resource’s current ETag in the If-Match header.

Type precondition, HTTP 428. Change the request, or the resource it names, then send it with a new idempotency key.

`processing_failed`

Processing failed. Contact support with the operation ID.

Type unavailable. Retry after a short, growing delay, with the same idempotency key.

`protocol_method_not_allowed`

Method not allowed.

Type invalid, HTTP 405. Do not retry this request as it is.

`protocol_not_found`

Not found.

Type not_found, HTTP 404. Do not retry this request as it is.

`protocol_request_too_large`

Request too large

Type too_large, HTTP 413. Do not retry this request as it is.

`protocol_unauthorized`

Unauthorized.

Type auth, HTTP 401. Do not retry this request as it is.

`query_too_long`

The question exceeds the 512-token limit.

Type invalid, HTTP 400. Do not retry this request as it is.

`rate_limited`

Too many requests. Try again later.

Type rate_limit, HTTP 429. Wait for the Retry-After seconds, then retry with the same idempotency key. Details: retry_after_seconds.

`relationship_conflict`

This change conflicts with a related resource. Check the referenced resources and try again.

Type conflict, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key.

`request_in_progress`

Another operation on this resource is still in progress. Wait before retrying with the same request key; for an upload, resume the existing upload if available.

Type conflict, HTTP 409. Wait for the Retry-After seconds, then retry with the same idempotency key. Details: retry_after_seconds.

`resend_cooldown`

An invitation was sent recently. Wait before requesting another email.

Type rate_limit, HTTP 429. Wait for the Retry-After seconds, then retry with the same idempotency key. Details: retry_after_seconds.

`resource_limit`

The file exceeded processing limits. Reduce its size or complexity and try again.

Type too_large. Do not retry this request as it is.

`response_budget_exceeded`

Use a smaller limit or fetch an individual document.

Type invalid, HTTP 400. Do not retry this request as it is.

`search_budget_exceeded`

A search spending limit for this request has been reached. Ask your organization administrator to increase the limit, or wait until it resets.

Type payment_required, HTTP 402. Change the request, or the resource it names, then send it with a new idempotency key.

`search_cancelled`

The search was interrupted. Retry with the same request key to check its status.

Type unavailable, HTTP 503. Retry after a short, growing delay, with the same idempotency key.

`search_compute_capacity`

Due to heavy load, we’re currently at compute capacity. Please try again later.

Type unavailable, HTTP 503. Wait for the Retry-After seconds, then retry with the same idempotency key. Details: retry_after_seconds.

`search_deadline_exceeded`

The search took longer than allowed. Retry with the same request key to check its status.

Type unavailable, HTTP 504. Retry after a short, growing delay, with the same idempotency key.

`search_entitlement_required`

Search is unavailable for this account. Check Billing or contact your organization administrator.

Type payment_required, HTTP 402. Change the request, or the resource it names, then send it with a new idempotency key.

`search_previous_failure`

This search attempt could not be completed. Contact support with the request ID if you need help checking its status.

Type conflict, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key.

`search_price_mismatch`

Search is temporarily unavailable. Please try again later.

Type unavailable, HTTP 503. Retry after a short, growing delay, with the same idempotency key.

`search_rate_limit_exceeded`

Your organization is sending searches too quickly. Wait one second and try again.

Type rate_limit, HTTP 429. Wait for the Retry-After seconds, then retry with the same idempotency key. Details: retry_after_seconds.

`search_reindex_required`

Some documents need to be reprocessed before you can search this drive. Reprocess the drive and try again.

Type conflict, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key.

`search_replay_expired`

The saved result for this request has expired. To run a new search, use a new request key. A new search may use credits.

Type conflict, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key.

`search_replay_unavailable`

The saved result is currently unavailable. Retry with the same request key.

Type conflict, HTTP 409. Retry after a short, growing delay, with the same idempotency key.

`search_request_in_progress`

This search is still processing, or its final status has not been confirmed. Retry with the same request key. If this continues, contact support with the request ID.

Type conflict, HTTP 409. Wait for the Retry-After seconds, then retry with the same idempotency key. Details: retry_after_seconds.

`search_route_not_found`

The requested resource could not be found.

Type not_found, HTTP 404. Do not retry this request as it is.

`search_snapshot_expired`

The search could not be completed. Retry with the same request key to check its status.

Type conflict, HTTP 409. Retry after a short, growing delay, with the same idempotency key.

`search_tariff_unavailable`

Search is temporarily unavailable. Please try again later.

Type unavailable, HTTP 503. Retry after a short, growing delay, with the same idempotency key.

`search_unavailable`

Search is temporarily unavailable. Try again later using the same request key.

Type unavailable, HTTP 503. Retry after a short, growing delay, with the same idempotency key.

`semantic_search_off`

Search by meaning is not available. Use keyword search or grep instead.

Type conflict, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key.

`session_invalid`

Your session has ended. Sign in again.

Type auth. Do not retry this request as it is.

`snapshot_expired`

This listing has expired. Start again from the first page.

Type conflict, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key.

`source_unavailable`

The original file is not available for this document.

Type not_found, HTTP 404. Do not retry this request as it is.

`stale_version`

This resource has changed. Refresh it before trying again.

Type precondition, HTTP 412. Change the request, or the resource it names, then send it with a new idempotency key.

`storage_capacity_exceeded`

This submission exceeds your available storage capacity. Free up space or increase capacity, then try again.

Type quota, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key.

`storage_entitlement_required`

Storage is unavailable for this workspace. Check its storage settings in Billing.

Type payment_required, HTTP 402. Change the request, or the resource it names, then send it with a new idempotency key.

`storage_not_configured`

Content storage is temporarily unavailable. Please try again later.

Type unavailable, HTTP 503. Retry after a short, growing delay, with the same idempotency key.

`storage_price_mismatch`

Storage purchases are temporarily unavailable. Please try again later.

Type unavailable, HTTP 503. Retry after a short, growing delay, with the same idempotency key.

`subscription_price_mismatch`

Monthly auto-topup changes are temporarily unavailable. Please try again later.

Type unavailable, HTTP 503. Retry after a short, growing delay, with the same idempotency key.

`temporarily_unavailable`

The service is temporarily unavailable. Try again later using the same request key, if one was supplied.

Type unavailable, HTTP 503. Retry after a short, growing delay, with the same idempotency key.

`unknown_field`

The request contains fields this endpoint does not support.

Type invalid, HTTP 400. Do not retry this request as it is. Details: allowed_fields.

`unknown_parameter`

The request contains query parameters this endpoint does not support.

Type invalid, HTTP 400. Do not retry this request as it is. Details: field.

`unsupported_format`

This file format is not supported. Use PDF, DOCX, TXT, or Markdown.

Type invalid, HTTP 400. Do not retry this request as it is. Details: field, allowed_values.

`unsupported_language`

FlashDrive supports questions in English. Rephrase your question in English.

Type invalid, HTTP 400. Do not retry this request as it is.

`unsupported_media_type`

Use a Content-Type supported by this endpoint.

Type invalid, HTTP 415. Do not retry this request as it is. Details: allowed_values.

`unsupported_search_effort`

This search option is unavailable. Choose a supported option and try again.

Type invalid, HTTP 400. Do not retry this request as it is.

`upload_expired`

This upload has expired. Check its status before creating a new upload.

Type conflict, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key.

`upload_incomplete`

Upload the file content before completing this upload.

Type conflict, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key.

`upload_limit`

This drive has reached its transfer or queued-upload capacity. Wait for capacity before creating another upload.

Type rate_limit, HTTP 429. Wait for the Retry-After seconds, then retry with the same idempotency key. Details: field, max_items, retry_after_seconds.

`upload_sealed`

This upload no longer accepts file content. Check its status before creating another upload.

Type conflict, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key.

`worker_failure`

Processing failed. Try again later, or contact support if the problem continues.

Type unavailable. Retry after a short, growing delay, with the same idempotency key.

`workspace_limit_reached`

This organization has reached its workspace limit.

Type quota, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key.

`workspace_storage_downgrade_blocked`

Stored files and pending uploads exceed the selected capacity. Free up space or choose a larger capacity.

Type quota, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key.

`workspace_storage_grace`

The funded storage period for this workspace has ended, so uploads and updates are paused. Check Billing to renew storage.

Type payment_required, HTTP 402. Change the request, or the resource it names, then send it with a new idempotency key.

`workspace_storage_insufficient_credits`

You don’t have enough available credits for this storage change. Add credits and try again.

Type payment_required, HTTP 402. Change the request, or the resource it names, then send it with a new idempotency key.

`workspace_storage_payment_blocked`

Storage payments are paused for this account. Contact support with the request ID.

Type payment_required, HTTP 402. Change the request, or the resource it names, then send it with a new idempotency key.

`workspace_storage_quote_expired`

This storage quote is no longer valid. Review a new quote before confirming the change.

Type conflict, HTTP 409. Change the request, or the resource it names, then send it with a new idempotency key.

`workspace_storage_restricted`

The funded storage period for this workspace has ended and storage access is paused. Check Billing to renew storage.

Type payment_required, HTTP 402. Change the request, or the resource it names, then send it with a new idempotency key.