Errors

not_found

404 Not found. There is no such thing on this account.

Open in Claude Open in ChatGPT .md

Status	Code	Retry?
404 Not found	`not_found`	No

What it means

There is no such thing on this account. Ids are prefixed by kind, so a message id starts with msg_.

Common causes

The id is mistyped or belongs to another account.
The thing was deleted.
The path is wrong.

What to do

Check the id. Ids are prefixed by kind, such as msg_ for a message.

Can I retry it?

No. The same request gets the same answer however often it is sent, so change the request rather than repeating it.

What the answer looks like

Response404

{
  "error": {
    "code": "not_found",
    "message": "There’s no message with that id.",
    "hint": "Check the id. Ids are prefixed by kind, such as `msg_` for a message.",
    "doc_url": "https://usebluebot.com/docs/errors/not_found",
    "request_id": "req_1Hq2LxW9cVbN3mKpRtYs0a"
  }
}

Branch on code, which never changes. message and hint are written for people and may be reworded. Quote request_id when you write to support.

Errors: the envelope and every code
Idempotency: retrying without sending twice
Limits: every cap and what happens when you reach it