Simulacra API Error Catalog

Problem responses include a stable code and, when available, a dereferenceable type URL. Preserve X-Request-Id and response-body request_id values when contacting support.

Error codes are part of the v1 contract. New codes may be added; existing codes are stable.

Code	Status	Title	Meaning
`simio_invalid_field`	400	Invalid field	A request field is missing, malformed, or outside the documented bounds.
`simio_upload_invalid`	400	Invalid upload	The dataset upload could not be parsed as a valid seed file request.
`simio_unsupported_content_type`	415	Unsupported content type	The upload used a media type the API does not accept.
`simio_file_too_large`	413	File too large	The uploaded seed file exceeded the API upload size limit.
`simio_idempotency_conflict`	409	Idempotency conflict	An Idempotency-Key was reused with a different request body.
`simio_idempotency_in_flight`	409	Request still processing	A prior request with the same Idempotency-Key is still running.
`simio_dataset_not_found`	404	Dataset not found	The dataset does not exist, expired, was deleted, or is not visible to this tenant.
`simio_generation_not_found`	404	Generation not found	The generation does not exist, expired, was deleted, or is not visible to this tenant.
`simio_job_not_found`	404	Job not found	The job ID is unknown or no longer retained.
`simio_signup_not_found`	404	Signup request not found	The signup request ID is unknown, expired, or not visible.
`simio_credential_claim_not_found`	404	Credential claim not found	The credential claim token is unknown, expired, or already used.
`simio_rotation_request_not_found`	404	Rotation request not found	The credential rotation request ID is unknown or not visible to this client.
`simio_invalid_idempotency_key`	400	Invalid Idempotency-Key	The Idempotency-Key header was present but malformed.
`simio_rotation_claim_already_consumed`	410	Rotation claim already consumed	The one-time credential_claim_token from a prior successful rotation has already been redeemed.
`simio_rotation_rate_limited`	429	Rotation rate limit reached	The authenticated client has rotated its credential too many times in the rate-limit window.
`simio_auth0_unreachable`	502	Auth0 unreachable	The API could not reach Auth0 to complete the rotation.
`simio_rotation_db_split`	500	Rotation partially completed	Auth0 rotated the client_secret but the matching internal write did not commit.
`simio_unknown_condition_column`	400	Unknown condition column	A generation condition referenced a column not present in the cleaned dataset schema.
`simio_unknown_condition_level`	400	Unknown condition level	A categorical condition referenced a level not present in the cleaned dataset schema.
`simio_quota_exhausted`	402	Quota exhausted	The request would exceed the company's active row subscription.
`simio_per_request_cap_exceeded`	413	Request cap exceeded	The requested row_count exceeds this credential's per-request safety cap.
`simio_quota_reservation_conflict`	409	Quota reservation conflict	The request could not reserve quota because another operation changed the quota state concurrently.
`simio_dataset_not_ready`	409	Dataset not ready	The dataset exists but is not ready for generation yet.
`simio_extend_cap_exceeded`	409	Retention cap exceeded	The dataset cannot be extended beyond the maximum continuous retention window.
`simio_impossible_conditions`	422	Impossible conditions	The requested conditions produced zero feasible synthetic rows.
`simio_impossible_generation`	422	Impossible generation	The model could not generate the requested output under the supplied settings.
`simio_generation_anomaly`	422	Generation anomaly	The generated output failed post-generation quality checks.
`simio_key_release_denied`	403	Key release denied	The customer-managed key or role refused access to decrypt a required artifact.
`simio_key_unavailable`	503	Key service unavailable	A required encryption key service was unavailable.
`simio_key_service_throttled`	503	Key service throttled	A required key service throttled the request.
`simio_key_service_internal`	500	Key service error	An internal key-service operation failed.
`simio_internal_error`	500	Internal server error	The API hit an internal error while processing the request.