{"errors":[{"code":"genius_version_unsupported","type":"invalid_request_error","http_status":400,"message":"Unsupported Genius-Version.","meaning":"The requested Genius API version is not supported.","resolution":"Use Genius-Version: 2026-04-01 or omit the header.","docs_url":"/v1/errors/genius_version_unsupported"},{"code":"validation_error","type":"invalid_request_error","http_status":400,"message":"Request validation failed.","meaning":"A required field is missing or malformed.","resolution":"Check the request body against /openapi.json and send all required fields.","docs_url":"/v1/errors/validation_error"},{"code":"invalid_json","type":"invalid_request_error","http_status":400,"message":"request body must be valid JSON","meaning":"The request body could not be parsed as JSON.","resolution":"Send valid JSON with the correct Content-Type header.","docs_url":"/v1/errors/invalid_json"},{"code":"invalid_body","type":"invalid_request_error","http_status":400,"message":"request body could not be read","meaning":"The request body could not be read or was empty when a payload was expected.","resolution":"Retry with a readable JSON request body.","docs_url":"/v1/errors/invalid_body"},{"code":"authentication_required","type":"authentication_error","http_status":401,"message":"authentication required","meaning":"The request did not include valid authenticated credentials.","resolution":"Authenticate with the current supported header-based auth before calling /v1 routes.","docs_url":"/v1/errors/authentication_required"},{"code":"idempotency_conflict","type":"idempotency_error","http_status":409,"message":"Idempotency key conflicts with a different request.","meaning":"The same Idempotency-Key was reused with a different request body on the same route.","resolution":"Reuse the same body with the same key, or generate a new Idempotency-Key.","docs_url":"/v1/errors/idempotency_conflict"},{"code":"idempotency_key_required","type":"idempotency_error","http_status":409,"message":"Idempotency-Key header is required for this mutation","meaning":"This mutation requires an Idempotency-Key header.","resolution":"Provide a unique Idempotency-Key header and retry the request.","docs_url":"/v1/errors/idempotency_key_required"},{"code":"precommit_transaction_not_found","type":"not_found_error","http_status":404,"message":"precommit transaction not found","meaning":"No governed communication transaction exists for the requested id.","resolution":"Check the transaction id and create or fetch a valid transaction first.","docs_url":"/v1/errors/precommit_transaction_not_found"},{"code":"precommit_decision_not_found","type":"not_found_error","http_status":404,"message":"precommit decision not found","meaning":"No persisted Genius decision exists for the requested id.","resolution":"Check the decision id and create or fetch a valid decision first.","docs_url":"/v1/errors/precommit_decision_not_found"},{"code":"precommit_proof_packet_not_found","type":"not_found_error","http_status":404,"message":"precommit proof packet not found","meaning":"No proof packet exists for the requested id.","resolution":"Check the proof packet id from a valid decision or transaction response.","docs_url":"/v1/errors/precommit_proof_packet_not_found"},{"code":"precommit_analysis_unavailable","type":"service_unavailable_error","http_status":502,"message":"precommit analysis failed closed before governance","meaning":"Genius could not complete the analysis path safely and failed closed.","resolution":"Retry later or route the communication to manual review.","docs_url":"/v1/errors/precommit_analysis_unavailable"},{"code":"precommit_analysis_failed","type":"invalid_request_error","http_status":400,"message":"precommit analysis could not be completed","meaning":"The input could not be converted into a governed decision safely.","resolution":"Review the request content and retry with a complete, valid communication payload.","docs_url":"/v1/errors/precommit_analysis_failed"},{"code":"internal_error","type":"service_unavailable_error","http_status":500,"message":"internal error","meaning":"Genius encountered an unexpected server-side failure.","resolution":"Retry later and use request_id or trace_id when contacting support.","docs_url":"/v1/errors/internal_error"},{"code":"rate_limit_exceeded","type":"rate_limit_error","http_status":429,"message":"Rate limit exceeded. Retry after the reset window.","meaning":"Too many Genius API calls were made within the current rate-limit window.","resolution":"Wait until the reset window or follow Retry-After before retrying.","docs_url":"/v1/errors/rate_limit_exceeded"},{"code":"genius_error_code_not_found","type":"not_found_error","http_status":404,"message":"genius error code not found","meaning":"The requested Genius error code is not present in the public dictionary.","resolution":"Consult /v1/errors for the current list of supported Genius error codes.","docs_url":"/v1/errors/genius_error_code_not_found"}],"object":"error_dictionary","version":"2026-04-01"}