Skip to content

Not found ​

404 · CAMPAIGN_NOT_FOUND · SURVEY_LINK_NOT_FOUND

One status, two different situations. Branch on code.

json
{
  "type": "about:blank",
  "title": "Not Found",
  "status": 404,
  "code": "SURVEY_LINK_NOT_FOUND",
  "detail": "Survey link not found"
}

CAMPAIGN_NOT_FOUND ​

No campaign with that id exists in the workspace the key belongs to. Either the id is wrong, or it belongs to another workspace.

A campaign in another workspace reads as absent rather than forbidden. That is deliberate: answering otherwise would let a key probe for the existence of campaigns it cannot see.

The link is gone, and the API does not say which way it went. It was consumed, it expired, it was revoked, or it never existed.

That collapse is the same one respondents see: a used link and an expired link render the same neutral page, so neither a recipient nor an observer can tell a valid-but-spent link from a fabricated one.

If you need to know whether a link was ever used, read it before it is consumed — viewed tells you whether it was opened. Once it is gone, it is gone. See How survey links behave.

What to do ​

Do not retry. Check the id, and check it belongs to this workspace.

Zefi API v1