Data Reaktor API errors

Stable error codes, HTTP statuses, retry guidance, and troubleshooting anchors.

AUTH_REQUIRED

HTTP 401 · Retryable: no

No valid session or API key was supplied.

INVALID_API_KEY

HTTP 401 · Retryable: no

The API key was not recognised or has been revoked.

KEY_EXPIRED

HTTP 401 · Retryable: no

The API key has expired and must be rotated before it can be used again.

KEY_SUSPENDED

HTTP 429 · Retryable: yes

Authentication failures temporarily suspended this API key. Retry after the suspension window.

FORBIDDEN

HTTP 403 · Retryable: no

Caller is authenticated but lacks permission for this resource.

OWNER_SCOPE_REQUIRED

HTTP 403 · Retryable: no

This operation requires a human session or an agent API key with owner provisioning scope.

CANNOT_REVOKE_SELF

HTTP 409 · Retryable: no

An owner agent key cannot revoke itself; use another owner credential.

AGENT_NOT_OWNED

HTTP 404 · Retryable: no

The target agent does not exist or is not owned by the authenticated caller.

NOT_FOUND

HTTP 404 · Retryable: no

The requested resource does not exist.

KNOWLEDGE_NOT_FOUND

HTTP 404 · Retryable: no

No normalized knowledge-graph record exists for the requested identifier.

KNOWLEDGE_STALE

HTTP 404 · Retryable: yes

A company record exists but must be revalidated by live enrichment before reuse.

VALIDATION_ERROR

HTTP 400 · Retryable: no

The request body failed schema validation.

UNSUPPORTED_TASK_TYPE

HTTP 400 · Retryable: no

The task type is not present in the capability catalog.

INSUFFICIENT_CREDITS

HTTP 402 · Retryable: no

The agent does not hold enough credits to run the requested operation.

MONTHLY_SPENDING_CAP_EXCEEDED

HTTP 402 · Retryable: no

The agent has funded credits but its owner-configured monthly spending allowance is exhausted.

TASK_NOT_CANCELLABLE

HTTP 409 · Retryable: no

The task is no longer queued, so cancellation and refund cannot be applied.

TASK_CANCELLED

HTTP 409 · Retryable: no

Cancellation won the queued-task state transition before execution began.

TASK_ALREADY_FINALIZED

HTTP 409 · Retryable: no

Another worker finalized or timed out the task before this execution result could be committed.

INVALID_AMOUNT

HTTP 400 · Retryable: no

The credit amount must be a positive integer.

RATE_LIMIT_EXCEEDED

HTTP 429 · Retryable: yes

The caller exceeded a rate limit window. Inspect the X-RateLimit-Reset header.

API_KEY_RATE_LIMIT_EXCEEDED

HTTP 429 · Retryable: yes

The API key exceeded its per-minute request quota. Inspect the rate-limit headers before retrying.

TASK_RATE_LIMIT_EXCEEDED

HTTP 429 · Retryable: yes

The caller exceeded the per-minute task submission quota.

AUTH_RATE_LIMIT_EXCEEDED

HTTP 429 · Retryable: yes

Too many authentication attempts were made in the current window.

PROVISIONING_RATE_LIMIT_EXCEEDED

HTTP 429 · Retryable: yes

The owner exceeded the hourly sub-agent provisioning quota.

RESEARCH_RATE_LIMIT_EXCEEDED

HTTP 429 · Retryable: yes

The caller exceeded the per-minute research request quota.

CONCURRENT_TASK_LIMIT

HTTP 429 · Retryable: yes

The agent already has the maximum number of active tasks. Retry after one completes.

BETA_CHECKOUT_DISABLED

HTTP 503 · Retryable: no

Set BETA_MODE=false to allow self-service credit purchases.

IDEMPOTENCY_KEY_REQUIRED

HTTP 400 · Retryable: no

Supply a UUID Idempotency-Key header so a starter-credit claim can be replayed safely.

STARTER_GRANT_INELIGIBLE

HTTP 403 · Retryable: no

Starter credits are limited to the first non-owner agent created by verified machine enrollment.

STARTER_GRANT_ALREADY_CLAIMED

HTTP 409 · Retryable: no

This account already used its one-time starter grant. Replaying the original Idempotency-Key returns the original result without another grant.

WORKFLOW_NOT_FOUND

HTTP 404 · Retryable: no

The named workflow definition was not found in .agents/workflows.

WORKFLOW_STEP_INTERRUPTED

HTTP 503 · Retryable: yes

A workflow worker stopped after step execution began. Retry the workflow; the interrupted step was not executed a second time automatically.

WORKFLOW_FAILED

HTTP 500 · Retryable: yes

One or more workflow steps failed irrecoverably.

TASK_FAILED

HTTP 500 · Retryable: yes

An internal error occurred while executing the skill.

PROVIDER_UNAVAILABLE

HTTP 503 · Retryable: yes

The configured AI provider could not accept or complete the request.

PROVIDER_ERROR

HTTP 502 · Retryable: yes

The provider rejected the request for a reason unrelated to model selection.

INVALID_JSON_RESPONSE

HTTP 502 · Retryable: yes

The AI provider response could not be parsed as the required JSON object.

MODEL_NOT_SELECTABLE

HTTP 400 · Retryable: no

The selected model is unavailable or incompatible with this workload.

ENRICHMENT_PROVIDER_UNAVAILABLE

HTTP 503 · Retryable: yes

Enrichment is not configured or could not accept the task.

ENRICHMENT_INVALID_TERMINAL_JSON

HTTP 502 · Retryable: yes

The enrichment provider returned a response that could not be parsed as the required terminal JSON object.

ENRICHMENT_QUALITY_FAILED

HTTP 422 · Retryable: no

The provider returned a terminal object, but required identity or evidence fields were missing or could not be verified.

ENRICHMENT_TIMEOUT

HTTP 504 · Retryable: yes

The enrichment provider did not finish within the bounded execution window.

BATCH_PARTIAL_FAILURE

HTTP 207 · Retryable: yes

The batch completed but at least one task failed.

MISSING_OUTPUT_FORMAT

HTTP 400 · Retryable: no

The supplied skill requires an outputFormat field.

PROVISIONING_FAILED

HTTP 500 · Retryable: yes

An error occurred while creating an agent.

INTERNAL_ERROR

HTTP 500 · Retryable: yes

An unhandled exception occurred. Check server logs.

PAYLOAD_TOO_LARGE

HTTP 413 · Retryable: no

The request body exceeded the configured size limit.

DUPLICATE_RESOURCE

HTTP 409 · Retryable: no

A resource with the same identifier already exists.

CORS_REJECTED

HTTP 403 · Retryable: no

The request origin is not permitted by the server CORS policy.