Docs

contract_not_found

404 not_found. Capa-Contract names a contract this project does not have.

View as Markdown
HTTP statustypeSurfaces
404not_foundREST, GraphQL

What it means

Capa-Contract names a contract this project does not have. Only contract 1 exists today.

WhenWhat the hint tells you
Capa-Contract is not 1the contracts that exist

What to do

Drop the Capa-Contract header or send 1.

The response

HTTP 404:

{
  "error": {
    "type": "not_found",
    "code": "contract_not_found",
    "message": "Contract 2 does not exist.",
    "param": "Capa-Contract",
    "hint": "This project has contract 1 only.",
    "docs": "https://docs.capacms.com/errors/contract_not_found"
  },
  "meta": {
    "version": "2026-10-01",
    "contract": 1,
    "requestId": "req_0f3c…"
  }
}

On GraphQL

/api/graphql answers the same code inside errors[].extensions. The status depends on the Accept header you send (status codes):

application/jsongraphql-response+jsonWhen
404404Capa-Contract other than 1

See also