Errors
Structured JSON errors — 4xx for request/access problems, 5xx for retryable platform failures.
Errors are returned as structured JSON. Treat 4xx as request or access problems, and
5xx as retryable platform failures.
| Status | Meaning |
|---|---|
400 | Invalid request — malformed body, missing mappingKey, or a body that fails the entity's unified schema validation. |
401 | Missing or expired bearer token. Generate a fresh token and retry. |
404 | Unknown accountId, entityType, or a mappingKey that isn't configured for this entity. |
429 | The backing system's rate limit was reached. Retry with exponential backoff. |
5xx | Temporary Flow or platform issue. Safe to retry idempotent reads; retry writes with the same externalId — it doubles as the idempotency key. |