Skip to main content
type
string
invalid_request_error
status
number
404

What happened

The schema id you provided does not match any schema in your account. This can happen if the id is wrong, the schema was deleted, or it belongs to a different account.
{
  "error": {
    "type": "invalid_request_error",
    "code": "SCHEMA_NOT_FOUND",
    "message": "No schema with id 018e1b2c-3d4e-5f6a-7b8c-9d0e1f2a3b4c",
    "status": 404,
    "doc_url": "https://done.mintlify.app/errors/schema-not-found"
  }
}

How to fix

Call GET /v1/schemas to retrieve the list of schemas in your account and confirm the id you are using.
curl https://api.done.app/v1/schemas \
  -H "Authorization: Bearer <your_token>"

Common causes

Double-check the UUID. Schema ids are UUIDs — a single wrong character produces a 404.
Each schema is scoped to the account that created it. A token from account A cannot access schemas from account B.
If the schema was deleted, you need to recreate it with POST /v1/schemas before creating new claims from it. Note: deleting a schema does not affect existing claims — they retain a snapshot of the contract.