Référence de l’API
Appels à la passerelle
Appeler un modèle par la passerelle gouvernée — et autour d’un appel : s’il lui faut un modèle, le modèle qu’un premier appel peut utiliser, la reprise d’un appel retenu, une demande d’exception, la vérification d’ancrage et les reçus de votre propre coffre.
Les résumés des routes et les noms des champs sont écrits en anglais, ici comme dans le fichier.
/api/v1/chat
POST /api/v1/chat/completions
The governed gateway, OpenAI-compatible
inference:writeX-Azoth-Usecase · X-Azoth-Decision-Ref · X-Azoth-Subject-Zone · X-Azoth-End-User · X-Azoth-Challenge-Passed · X-Azoth-On-Behalf-Of · X-Azoth-Locale · X-Azoth-Alternative · X-Azoth-Refusal-Ref · Idempotency-Keymodel (obligatoire) · messages (obligatoire) · temperature · max_tokens · stream · azoth_use_cache · azoth_task · azoth_cache_policy · azoth_agent_id · azoth_workflow_id · azoth_compute_os · azoth_sources200 · 202 human_review_required · 400 validation_failed, invalid_decision_ref, invalid_on_behalf_of, invalid_alternative, alternative_not_offered, alternative_mismatch, invalid_refusal_ref, human_identity_required, idempotency_key_invalid · 401 api_key_missing, api_key_invalid · 402 budget_exceeded, ai_ops_limit_exceeded, sealed_decisions_limit_reached, trial_exhausted · 403 api_key_scope_denied, policy_blocked, usecase_unresolved, usecase_not_approved, usecase_prohibited, usecase_archived, usecase_divergence, mandate_suspended, mandate_expired, kill_switch_active, jurisdiction_blocked, sovereignty_blocked, secnumcloud_blocked, egress_blocked, data_exfiltration_blocked, redaction_failed, human_review_not_resumable, on_behalf_of_not_allowed, ungrounded_answer · 409 idempotency_key_in_progress, idempotency_replay_unavailable · 422 provider_not_connected, provider_key_rejected, provider_permission_denied, provider_model_not_found, provider_payment_required, provider_request_too_large, provider_request_rejected, provider_not_supported, onboarding_no_provider, trial_unavailable, trial_limits_exceeded, idempotency_key_reused · 428 exhaustion_challenge_required · 429 exhaustion_slow, exhaustion_blocked, tenant_concurrency_limit, loop_detected · 500 internal_error · 502 provider_failure, provider_rate_limited · 503 governance_error, kill_switch_unavailable, budget_unavailable, identity_unavailable, service_unavailablePOST /api/v1/chat
The governed gateway with an explicit provider, fallbacks and streaming
inference:writeX-Azoth-Usecase · X-Azoth-Decision-Ref · X-Azoth-Subject-Zone · X-Azoth-End-User · X-Azoth-Challenge-Passed · X-Azoth-On-Behalf-Of · X-Azoth-Locale · X-Azoth-Alternative · X-Azoth-Refusal-Ref · Idempotency-Keyprovider (obligatoire) · model (obligatoire) · messages (obligatoire) · temperature · maxTokens · stream · useCache · task · cachePolicy · agentId · workflowId · fallbackProviders · azureEndpoint · azureDeployment · ollamaBaseUrl · onApprovalRequired · azoth_sources200 · 202 human_review_required · 400 validation_failed, invalid_decision_ref, invalid_on_behalf_of, invalid_alternative, alternative_not_offered, alternative_mismatch, invalid_refusal_ref, human_identity_required, idempotency_key_invalid · 401 api_key_missing, api_key_invalid · 402 budget_exceeded, ai_ops_limit_exceeded, sealed_decisions_limit_reached · 403 api_key_scope_denied, policy_blocked, usecase_unresolved, usecase_not_approved, usecase_prohibited, usecase_archived, usecase_divergence, mandate_suspended, mandate_expired, kill_switch_active, jurisdiction_blocked, sovereignty_blocked, secnumcloud_blocked, egress_blocked, ollama_endpoint_missing, ollama_endpoint_not_declared, data_exfiltration_blocked, redaction_failed, human_review_not_resumable, on_behalf_of_not_allowed, ungrounded_answer · 409 idempotency_key_in_progress, idempotency_replay_unavailable · 422 endpoint_url_not_allowed, azure_endpoint_not_allowed, azure_config_required, invalid_azure_deployment, provider_not_connected, provider_key_rejected, provider_permission_denied, provider_model_not_found, provider_payment_required, provider_request_too_large, provider_request_rejected, idempotency_key_reused · 428 exhaustion_challenge_required · 429 exhaustion_slow, exhaustion_blocked, tenant_concurrency_limit, loop_detected · 500 internal_error · 502 provider_failure, provider_rate_limited · 503 governance_error, kill_switch_unavailable, budget_unavailable, identity_unavailable, service_unavailable/api/v1/infer
POST /api/v1/infer/resume
Run a held call once a reviewer approved it
inference:writeapproval_request_idapproval_request_id (obligatoire)200 · 400 validation_failed · 401 api_key_missing, api_key_invalid · 402 budget_exceeded, ai_ops_limit_exceeded, sealed_decisions_limit_reached · 403 api_key_scope_denied, not_requester, rejected, policy_blocked, usecase_not_approved, usecase_prohibited, usecase_archived, mandate_suspended, mandate_expired, kill_switch_active, jurisdiction_blocked, sovereignty_blocked, egress_blocked · 404 not_found · 409 pending, already_executed · 410 approval_expired · 422 provider_not_supported, provider_not_connected, provider_key_rejected, provider_permission_denied, provider_model_not_found, provider_payment_required, provider_request_too_large, provider_request_rejected · 429 · 500 internal_error · 502 provider_failure, provider_rate_limited · 503 governance_error, kill_switch_unavailable, provider_key_storage_unavailable, service_unavailablePOST /api/v1/infer/preflight
Score whether a request needs a model call at all
advisory:readFEATURE_IAE.connectorId · request200 · 400 validation_failed · 401 api_key_missing, api_key_invalid · 403 api_key_scope_denied, api_key_role_denied, ip_not_allowed · 413 validation_failed · 429 · 500 internal_error · 501 feature_disabled/api/v1/models
GET /api/v1/models/defaults
Which model a first call can use, per provider
advisory:read200 · 401 api_key_missing, api_key_invalid · 403 api_key_scope_denied, api_key_role_denied, ip_not_allowed · 429 · 500 internal_error/api/v1/exceptions
POST /api/v1/exceptions
Ask the rule's owner for a time-limited exception to a refusal
inference:writeFEATURE_HELPFUL_REFUSALS.refusal_ref (obligatoire) · justification (obligatoire) · duration_days · requester_label200 · 201 · 400 validation_failed, invalid_refusal_ref, not_exceptionable, no_identity, duration_exceeds_ceiling, incident_containment · 401 api_key_missing, api_key_invalid · 403 api_key_scope_denied, api_key_role_denied, ip_not_allowed, plan_required · 404 rule_not_found · 409 capability_off · 429 · 500 internal_error · 501 feature_disabled · 503 service_unavailableGET /api/v1/exceptions/{id}
Where an exception this key asked for stands
inference:writeFEATURE_HELPFUL_REFUSALS.id (obligatoire)200 · 400 validation_failed · 401 api_key_missing, api_key_invalid · 403 api_key_scope_denied, api_key_role_denied, ip_not_allowed, plan_required · 404 not_found · 500 internal_error · 501 feature_disabled · 503 service_unavailable/api/v1/grounding
POST /api/v1/grounding/release
Fetch a high-stakes answer the grounding check held, once approved
inference:writeFEATURE_GROUNDING_CHECK.approval_request_id (obligatoire)200 · 400 validation_failed · 401 api_key_missing, api_key_invalid · 403 rejected, api_key_scope_denied · 404 not_found · 409 pending, already_released · 410 approval_expired · 429 · 500 internal_error · 501 feature_disabled · 503 service_unavailablePOST /api/v1/grounding/receipts
Seal the receipt of a grounding check run on your side
inference:writeFEATURE_GROUNDING_CHECK.traceId (obligatoire) · claims (obligatoire) · supported (obligatoire) · judgeVersion (obligatoire) · claimsVersion (obligatoire) · sourcesHash (obligatoire) · sourceCount (obligatoire) · latencyMs · usecaseId202 · 400 validation_failed · 401 api_key_missing, api_key_invalid · 403 api_key_scope_denied, api_key_role_denied, ip_not_allowed, plan_required · 404 usecase_not_found · 409 capability_off · 429 · 500 internal_error · 501 feature_disabled · 503 service_unavailable/api/v1/vault
POST /api/v1/vault/receipts
Seal the receipt of a call kept in your own vault
inference:writeFEATURE_CLIENT_VAULT.X-Azoth-Decision-ReftraceId (obligatoire) · plaintextHash (obligatoire) · ciphertextHash (obligatoire) · keyId202 · 400 validation_failed, invalid_decision_ref · 401 api_key_missing, api_key_invalid · 403 api_key_scope_denied, api_key_role_denied, ip_not_allowed · 429 · 500 internal_error · 501 feature_disabled