Reference
unauthenticated
The request carried no API key, or one the API could not verify.
What it means
The request carried no API key, or one the API could not verify.
Retry after fixing
Retrying unchanged will not help. Correct the cause, then send it again.
What causes it
- No `Authorization` header was sent.
- The header was sent without the `Bearer ` prefix — the value alone is not accepted.
- The key was revoked, or belongs to a workspace that has since been deleted.
- A key from one environment was used against another.
How to fix it
- Send `Authorization: Bearer <your key>`.
- Check the key is still listed in your dashboard under API keys.
- Confirm you are calling `https://api.integrable.cloud` and not a stale host.
What the response looks like
{
"error": {
"code": "unauthenticated",
"message": "The request carried no API key, or one the API could not verify",
"request_id": "7cb7f7862a82425d8e4c3fb8a497dfe6"
},
"type": "https://integrable.cloud/docs/errors/unauthenticated",
"title": "Unauthenticated",
"status": 401,
"detail": "The request carried no API key, or one the API could not verify",
"instance": "/api/bots/01a0652b-3713-7ea1-a6c9-2e895389ec34"
}Branch on error.code, not on the message — the code is stable, the sentence is not. Log request_id either way.
Still stuck
Quote the request_id from the response — hello@integrable.cloud. It is what lets us find the exact request. The full list of codes is at Error codes, and the conventions every endpoint shares are in Retries, versioning and limits.
Something here wrong or missing? Tell us — the documentation and the API are maintained by the same person, so a correction is a fix rather than a ticket.