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.

CodeStatusTitleMeaning
simio_invalid_field400Invalid fieldA request field is missing, malformed, or outside the documented bounds.
simio_upload_invalid400Invalid uploadThe dataset upload could not be parsed as a valid seed file request.
simio_unsupported_file_type400Unsupported file typeThe uploaded seed file uses a format the dataset reader does not support.
simio_file_corrupt400Unreadable fileThe uploaded seed file could not be read as its declared format.
simio_encoding_error400Invalid text encodingThe uploaded text file could not be decoded reliably.
simio_all_na_column400Empty columnAt least one seed-data column contains no observed values.
simio_remaining_na400Unresolved missing valuesThe seed data could not be prepared into the complete training frame required for generation.
simio_insufficient_rows400Insufficient rowsThe seed dataset contains too few usable rows for training.
simio_empty_training_frame400No usable training dataThe uploaded dataset contains no usable training frame.
simio_generated_data400Generated seed dataThe uploaded seed appears to contain generated rather than original observed data.
simio_invalid_request400Invalid generation requestThe generation request could not be interpreted by the fitted model interface.
simio_unsupported_content_type415Unsupported content typeThe upload used a media type the API does not accept.
simio_file_too_large413File too largeThe uploaded seed file exceeded the API upload size limit.
simio_idempotency_conflict409Idempotency conflictAn Idempotency-Key was reused with a different request body.
simio_idempotency_in_flight409Request still processingA prior request with the same Idempotency-Key is still running.
simio_dataset_not_found404Dataset not foundThe dataset does not exist, expired, was deleted, or is not visible to this tenant.
simio_generation_not_found404Generation not foundThe generation does not exist, expired, was deleted, or is not visible to this tenant.
simio_job_not_found404Job not foundThe job ID is unknown or no longer retained.
simio_signup_not_found404Signup request not foundThe signup request ID is unknown, expired, or not visible.
simio_credential_claim_not_found404Credential claim not foundThe credential claim token is unknown, expired, or already used.
simio_rotation_request_not_found404Rotation request not foundThe credential rotation request ID is unknown or not visible to this client.
simio_invalid_idempotency_key400Invalid Idempotency-KeyThe Idempotency-Key header was present but malformed.
simio_rotation_claim_already_consumed410Rotation claim already consumedThe one-time credential_claim_token from a prior successful rotation has already been redeemed.
simio_rotation_rate_limited429Rotation rate limit reachedThe authenticated client has rotated its credential too many times in the rate-limit window.
simio_route_preflight_rate_limited429Routing preflight rate limit reachedThe authenticated tenant sent too many route-plan preflight requests in the local protection window.
simio_auth0_unreachable502Auth0 unreachableThe API could not reach Auth0 to complete the rotation.
simio_rotation_db_split500Rotation partially completedAuth0 rotated the client_secret but the matching internal write did not commit.
simio_model_declaration_syntax_error400Invalid modeling declarationThe model_declaration part is malformed.
simio_model_declaration_semantic_error422Unsupported modeling declarationA declared column cannot be modeled as continuous for this dataset.
route_plan_syntax_error400Invalid routing declarationThe route-plan document is malformed or names unsupported fields.
route_plan_semantic_error422Incompatible routing declarationThe route-plan design is validly shaped but cannot describe this dataset.
route_plan_empirical_error422Routing declaration contradicts dataObserved answered/missing cells do not agree with the declared questionnaire route.
route_plan_unsupported_schema422Unsupported routing schemaThe declaration requests a routing shape that schema v1 does not implement.
simio_unknown_condition_column400Unknown condition columnA generation condition referenced a column not present in the cleaned dataset schema.
simio_unknown_condition_level400Unknown condition levelA categorical condition referenced a level not present in the cleaned dataset schema.
simio_quota_exhausted402Quota exhaustedThe request would exceed the company's active row subscription.
simio_quota_not_configured409Quota not configuredNo unambiguous active subscription is configured for this account.
simio_per_request_cap_exceeded413Request cap exceededThe requested row_count exceeds this credential's per-request safety cap.
simio_quota_reservation_conflict409Quota reservation conflictThe request could not reserve quota because another operation changed the quota state concurrently.
simio_dataset_not_ready409Dataset not readyThe dataset exists but is not ready for generation yet.
simio_extend_cap_exceeded409Retention cap exceededThe dataset cannot be extended beyond the maximum continuous retention window.
simio_impossible_conditions422Impossible conditionsThe requested conditions produced zero feasible synthetic rows.
simio_impossible_generation422Impossible generationThe model could not generate the requested output under the supplied settings.
simio_generation_anomaly422Generation anomalyThe generated output failed post-generation quality checks.
simio_key_release_denied403Key release deniedThe customer-managed key or role refused access to decrypt a required artifact.
simio_key_unavailable503Key service unavailableA required encryption key service was unavailable.
simio_key_service_throttled503Key service throttledA required key service throttled the request.
simio_key_service_internal500Key service errorAn internal key-service operation failed.
simio_internal_error500Internal server errorThe API hit an internal error while processing the request.