not_found: Not found
Havoptic API error not_found (HTTP 404, Not found): The release, tool, version, vendor, feature, webhook or route you asked for does not exist. What it means and how to fix it.
| Field | Value |
|---|---|
| type | https://www.havoptic.com/docs/errors/not_found |
| HTTP status | 404 |
| title | Not found |
| Returned by | api.havoptic.com, www.havoptic.com/api/v1 |
What it means
The path is well formed but nothing matches it. On api.havoptic.com an unknown route also returns this type.
Common causes
- A release id with a typo. Ids look like
claude-code-2.1.302;[email protected]also works. - A version that Havoptic has not tracked (yet) on
/tools/{id}/versions/{version}. - A webhook id that was deleted, or that belongs to a different API key.
- A path without the
/v1prefix on api.havoptic.com.
How to fix it
- List first, then fetch:
GET /v1/tools/{id}/releasesorGET /v1/releases?tool={id}return valid ids. - For "newest" use
GET /v1/tools/{id}/latestinstead of guessing a version.
Example response
{
"type": "https://www.havoptic.com/docs/errors/not_found",
"title": "Not found",
"status": 404,
"detail": "Release not found: claude-code-9.9.9"
}