# Errors URL: https://docs.domainruntime.dev/docs/reference/errors Status: Verified Reviewed: 2026-09-23 ```json { "ok": false, "error": "environment_not_found" } ``` Codes are stable; messages may change. Runtime codes use `snake_case`. Codes from the query engine use `kebab-case`. ## Calling actions [#calling-actions] | Code | Status | Meaning | Do | | ---------------------------------------------------------------------- | ------ | -------------------------------------------------------------------- | ----------------------------------- | | `execution_envelope_invalid` | 400 | the body is not `{ requestId, input }`, or `requestId` is not a UUID | fix the request | | `action_contract_validation_failed` | 400 | the input does not match the action's schema; your code did not run | fix the input | | `action_not_found` | 404 | no action with that id in the active release | check the id; publish the domain | | `access_denied` | 403 | you may not run this action or see its execution | | | `environment_release_missing` | 409 | the environment has no active release yet | publish a domain | | `REQUEST_CONFLICT` | 409 | this request id was already used for another action or input | use a new request id for a new call | | `CONTRACT_MISMATCH` | 409 | the contract hash you sent does not match the active release | reload the contract | | `execution_result_timeout` | 504 | the action did not finish within 110 s; it may still finish | follow `GET /executions/{id}` | | `execution_total_file_size_exceeded` · `execution_file_limit_exceeded` | 400 | file inputs over 128 MiB in total, or more than 16 files | | | `execution_file_digest_mismatch` | 422 | a file's content did not match its declared checksum | upload it again | | `execution_not_found` · `run_not_found` | 404 | no execution or run with that id, or not yours | | ## Inside an execution [#inside-an-execution] These do not come back as an HTTP error: the call answers `200` and the execution carries the code. | Code | Meaning | | -------------------------- | -------------------------------------------------------------------------------- | | `action_failed` | your `execute` threw; the execution holds your message, up to 1000 characters | | `execution_output_invalid` | your action returned something that does not match `output`; writes it made stay | | `workflow_failed` | a workflow run failed or was cancelled | ## Authentication [#authentication] | Code | Status | Meaning | Do | | ---------------------------- | --------------------------- | --------------------------------------------------------------- | --------------------------------------- | | `invalid_credentials` | 401 | the token or key is missing, expired or revoked | sign in again, or mint a new user token | | `organization_access_denied` | 403 | the caller is not a member of the environment's organization | check the organization and key | | `session_access_denied` | WebSocket close 4401 / 4403 | the live-query socket's token is not valid for this environment | mint a token for this environment | ## Environments [#environments] | Code | Status | Meaning | Do | | ------------------------------------------ | ------ | ---------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | `environment_not_found` | 404 | no environment with that handle, or not visible to you | check the handle and organization | | `environment_release_unavailable` | 502 | the active release could not be loaded | retry | | `catalog_migration_required` | 409 | the organization still uses the previous project model | migrate it in the console | | `managed_build_required` | 410 | direct publishing is not allowed on this environment | release it instead | | `schema_change_refused` | 409 | the stored data does not allow a schema change; `details.issues` lists each one; nothing was applied | fix the data or the schema; see [Changing the schema](/docs/data/modeling-data#changing-the-schema) | | `removal_unconfirmed` | 409 | the publish removes something the domain declared | confirm with `druntime push --yes` or `--delete ` | | `development_workflow_adapter_unavailable` | 409 | workflow actions are not available in development yet | test the workflow in a production release | ## Queries and writes [#queries-and-writes] | Type | Status | Meaning | | ------------------- | ------ | ------------------------------------------------------------------------ | | `permission-denied` | 400 | a permission rule rejected the write | | `validation-failed` | 400 | the query or write is malformed | | `record-not-unique` | 400 | a write would give two objects the same value of a `.unique()` attribute | | `rate-limited` | 429 | this environment is blocked from further requests; contact us | | `timeout` | 429 | the query ran longer than 30 s; add an index or narrow it | | `result-too-large` | — | a live query result exceeded 8 MiB; paginate it | Over HTTP (`POST /query`) these arrive as `{ "ok": false, "error": "data_provider_rejected" }` with the status above. On the live-query socket they arrive as an `error` frame with the type. ## Files [#files] | Code | Status | Meaning | | ------------------------ | ------ | -------------------------------------------------- | | `storage_body_invalid` | 400 | the signed-upload-url request is not a JSON object | | `storage_body_too_large` | 400 | the signed-upload-url request is over 1 MiB | ## From the Platform SDK [#from-the-platform-sdk] The Platform SDK throws `PlatformApiError` with `status`, and today the code in `message`.