DocsError codes

not_found

No resource with that identifier exists in the workspace the key belongs to.

On this page
404HTTP 404 · Not Found

What it means#

No resource with that identifier exists in the workspace the key belongs to.

Do not retry

The identical request will fail the same way every time. Change it first.

What causes it#

  • The id is wrong, truncated, or from a different environment.
  • The resource was deleted.
  • The resource belongs to another workspace. The API answers 404 rather than 403 here on purpose — confirming that an id exists in someone else's workspace is itself a leak.

How to fix it#

  • List the collection and confirm the id appears in it.
  • Check the key is issued for the workspace you expect.

What the response looks like#

404 application/problem+json
{
  "error": {
    "code": "not_found",
    "message": "No resource with that identifier exists in the workspace the key belongs to",
    "request_id": "7cb7f7862a82425d8e4c3fb8a497dfe6"
  },
  "type": "https://integrable.cloud/docs/errors/not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "No resource with that identifier exists in the workspace the key belongs to",
  "instance": "/api/agents/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 unclear or missing? Tell us and we’ll fix it.