HTTP 404
not_found
HTTP 404 — Not found
When you see it
No row with that id belongs to this user, or it was permanently deleted.
What to do
Treat it as gone. A trashed row is still readable under /trash; a deleted one is not recoverable.
The response
Every error is RFC 9457 problem+json:
json
{
"type": "https://devs.inittasks.com/errors/not_found",
"title": "Not found",
"status": 404,
"detail": "a sentence for a developer; never branch on it",
"instance": "/todos/8E4F2A1B",
"request_id": "3f9a1c7e-2b44-4d1e-9c30-5a7e8b2d1f60"
}Branch on type, never on detail or on the HTTP status alone — several codes share a status.