{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/axonflow/json-schema/axonflow-hitlcreate-request-schema.json",
  "title": "HITLCreateRequest",
  "description": "Body for POST /api/v1/hitl/queue. Org/tenant identity comes from the\n`X-Org-ID` / `X-Tenant-ID` headers, not the body. Source of truth:\n`platform/agent/hitl/handler.go` (CreateRequestInput).\n",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/axonflow-hitl-api-openapi.yml#/components/schemas/HITLCreateRequest",
  "type": "object",
  "required": [
    "client_id",
    "original_query",
    "request_type",
    "triggered_policy_id",
    "triggered_policy_name",
    "trigger_reason"
  ],
  "properties": {
    "client_id": {
      "type": "string"
    },
    "user_id": {
      "type": "string"
    },
    "original_query": {
      "type": "string",
      "description": "The query/action awaiting human review"
    },
    "request_type": {
      "type": "string",
      "description": "Request classification (e.g. `mcp_query`, `llm_chat`)"
    },
    "request_context": {
      "type": "object",
      "additionalProperties": true
    },
    "triggered_policy_id": {
      "type": "string"
    },
    "triggered_policy_name": {
      "type": "string"
    },
    "trigger_reason": {
      "type": "string"
    },
    "severity": {
      "type": "string",
      "enum": [
        "low",
        "medium",
        "high",
        "critical"
      ]
    },
    "eu_ai_act_article": {
      "type": "string"
    },
    "compliance_framework": {
      "type": "string"
    },
    "risk_classification": {
      "type": "string"
    },
    "expires_in_seconds": {
      "type": "integer",
      "description": "TTL before the request auto-expires"
    },
    "notify_url": {
      "type": "string",
      "format": "uri",
      "description": "Optional outbound webhook URL fired asynchronously after the request\ntransitions to a terminal state (approved / rejected / overridden /\nexpired). Must use `https://` or `http://`. The platform signs the\nenvelope with HMAC-SHA256 over the body keyed by the deployment's\n`AXONFLOW_HITL_WEBHOOK_SIGNING_KEY`, sent as\n`X-AxonFlow-Signature: sha256=<hex>`. See the HITLWebhookEnvelope\nschema and `docs.getaxonflow.com/docs/governance/hitl` for the full\nshape + verification recipe.\n"
    }
  }
}