Error code

Ref not found

The project has no branch, tag, or environment by that name. On the delivery API it also means the ref is not one delivery serves: a branch, a live environment such as `dev`, an environment that points at nothing, or a tag with no published snapshot.

Fig. 03 Ratchet and pawlThe wheel turns freely one way, and the pawl stops it turning back.

Code: REF_NOT_FOUND
Management API: 404
Delivery API: 404

What to do

Check the name: a new project's first branch is v0.0.x, not main. Delivery serves tags and environments that point at tags; read branches and live environments through preview.

The response

Every refusal is an application/problem+json document. Its detail says what went wrong in that request; its type is this page.

{
  "code": "REF_NOT_FOUND",
  "type": "https://coho-cms.com/errors/ref-not-found",
  "title": "Ref not found",
  "status": 404,
  "detail": "What went wrong in this request, in a sentence.",
  "instance": "/v1/projects/…"
}

Every code

The error codes, in a table with a filter.