# استدعاءات البوابة

استدعاء نموذج عبر البوابة المحكومة — وما يحيط بالاستدعاء: هل يحتاج إلى نموذج، والنموذج الذي يمكن لأول استدعاء استخدامه، واستئناف استدعاء معلّق، وطلب استثناء، والتحقق من الاستناد، وإيصالات خزنتك الخاصة.

[مرجع واجهة API كاملًا](https://www.azothos.ai/ar/docs/api)

> ملخصات المسارات وأسماء الحقول مكتوبة بالإنجليزية، هنا وفي الملف.

## /api/v1/chat

### POST /api/v1/chat/completions

The governed gateway, OpenAI-compatible

- **المصادقة** — مفتاح API
- **نطاق المفتاح** — `inference:write`
- **الترويسات** — `X-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-Key`
- **الجسم** — `model` (إلزامي) · `messages` (إلزامي) · `temperature` · `max_tokens` · `stream` · `azoth_use_cache` · `azoth_task` · `azoth_cache_policy` · `azoth_agent_id` · `azoth_workflow_id` · `azoth_compute_os` · `azoth_sources`
- **الإجابات** — `200` · `202` [human_review_required](https://www.azothos.ai/ar/docs/errors#human_review_required) · `400` [validation_failed](https://www.azothos.ai/ar/docs/errors#validation_failed), [invalid_decision_ref](https://www.azothos.ai/ar/docs/errors#invalid_decision_ref), [invalid_on_behalf_of](https://www.azothos.ai/ar/docs/errors#invalid_on_behalf_of), [invalid_alternative](https://www.azothos.ai/ar/docs/errors#invalid_alternative), [alternative_not_offered](https://www.azothos.ai/ar/docs/errors#alternative_not_offered), [alternative_mismatch](https://www.azothos.ai/ar/docs/errors#alternative_mismatch), [invalid_refusal_ref](https://www.azothos.ai/ar/docs/errors#invalid_refusal_ref), [human_identity_required](https://www.azothos.ai/ar/docs/errors#human_identity_required), [idempotency_key_invalid](https://www.azothos.ai/ar/docs/errors#idempotency_key_invalid) · `401` [api_key_missing](https://www.azothos.ai/ar/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/ar/docs/errors#api_key_invalid) · `402` [budget_exceeded](https://www.azothos.ai/ar/docs/errors#budget_exceeded), [ai_ops_limit_exceeded](https://www.azothos.ai/ar/docs/errors#ai_ops_limit_exceeded), [sealed_decisions_limit_reached](https://www.azothos.ai/ar/docs/errors#sealed_decisions_limit_reached), [trial_exhausted](https://www.azothos.ai/ar/docs/errors#trial_exhausted) · `403` [api_key_scope_denied](https://www.azothos.ai/ar/docs/errors#api_key_scope_denied), [policy_blocked](https://www.azothos.ai/ar/docs/errors#policy_blocked), [usecase_unresolved](https://www.azothos.ai/ar/docs/errors#usecase_unresolved), [usecase_not_approved](https://www.azothos.ai/ar/docs/errors#usecase_not_approved), [usecase_prohibited](https://www.azothos.ai/ar/docs/errors#usecase_prohibited), [usecase_archived](https://www.azothos.ai/ar/docs/errors#usecase_archived), [usecase_divergence](https://www.azothos.ai/ar/docs/errors#usecase_divergence), [mandate_suspended](https://www.azothos.ai/ar/docs/errors#mandate_suspended), [mandate_expired](https://www.azothos.ai/ar/docs/errors#mandate_expired), [kill_switch_active](https://www.azothos.ai/ar/docs/errors#kill_switch_active), [jurisdiction_blocked](https://www.azothos.ai/ar/docs/errors#jurisdiction_blocked), [sovereignty_blocked](https://www.azothos.ai/ar/docs/errors#sovereignty_blocked), [secnumcloud_blocked](https://www.azothos.ai/ar/docs/errors#secnumcloud_blocked), [egress_blocked](https://www.azothos.ai/ar/docs/errors#egress_blocked), [data_exfiltration_blocked](https://www.azothos.ai/ar/docs/errors#data_exfiltration_blocked), [redaction_failed](https://www.azothos.ai/ar/docs/errors#redaction_failed), [human_review_not_resumable](https://www.azothos.ai/ar/docs/errors#human_review_not_resumable), [on_behalf_of_not_allowed](https://www.azothos.ai/ar/docs/errors#on_behalf_of_not_allowed), [ungrounded_answer](https://www.azothos.ai/ar/docs/errors#ungrounded_answer) · `409` [idempotency_key_in_progress](https://www.azothos.ai/ar/docs/errors#idempotency_key_in_progress), [idempotency_replay_unavailable](https://www.azothos.ai/ar/docs/errors#idempotency_replay_unavailable) · `422` [provider_not_connected](https://www.azothos.ai/ar/docs/errors#provider_not_connected), [provider_key_rejected](https://www.azothos.ai/ar/docs/errors#provider_key_rejected), [provider_permission_denied](https://www.azothos.ai/ar/docs/errors#provider_permission_denied), [provider_model_not_found](https://www.azothos.ai/ar/docs/errors#provider_model_not_found), [provider_payment_required](https://www.azothos.ai/ar/docs/errors#provider_payment_required), [provider_request_too_large](https://www.azothos.ai/ar/docs/errors#provider_request_too_large), [provider_request_rejected](https://www.azothos.ai/ar/docs/errors#provider_request_rejected), [provider_not_supported](https://www.azothos.ai/ar/docs/errors#provider_not_supported), [onboarding_no_provider](https://www.azothos.ai/ar/docs/errors#onboarding_no_provider), [trial_unavailable](https://www.azothos.ai/ar/docs/errors#trial_unavailable), [trial_limits_exceeded](https://www.azothos.ai/ar/docs/errors#trial_limits_exceeded), [idempotency_key_reused](https://www.azothos.ai/ar/docs/errors#idempotency_key_reused) · `428` [exhaustion_challenge_required](https://www.azothos.ai/ar/docs/errors#exhaustion_challenge_required) · `429` [exhaustion_slow](https://www.azothos.ai/ar/docs/errors#exhaustion_slow), [exhaustion_blocked](https://www.azothos.ai/ar/docs/errors#exhaustion_blocked), [tenant_concurrency_limit](https://www.azothos.ai/ar/docs/errors#tenant_concurrency_limit), [loop_detected](https://www.azothos.ai/ar/docs/errors#loop_detected) · `500` [internal_error](https://www.azothos.ai/ar/docs/errors#internal_error) · `502` [provider_failure](https://www.azothos.ai/ar/docs/errors#provider_failure), [provider_rate_limited](https://www.azothos.ai/ar/docs/errors#provider_rate_limited) · `503` [governance_error](https://www.azothos.ai/ar/docs/errors#governance_error), [kill_switch_unavailable](https://www.azothos.ai/ar/docs/errors#kill_switch_unavailable), [budget_unavailable](https://www.azothos.ai/ar/docs/errors#budget_unavailable), [identity_unavailable](https://www.azothos.ai/ar/docs/errors#identity_unavailable), [service_unavailable](https://www.azothos.ai/ar/docs/errors#service_unavailable)

### POST /api/v1/chat

The governed gateway with an explicit provider, fallbacks and streaming

- **المصادقة** — مفتاح API
- **نطاق المفتاح** — `inference:write`
- **الترويسات** — `X-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-Key`
- **الجسم** — `provider` (إلزامي) · `model` (إلزامي) · `messages` (إلزامي) · `temperature` · `maxTokens` · `stream` · `useCache` · `task` · `cachePolicy` · `agentId` · `workflowId` · `fallbackProviders` · `azureEndpoint` · `azureDeployment` · `ollamaBaseUrl` · `onApprovalRequired` · `azoth_sources`
- **الإجابات** — `200` · `202` [human_review_required](https://www.azothos.ai/ar/docs/errors#human_review_required) · `400` [validation_failed](https://www.azothos.ai/ar/docs/errors#validation_failed), [invalid_decision_ref](https://www.azothos.ai/ar/docs/errors#invalid_decision_ref), [invalid_on_behalf_of](https://www.azothos.ai/ar/docs/errors#invalid_on_behalf_of), [invalid_alternative](https://www.azothos.ai/ar/docs/errors#invalid_alternative), [alternative_not_offered](https://www.azothos.ai/ar/docs/errors#alternative_not_offered), [alternative_mismatch](https://www.azothos.ai/ar/docs/errors#alternative_mismatch), [invalid_refusal_ref](https://www.azothos.ai/ar/docs/errors#invalid_refusal_ref), [human_identity_required](https://www.azothos.ai/ar/docs/errors#human_identity_required), [idempotency_key_invalid](https://www.azothos.ai/ar/docs/errors#idempotency_key_invalid) · `401` [api_key_missing](https://www.azothos.ai/ar/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/ar/docs/errors#api_key_invalid) · `402` [budget_exceeded](https://www.azothos.ai/ar/docs/errors#budget_exceeded), [ai_ops_limit_exceeded](https://www.azothos.ai/ar/docs/errors#ai_ops_limit_exceeded), [sealed_decisions_limit_reached](https://www.azothos.ai/ar/docs/errors#sealed_decisions_limit_reached) · `403` [api_key_scope_denied](https://www.azothos.ai/ar/docs/errors#api_key_scope_denied), [policy_blocked](https://www.azothos.ai/ar/docs/errors#policy_blocked), [usecase_unresolved](https://www.azothos.ai/ar/docs/errors#usecase_unresolved), [usecase_not_approved](https://www.azothos.ai/ar/docs/errors#usecase_not_approved), [usecase_prohibited](https://www.azothos.ai/ar/docs/errors#usecase_prohibited), [usecase_archived](https://www.azothos.ai/ar/docs/errors#usecase_archived), [usecase_divergence](https://www.azothos.ai/ar/docs/errors#usecase_divergence), [mandate_suspended](https://www.azothos.ai/ar/docs/errors#mandate_suspended), [mandate_expired](https://www.azothos.ai/ar/docs/errors#mandate_expired), [kill_switch_active](https://www.azothos.ai/ar/docs/errors#kill_switch_active), [jurisdiction_blocked](https://www.azothos.ai/ar/docs/errors#jurisdiction_blocked), [sovereignty_blocked](https://www.azothos.ai/ar/docs/errors#sovereignty_blocked), [secnumcloud_blocked](https://www.azothos.ai/ar/docs/errors#secnumcloud_blocked), [egress_blocked](https://www.azothos.ai/ar/docs/errors#egress_blocked), [ollama_endpoint_missing](https://www.azothos.ai/ar/docs/errors#ollama_endpoint_missing), [ollama_endpoint_not_declared](https://www.azothos.ai/ar/docs/errors#ollama_endpoint_not_declared), [data_exfiltration_blocked](https://www.azothos.ai/ar/docs/errors#data_exfiltration_blocked), [redaction_failed](https://www.azothos.ai/ar/docs/errors#redaction_failed), [human_review_not_resumable](https://www.azothos.ai/ar/docs/errors#human_review_not_resumable), [on_behalf_of_not_allowed](https://www.azothos.ai/ar/docs/errors#on_behalf_of_not_allowed), [ungrounded_answer](https://www.azothos.ai/ar/docs/errors#ungrounded_answer) · `409` [idempotency_key_in_progress](https://www.azothos.ai/ar/docs/errors#idempotency_key_in_progress), [idempotency_replay_unavailable](https://www.azothos.ai/ar/docs/errors#idempotency_replay_unavailable) · `422` [endpoint_url_not_allowed](https://www.azothos.ai/ar/docs/errors#endpoint_url_not_allowed), [azure_endpoint_not_allowed](https://www.azothos.ai/ar/docs/errors#azure_endpoint_not_allowed), [azure_config_required](https://www.azothos.ai/ar/docs/errors#azure_config_required), [invalid_azure_deployment](https://www.azothos.ai/ar/docs/errors#invalid_azure_deployment), [provider_not_connected](https://www.azothos.ai/ar/docs/errors#provider_not_connected), [provider_key_rejected](https://www.azothos.ai/ar/docs/errors#provider_key_rejected), [provider_permission_denied](https://www.azothos.ai/ar/docs/errors#provider_permission_denied), [provider_model_not_found](https://www.azothos.ai/ar/docs/errors#provider_model_not_found), [provider_payment_required](https://www.azothos.ai/ar/docs/errors#provider_payment_required), [provider_request_too_large](https://www.azothos.ai/ar/docs/errors#provider_request_too_large), [provider_request_rejected](https://www.azothos.ai/ar/docs/errors#provider_request_rejected), [idempotency_key_reused](https://www.azothos.ai/ar/docs/errors#idempotency_key_reused) · `428` [exhaustion_challenge_required](https://www.azothos.ai/ar/docs/errors#exhaustion_challenge_required) · `429` [exhaustion_slow](https://www.azothos.ai/ar/docs/errors#exhaustion_slow), [exhaustion_blocked](https://www.azothos.ai/ar/docs/errors#exhaustion_blocked), [tenant_concurrency_limit](https://www.azothos.ai/ar/docs/errors#tenant_concurrency_limit), [loop_detected](https://www.azothos.ai/ar/docs/errors#loop_detected) · `500` [internal_error](https://www.azothos.ai/ar/docs/errors#internal_error) · `502` [provider_failure](https://www.azothos.ai/ar/docs/errors#provider_failure), [provider_rate_limited](https://www.azothos.ai/ar/docs/errors#provider_rate_limited) · `503` [governance_error](https://www.azothos.ai/ar/docs/errors#governance_error), [kill_switch_unavailable](https://www.azothos.ai/ar/docs/errors#kill_switch_unavailable), [budget_unavailable](https://www.azothos.ai/ar/docs/errors#budget_unavailable), [identity_unavailable](https://www.azothos.ai/ar/docs/errors#identity_unavailable), [service_unavailable](https://www.azothos.ai/ar/docs/errors#service_unavailable)

## /api/v1/infer

### POST /api/v1/infer/resume

Run a held call once a reviewer approved it

- **المصادقة** — مفتاح API
- **نطاق المفتاح** — `inference:write`
- **المعاملات** — `approval_request_id`
- **الجسم** — `approval_request_id` (إلزامي)
- **الإجابات** — `200` · `400` [validation_failed](https://www.azothos.ai/ar/docs/errors#validation_failed) · `401` [api_key_missing](https://www.azothos.ai/ar/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/ar/docs/errors#api_key_invalid) · `402` [budget_exceeded](https://www.azothos.ai/ar/docs/errors#budget_exceeded), [ai_ops_limit_exceeded](https://www.azothos.ai/ar/docs/errors#ai_ops_limit_exceeded), [sealed_decisions_limit_reached](https://www.azothos.ai/ar/docs/errors#sealed_decisions_limit_reached) · `403` [api_key_scope_denied](https://www.azothos.ai/ar/docs/errors#api_key_scope_denied), [not_requester](https://www.azothos.ai/ar/docs/errors#not_requester), [rejected](https://www.azothos.ai/ar/docs/errors#rejected), [policy_blocked](https://www.azothos.ai/ar/docs/errors#policy_blocked), [usecase_not_approved](https://www.azothos.ai/ar/docs/errors#usecase_not_approved), [usecase_prohibited](https://www.azothos.ai/ar/docs/errors#usecase_prohibited), [usecase_archived](https://www.azothos.ai/ar/docs/errors#usecase_archived), [mandate_suspended](https://www.azothos.ai/ar/docs/errors#mandate_suspended), [mandate_expired](https://www.azothos.ai/ar/docs/errors#mandate_expired), [kill_switch_active](https://www.azothos.ai/ar/docs/errors#kill_switch_active), [jurisdiction_blocked](https://www.azothos.ai/ar/docs/errors#jurisdiction_blocked), [sovereignty_blocked](https://www.azothos.ai/ar/docs/errors#sovereignty_blocked), [egress_blocked](https://www.azothos.ai/ar/docs/errors#egress_blocked) · `404` [not_found](https://www.azothos.ai/ar/docs/errors#not_found) · `409` [pending](https://www.azothos.ai/ar/docs/errors#pending), [already_executed](https://www.azothos.ai/ar/docs/errors#already_executed) · `410` [approval_expired](https://www.azothos.ai/ar/docs/errors#approval_expired) · `422` [provider_not_supported](https://www.azothos.ai/ar/docs/errors#provider_not_supported), [provider_not_connected](https://www.azothos.ai/ar/docs/errors#provider_not_connected), [provider_key_rejected](https://www.azothos.ai/ar/docs/errors#provider_key_rejected), [provider_permission_denied](https://www.azothos.ai/ar/docs/errors#provider_permission_denied), [provider_model_not_found](https://www.azothos.ai/ar/docs/errors#provider_model_not_found), [provider_payment_required](https://www.azothos.ai/ar/docs/errors#provider_payment_required), [provider_request_too_large](https://www.azothos.ai/ar/docs/errors#provider_request_too_large), [provider_request_rejected](https://www.azothos.ai/ar/docs/errors#provider_request_rejected) · `429` · `500` [internal_error](https://www.azothos.ai/ar/docs/errors#internal_error) · `502` [provider_failure](https://www.azothos.ai/ar/docs/errors#provider_failure), [provider_rate_limited](https://www.azothos.ai/ar/docs/errors#provider_rate_limited) · `503` [governance_error](https://www.azothos.ai/ar/docs/errors#governance_error), [kill_switch_unavailable](https://www.azothos.ai/ar/docs/errors#kill_switch_unavailable), [provider_key_storage_unavailable](https://www.azothos.ai/ar/docs/errors#provider_key_storage_unavailable), [service_unavailable](https://www.azothos.ai/ar/docs/errors#service_unavailable)

### POST /api/v1/infer/preflight

Score whether a request needs a model call at all

- **المصادقة** — مفتاح API
- **نطاق المفتاح** — `advisory:read`
- **الوحدة** — متاح حيث يشغّل النشر `FEATURE_IAE`.
- **الجسم** — `connectorId` · `request`
- **الإجابات** — `200` · `400` [validation_failed](https://www.azothos.ai/ar/docs/errors#validation_failed) · `401` [api_key_missing](https://www.azothos.ai/ar/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/ar/docs/errors#api_key_invalid) · `403` [api_key_scope_denied](https://www.azothos.ai/ar/docs/errors#api_key_scope_denied), [api_key_role_denied](https://www.azothos.ai/ar/docs/errors#api_key_role_denied), [ip_not_allowed](https://www.azothos.ai/ar/docs/errors#ip_not_allowed) · `413` [validation_failed](https://www.azothos.ai/ar/docs/errors#validation_failed) · `429` · `500` [internal_error](https://www.azothos.ai/ar/docs/errors#internal_error) · `501` [feature_disabled](https://www.azothos.ai/ar/docs/errors#feature_disabled)

## /api/v1/models

### GET /api/v1/models/defaults

Which model a first call can use, per provider

- **المصادقة** — مفتاح API
- **نطاق المفتاح** — `advisory:read`
- **الإجابات** — `200` · `401` [api_key_missing](https://www.azothos.ai/ar/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/ar/docs/errors#api_key_invalid) · `403` [api_key_scope_denied](https://www.azothos.ai/ar/docs/errors#api_key_scope_denied), [api_key_role_denied](https://www.azothos.ai/ar/docs/errors#api_key_role_denied), [ip_not_allowed](https://www.azothos.ai/ar/docs/errors#ip_not_allowed) · `429` · `500` [internal_error](https://www.azothos.ai/ar/docs/errors#internal_error)

## /api/v1/exceptions

### POST /api/v1/exceptions

Ask the rule's owner for a time-limited exception to a refusal

- **المصادقة** — مفتاح API
- **نطاق المفتاح** — `inference:write`
- **الوحدة** — متاح حيث يشغّل النشر `FEATURE_HELPFUL_REFUSALS`.
- **الجسم** — `refusal_ref` (إلزامي) · `justification` (إلزامي) · `duration_days` · `requester_label`
- **الإجابات** — `200` · `201` · `400` [validation_failed](https://www.azothos.ai/ar/docs/errors#validation_failed), [invalid_refusal_ref](https://www.azothos.ai/ar/docs/errors#invalid_refusal_ref), [not_exceptionable](https://www.azothos.ai/ar/docs/errors#not_exceptionable), [no_identity](https://www.azothos.ai/ar/docs/errors#no_identity), [duration_exceeds_ceiling](https://www.azothos.ai/ar/docs/errors#duration_exceeds_ceiling), [incident_containment](https://www.azothos.ai/ar/docs/errors#incident_containment) · `401` [api_key_missing](https://www.azothos.ai/ar/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/ar/docs/errors#api_key_invalid) · `403` [api_key_scope_denied](https://www.azothos.ai/ar/docs/errors#api_key_scope_denied), [api_key_role_denied](https://www.azothos.ai/ar/docs/errors#api_key_role_denied), [ip_not_allowed](https://www.azothos.ai/ar/docs/errors#ip_not_allowed), [plan_required](https://www.azothos.ai/ar/docs/errors#plan_required) · `404` [rule_not_found](https://www.azothos.ai/ar/docs/errors#rule_not_found) · `409` [capability_off](https://www.azothos.ai/ar/docs/errors#capability_off) · `429` · `500` [internal_error](https://www.azothos.ai/ar/docs/errors#internal_error) · `501` [feature_disabled](https://www.azothos.ai/ar/docs/errors#feature_disabled) · `503` [service_unavailable](https://www.azothos.ai/ar/docs/errors#service_unavailable)

### GET /api/v1/exceptions/{id}

Where an exception this key asked for stands

- **المصادقة** — مفتاح API
- **نطاق المفتاح** — `inference:write`
- **الوحدة** — متاح حيث يشغّل النشر `FEATURE_HELPFUL_REFUSALS`.
- **المعاملات** — `id` (إلزامي)
- **الإجابات** — `200` · `400` [validation_failed](https://www.azothos.ai/ar/docs/errors#validation_failed) · `401` [api_key_missing](https://www.azothos.ai/ar/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/ar/docs/errors#api_key_invalid) · `403` [api_key_scope_denied](https://www.azothos.ai/ar/docs/errors#api_key_scope_denied), [api_key_role_denied](https://www.azothos.ai/ar/docs/errors#api_key_role_denied), [ip_not_allowed](https://www.azothos.ai/ar/docs/errors#ip_not_allowed), [plan_required](https://www.azothos.ai/ar/docs/errors#plan_required) · `404` [not_found](https://www.azothos.ai/ar/docs/errors#not_found) · `500` [internal_error](https://www.azothos.ai/ar/docs/errors#internal_error) · `501` [feature_disabled](https://www.azothos.ai/ar/docs/errors#feature_disabled) · `503` [service_unavailable](https://www.azothos.ai/ar/docs/errors#service_unavailable)

## /api/v1/grounding

### POST /api/v1/grounding/release

Fetch a high-stakes answer the grounding check held, once approved

- **المصادقة** — مفتاح API
- **نطاق المفتاح** — `inference:write`
- **الوحدة** — متاح حيث يشغّل النشر `FEATURE_GROUNDING_CHECK`.
- **الجسم** — `approval_request_id` (إلزامي)
- **الإجابات** — `200` · `400` [validation_failed](https://www.azothos.ai/ar/docs/errors#validation_failed) · `401` [api_key_missing](https://www.azothos.ai/ar/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/ar/docs/errors#api_key_invalid) · `403` [rejected](https://www.azothos.ai/ar/docs/errors#rejected), [api_key_scope_denied](https://www.azothos.ai/ar/docs/errors#api_key_scope_denied) · `404` [not_found](https://www.azothos.ai/ar/docs/errors#not_found) · `409` [pending](https://www.azothos.ai/ar/docs/errors#pending), [already_released](https://www.azothos.ai/ar/docs/errors#already_released) · `410` [approval_expired](https://www.azothos.ai/ar/docs/errors#approval_expired) · `429` · `500` [internal_error](https://www.azothos.ai/ar/docs/errors#internal_error) · `501` [feature_disabled](https://www.azothos.ai/ar/docs/errors#feature_disabled) · `503` [service_unavailable](https://www.azothos.ai/ar/docs/errors#service_unavailable)

### POST /api/v1/grounding/receipts

Seal the receipt of a grounding check run on your side

- **المصادقة** — مفتاح API
- **نطاق المفتاح** — `inference:write`
- **الوحدة** — متاح حيث يشغّل النشر `FEATURE_GROUNDING_CHECK`.
- **الجسم** — `traceId` (إلزامي) · `claims` (إلزامي) · `supported` (إلزامي) · `judgeVersion` (إلزامي) · `claimsVersion` (إلزامي) · `sourcesHash` (إلزامي) · `sourceCount` (إلزامي) · `latencyMs` · `usecaseId`
- **الإجابات** — `202` · `400` [validation_failed](https://www.azothos.ai/ar/docs/errors#validation_failed) · `401` [api_key_missing](https://www.azothos.ai/ar/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/ar/docs/errors#api_key_invalid) · `403` [api_key_scope_denied](https://www.azothos.ai/ar/docs/errors#api_key_scope_denied), [api_key_role_denied](https://www.azothos.ai/ar/docs/errors#api_key_role_denied), [ip_not_allowed](https://www.azothos.ai/ar/docs/errors#ip_not_allowed), [plan_required](https://www.azothos.ai/ar/docs/errors#plan_required) · `404` [usecase_not_found](https://www.azothos.ai/ar/docs/errors#usecase_not_found) · `409` [capability_off](https://www.azothos.ai/ar/docs/errors#capability_off) · `429` · `500` [internal_error](https://www.azothos.ai/ar/docs/errors#internal_error) · `501` [feature_disabled](https://www.azothos.ai/ar/docs/errors#feature_disabled) · `503` [service_unavailable](https://www.azothos.ai/ar/docs/errors#service_unavailable)

## /api/v1/vault

### POST /api/v1/vault/receipts

Seal the receipt of a call kept in your own vault

- **المصادقة** — مفتاح API
- **نطاق المفتاح** — `inference:write`
- **الوحدة** — متاح حيث يشغّل النشر `FEATURE_CLIENT_VAULT`.
- **الترويسات** — `X-Azoth-Decision-Ref`
- **الجسم** — `traceId` (إلزامي) · `plaintextHash` (إلزامي) · `ciphertextHash` (إلزامي) · `keyId`
- **الإجابات** — `202` · `400` [validation_failed](https://www.azothos.ai/ar/docs/errors#validation_failed), [invalid_decision_ref](https://www.azothos.ai/ar/docs/errors#invalid_decision_ref) · `401` [api_key_missing](https://www.azothos.ai/ar/docs/errors#api_key_missing), [api_key_invalid](https://www.azothos.ai/ar/docs/errors#api_key_invalid) · `403` [api_key_scope_denied](https://www.azothos.ai/ar/docs/errors#api_key_scope_denied), [api_key_role_denied](https://www.azothos.ai/ar/docs/errors#api_key_role_denied), [ip_not_allowed](https://www.azothos.ai/ar/docs/errors#ip_not_allowed) · `429` · `500` [internal_error](https://www.azothos.ai/ar/docs/errors#internal_error) · `501` [feature_disabled](https://www.azothos.ai/ar/docs/errors#feature_disabled)
