Errors

Every refusal has the same JSON body:

{"error": "Not a member of this project", "code": "PERMISSION_DENIED", "message": "Not a member of this project",
 "remedy": "Use a credential whose scope, kind and project reach this operation, or ask a project administrator for access.",
 "docs": "/docs/reference/errors/#permission_denied", "request_id": "req_4f0c..."}

code is stable; message (also sent as error, for older clients) is for people. request_id equals the X-Request-Id header that every response carries; quote it when you report a failure. docs links to the code’s heading below. A 503 with busy carries Retry-After.

Generated from the Platform’s error policy by tools/errors_page.py; do not edit by hand.

Requests and credentials

INVALID_ARGUMENT

Correct the request: compare its fields with the operation’s schema in /api/v1/openapi.json and send it again.

UNAUTHENTICATED

PERMISSION_DENIED

Use a credential whose scope, kind and project reach this operation, or ask a project administrator for access.

MACHINE_AUTH_REQUIRED

Send the bearer credential alone: no browser cookie and no Origin header.

invalid_token

Send a current agent key as Authorization: Bearer, or sign in (RFC 6750).

NOT_FOUND

Check the project, operation and identifiers; list them again to find current ones.

METHOD_NOT_ALLOWED

Use the HTTP method the operation documents: POST for operations, GET for resources.

PAYLOAD_TOO_LARGE

Send a smaller request, within the limit the message names.

Service state

UNAVAILABLE

Retry later; if it persists, ask the deployment’s operator to check the service.

busy

Retry after the number of seconds in Retry-After.

REQUEST_FAILED

Retry once; if it fails again, report the request id to the deployment’s operator.

INTERNAL

Report the request id to the deployment’s operator; the request was not completed.

store-unavailable

The payload store cannot be reached: retry later.

runner-unavailable

The script runner is not available on this deployment: retry later or ask its operator.

embedding-unavailable

The embedding model is not available: retry later, or search by words.

Upstream sources

SOURCE_ACCESS_DENIED

Ask the source’s owner for access, or reconnect with a credential that can read it.

SOURCE_DELETED

The upstream item was deleted: select another one.

SOURCE_MISSING

The upstream item is gone: select another one, or reconnect the source.

SOURCE_NEEDS_REVIEW

Review the source’s mapping or selection in the Workspace, then try again.

SOURCE_OFFLINE

The upstream system cannot be reached: retry later, or ask its administrator.

SOURCE_PENDING

The source is still being prepared: retry after it is ready.

SOURCE_REVISION_UNAVAILABLE

The requested upstream revision is no longer available: fetch the current one.

Data and collaboration

CURSOR_EXPIRED

The cursor is older than the retained history: start again from changes/head.

agent-refused

The agent’s scopes, budget or expiry do not allow this: ask its owner to widen them, or act yourself.

ai-use-changed

AI-use permissions changed: read them again and repeat the grant.

authority-copy

This is a copy of a project owned elsewhere: make changes on the owning deployment.

authority-transferred

This project moved to another deployment: make changes there.

budget-exhausted

The agent’s budget for today is spent: retry tomorrow, or ask its owner to raise it.

capacity-exceeded

Reduce the request (fewer rows, a smaller area or file) to fit the stated limit.

command-owned

This command id belongs to another request: use a new command id.

condition-required

Send the expected generation (or revision) you read, so the change applies only to that state.

entity-conflict

The well or wellbore changed or already exists: read it again and repeat the change.

group-changed

The result group changed: read it again and repeat the change.

incompatible-context

Choose inputs whose scientific context (CRS, units, datum) matches the operation.

integrity-conflict

The stored content does not match what was expected: read it again before changing it.

invalid-relationship

Use a relationship the registry allows for these subject and object kinds (GET /api/v1/contracts).

not-found

Check the identifiers; list the assets or entities again to find current ones.

plan-required

Propose the exact request with agents/propose, have it approved, and send X-Ophiolite-Plan naming the plan.

recipients-changed

Recipients changed since you read them: read the current grants and repeat the change.

revision-conflict

A newer revision exists: read the current revision and repeat the change against it.

selection-changed

The source selection changed: read it again and repeat the change.

stage-changed

The review stage changed: read it again and repeat the transition.

unsafe-destination

Use a public HTTPS address; private, loopback and link-local addresses are refused.

unsupported-crs

Choose one of the supported CRSs the message lists.

webhook-changed

The webhook changed: read it again and repeat the change with its current generation.

Native service (gRPC status names)

CONFLICT

Read the current state again and repeat the change against it.

CANCELLED

The request was cancelled before it finished: send it again.

UNKNOWN

Retry once; if it fails again, report the request id.

DEADLINE_EXCEEDED

Retry later, with a smaller request if you can.

ALREADY_EXISTS

It already exists: read it instead of creating it again.

RESOURCE_EXHAUSTED

Retry later, or reduce the request.

FAILED_PRECONDITION

Read the current state and bring it to what the operation needs first.

ABORTED

Read the current state again and repeat the change against it.

OUT_OF_RANGE

Use values inside the range the message names.

UNIMPLEMENTED

This deployment does not offer the operation.

DATA_LOSS

Report the request id to the deployment’s operator.