not_found

HTTP 404Not Found

The resource does not exist, or is not visible to this credential.

The API deliberately does not distinguish between ‘does not exist’ and ‘exists but you cannot see it’. Both return 404, so that record existence cannot be probed by a credential that lacks access.

Response shape

{
  "type": "https://api-docs.ahoy.ai/rest/v1/errors/not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "No 'ahoy_contact' record with id 'rec_01J8Z2K9QW3X4Y5Z6A7B8C9D'.",
  "code": "not_found",
  "request_id": "req_01J8Z2K9QW3X4Y5Z6A7B8C9D"
}

This code is not further sub-classified — it never carries a reason member.

How to resolve it

• Verify the object type and record id.
• Confirm the key has a read grant on the object type via GET /rest/v1/objects/.
• Check the path — an unknown or mis-cased {object_type} segment also returns this error.