examples · errors · 12 / 19
12. 404 - schema not registered
← Errors exampleswhat 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/:idif it should exist. - Confirm the schema id is fully qualified - the catalog stores
shop.customers, notcustomers. 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.vsshops.. - 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.