DocsError codes

method_not_allowed

The path exists but does not accept this HTTP method.

On this page
405HTTP 405 · Method Not Allowed

What it means#

The path exists but does not accept this HTTP method.

Do not retry

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

What causes it#

  • A `GET` was sent to a create-only endpoint, or a `POST` to a read-only one.
  • A trailing-slash variant was used that routes differently.

How to fix it#

  • Check the method in the API reference — the `Allow` response header also lists what the path accepts.

What the response looks like#

405 application/problem+json
{
  "error": {
    "code": "method_not_allowed",
    "message": "The path exists but does not accept this HTTP method",
    "request_id": "7cb7f7862a82425d8e4c3fb8a497dfe6"
  },
  "type": "https://integrable.cloud/docs/errors/method_not_allowed",
  "title": "Method Not Allowed",
  "status": 405,
  "detail": "The path exists but does not accept this HTTP method",
  "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.