Error Catalogoverrides-unavailable

overrides-unavailable

503 Service Unavailable — This deployment does not manage mapping overrides through the API.

overrides-unavailable

HTTP 503 Service Unavailable
Content-Type: application/problem+json

{
  "type": "https://docs.transmute.403fin.io/errors/overrides-unavailable",
  "title": "Mapping overrides unavailable",
  "status": 503,
  "detail": "Self-serve mapping overrides are not available in this deployment",
  "requestId": "req_01J..."
}

The /v1/overrides routes exist on this deployment, but overrides are not managed through them.

Common causes

  • A self-hosted deployment that loads override documents from files (TRANSMUTE_MAPPING_OVERRIDES); the files are the source of truth there
  • A deployment running without a database

How to fix it

Self-hosting: manage overrides through your document directory, or run with a database and without the directory to use the API. On the hosted API this should not occur — contact support with the X-Request-Id.

Does it bill?

No. Override management is never metered.

Was this page helpful?