Skip to Content
InvyteDocs

Errors

The error envelope, every code, and what to do about each.

Refusals share one shape:

{
  "version": "1",
  "error": {
    "code": "forbidden",
    "message": "This Job is in another organization.",
    "retryable": false,
    "requestId": "req_…",
    "organizationId": "org_…",
    "url": "https://www.invyte.ai/…"
  }
}

url, when present, is a page where a person can fix the problem, such as choosing the organization a connection works in. organizationId appears when switching organization would fix it.

CodeHTTPWhat to do
invalid_request400Fix the input. message says which field.
unauthorized401The key or sign-in isn't valid. Use a valid key, or sign in again.
forbidden403The caller may not do this here. Check the role, or follow url.
not_found404No such operation, or nothing the caller can see.
conflict409The idempotency key was used for other input, or a confirmation expired or changed.
rate_limited429Wait for Retry-After seconds.
temporarily_unavailable503Try again with backoff.

Invyte never says whether something you can't see exists: a Job outside your access is not_found, not forbidden.