NOT_FOUND — Resource doesn't exist
Summary
Section titled “Summary”The endpoint shape was valid but a referenced ID couldn’t be found. Either the resource doesn’t exist, was deleted, or belongs to a different organization than your API key.
HTTP status
Section titled “HTTP status”404 Not Found. Standard envelope.
Example response
Section titled “Example response”{ "success": false, "error": { "code": "NOT_FOUND", "message": "Question with id 'q_01HXJZK...' not found.", "request_id": "req_01HXJZK4ABCDEF", "doc_url": "https://docs.surveycoder.io/errors/not-found" }}Why this happens
Section titled “Why this happens”- A typo in the ID.
- The resource was deleted (deletes are hard — there’s no soft-delete fallback).
- You’re using a production key against a test-mode resource (or vice versa).
- The resource belongs to a different org. Resources are strictly scoped per org, even within a workspace.
How to fix it
Section titled “How to fix it”- Double-check the ID. Most IDs are 28-character ULIDs prefixed by their resource type (
proj_,q_,job_,cb_). - List resources to confirm the ID exists:
GET /v1/projects,GET /v1/projects/{id}/questions, etc. - Confirm the API key belongs to the same org as the resource — check the dashboard.
- If it was deleted, recreate it (or restore from a recent SPSS/CSV export).
Related
Section titled “Related”VALIDATION_ERROR- API reference — every list endpoint helps confirm IDs