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.
| Code | HTTP | What to do |
|---|---|---|
invalid_request | 400 | Fix the input. message says which field. |
unauthorized | 401 | The key or sign-in isn't valid. Use a valid key, or sign in again. |
forbidden | 403 | The caller may not do this here. Check the role, or follow url. |
not_found | 404 | No such operation, or nothing the caller can see. |
conflict | 409 | The idempotency key was used for other input, or a confirmation expired or changed. |
rate_limited | 429 | Wait for Retry-After seconds. |
temporarily_unavailable | 503 | Try again with backoff. |
Invyte never says whether something you can't see exists: a Job outside your access is not_found, not forbidden.