OriginChain docs
examples · errors · 12 / 19

12. 404 - schema not registered

← Errors examples
what this error means

The URL targets a schema id that is not registered for this tenant. Same root cause as the SQL unknown_table 400, but surfaced at the REST resource layer rather than through the SQL translator.

what triggers it

A direct GET against a schema id that doesn't exist.

GET /v1/tenants/:t/schemas/:id
curl "https://$OC_HOST/v1/tenants/$OC_TENANT/schemas/does.not.exist" \
  -H "Authorization: Bearer $OC_TOKEN"
the canonical response body
{
  "error": "schema_not_found",
  "message": "no schema 'does.not.exist' for tenant",
  "retry": false
}
how to recover
  • List schemas registered for this tenant: GET /v1/tenants/:t/schemas.
  • Register the manifest with PUT /v1/tenants/:t/schemas/:id if it should exist.
  • Confirm the schema id is fully qualified - the catalog stores shop.customers, not customers.
  • retry: false - register the schema first, then retry.
common upstream causes
  • Schema registered on staging but not yet on prod.
  • Typo in the namespace - shop. vs shops..
  • Schema was deleted (via a destructive-data confirm) and a downstream service still references it.
  • Multi-region deploy where the new region missed a migration step.