AIARCOASC Docs

Errors

A small, stable error envelope with machine-readable codes.

What it is

Every error response uses the same envelope:

{
  "error": {
    "code": "forbidden_scope",
    "message": "Missing scope pods:write",
    "request_id": "req_2a8…"
  }
}

Quickstart

# Detect by code, not by message
curl -i https://api.asc.aiarco.com/v1/pods -X POST -d '...' | jq '.error.code'
from aiarco import AscError
try:
    client.pods.run(...)
except AscError as e:
    if e.code == 'forbidden_scope': ...
try { await client.pods.run({...}); } catch (e: any) { if (e.code === 'forbidden_scope') {...} }

Security

All access is authenticated and scoped. See Auth & scopes and Network controls.

Error codes

CodeHTTPMeaning
unauthorized401No / invalid API key or JWT.
forbidden_scope403Key is valid but missing the required scope.
not_found404Resource does not exist or you don't have access.
conflict409State conflict (e.g. resource already exists).
validation422Request body failed schema validation.
rate_limited429See Rate limits. Retry after Retry-After seconds.
quota_exceeded429Per-tenant quota exhausted. Lift via sales.
payment_required402Tenant past due.
idempotency_conflict409Same idempotency key, different body.
unavailable503Transient — retry with backoff.
internal500We made a mistake. Quote request_id to support.