{"openapi":"3.1.0","info":{"title":"GaaS — Governance as a Service","description":"Real-time governance layer for autonomous AI agents.","version":"0.2.17"},"paths":{"/status":{"get":{"tags":["status","status"],"summary":"Public status page","description":"Human-readable system health dashboard","operationId":"get_status_page_status_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/status/api":{"get":{"tags":["status","status"],"summary":"Status page data API","description":"JSON API for status page data (components, SLOs, uptime)","operationId":"get_status_api_status_api_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Status Api Status Api Get"}}}}}}},"/.well-known/gaas-audit-keys.json":{"get":{"tags":["a2a-discovery","a2a-discovery"],"summary":"Get Audit Keys","description":"The public key that signs Governance Proof Tokens and audit records, as a JWK Set.\n\nPublic: anyone checking a proof token offline needs it. Empty ``keys`` when signing is off.","operationId":"get_audit_keys__well_known_gaas_audit_keys_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/a2a/proxy/messages":{"post":{"tags":["a2a","a2a"],"summary":"Proxy Message","description":"Proxy an A2A message through GaaS governance.\n\n1. Evaluate the message against policies\n2. If approved, forward to the target agent\n3. Return the governance-wrapped result","operationId":"proxy_message_a2a_proxy_messages_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/_ProxyMessageBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/a2a/proxy/messages/shadow":{"post":{"tags":["a2a","a2a"],"summary":"Proxy Message Shadow","description":"Proxy in shadow mode — run governance but always forward.\n\nUsed during A2A onboarding to observe governance decisions\nwithout blocking traffic.","operationId":"proxy_message_shadow_a2a_proxy_messages_shadow_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/_ProxyMessageBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/a2a/proxy/agents/discover":{"post":{"tags":["a2a","a2a"],"summary":"Discover Agent","description":"Discover a remote A2A agent by URL.\n\nFetches the agent's /.well-known/agent.json and returns the Agent Card.","operationId":"discover_agent_a2a_proxy_agents_discover_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/.well-known/agent-card.json":{"get":{"tags":["A2A: Agent Card"],"summary":" Get Agent Card","description":"Returns the public AgentCard describing this agent's capabilities, supported transports, and skills.","operationId":"_get_agent_card__well_known_agent_card_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/a2a/v1":{"post":{"tags":["A2A: JSON-RPC"],"summary":"A2A JSON-RPC endpoint","description":"A2A JSON-RPC 2.0 endpoint. The `method` field selects the operation;\n`params` must match that method's schema (see the `oneOf` below).\n\n**Supported methods:**\n\n- `SendMessage` — Send a message to the agent (returns a Task or response Message).\n- `SendStreamingMessage` — Send a message and receive a Server-Sent Events stream.\n- `GetTask` — Fetch a task by ID.\n- `ListTasks` — List tasks with pagination and filtering.\n- `CancelTask` — Cancel an in-progress task.\n- `CreateTaskPushNotificationConfig` — Register a push-notification config on a task.\n- `GetTaskPushNotificationConfig` — Read a single push-notification config.\n- `ListTaskPushNotificationConfigs` — List all push-notification configs for a task.\n- `DeleteTaskPushNotificationConfig` — Delete a push-notification config.\n- `SubscribeToTask` — Subscribe to task events via Server-Sent Events.\n- `GetExtendedAgentCard` — Fetch the authenticated extended agent card.\n","operationId":"handle_requests_a2a_v1_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"requestBody":{"description":"A2A JSON-RPC 2.0 request","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/A2ARequest"}}}},"parameters":[{"in":"header","name":"A2A-Version","required":true,"schema":{"type":"string","enum":["1.0"]},"example":"1.0"}]}},"/a2a/v1/":{"post":{"tags":["A2A: JSON-RPC"],"summary":"A2A JSON-RPC endpoint","description":"A2A JSON-RPC 2.0 endpoint. The `method` field selects the operation;\n`params` must match that method's schema (see the `oneOf` below).\n\n**Supported methods:**\n\n- `SendMessage` — Send a message to the agent (returns a Task or response Message).\n- `SendStreamingMessage` — Send a message and receive a Server-Sent Events stream.\n- `GetTask` — Fetch a task by ID.\n- `ListTasks` — List tasks with pagination and filtering.\n- `CancelTask` — Cancel an in-progress task.\n- `CreateTaskPushNotificationConfig` — Register a push-notification config on a task.\n- `GetTaskPushNotificationConfig` — Read a single push-notification config.\n- `ListTaskPushNotificationConfigs` — List all push-notification configs for a task.\n- `DeleteTaskPushNotificationConfig` — Delete a push-notification config.\n- `SubscribeToTask` — Subscribe to task events via Server-Sent Events.\n- `GetExtendedAgentCard` — Fetch the authenticated extended agent card.\n","operationId":"handle_requests_a2a_v1__post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"requestBody":{"description":"A2A JSON-RPC 2.0 request","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/A2ARequest"}}}},"parameters":[{"in":"header","name":"A2A-Version","required":true,"schema":{"type":"string","enum":["1.0"]},"example":"1.0"}]}},"/internal/email/send":{"post":{"tags":["internal"],"summary":"Send Internal Email","description":"Dispatch an email via the Python EmailService from a trusted caller (BFF).","operationId":"send_internal_email_internal_email_send_post","parameters":[{"name":"x-internal-key","in":"header","required":true,"schema":{"type":"string","title":"X-Internal-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalEmailRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Send Internal Email Internal Email Send Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/approvals/{intent_id}":{"get":{"tags":["internal"],"summary":"Get Approval","description":"What the dashboard's approval page shows: what was blocked, why, and whether it is approved.","operationId":"get_approval_internal_approvals__intent_id__get","parameters":[{"name":"intent_id","in":"path","required":true,"schema":{"type":"string","title":"Intent Id"}},{"name":"org_id","in":"query","required":true,"schema":{"type":"string","maxLength":128,"title":"Org Id"}},{"name":"x-internal-key","in":"header","required":true,"schema":{"type":"string","title":"X-Internal-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Approval Internal Approvals  Intent Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["internal"],"summary":"Approve In Dashboard","description":"An operator or admin who signed in with two-factor approves a blocked action.","operationId":"approve_in_dashboard_internal_approvals__intent_id__post","parameters":[{"name":"intent_id","in":"path","required":true,"schema":{"type":"string","title":"Intent Id"}},{"name":"x-internal-key","in":"header","required":true,"schema":{"type":"string","title":"X-Internal-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DashboardApproval"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Approve In Dashboard Internal Approvals  Intent Id  Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/org/{org_id}/settings":{"get":{"tags":["internal"],"summary":"Get Org Settings","operationId":"get_org_settings_internal_org__org_id__settings_get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"x-internal-key","in":"header","required":true,"schema":{"type":"string","title":"X-Internal-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Org Settings Internal Org  Org Id  Settings Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["internal"],"summary":"Update Org Settings","description":"An admin who signed in with two-factor changes the organization's settings.","operationId":"update_org_settings_internal_org__org_id__settings_put","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"x-internal-key","in":"header","required":true,"schema":{"type":"string","title":"X-Internal-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrgSettingsUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Org Settings Internal Org  Org Id  Settings Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/org/{org_id}/context-endpoint":{"get":{"tags":["internal"],"summary":"Internal Get","operationId":"internal_get_internal_org__org_id__context_endpoint_get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"x-internal-key","in":"header","required":true,"schema":{"type":"string","title":"X-Internal-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Internal Get Internal Org  Org Id  Context Endpoint Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["internal"],"summary":"Internal Put","operationId":"internal_put_internal_org__org_id__context_endpoint_put","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"x-internal-key","in":"header","required":true,"schema":{"type":"string","title":"X-Internal-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalSettings"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Internal Put Internal Org  Org Id  Context Endpoint Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/org/{org_id}/context-endpoint/enabled":{"post":{"tags":["internal"],"summary":"Internal Enable","operationId":"internal_enable_internal_org__org_id__context_endpoint_enabled_post","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"x-internal-key","in":"header","required":true,"schema":{"type":"string","title":"X-Internal-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalEnable"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Internal Enable Internal Org  Org Id  Context Endpoint Enabled Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/org/{org_id}/context-endpoint/delete":{"post":{"tags":["internal"],"summary":"Internal Delete","operationId":"internal_delete_internal_org__org_id__context_endpoint_delete_post","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"x-internal-key","in":"header","required":true,"schema":{"type":"string","title":"X-Internal-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalActor"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Internal Delete Internal Org  Org Id  Context Endpoint Delete Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/org/{org_id}/context-endpoint/test":{"post":{"tags":["internal"],"summary":"Internal Test","operationId":"internal_test_internal_org__org_id__context_endpoint_test_post","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"x-internal-key","in":"header","required":true,"schema":{"type":"string","title":"X-Internal-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalActor"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Internal Test Internal Org  Org Id  Context Endpoint Test Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/org/{org_id}/context-endpoint/rotate-signing-secret":{"post":{"tags":["internal"],"summary":"Internal Rotate","operationId":"internal_rotate_internal_org__org_id__context_endpoint_rotate_signing_secret_post","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"x-internal-key","in":"header","required":true,"schema":{"type":"string","title":"X-Internal-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalActor"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Internal Rotate Internal Org  Org Id  Context Endpoint Rotate Signing Secret Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/health/live":{"get":{"tags":["health"],"summary":"Health Live","description":"Liveness probe — is the process alive?","operationId":"health_live_v1_health_live_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthLiveEnvelope"}}}}}}},"/v1/health/ready":{"get":{"tags":["health"],"summary":"Health Ready","description":"Readiness probe — can the service handle requests?","operationId":"health_ready_v1_health_ready_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthReadyEnvelope"}}}}}}},"/v1/health/startup":{"get":{"tags":["health"],"summary":"Health Startup","description":"Startup probe — has the service finished initializing?","operationId":"health_startup_v1_health_startup_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthStartupEnvelope"}}}}}}},"/v1/health":{"get":{"tags":["health"],"summary":"Health","description":"Backward-compatible health endpoint (sanitized errors).","operationId":"health_v1_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthEnvelope"}}}}}}},"/v1/intents":{"post":{"tags":["intents"],"summary":"Submit Intent","operationId":"submit_intent_v1_intents_post","parameters":[{"name":"mode","in":"query","required":false,"schema":{"type":"string","pattern":"^(live|shadow|test)$","default":"live","title":"Mode"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntentSubmission"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DecisionEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/intents/batch":{"post":{"tags":["intents"],"summary":"Submit Intent Batch","operationId":"submit_intent_batch_v1_intents_batch_post","parameters":[{"name":"mode","in":"query","required":false,"schema":{"type":"string","pattern":"^(live|shadow|test)$","default":"live","title":"Mode"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkIntentSubmission"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkDecisionEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/intents/{intent_id}/outcome":{"post":{"tags":["intents"],"summary":"Report Outcome","description":"Record what the caller actually did with a decision.\n\nStored in a side table — the audit record's execution block is inside\nthe hash chain and is never mutated. Executing against a BLOCK is a\ndeviation: logged, recorded in the agent's trust history, and — when\nthe org's membrane says deviation_action=suspend — the agent is\nsuspended, which pol_t1_017 enforces on its next intent.","operationId":"report_outcome_v1_intents__intent_id__outcome_post","parameters":[{"name":"intent_id","in":"path","required":true,"schema":{"type":"string","title":"Intent Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutcomeReport"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Report Outcome V1 Intents  Intent Id  Outcome Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/intents/{intent_id}/decision":{"get":{"tags":["intents"],"summary":"Get Decision","operationId":"get_decision_v1_intents__intent_id__decision_get","parameters":[{"name":"intent_id","in":"path","required":true,"schema":{"type":"string","title":"Intent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DecisionEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/intents/{intent_id}/audit":{"get":{"tags":["intents"],"summary":"Get Audit","operationId":"get_audit_v1_intents__intent_id__audit_get","parameters":[{"name":"intent_id","in":"path","required":true,"schema":{"type":"string","title":"Intent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/intents/{intent_id}/override":{"get":{"tags":["intents"],"summary":"Get Override","description":"Whether a person approved this blocked intent, and whether a retry has used the approval.\n\n``status`` is ``not_approved``, ``approved`` (a retry of the same action within the window is\napproved once), ``used`` or ``expired``. An agent polls this, then retries the same action once\nwith ``context_provided.prior_intents=[intent_id]`` (packages/api/overrides.py).","operationId":"get_override_v1_intents__intent_id__override_get","parameters":[{"name":"intent_id","in":"path","required":true,"schema":{"type":"string","title":"Intent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Override V1 Intents  Intent Id  Override Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/intents/{intent_id}/explanation":{"get":{"tags":["intents"],"summary":"Get plain-English explanation for a governance decision","description":"Returns the plain-English explanation Claude wrote for the governance decision on this intent, suitable for regulatory submissions, legal proceedings and compliance review. Explanations are generated after the verdict is returned, so the submitting agent never waits for one; they cover live-mode block, escalate and approve_modified decisions, and approve decisions with risk score >= 0.5, when GAAS_FEATURE_EXPLAIN_DECISIONS is enabled.\n\n- **200** — the explanation.\n- **202** — still being generated. Poll again after the `Retry-After` header (seconds); stop at `poll_until`.\n- **404** `not_found` — no decision for this intent, or no explanation will be produced; `error.details[0].reason` says why: `disabled`, `not_live`, `not_eligible` or `unavailable`.","operationId":"get_explanation_v1_intents__intent_id__explanation_get","parameters":[{"name":"intent_id","in":"path","required":true,"schema":{"type":"string","title":"Intent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GovernanceExplanationEnvelope"}}}},"202":{"description":"Explanation still being generated — poll again after Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExplanationPending"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/escalations/stats":{"get":{"tags":["escalations"],"summary":"Get Stats","operationId":"get_stats_v1_escalations_stats_get","parameters":[{"name":"period","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"default":30,"title":"Period"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EscalationStatsEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/escalations/pending":{"get":{"tags":["escalations"],"summary":"Get Pending","operationId":"get_pending_v1_escalations_pending_get","parameters":[{"name":"reviewer_id","in":"query","required":true,"schema":{"type":"string","title":"Reviewer Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PendingEscalationsEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/escalations/webhooks":{"get":{"tags":["escalations"],"summary":"List Webhooks","operationId":"list_webhooks_v1_escalations_webhooks_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookListEnvelope"}}}}}},"post":{"tags":["escalations"],"summary":"Register Webhook","operationId":"register_webhook_v1_escalations_webhooks_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookRegisterRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/escalations/webhooks/{webhook_id}":{"delete":{"tags":["escalations"],"summary":"Unregister Webhook","operationId":"unregister_webhook_v1_escalations_webhooks__webhook_id__delete","parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"string","title":"Webhook Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookUnregisteredEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/escalations/webhooks/deliveries/failed":{"get":{"tags":["escalations"],"summary":"List Failed Deliveries","description":"List all failed webhook deliveries (Dead Letter Queue).\n\nFailed deliveries can be manually retried using the retry endpoint.","operationId":"list_failed_deliveries_v1_escalations_webhooks_deliveries_failed_get","parameters":[{"name":"webhook_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by specific webhook","title":"Webhook Id"},"description":"Filter by specific webhook"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookDeliveriesEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/escalations/webhooks/deliveries/{delivery_id}/retry":{"post":{"tags":["escalations"],"summary":"Retry Webhook Delivery","description":"Manually retry a failed webhook delivery.\n\nOnly deliveries with status=FAILED can be retried.\nThe delivery will be re-sent with up to 3 retry attempts.\nA delivery that belongs to another organization's webhook is reported as\nnot found, exactly like a missing one.","operationId":"retry_webhook_delivery_v1_escalations_webhooks_deliveries__delivery_id__retry_post","parameters":[{"name":"delivery_id","in":"path","required":true,"schema":{"type":"string","title":"Delivery Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookRetryResultEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/escalations":{"get":{"tags":["escalations"],"summary":"List Escalations","operationId":"list_escalations_v1_escalations_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"assigned_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assigned To"}},{"name":"trigger_source","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trigger Source"}},{"name":"risk_min","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Risk Min"}},{"name":"risk_max","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Risk Max"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","default":"newest","title":"Sort"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EscalationListEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/escalations/{escalation_id}":{"get":{"tags":["escalations"],"summary":"Get Escalation","operationId":"get_escalation_v1_escalations__escalation_id__get","parameters":[{"name":"escalation_id","in":"path","required":true,"schema":{"type":"string","title":"Escalation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EscalationEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/escalations/{escalation_id}/context":{"get":{"tags":["escalations"],"summary":"Get Context","operationId":"get_context_v1_escalations__escalation_id__context_get","parameters":[{"name":"escalation_id","in":"path","required":true,"schema":{"type":"string","title":"Escalation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContextPackageEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/escalations/{escalation_id}/review":{"post":{"tags":["escalations"],"summary":"Submit Review","operationId":"submit_review_v1_escalations__escalation_id__review_post","parameters":[{"name":"escalation_id","in":"path","required":true,"schema":{"type":"string","title":"Escalation Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewSubmission"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewResultEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/escalations/{escalation_id}/reassign":{"post":{"tags":["escalations"],"summary":"Reassign Escalation","operationId":"reassign_escalation_v1_escalations__escalation_id__reassign_post","parameters":[{"name":"escalation_id","in":"path","required":true,"schema":{"type":"string","title":"Escalation Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReassignRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EscalationEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/escalations/{escalation_id}/cancel":{"post":{"tags":["escalations"],"summary":"Cancel Escalation","operationId":"cancel_escalation_v1_escalations__escalation_id__cancel_post","parameters":[{"name":"escalation_id","in":"path","required":true,"schema":{"type":"string","title":"Escalation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EscalationEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agents/{agent_id}/trust/reset":{"post":{"tags":["agent-trust"],"summary":"Reset an agent's session trust and behavioural profile","description":"Operator or admin. Returns the agent's trust budget to full (1.0) and clears its behavioural profile, so neither the session-trust policy (pol_t1_015) nor the anomaly policy (pol_security_001) blocks it on the strength of its past. Scoped to your organization.","operationId":"reset_agent_trust_v1_agents__agent_id__trust_reset_post","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/TrustResetRequest"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrustResetEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/learning/calibration":{"get":{"tags":["learning"],"summary":"Get Calibration","operationId":"get_calibration_v1_learning_calibration_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalibrationEnvelope"}}}}}}},"/v1/learning/calibration/history":{"get":{"tags":["learning"],"summary":"Get Calibration History","operationId":"get_calibration_history_v1_learning_calibration_history_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalibrationHistoryEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/learning/insights":{"get":{"tags":["learning"],"summary":"Get Insights","operationId":"get_insights_v1_learning_insights_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InsightListEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/learning/insights/{insight_id}":{"get":{"tags":["learning"],"summary":"Get Insight","operationId":"get_insight_v1_learning_insights__insight_id__get","parameters":[{"name":"insight_id","in":"path","required":true,"schema":{"type":"string","title":"Insight Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InsightEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/learning/incidents":{"post":{"tags":["learning"],"summary":"Report Incident","operationId":"report_incident_v1_learning_incidents_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IncidentSubmission"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordedEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/learning/feedback":{"post":{"tags":["learning"],"summary":"Submit Feedback","operationId":"submit_feedback_v1_learning_feedback_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackSubmission"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordedEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/learning/metrics":{"get":{"tags":["learning"],"summary":"Get Metrics","operationId":"get_metrics_v1_learning_metrics_get","parameters":[{"name":"period","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"default":90,"title":"Period"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LearningMetricsEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/learning/backtest":{"post":{"tags":["learning"],"summary":"Run Backtest","operationId":"run_backtest_v1_learning_backtest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BacktestRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BacktestResultEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/learning/ckb/updates":{"get":{"tags":["learning"],"summary":"Get Ckb Updates","description":"Return the caller's organization's Collective Knowledge Base updates: its insights and a\nsummary of its 7-day learning metrics.\n\nUntil 2026-10-06 this read every organization's observations, and it would have answered 500\nfor any insight: it read ``title``, ``description`` and ``created_at``, which ``Insight`` does\nnot have (an insight has ``summary`` and ``generated_at``).","operationId":"get_ckb_updates_v1_learning_ckb_updates_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CkbUpdatesEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/onboarding/intake":{"post":{"tags":["onboarding"],"summary":"Create Intake","operationId":"create_intake_v1_onboarding_intake_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntakeSubmission"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntakeEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/onboarding/intake/{intake_id}":{"get":{"tags":["onboarding"],"summary":"Get Intake","operationId":"get_intake_v1_onboarding_intake__intake_id__get","parameters":[{"name":"intake_id","in":"path","required":true,"schema":{"type":"string","title":"Intake Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntakeEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/onboarding/intake/{intake_id}/documents":{"post":{"tags":["onboarding"],"summary":"Upload Documents","operationId":"upload_documents_v1_onboarding_intake__intake_id__documents_post","parameters":[{"name":"intake_id","in":"path","required":true,"schema":{"type":"string","title":"Intake Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentUpload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentsReceivedEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/onboarding/intake/{intake_id}/process":{"post":{"tags":["onboarding"],"summary":"Process Intake","operationId":"process_intake_v1_onboarding_intake__intake_id__process_post","parameters":[{"name":"intake_id","in":"path","required":true,"schema":{"type":"string","title":"Intake Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProcessIntakeEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/membranes/current":{"get":{"tags":["onboarding"],"summary":"Get Current Membrane","description":"Return the active governance membrane for the authenticated org.","operationId":"get_current_membrane_v1_membranes_current_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrgMembraneEnvelope"}}}}}}},"/v1/membranes/{membrane_id}":{"get":{"tags":["onboarding"],"summary":"Get Membrane","operationId":"get_membrane_v1_membranes__membrane_id__get","parameters":[{"name":"membrane_id","in":"path","required":true,"schema":{"type":"string","title":"Membrane Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MembraneEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/membranes/{membrane_id}/readiness":{"get":{"tags":["onboarding"],"summary":"Get Readiness","operationId":"get_readiness_v1_membranes__membrane_id__readiness_get","parameters":[{"name":"membrane_id","in":"path","required":true,"schema":{"type":"string","title":"Membrane Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadinessEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/membranes/{membrane_id}/escalation-config":{"patch":{"tags":["onboarding"],"summary":"Update Membrane Escalation Config","operationId":"update_membrane_escalation_config_v1_membranes__membrane_id__escalation_config_patch","parameters":[{"name":"membrane_id","in":"path","required":true,"schema":{"type":"string","title":"Membrane Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EscalationConfigUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MembraneEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/membranes/{membrane_id}/enforcement-config":{"patch":{"tags":["onboarding"],"summary":"Update Membrane Enforcement Config","description":"Set the org's enforcement contract (Phase II — the gate).\n\nEnabling enforcement is the first paid capability: it requires the\nDeveloper plan or above. Disabling is always allowed — no plan can\ntrap an org in enforcement. The audit record itself is unaffected\neither way (record-free-forever invariant).","operationId":"update_membrane_enforcement_config_v1_membranes__membrane_id__enforcement_config_patch","parameters":[{"name":"membrane_id","in":"path","required":true,"schema":{"type":"string","title":"Membrane Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnforcementConfigUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MembraneEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/membranes/{membrane_id}/shadow/stats":{"get":{"tags":["onboarding"],"summary":"Get Shadow Stats","operationId":"get_shadow_stats_v1_membranes__membrane_id__shadow_stats_get","parameters":[{"name":"membrane_id","in":"path","required":true,"schema":{"type":"string","title":"Membrane Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShadowStatsEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/membranes/{membrane_id}/shadow/feedback":{"post":{"tags":["onboarding"],"summary":"Submit Shadow Feedback","operationId":"submit_shadow_feedback_v1_membranes__membrane_id__shadow_feedback_post","parameters":[{"name":"membrane_id","in":"path","required":true,"schema":{"type":"string","title":"Membrane Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShadowFeedbackSubmission"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShadowFeedbackEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/membranes/{membrane_id}/activate":{"post":{"tags":["onboarding"],"summary":"Activate Membrane","operationId":"activate_membrane_v1_membranes__membrane_id__activate_post","parameters":[{"name":"membrane_id","in":"path","required":true,"schema":{"type":"string","title":"Membrane Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MembraneEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/membranes/{membrane_id}/deactivate":{"post":{"tags":["onboarding"],"summary":"Deactivate Membrane","operationId":"deactivate_membrane_v1_membranes__membrane_id__deactivate_post","parameters":[{"name":"membrane_id","in":"path","required":true,"schema":{"type":"string","title":"Membrane Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeactivationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MembraneEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/membranes/{membrane_id}/history":{"get":{"tags":["onboarding"],"summary":"Get Membrane History","operationId":"get_membrane_history_v1_membranes__membrane_id__history_get","parameters":[{"name":"membrane_id","in":"path","required":true,"schema":{"type":"string","title":"Membrane Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MembraneHistoryEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/membranes/{membrane_id}/enable-shadow":{"post":{"tags":["onboarding"],"summary":"Enable Shadow","operationId":"enable_shadow_v1_membranes__membrane_id__enable_shadow_post","parameters":[{"name":"membrane_id","in":"path","required":true,"schema":{"type":"string","title":"Membrane Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MembraneEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/onboarding/quickstart":{"post":{"tags":["onboarding"],"summary":"Quickstart","description":"Single-call onboarding: creates intake, runs analysis, generates\nmembrane in SHADOW status, and provisions an API key.\n\nEvery call creates a NEW organization with a random id. The id was once\nderived from ``org_name``; since this endpoint is unauthenticated and\nprovisions an ``admin`` key, anyone who knew an existing org's id (the public\nproof-token check returns it; ``\"Default\"`` gave ``org_default``) could post\nit as a name and receive an admin key for that org.","operationId":"quickstart_v1_onboarding_quickstart_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuickstartRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuickstartEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/onboarding/welcome":{"post":{"tags":["onboarding"],"summary":"Send Welcome Sequence","description":"Send the welcome email and start the drip sequence for an org.\n\nExists because provisioning has two paths and only one of them sent mail.\nQuickstart did everything in one call; the dashboard wizard (and every OAuth\nsignup) provisions through ``ensureMembrane`` using the granular endpoints,\nso users got a membrane and an API key and then silence — no welcome, no\nonboarding sequence. Confirmed against a real signup on 2026-08-21.\n\nIdempotent per org: enrollment is skipped when one already exists, so a retry\nor a second key never restarts the sequence. Returns 202 because the email\nis dispatched in the background.","operationId":"send_welcome_sequence_v1_onboarding_welcome_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WelcomeRequest"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Send Welcome Sequence V1 Onboarding Welcome Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/dashboard/command-center":{"get":{"tags":["dashboard"],"summary":"Get Command Center","operationId":"get_command_center_v1_dashboard_command_center_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommandCenterEnvelope"}}}}}}},"/v1/dashboard/attention-queue":{"get":{"tags":["dashboard"],"summary":"Get Attention Queue","operationId":"get_attention_queue_v1_dashboard_attention_queue_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AttentionQueueEnvelope"}}}}}}},"/v1/dashboard/daily-digest":{"get":{"tags":["dashboard"],"summary":"Get Daily Digest","operationId":"get_daily_digest_v1_dashboard_daily_digest_get","parameters":[{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO date YYYY-MM-DD, default yesterday","title":"Date"},"description":"ISO date YYYY-MM-DD, default yesterday"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DailyDigestEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/dashboard/weekly-summary":{"get":{"tags":["dashboard"],"summary":"Get Weekly Summary","operationId":"get_weekly_summary_v1_dashboard_weekly_summary_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WeeklySummaryEnvelope"}}}}}}},"/v1/dashboard/evidence-package":{"post":{"tags":["dashboard"],"summary":"Generate Evidence Package","operationId":"generate_evidence_package_v1_dashboard_evidence_package_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvidencePackageRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvidencePackageEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/dashboard/evidence-package/{package_id}":{"get":{"tags":["dashboard"],"summary":"Get Evidence Package","description":"A package the caller's organization generated; another organization's is a 404.","operationId":"get_evidence_package_v1_dashboard_evidence_package__package_id__get","parameters":[{"name":"package_id","in":"path","required":true,"schema":{"type":"string","title":"Package Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvidencePackageEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/dashboard/decisions":{"get":{"tags":["dashboard"],"summary":"Get Decision Stream","operationId":"get_decision_stream_v1_dashboard_decisions_get","parameters":[{"name":"verdict","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Verdict"}},{"name":"risk_classification","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Risk Classification"}},{"name":"agent_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"}},{"name":"action_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Action Type"}},{"name":"deliberation","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Deliberation"}},{"name":"pipeline_mode","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pipeline Mode"}},{"name":"time_range","in":"query","required":false,"schema":{"type":"string","default":"last_7d","title":"Time Range"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DecisionStreamEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/dashboard/agents":{"get":{"tags":["dashboard"],"summary":"Get Agent Explorer","operationId":"get_agent_explorer_v1_dashboard_agents_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentExplorerEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/dashboard/metrics/history":{"get":{"tags":["dashboard"],"summary":"Get Metrics History","description":"The caller's organization's metrics for each hour that had decisions or escalations.\n\nComputed from the organization's own decisions and escalations. Until 2026-10-06 this read\nhourly snapshots that were never stored and carried no organization; ``POST\n/dashboard/metrics/snapshot``, which wrote one across every organization, is retired.","operationId":"get_metrics_history_v1_dashboard_metrics_history_get","parameters":[{"name":"start","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO date-time: the first hour to include","title":"Start"},"description":"ISO date-time: the first hour to include"},{"name":"end","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO date-time: the last hour to include (default now)","title":"End"},"description":"ISO date-time: the last hour to include (default now)"},{"name":"hours","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":8760,"minimum":1},{"type":"null"}],"description":"Without start: the window is this many hours before end (default 720, 30 days)","title":"Hours"},"description":"Without start: the window is this many hours before end (default 720, 30 days)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":2000,"minimum":1,"default":720,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetricsHistoryEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/audit/{audit_id}/verification-bundle":{"get":{"tags":["reconstruction"],"summary":"Download verification bundle for a single audit record","description":"Returns a self-contained ZIP file that a third-party auditor can use to verify a governance decision offline, without GaaS installation.","operationId":"get_verification_bundle_single_v1_audit__audit_id__verification_bundle_get","parameters":[{"name":"audit_id","in":"path","required":true,"schema":{"type":"string","title":"Audit Id"}}],"responses":{"200":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/audit/verification-bundle":{"get":{"tags":["reconstruction"],"summary":"Download verification bundle for a range of audit records","description":"Returns a self-contained ZIP covering a date range of audit records. Supports pagination via limit/offset.","operationId":"get_verification_bundle_range_v1_audit_verification_bundle_get","parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Date"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/audit/{audit_id}/reconstruction":{"get":{"tags":["reconstruction"],"summary":"Reconstruct a governance decision","description":"Generates a structured JSON reconstruction of a governance decision, including inline hash verification. Suitable for regulators and auditors.","operationId":"get_reconstruction_report_v1_audit__audit_id__reconstruction_get","parameters":[{"name":"audit_id","in":"path","required":true,"schema":{"type":"string","title":"Audit Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Reconstruction Report V1 Audit  Audit Id  Reconstruction Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/audit/chain/verify":{"get":{"tags":["audit"],"summary":"Verify Chain","operationId":"verify_chain_v1_audit_chain_verify_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChainVerificationEnvelope"}}}}}}},"/v1/audit/retention":{"get":{"tags":["audit"],"summary":"Get Retention Status","description":"The caller's own records and retention period (None: kept until the organization sets one).\n\nUntil 2026-09-28 this counted every organization's records and reported a global default.","operationId":"get_retention_status_v1_audit_retention_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RetentionStatusEnvelope"}}}}}}},"/v1/audit/retention/purge":{"post":{"tags":["audit"],"summary":"Purge Retention","description":"Remove the caller's own records older than its retention period, now (the daily job does the\nsame). Nothing is removed while the organization has no period.\n\nUntil 2026-09-28 any operator key removed **every** organization's records older than a global\ndefault; production's oldest records (Feb 2026) were not yet old enough for it to remove any.","operationId":"purge_retention_v1_audit_retention_purge_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RetentionPurgeEnvelope"}}}}}}},"/v1/audit/export":{"get":{"tags":["audit"],"summary":"Export Audits","operationId":"export_audits_v1_audit_export_get","parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Date"}},{"name":"include_verification","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Verification"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":10000,"minimum":1,"default":1000,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditExportEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/audit/export/stream":{"get":{"tags":["audit"],"summary":"Export Audits Stream","description":"Stream audit records as JSONL (one JSON object per line).\n\nSuitable for large exports — the client receives records incrementally\nwithout buffering the entire dataset in memory.","operationId":"export_audits_stream_v1_audit_export_stream_get","parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End Date"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/audit/{audit_id}/delegation-chain":{"get":{"tags":["audit"],"summary":"Get Delegation Chain","description":"Return the full A2A delegation tree with hash verification status.\n\nWalks from the root audit record through all child records linked\nby ``a2a_context.parent_audit_id``.","operationId":"get_delegation_chain_v1_audit__audit_id__delegation_chain_get","parameters":[{"name":"audit_id","in":"path","required":true,"schema":{"type":"string","title":"Audit Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Delegation Chain V1 Audit  Audit Id  Delegation Chain Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/audit/timestamps":{"get":{"tags":["audit"],"summary":"List Timestamps","description":"Your organization's daily public timestamps, newest day first, and the digest recipe.\n\nEach UTC day with audit records gets one proof, made a little after the day ends. Only the\ncaller's organization's days are listed.","operationId":"list_timestamps_v1_audit_timestamps_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":366,"minimum":1,"default":90,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Timestamps V1 Audit Timestamps Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/audit/timestamps/{day}/ots":{"get":{"tags":["audit"],"summary":"Download Timestamp","description":"The detached ``.ots`` proof for one UTC day, for the official ``ots`` client.\n\nSaved as ``<day>.hashes.ots`` so ``ots verify`` finds the ``<day>.hashes`` file the recipe\nbuilds next to it. Another organization's day is a 404, the same as a day with no proof.","operationId":"download_timestamp_v1_audit_timestamps__day__ots_get","parameters":[{"name":"day","in":"path","required":true,"schema":{"type":"string","format":"date","title":"Day"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/waitlist/join":{"post":{"tags":["waitlist","waitlist"],"summary":"Join Waitlist","description":"Join the GaaS waitlist. Pre-auth — no API key required.","operationId":"join_waitlist_v1_waitlist_join_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WaitlistJoinRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WaitlistJoinEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/waitlist/verify":{"post":{"tags":["waitlist","waitlist"],"summary":"Verify Email","description":"Verify waitlist email via double opt-in token. Pre-auth — no API key required.","operationId":"verify_email_v1_waitlist_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WaitlistVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WaitlistVerifyEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/waitlist/unsubscribe":{"post":{"tags":["waitlist","waitlist"],"summary":"Unsubscribe From Waitlist","description":"Unsubscribe from waitlist emails. Pre-auth — no API key required.","operationId":"unsubscribe_from_waitlist_v1_waitlist_unsubscribe_post","parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string","description":"Waitlist entry ID","title":"Id"},"description":"Waitlist entry ID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WaitlistUnsubscribeRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WaitlistUnsubscribeEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/waitlist/entries":{"get":{"tags":["waitlist","waitlist"],"summary":"List Waitlist Entries","description":"List waitlist entries with optional filters. Auth required.","operationId":"list_waitlist_entries_v1_waitlist_entries_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by status","title":"Status"},"description":"Filter by status"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WaitlistListEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/waitlist/entries/{entry_id}":{"get":{"tags":["waitlist","waitlist"],"summary":"Get Waitlist Entry","description":"Get a single waitlist entry by ID. Auth required.","operationId":"get_waitlist_entry_v1_waitlist_entries__entry_id__get","parameters":[{"name":"entry_id","in":"path","required":true,"schema":{"type":"string","title":"Entry Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WaitlistEntryEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/waitlist/entries/{entry_id}/approve":{"post":{"tags":["waitlist","waitlist"],"summary":"Approve Entry","description":"Approve a verified waitlist entry. Auth required.","operationId":"approve_entry_v1_waitlist_entries__entry_id__approve_post","parameters":[{"name":"entry_id","in":"path","required":true,"schema":{"type":"string","title":"Entry Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WaitlistEntryEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/waitlist/entries/{entry_id}/reject":{"post":{"tags":["waitlist","waitlist"],"summary":"Reject Entry","description":"Reject a waitlist entry. Auth required.","operationId":"reject_entry_v1_waitlist_entries__entry_id__reject_post","parameters":[{"name":"entry_id","in":"path","required":true,"schema":{"type":"string","title":"Entry Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WaitlistEntryEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/waitlist/invite":{"post":{"tags":["waitlist","waitlist"],"summary":"Bulk Invite","description":"Bulk-invite approved waitlist entries. Auth required.","operationId":"bulk_invite_v1_waitlist_invite_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WaitlistBulkInviteRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WaitlistBulkInviteEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/waitlist/analytics":{"get":{"tags":["waitlist","waitlist"],"summary":"Get Waitlist Analytics","description":"Get waitlist analytics and attribution data. Auth required.","operationId":"get_waitlist_analytics_v1_waitlist_analytics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WaitlistAnalyticsEnvelope"}}}}}}},"/v1/contact":{"post":{"tags":["contact","contact"],"summary":"Submit Contact","description":"Deliver a gaas.is \"Talk to sales\" submission. Pre-auth — no API key required.","operationId":"submit_contact_v1_contact_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactRequest"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactAccepted"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/drip/unsubscribe":{"get":{"tags":["drip"],"summary":"Unsubscribe","description":"Unsubscribe from drip campaign emails.","operationId":"unsubscribe_v1_drip_unsubscribe_get","parameters":[{"name":"token","in":"query","required":true,"schema":{"type":"string","description":"Enrollment ID","title":"Token"},"description":"Enrollment ID"}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/drip/sequences":{"get":{"tags":["drip"],"summary":"List Sequences","description":"List all custom drip sequences for the org.","operationId":"list_sequences_v1_drip_sequences_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response List Sequences V1 Drip Sequences Get"}}}}}},"post":{"tags":["drip"],"summary":"Create Sequence","description":"Create a custom drip sequence.","operationId":"create_sequence_v1_drip_sequences_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_create_sequence_v1_drip_sequences_post"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Create Sequence V1 Drip Sequences Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/drip/sequences/{sequence_id}":{"get":{"tags":["drip"],"summary":"Get Sequence","description":"Get a custom drip sequence by ID.","operationId":"get_sequence_v1_drip_sequences__sequence_id__get","parameters":[{"name":"sequence_id","in":"path","required":true,"schema":{"type":"string","title":"Sequence Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Sequence V1 Drip Sequences  Sequence Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["drip"],"summary":"Update Sequence","description":"Update a custom drip sequence.","operationId":"update_sequence_v1_drip_sequences__sequence_id__put","parameters":[{"name":"sequence_id","in":"path","required":true,"schema":{"type":"string","title":"Sequence Id"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_update_sequence_v1_drip_sequences__sequence_id__put"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Sequence V1 Drip Sequences  Sequence Id  Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["drip"],"summary":"Delete Sequence","description":"Delete a custom drip sequence.","operationId":"delete_sequence_v1_drip_sequences__sequence_id__delete","parameters":[{"name":"sequence_id","in":"path","required":true,"schema":{"type":"string","title":"Sequence Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/org/{org_id}/data/export":{"get":{"tags":["gdpr","gdpr"],"summary":"Export Org Data","operationId":"export_org_data_v1_org__org_id__data_export_get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","description":"Organization ID","title":"Org Id"},"description":"Organization ID"},{"name":"include_audit_records","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Include Audit Records"}},{"name":"include_decisions","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Include Decisions"}},{"name":"include_escalations","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Include Escalations"}},{"name":"include_onboarding","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Include Onboarding"}},{"name":"include_api_keys","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Include Api Keys"}},{"name":"include_webhooks","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Include Webhooks"}},{"name":"include_drip","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Include Drip"}},{"name":"include_consent","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Include Consent"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataExportEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/org/{org_id}/data/erasure-preview":{"get":{"tags":["gdpr","gdpr"],"summary":"Preview Org Erasure","operationId":"preview_org_erasure_v1_org__org_id__data_erasure_preview_get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","description":"Organization ID","title":"Org Id"},"description":"Organization ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErasurePreviewEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/org/{org_id}/data":{"delete":{"tags":["gdpr","gdpr"],"summary":"Erase Org Data","operationId":"erase_org_data_v1_org__org_id__data_delete","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","description":"Organization ID","title":"Org Id"},"description":"Organization ID"},{"name":"confirm","in":"query","required":false,"schema":{"type":"boolean","description":"Must be true to proceed","default":false,"title":"Confirm"},"description":"Must be true to proceed"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErasureEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/org/{org_id}/decisions/{intent_id}/explanation":{"get":{"tags":["gdpr","gdpr"],"summary":"Explain Decision","operationId":"explain_decision_v1_org__org_id__decisions__intent_id__explanation_get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"intent_id","in":"path","required":true,"schema":{"type":"string","title":"Intent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DecisionExplanationEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/org/{org_id}/consent":{"get":{"tags":["gdpr","gdpr"],"summary":"Get Consent Status","operationId":"get_consent_status_v1_org__org_id__consent_get","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConsentStatusEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["gdpr","gdpr"],"summary":"Grant Consent","operationId":"grant_consent_v1_org__org_id__consent_post","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConsentGrantRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConsentRecordEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/org/{org_id}/consent/{purpose}":{"delete":{"tags":["gdpr","gdpr"],"summary":"Revoke Consent","operationId":"revoke_consent_v1_org__org_id__consent__purpose__delete","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string","title":"Org Id"}},{"name":"purpose","in":"path","required":true,"schema":{"type":"string","title":"Purpose"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConsentRevokedEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/webhooks/resend":{"post":{"tags":["email"],"summary":"Receive Resend Webhook","description":"Receive and process Resend webhook events.\n\nThis endpoint is pre-auth (exempt from API key checks) because\nResend's servers call it directly.","operationId":"receive_resend_webhook_v1_webhooks_resend_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Receive Resend Webhook V1 Webhooks Resend Post"}}}}}}},"/v1/subprocessor/changes":{"post":{"tags":["subprocessor"],"summary":"Create Change","description":"Create a new sub-processor change (admin only).","operationId":"create_change_v1_subprocessor_changes_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_create_change_v1_subprocessor_changes_post"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Change V1 Subprocessor Changes Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["subprocessor"],"summary":"List Changes","description":"List sub-processor changes.","operationId":"list_changes_v1_subprocessor_changes_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Changes V1 Subprocessor Changes Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/subprocessor/changes/{change_id}":{"get":{"tags":["subprocessor"],"summary":"Get Change","description":"Get details of a specific change.","operationId":"get_change_v1_subprocessor_changes__change_id__get","parameters":[{"name":"change_id","in":"path","required":true,"schema":{"type":"string","title":"Change Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Change V1 Subprocessor Changes  Change Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["subprocessor"],"summary":"Cancel Change","description":"Cancel a scheduled change (admin only).","operationId":"cancel_change_v1_subprocessor_changes__change_id__delete","parameters":[{"name":"change_id","in":"path","required":true,"schema":{"type":"string","title":"Change Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/subprocessor/notifications":{"get":{"tags":["subprocessor"],"summary":"List Notifications","description":"List notifications for the authenticated org.","operationId":"list_notifications_v1_subprocessor_notifications_get","parameters":[{"name":"change_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Change Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Notifications V1 Subprocessor Notifications Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/subprocessor/object":{"get":{"tags":["subprocessor"],"summary":"Object Form","description":"Display objection form (pre-auth).","operationId":"object_form_v1_subprocessor_object_get","parameters":[{"name":"token","in":"query","required":true,"schema":{"type":"string","title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["subprocessor"],"summary":"Submit Objection","description":"Submit objection (pre-auth).","operationId":"submit_objection_v1_subprocessor_object_post","requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_submit_objection_v1_subprocessor_object_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/openapi.json":{"get":{"tags":["openapi","openapi"],"summary":"Download OpenAPI specification","description":"Returns the full OpenAPI 3.x specification as downloadable JSON","operationId":"get_openapi_spec_v1_openapi_json_get","responses":{"200":{"description":"Successful Response"}}}},"/v1/feature-flags":{"get":{"tags":["feature-flags","feature-flags"],"summary":"List feature flags","description":"List all feature flags (global + org-specific)","operationId":"list_flags_v1_feature_flags_get","parameters":[{"name":"show_global","in":"query","required":false,"schema":{"type":"boolean","description":"Include global flags","default":true,"title":"Show Global"},"description":"Include global flags"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeatureFlagListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["feature-flags","feature-flags"],"summary":"Create or update feature flag","description":"Create a new feature flag or update an existing one","operationId":"create_flag_v1_feature_flags_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeatureFlagCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeatureFlagResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/feature-flags/{name}":{"get":{"tags":["feature-flags","feature-flags"],"summary":"Get feature flag","description":"Get details of a specific feature flag","operationId":"get_flag_v1_feature_flags__name__get","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeatureFlagResponse"}}}},"404":{"description":"Flag not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["feature-flags","feature-flags"],"summary":"Update feature flag","description":"Partially update an existing feature flag","operationId":"update_flag_v1_feature_flags__name__patch","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeatureFlagUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeatureFlagResponse"}}}},"404":{"description":"Flag not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["feature-flags","feature-flags"],"summary":"Delete feature flag","description":"Delete a feature flag","operationId":"delete_flag_v1_feature_flags__name__delete","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}}],"responses":{"204":{"description":"Successful Response"},"404":{"description":"Flag not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/feature-flags/{name}/check":{"get":{"tags":["feature-flags","feature-flags"],"summary":"Check if flag is enabled","description":"Check if a feature flag is enabled for this organization","operationId":"check_flag_v1_feature_flags__name__check_get","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string","title":"Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeatureFlagCheckResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/slo/status":{"get":{"tags":["slo","SLO"],"summary":"Get all SLO statuses","description":"Get current status for all configured SLOs.\n\nReturns compliance status, error budgets, and severity for each SLO.","operationId":"get_all_slo_statuses_v1_slo_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SLOStatusListResponse"}}}}}}},"/v1/slo/status/{slo_name}":{"get":{"tags":["slo","SLO"],"summary":"Get specific SLO status","description":"Get current status for a specific SLO.\n\nAvailable SLOs:\n- API Availability\n- Intent Submission Latency P95\n- Intent Submission Latency P99\n- Error Rate","operationId":"get_slo_status_v1_slo_status__slo_name__get","parameters":[{"name":"slo_name","in":"path","required":true,"schema":{"type":"string","title":"Slo Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SLOStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/slo/error-budget/{slo_name}":{"get":{"tags":["slo","SLO"],"summary":"Get error budget","description":"Get current error budget for an SLO.\n\nShows:\n- Total error budget allowed\n- Amount consumed so far\n- Amount remaining\n- Percentage remaining","operationId":"get_error_budget_v1_slo_error_budget__slo_name__get","parameters":[{"name":"slo_name","in":"path","required":true,"schema":{"type":"string","title":"Slo Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBudgetResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/slo/burn-rate/{slo_name}":{"get":{"tags":["slo","SLO"],"summary":"Get error budget burn rate","description":"Get error budget burn rates for multiple time windows.\n\nBurn rate indicates how fast error budget is being consumed:\n- 1.0 = normal consumption rate\n- 2.0 = consuming twice as fast (budget will exhaust early)\n- 10.0+ = critical consumption rate\n\nReturns burn rates for 1h, 6h, 24h, and 72h windows.","operationId":"get_burn_rate_v1_slo_burn_rate__slo_name__get","parameters":[{"name":"slo_name","in":"path","required":true,"schema":{"type":"string","title":"Slo Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BurnRateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/slo/report/monthly":{"get":{"tags":["slo","SLO"],"summary":"Generate monthly SLO report","description":"Generate comprehensive monthly SLO report.\n\nIncludes:\n- Status of all SLOs\n- Error budget consumption\n- Compliance percentage\n- Violation counts\n\nUsed for stakeholder reporting and reliability reviews.","operationId":"get_monthly_report_v1_slo_report_monthly_get","parameters":[{"name":"month","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Month in YYYY-MM format (defaults to current month)","title":"Month"},"description":"Month in YYYY-MM format (defaults to current month)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SLOReportResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/synthetic/uptime/{check_name}":{"get":{"tags":["synthetic","Synthetic Monitoring"],"summary":"Get uptime metrics for a check","description":"Get uptime metrics for a synthetic check.\n\nReturns:\n- Uptime percentage\n- Total/successful/failed checks\n- Latency statistics (avg, p95, p99)\n- Per-region uptime breakdown\n\nDefault lookback window is 24 hours.","operationId":"get_uptime_metrics_v1_synthetic_uptime__check_name__get","parameters":[{"name":"check_name","in":"path","required":true,"schema":{"type":"string","title":"Check Name"}},{"name":"hours","in":"query","required":false,"schema":{"type":"integer","maximum":720,"minimum":1,"description":"Hours to look back","default":24,"title":"Hours"},"description":"Hours to look back"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UptimeMetricsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/synthetic/checks":{"get":{"tags":["synthetic","Synthetic Monitoring"],"summary":"List all configured checks","description":"List all configured synthetic checks.\n\nReturns check definitions including:\n- Name, type, URL\n- Check interval\n- Regions\n- Enabled status","operationId":"list_checks_v1_synthetic_checks_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"type":"object","title":"Response List Checks V1 Synthetic Checks Get"}}}}}}},"/v1/policies/config":{"post":{"tags":["policy-config","Policy Configuration"],"summary":"Create Policy Config","description":"Create a new custom policy configuration.\n\n**Tier 3 policies** require org-specific settings (thresholds, routing rules, etc.).\nThis endpoint allows organizations to define policy behavior.","operationId":"create_policy_config_v1_policies_config_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyConfigCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyConfigResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["policy-config","Policy Configuration"],"summary":"List Policy Configs","description":"List all policy configurations for the organization.\n\n**Query Parameters:**\n- enabled_only: If true, return only enabled configs (default: false)","operationId":"list_policy_configs_v1_policies_config_get","parameters":[{"name":"enabled_only","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Enabled Only"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyConfigListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/policies/config/{policy_id}":{"get":{"tags":["policy-config","Policy Configuration"],"summary":"Get Policy Config","description":"Get configuration for a specific policy.\n\nReturns the active configuration settings for the given policy ID.","operationId":"get_policy_config_v1_policies_config__policy_id__get","parameters":[{"name":"policy_id","in":"path","required":true,"schema":{"type":"string","title":"Policy Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyConfigResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["policy-config","Policy Configuration"],"summary":"Update Policy Config","description":"Update an existing policy configuration.\n\nAllows modification of settings, enabling/disabling, and threshold adjustments.","operationId":"update_policy_config_v1_policies_config__policy_id__put","parameters":[{"name":"policy_id","in":"path","required":true,"schema":{"type":"string","title":"Policy Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyConfigUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyConfigResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["policy-config","Policy Configuration"],"summary":"Delete Policy Config","description":"Delete a policy configuration.\n\n**Warning:** This removes all settings for the policy. The policy will fall back\nto default behavior (typically CONDITIONAL with minimal enforcement).","operationId":"delete_policy_config_v1_policies_config__policy_id__delete","parameters":[{"name":"policy_id","in":"path","required":true,"schema":{"type":"string","title":"Policy Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/api-keys":{"get":{"tags":["api-keys","api-keys"],"summary":"List Api Keys","description":"List all API keys for the organization (redacted - no raw keys).","operationId":"list_api_keys_v1_api_keys_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response List Api Keys V1 Api Keys Get"}}}}}},"post":{"tags":["api-keys","api-keys"],"summary":"Create Api Key","description":"Provision a new API key. The raw key is only returned once.","operationId":"create_api_key_v1_api_keys_post","requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/CreateKeyRequest"},{"type":"null"}],"title":"Body"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Create Api Key V1 Api Keys Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/api-keys/{key_id}/rotate":{"post":{"tags":["api-keys","api-keys"],"summary":"Rotate Api Key","description":"Atomically rotate an API key: provisions a new key and revokes the old one.\n\nThe raw key is only returned in this response. Operator role required.","operationId":"rotate_api_key_v1_api_keys__key_id__rotate_post","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Rotate Api Key V1 Api Keys  Key Id  Rotate Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/api-keys/{key_id}":{"delete":{"tags":["api-keys","api-keys"],"summary":"Revoke Api Key","description":"Revoke an API key by ID.","operationId":"revoke_api_key_v1_api_keys__key_id__delete","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agent-registry/agents":{"post":{"tags":["agent-registry","agent-registry"],"summary":"Register Agent","description":"Register a new A2A agent by URL.\n\nDiscovers the agent's Agent Card, computes initial trust score,\nand persists in the registry.","operationId":"register_agent_v1_agent_registry_agents_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterAgentRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["agent-registry","agent-registry"],"summary":"List Agents","description":"List registered A2A agents for the organization.","operationId":"list_agents_v1_agent_registry_agents_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agent-registry/agents/{agent_id}":{"get":{"tags":["agent-registry","agent-registry"],"summary":"Get Agent","description":"Get details and trust score for a registered agent.","operationId":"get_agent_v1_agent_registry_agents__agent_id__get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agent-registry/agents/{agent_id}/refresh":{"post":{"tags":["agent-registry","agent-registry"],"summary":"Refresh Agent","description":"Refresh an agent's card and re-compute trust score.","operationId":"refresh_agent_v1_agent_registry_agents__agent_id__refresh_post","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agent-registry/agents/{agent_id}/suspend":{"post":{"tags":["agent-registry","agent-registry"],"summary":"Suspend Agent","description":"Suspend an agent from interactions.","operationId":"suspend_agent_v1_agent_registry_agents__agent_id__suspend_post","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agent-registry/agents/{agent_id}/unsuspend":{"post":{"tags":["agent-registry","agent-registry"],"summary":"Unsuspend Agent","description":"Restore a suspended agent.","operationId":"unsuspend_agent_v1_agent_registry_agents__agent_id__unsuspend_post","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agent-registry/agents/{agent_id}/quarantine":{"post":{"tags":["agent-registry","agent-registry"],"summary":"Quarantine Agent","description":"Quarantine an agent — blocked at Tier 1 (pol_t1_017) on its next intent.","operationId":"quarantine_agent_v1_agent_registry_agents__agent_id__quarantine_post","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agent-registry/agents/{agent_id}/unquarantine":{"post":{"tags":["agent-registry","agent-registry"],"summary":"Unquarantine Agent","description":"Release a quarantined agent back to active.","operationId":"unquarantine_agent_v1_agent_registry_agents__agent_id__unquarantine_post","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agent-registry/agents/{agent_id}/interactions":{"get":{"tags":["agent-registry","agent-registry"],"summary":"Get Interactions","description":"Get interaction history for an agent.","operationId":"get_interactions_v1_agent_registry_agents__agent_id__interactions_get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agent-registry/trust-scores":{"get":{"tags":["agent-registry","agent-registry"],"summary":"Trust Scores Overview","description":"Get trust score overview/leaderboard for all agents.","operationId":"trust_scores_overview_v1_agent_registry_trust_scores_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/ap2/mandates":{"post":{"tags":["ap2","ap2"],"summary":"Register Mandate","description":"Register and validate an AP2 mandate.","operationId":"register_mandate_v1_ap2_mandates_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["ap2","ap2"],"summary":"List Mandates","description":"List AP2 mandates for the organization.","operationId":"list_mandates_v1_ap2_mandates_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ap2/mandates/{mandate_id}":{"get":{"tags":["ap2","ap2"],"summary":"Get Mandate","description":"Get mandate details + spend tracking.","operationId":"get_mandate_v1_ap2_mandates__mandate_id__get","parameters":[{"name":"mandate_id","in":"path","required":true,"schema":{"type":"string","title":"Mandate Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ap2/mandates/{mandate_id}/revoke":{"post":{"tags":["ap2","ap2"],"summary":"Revoke Mandate","description":"Revoke an active mandate.","operationId":"revoke_mandate_v1_ap2_mandates__mandate_id__revoke_post","parameters":[{"name":"mandate_id","in":"path","required":true,"schema":{"type":"string","title":"Mandate Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ap2/transactions":{"get":{"tags":["ap2","ap2"],"summary":"List Transactions","description":"List AP2 payment transactions with governance verdicts.","operationId":"list_transactions_v1_ap2_transactions_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ap2/transactions/{tx_id}":{"get":{"tags":["ap2","ap2"],"summary":"Get Transaction","description":"Get full transaction details + audit trail.","operationId":"get_transaction_v1_ap2_transactions__tx_id__get","parameters":[{"name":"tx_id","in":"path","required":true,"schema":{"type":"string","title":"Tx Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ap2/spend-summary":{"get":{"tags":["ap2","ap2"],"summary":"Spend Summary","description":"Get cumulative spend summary per agent/mandate.","operationId":"spend_summary_v1_ap2_spend_summary_get","parameters":[{"name":"agent_id","in":"query","required":true,"schema":{"type":"string","title":"Agent Id"}},{"name":"mandate_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mandate Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/compliance/eu-ai-act":{"get":{"tags":["compliance"],"summary":"EU AI Act compliance status","description":"Returns the EU AI Act compliance posture for this organisation. High-risk requirements apply from 2 December 2027 (Annex III systems) and 2 August 2028 (Annex I products) under Regulation (EU) 2026/1744. Breaching them can cost up to €15M or 3% of worldwide annual turnover; prohibited practices up to €35M or 7% (Article 99).","operationId":"get_eu_ai_act_status_v1_compliance_eu_ai_act_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EUAIActStatusEnvelope"}}}}}}},"/v1/compliance/eu-ai-act/report":{"get":{"tags":["compliance"],"summary":"Full EU AI Act compliance report","description":"Full per-article EU AI Act compliance report with GaaS capability evidence. Suitable for regulatory submissions and auditor review.","operationId":"get_eu_ai_act_report_v1_compliance_eu_ai_act_report_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EUAIActReportEnvelope"}}}}}}},"/v1/compliance/nist-ai-rmf":{"get":{"tags":["compliance"],"summary":"NIST AI RMF compliance status","description":"Returns NIST AI RMF 1.0 compliance posture across all four functions (GOVERN, MAP, MEASURE, MANAGE).","operationId":"get_nist_ai_rmf_status_v1_compliance_nist_ai_rmf_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NISTAIRMFStatusEnvelope"}}}}}}},"/v1/compliance/nist-ai-rmf/report":{"get":{"tags":["compliance"],"summary":"Full NIST AI RMF compliance report","description":"Full NIST AI RMF 1.0 compliance report with per-subcategory evidence. Suitable for auditor review.","operationId":"get_nist_ai_rmf_report_v1_compliance_nist_ai_rmf_report_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NISTAIRMFReportEnvelope"}}}}}}},"/v1/compliance/nist-800-53":{"get":{"tags":["compliance"],"summary":"NIST SP 800-53 Rev. 5 compliance status","description":"Returns NIST SP 800-53 Rev. 5 compliance posture for AI-agent-relevant control families (AC, AU, SI, IR). Moderate baseline.","operationId":"get_nist_800_53_status_v1_compliance_nist_800_53_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NIST80053StatusEnvelope"}}}}}}},"/v1/compliance/nist-800-53/report":{"get":{"tags":["compliance"],"summary":"Full NIST SP 800-53 compliance report","description":"Full NIST SP 800-53 Rev. 5 compliance report with per-control evidence. FedRAMP readiness score included.","operationId":"get_nist_800_53_report_v1_compliance_nist_800_53_report_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NIST80053ReportEnvelope"}}}}}}},"/v1/compliance/fedramp":{"get":{"tags":["compliance"],"summary":"FedRAMP Moderate Baseline compliance status","description":"Returns FedRAMP Moderate Baseline compliance posture for AI-agent-specific controls. 5 of 325 controls in scope for the GaaS middleware layer.","operationId":"get_fedramp_status_v1_compliance_fedramp_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FedRAMPStatusEnvelope"}}}}}}},"/v1/compliance/fedramp/report":{"get":{"tags":["compliance"],"summary":"Full FedRAMP Moderate compliance report","description":"Full FedRAMP Moderate Baseline compliance report. Scope note: GaaS enforces AI-agent-specific controls. Infrastructure-layer controls are in GaaS's own ATO package.","operationId":"get_fedramp_report_v1_compliance_fedramp_report_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FedRAMPReportEnvelope"}}}}}}},"/v1/compliance/cmmc":{"get":{"tags":["compliance"],"summary":"CMMC 2.0 Level 1-2 compliance status","description":"Returns CMMC 2.0 Level 1–2 compliance posture for AI-agent CUI handling practices.","operationId":"get_cmmc_status_v1_compliance_cmmc_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CMMCStatusEnvelope"}}}}}}},"/v1/compliance/cmmc/report":{"get":{"tags":["compliance"],"summary":"Full CMMC 2.0 compliance report","description":"Full CMMC 2.0 Level 1–2 compliance report for DoD contractor CUI handling. Required for DFARS 252.204-7012 compliance.","operationId":"get_cmmc_report_v1_compliance_cmmc_report_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CMMCReportEnvelope"}}}}}}},"/v1/compliance/federal":{"get":{"tags":["compliance"],"summary":"Federal compliance summary","description":"Combined federal procurement readiness summary across NIST AI RMF, NIST SP 800-53, FedRAMP Moderate, and CMMC 2.0.","operationId":"get_federal_summary_v1_compliance_federal_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FederalSummaryEnvelope"}}}}}}},"/v1/compliance/federal/evidence/{control_id}":{"get":{"tags":["compliance"],"summary":"3PAO evidence package for a control","description":"Returns the 3PAO-ready evidence package for a specific control ID. Includes GaaS capability description, evidence artefacts, API endpoints, enforcing policy IDs, and NIST SP 800-53A assessment procedures.","operationId":"get_federal_evidence_v1_compliance_federal_evidence__control_id__get","parameters":[{"name":"control_id","in":"path","required":true,"schema":{"type":"string","title":"Control Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ControlEvidencePackageEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/compliance/evidence/export":{"get":{"tags":["compliance"],"summary":"Export Grc Evidence","description":"Export control evidence rows for GRC platforms (Vanta/Drata manual upload).\n\nOne row per control: id, framework, family, title, requirement, status,\ncapability, evidence endpoints, enforcing policies, assessment procedures,\nand last-assessed date. CSV multi-values are \"; \"-joined within quoted cells.","operationId":"export_grc_evidence_v1_compliance_evidence_export_get","parameters":[{"name":"framework","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Framework filter; omit for all","title":"Framework"},"description":"Framework filter; omit for all"},{"name":"format","in":"query","required":false,"schema":{"type":"string","pattern":"^(json|csv)$","default":"json","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/model-inventory":{"get":{"tags":["model-inventory"],"summary":"Model inventory","description":"Returns a model inventory for all AI agents registered in this organisation, for your model risk management. Automatically generated from the GaaS agent registry and audit trail — no separate data entry required. SR 11-7 / OCC 2011-12 were rescinded on 2026-04-17; their replacement (SR 26-2 / OCC 2026-13) places generative and agentic AI models outside its scope.","operationId":"get_model_inventory_v1_model_inventory_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelInventoryEnvelope"}}}}}}},"/v1/model-inventory/export":{"get":{"tags":["model-inventory"],"summary":"Export the model inventory (CSV or HTML)","description":"Export the complete model inventory as a CSV file (Excel-compatible) or as a print-ready HTML document suitable for saving as PDF.","operationId":"export_model_inventory_v1_model_inventory_export_get","parameters":[{"name":"format","in":"query","required":false,"schema":{"enum":["csv","html"],"type":"string","description":"Export format: 'csv' or 'html'","default":"csv","title":"Format"},"description":"Export format: 'csv' or 'html'"}],"responses":{"200":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/model-inventory/{agent_id}":{"get":{"tags":["model-inventory"],"summary":"Model inventory entry","description":"Returns the model inventory entry for a specific AI agent.","operationId":"get_model_inventory_entry_v1_model_inventory__agent_id__get","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelInventoryEntryEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/verify/proof/{token_id}":{"get":{"tags":["verify"],"summary":"Verify a Governance Proof Token (public)","description":"Public — no API key. Checks that GaaS signed the token (ECDSA P-256 / SHA-256), that its contents are unchanged, and that the audit record it is anchored to still matches its audit_hash. Returns the signed token so it can also be checked offline with the key at /.well-known/gaas-audit-keys.json. 404 when no token has this id.","operationId":"verify_proof_v1_verify_proof__token_id__get","parameters":[{"name":"token_id","in":"path","required":true,"schema":{"type":"string","title":"Token Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyProofEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/policy-registry":{"get":{"tags":["policy-registry"],"summary":"Search the policy registry","description":"Search and browse the GaaS policy registry.  Returns public packs available to all organisations plus any private packs submitted by this organisation.  Filter by vertical (healthcare, financial, government, ...) or regulation (HIPAA, EU AI Act, GDPR, ...) or free-text search.","operationId":"list_policy_packs_v1_policy_registry_get","parameters":[{"name":"vertical","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Industry vertical filter","title":"Vertical"},"description":"Industry vertical filter"},{"name":"regulation","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Regulation filter (e.g. HIPAA, GDPR)","title":"Regulation"},"description":"Regulation filter (e.g. HIPAA, GDPR)"},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Free-text search","title":"Q"},"description":"Free-text search"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyRegistryListEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["policy-registry"],"summary":"Submit a policy pack","description":"Submit a new policy pack to the registry.  The pack will be visible only to this organisation unless submitted as a public pack (org_id=None).  All referenced policy IDs must exist in the GaaS policy engine.","operationId":"submit_policy_pack_v1_policy_registry_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyPackMetadata"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyPackEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/policy-registry/{pack_id}":{"get":{"tags":["policy-registry"],"summary":"Get policy pack details","operationId":"get_policy_pack_v1_policy_registry__pack_id__get","parameters":[{"name":"pack_id","in":"path","required":true,"schema":{"type":"string","title":"Pack Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyPackEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/policy-registry/{pack_id}/policies":{"get":{"tags":["policy-registry"],"summary":"List policies in a pack","description":"Returns full policy definitions for all policies included in a pack.","operationId":"list_pack_policies_v1_policy_registry__pack_id__policies_get","parameters":[{"name":"pack_id","in":"path","required":true,"schema":{"type":"string","title":"Pack Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Pack Policies V1 Policy Registry  Pack Id  Policies Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/policy-registry/{pack_id}/install":{"post":{"tags":["policy-registry"],"summary":"Install a policy pack","description":"Install all policies from a pack into this organisation's active governance registry.  Policies already present are skipped (idempotent).  Installed policies become active in the governance pipeline immediately.","operationId":"install_policy_pack_v1_policy_registry__pack_id__install_post","parameters":[{"name":"pack_id","in":"path","required":true,"schema":{"type":"string","title":"Pack Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyPackInstallEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/policy/epoch":{"get":{"tags":["policy-registry"],"summary":"Current policy epoch","description":"Returns the current policy epoch and staleness status for this instance.","operationId":"get_policy_epoch_v1_policy_epoch_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Policy Epoch V1 Policy Epoch Get"}}}}}}},"/v1/policy/epoch/history":{"get":{"tags":["policy-registry"],"summary":"Epoch change history","description":"Returns the history of policy epoch changes for audit purposes.","operationId":"get_policy_epoch_history_v1_policy_epoch_history_get","parameters":[{"name":"since_epoch","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Since Epoch"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Policy Epoch History V1 Policy Epoch History Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/policy-authoring/generate":{"post":{"tags":["policy-authoring"],"summary":"Generate Policy","description":"Generate a draft policy from a plain-English compliance description.\n\nThe draft contains:\n- Generated Python condition code (for operator review)\n- Plain-English explanation of what the condition checks\n- Recommended scope, severity, and verdict\n- Smoke test results (5 canonical intent scenarios)\n\nThe draft expires after 7 days.  Activate it via the /activate endpoint.","operationId":"generate_policy_v1_policy_authoring_generate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GeneratePolicyRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DraftPolicy"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/policy-authoring/activate":{"post":{"tags":["policy-authoring"],"summary":"Activate Policy","description":"Compile a reviewed draft policy and register it in the live policy registry.\n\nRuns smoke tests again at activation time.  Returns an error (200 + registered=False)\nif smoke tests fail — does not raise 4xx/5xx so the client can inspect results.","operationId":"activate_policy_v1_policy_authoring_activate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyActivationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyActivationResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/policy-authoring/drafts":{"get":{"tags":["policy-authoring"],"summary":"List Drafts","description":"List all pending (non-expired) draft policies for this organization.","operationId":"list_drafts_v1_policy_authoring_drafts_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/DraftPolicy"},"type":"array","title":"Response List Drafts V1 Policy Authoring Drafts Get"}}}}}}},"/v1/policy-authoring/drafts/{draft_id}":{"delete":{"tags":["policy-authoring"],"summary":"Delete Draft","description":"Discard a draft policy.","operationId":"delete_draft_v1_policy_authoring_drafts__draft_id__delete","parameters":[{"name":"draft_id","in":"path","required":true,"schema":{"type":"string","title":"Draft Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/policy-authoring/drafts/{draft_id}/export":{"get":{"tags":["policy-authoring"],"summary":"Export Draft","description":"Export a draft as a spec-conformant policy.md file (authmd spec 0.1).\n\nOnly drafts whose condition was expressible in the declarative matcher\ngrammar can be exported (the expressiveness cliff) — everything else\nreturns 422 and remains activatable as a code policy.","operationId":"export_draft_v1_policy_authoring_drafts__draft_id__export_get","parameters":[{"name":"draft_id","in":"path","required":true,"schema":{"type":"string","title":"Draft Id"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","default":"policy-md","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Export Draft V1 Policy Authoring Drafts  Draft Id  Export Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/policy-authoring/policies":{"get":{"tags":["policy-authoring"],"summary":"List Active Policies","description":"List NL-authored policies activated this server session for this organization.\n\nNote: Records are stored in-memory and reset on server restart.  Use the\naudit trail for permanent governance records.","operationId":"list_active_policies_v1_policy_authoring_policies_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ActivatedPolicyRecord"},"type":"array","title":"Response List Active Policies V1 Policy Authoring Policies Get"}}}}}}},"/v1/contest/stats":{"get":{"tags":["contest","contest"],"summary":"Get Contest Stats","description":"Return live contest pool statistics.\n\nNo authentication required — this endpoint is public so the Lambda mailer\ncan call it without an API key.","operationId":"get_contest_stats_v1_contest_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContestStatsEnvelope"}}}}}}},"/v1/intents/{intent_id}/appeal":{"get":{"tags":["appeals"],"summary":"Appeal Confirm","description":"Show a confirmation page before recording the appeal.\n\nAccepts GET so email clients can render the link as a button.\nThe confirmation step prevents accidental triggers (email prefetch, etc.).","operationId":"appeal_confirm_v1_intents__intent_id__appeal_get","parameters":[{"name":"intent_id","in":"path","required":true,"schema":{"type":"string","title":"Intent Id"}},{"name":"action","in":"query","required":true,"schema":{"type":"string","title":"Action"}},{"name":"token","in":"query","required":true,"schema":{"type":"string","title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["appeals"],"summary":"Appeal Submit","description":"Record an appeal decision.\n\nOn approve: records a human override — the agent's retry of the same action within 24 hours\nis approved once (packages/api/overrides.py) — and fires ``decision.overridden``. The blocked\ndecision itself stays a BLOCK: it is the record of what the policies decided.\nOn deny: annotates the stored decision as confirmed by an admin.\nEither way a note is appended to ``block.resubmit_guidance``.","operationId":"appeal_submit_v1_intents__intent_id__appeal_post","parameters":[{"name":"intent_id","in":"path","required":true,"schema":{"type":"string","title":"Intent Id"}}],"requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_appeal_submit_v1_intents__intent_id__appeal_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agent-contract":{"get":{"tags":["agent-contract"],"summary":"Get Agent Contract","description":"Generate a personalized GaaS agent contract for the given framework and format.","operationId":"get_agent_contract_v1_agent_contract_get","parameters":[{"name":"framework","in":"query","required":false,"schema":{"enum":["claude","openai","langchain","generic_python"],"type":"string","default":"claude","title":"Framework"}},{"name":"format","in":"query","required":false,"schema":{"enum":["system_prompt","claude_md","tool_def","combined"],"type":"string","default":"system_prompt","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Agent Contract V1 Agent Contract Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/agent-contract/test":{"post":{"tags":["agent-contract"],"summary":"Test Agent Contract","description":"Test governance integration via a shadow-mode sample intent.\n\nConstructs a minimal low-risk intent and runs it through the full pipeline\nin SHADOW mode. Returns the verdict to confirm governance is reachable.","operationId":"test_agent_contract_v1_agent_contract_test_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentContractTestRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Test Agent Contract V1 Agent Contract Test Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/governance-files/validate":{"post":{"tags":["governance-files"],"summary":"Validate Bundle","description":"Dry-run validation against spec 0.1. Never mutates anything.","operationId":"validate_bundle_v1_governance_files_validate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BundleSubmission"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/governance-files/apply":{"post":{"tags":["governance-files"],"summary":"Apply Bundle","description":"Compile the bundle into live, org-scoped Tier-3 policy.\n\nRe-application replaces the org's previously applied file policies\n(each change bumps the policy epoch). Enforcement of an org-signature\nrequirement follows the org's signing posture; v0.1 of this endpoint\nverifies an attestation when one is supplied.","operationId":"apply_bundle_v1_governance_files_apply_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BundleSubmission"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppliedBundleResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/governance-files/current":{"get":{"tags":["governance-files"],"summary":"Current Bundle","description":"The org's currently applied bundle, or 404 when none has been applied.","operationId":"current_bundle_v1_governance_files_current_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppliedBundleResponse"}}}}}}},"/v1/context-endpoint":{"get":{"tags":["context-endpoint"],"summary":"Your organization's context endpoint","operationId":"get_context_endpoint_v1_context_endpoint_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Context Endpoint V1 Context Endpoint Get"}}}}}},"put":{"tags":["context-endpoint"],"summary":"Create or replace your organization's context endpoint","operationId":"put_context_endpoint_v1_context_endpoint_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndpointSettings"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Put Context Endpoint V1 Context Endpoint Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["context-endpoint"],"summary":"Remove your organization's context endpoint","operationId":"delete_context_endpoint_v1_context_endpoint_delete","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Delete Context Endpoint V1 Context Endpoint Delete"}}}}}}},"/v1/context-endpoint/test":{"post":{"tags":["context-endpoint"],"summary":"Send a signed test request to your context endpoint","operationId":"test_context_endpoint_v1_context_endpoint_test_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Test Context Endpoint V1 Context Endpoint Test Post"}}}}}}},"/v1/context-endpoint/rotate-signing-secret":{"post":{"tags":["context-endpoint"],"summary":"Replace the signing secret (shown once)","operationId":"rotate_context_endpoint_secret_v1_context_endpoint_rotate_signing_secret_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Rotate Context Endpoint Secret V1 Context Endpoint Rotate Signing Secret Post"}}}}}}}},"components":{"schemas":{"A2APushNotificationConfig":{"properties":{"url":{"type":"string","maxLength":512,"title":"Url"},"token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Token"},"authentication":{"anyOf":[{"$ref":"#/components/schemas/A2ASecurityScheme"},{"type":"null"}]}},"type":"object","required":["url"],"title":"A2APushNotificationConfig","description":"Push notification registration for a task. Spec v0.3 §6."},"A2ARole":{"type":"string","enum":["user","agent"],"title":"A2ARole","description":"Message sender role in A2A conversations."},"A2ASecurityScheme":{"properties":{"schemes":{"items":{"type":"string"},"type":"array","title":"Schemes"},"credentials":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Credentials"}},"type":"object","title":"A2ASecurityScheme","description":"Authentication requirements for an A2A agent. Spec v0.3 §3.1."},"ATOStatus":{"type":"string","enum":["authorized","in_process","ready","not_started"],"title":"ATOStatus"},"AccuracyMetrics":{"properties":{"override_rate":{"$ref":"#/components/schemas/TrendMetric"},"false_block_rate":{"$ref":"#/components/schemas/TrendMetric"},"false_approve_rate":{"$ref":"#/components/schemas/TrendMetric"}},"type":"object","required":["override_rate","false_block_rate","false_approve_rate"],"title":"AccuracyMetrics"},"Action":{"properties":{"type":{"$ref":"#/components/schemas/ActionType"},"verb":{"type":"string","maxLength":128,"title":"Verb"},"target":{"$ref":"#/components/schemas/ActionTarget"},"payload":{"$ref":"#/components/schemas/ActionPayload"}},"type":"object","required":["type","verb","target","payload"],"title":"Action","description":"The action the agent intends to take. Spec §3.2 intent.action."},"ActionPayload":{"properties":{"summary":{"type":"string","maxLength":1000,"minLength":10,"title":"Summary"},"content":{"additionalProperties":true,"type":"object","title":"Content"},"estimated_impact":{"$ref":"#/components/schemas/EstimatedImpact"}},"type":"object","required":["summary","content","estimated_impact"],"title":"ActionPayload","description":"Structured content of the action. Spec §3.2 intent.action.payload."},"ActionTarget":{"properties":{"type":{"$ref":"#/components/schemas/TargetType"},"identifier":{"type":"string","maxLength":512,"title":"Identifier"},"sensitivity":{"$ref":"#/components/schemas/Sensitivity","default":"public"},"jurisdiction":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Jurisdiction"}},"type":"object","required":["type","identifier"],"title":"ActionTarget","description":"What the action is directed at. Spec §3.2 intent.action.target."},"ActionType":{"type":"string","enum":["communicate","transact","access","control","publish","recommend","modify"],"title":"ActionType","description":"Category of agent action. Spec §3.3."},"ActivatedPolicyRecord":{"properties":{"record_id":{"type":"string","title":"Record Id"},"policy_id":{"type":"string","title":"Policy Id"},"org_id":{"type":"string","title":"Org Id"},"policy_name":{"type":"string","title":"Policy Name"},"policy_version":{"type":"string","title":"Policy Version"},"activated_at":{"type":"string","format":"date-time","title":"Activated At"},"activated_by":{"type":"string","title":"Activated By"},"description":{"type":"string","title":"Description"},"recommended_severity":{"type":"string","title":"Recommended Severity"},"recommended_verdict":{"type":"string","title":"Recommended Verdict"}},"type":"object","required":["record_id","policy_id","org_id","policy_name","policy_version","activated_at","activated_by","description","recommended_severity","recommended_verdict"],"title":"ActivatedPolicyRecord","description":"Lightweight log entry created when a draft policy is successfully activated.\n\nStored in InMemoryActivationLog for the duration of the server session."},"ActivationRequest":{"properties":{"mode":{"type":"string","title":"Mode","default":"live"},"confirmation":{"type":"string","title":"Confirmation","default":""}},"type":"object","title":"ActivationRequest"},"AgentContractTestRequest":{"properties":{"framework":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Framework"}},"type":"object","title":"AgentContractTestRequest"},"AgentDelegationLimits":{"properties":{"max_financial_exposure_usd":{"type":"number","title":"Max Financial Exposure Usd","default":0.0},"max_audience_size":{"type":"integer","title":"Max Audience Size","default":1},"allowed_action_types":{"items":{"type":"string"},"type":"array","title":"Allowed Action Types"},"prohibited_action_types":{"items":{"type":"string"},"type":"array","title":"Prohibited Action Types"},"data_access_scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data Access Scope"}},"type":"object","title":"AgentDelegationLimits"},"AgentExplorerEnvelope":{"properties":{"agent_explorer":{"$ref":"#/components/schemas/AgentExplorerResponse"}},"type":"object","required":["agent_explorer"],"title":"AgentExplorerEnvelope"},"AgentExplorerResponse":{"properties":{"agents":{"items":{"$ref":"#/components/schemas/AgentStats"},"type":"array","title":"Agents"},"total":{"type":"integer","title":"Total","default":0},"limit":{"type":"integer","title":"Limit","default":20},"offset":{"type":"integer","title":"Offset","default":0}},"type":"object","title":"AgentExplorerResponse","description":"Agent explorer listing. Spec Section 7.1."},"AgentFramework":{"type":"string","enum":["langchain","autogen","crewai","openai_assistants","anthropic_tools","semantic_kernel","haystack","custom"],"title":"AgentFramework","description":"Agent framework identifier. Spec §3.2 intent.agent.framework."},"AgentInfo":{"properties":{"id":{"type":"string","maxLength":256,"title":"Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"framework":{"$ref":"#/components/schemas/AgentFramework","default":"custom"},"version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Version"},"owner":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Owner"},"trust_tier":{"anyOf":[{"$ref":"#/components/schemas/TrustTier"},{"type":"null"}]}},"type":"object","required":["id"],"title":"AgentInfo","description":"Identity of the agent proposing the action. Spec §3.2 intent.agent."},"AgentRiskProfile":{"properties":{"name":{"type":"string","title":"Name"},"risk_assessment":{"type":"string","title":"Risk Assessment","default":"moderate"},"primary_risks":{"items":{"type":"string"},"type":"array","title":"Primary Risks"},"recommended_delegation_limits":{"$ref":"#/components/schemas/AgentDelegationLimits"},"enrichment_sources_required":{"items":{"type":"string"},"type":"array","title":"Enrichment Sources Required"},"deliberation_panel":{"items":{"type":"string"},"type":"array","title":"Deliberation Panel"}},"type":"object","required":["name"],"title":"AgentRiskProfile"},"AgentStats":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"agent_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Name"},"total_decisions":{"type":"integer","title":"Total Decisions","default":0},"blocked":{"type":"integer","title":"Blocked","default":0},"approved":{"type":"integer","title":"Approved","default":0},"modified":{"type":"integer","title":"Modified","default":0},"escalated":{"type":"integer","title":"Escalated","default":0},"block_rate":{"type":"number","title":"Block Rate","default":0.0},"avg_risk":{"type":"number","title":"Avg Risk","default":0.0}},"type":"object","required":["agent_id"],"title":"AgentStats","description":"Per-agent governance statistics. Spec Section 7.1."},"AlternativeAction":{"properties":{"description":{"type":"string","title":"Description"},"action_verb":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Action Verb"},"suggested_content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Suggested Content"},"compliance_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Compliance Status"}},"type":"object","required":["description"],"title":"AlternativeAction","description":"A suggested alternative the agent could take instead. Spec §4.1."},"AppliedBundleResponse":{"properties":{"org_id":{"type":"string","title":"Org Id"},"manifest":{"additionalProperties":{"type":"string"},"type":"object","title":"Manifest"},"manifest_hash":{"type":"string","title":"Manifest Hash"},"policy_ids":{"items":{"type":"string"},"type":"array","title":"Policy Ids"},"policies_applied":{"type":"integer","title":"Policies Applied"},"escalation_routes":{"type":"integer","title":"Escalation Routes"},"drift":{"items":{"type":"string"},"type":"array","title":"Drift"},"applied_at":{"type":"string","format":"date-time","title":"Applied At"},"applied_by":{"type":"string","title":"Applied By"}},"type":"object","required":["org_id","manifest","manifest_hash","policy_ids","policies_applied","escalation_routes","drift","applied_at","applied_by"],"title":"AppliedBundleResponse"},"AssignmentMode":{"type":"string","enum":["any","all","quorum"],"title":"AssignmentMode","description":"How multiple reviewers are handled. Escalation-spec §3.3."},"AttentionItem":{"properties":{"id":{"type":"string","title":"Id"},"type":{"type":"string","title":"Type"},"urgency":{"type":"string","title":"Urgency"},"title":{"type":"string","title":"Title"},"description":{"type":"string","title":"Description"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp"},"reference_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reference Id"},"reference_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reference Type"}},"type":"object","required":["id","type","urgency","title","description","timestamp"],"title":"AttentionItem","description":"A single attention item. Spec Section 3.3."},"AttentionQueueEnvelope":{"properties":{"attention_queue":{"$ref":"#/components/schemas/AttentionQueueResponse"}},"type":"object","required":["attention_queue"],"title":"AttentionQueueEnvelope"},"AttentionQueueResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/AttentionItem"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total","default":0},"generated_at":{"type":"string","format":"date-time","title":"Generated At"}},"type":"object","required":["generated_at"],"title":"AttentionQueueResponse","description":"Current attention items, ranked by urgency. Spec Section 10.3."},"AuditA2AContext":{"properties":{"context_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Context Id"},"task_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Id"},"source_agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Agent Id"},"source_agent_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Agent Url"},"target_agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Agent Id"},"target_agent_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Agent Url"},"parent_audit_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Audit Id"},"delegation_depth":{"type":"integer","title":"Delegation Depth","default":0},"chain_root_audit_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chain Root Audit Id"}},"type":"object","title":"AuditA2AContext","description":"A2A-specific audit context for inter-agent interactions."},"AuditAP2Context":{"properties":{"transaction_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Transaction Id"},"intent_mandate_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Intent Mandate Id"},"cart_mandate_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cart Mandate Id"},"payment_mandate_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payment Mandate Id"},"amount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Amount"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency"},"modality":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Modality"},"merchant_agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Merchant Agent Id"},"mandate_conditions_met":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Mandate Conditions Met"},"cumulative_spend":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cumulative Spend"},"spend_limit_remaining":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Spend Limit Remaining"}},"type":"object","title":"AuditAP2Context","description":"AP2-specific audit context for payment governance decisions."},"AuditAction":{"properties":{"type":{"type":"string","title":"Type"},"verb":{"type":"string","title":"Verb"},"target":{"$ref":"#/components/schemas/AuditTarget"},"payload":{"$ref":"#/components/schemas/AuditActionPayload"}},"type":"object","required":["type","verb","target","payload"],"title":"AuditAction","description":"Action as captured in the audit trail."},"AuditActionPayload":{"properties":{"summary":{"type":"string","title":"Summary"},"estimated_impact":{"$ref":"#/components/schemas/AuditEstimatedImpact"}},"type":"object","required":["summary","estimated_impact"],"title":"AuditActionPayload","description":"Action payload summary for the audit trail."},"AuditAgent":{"properties":{"id":{"type":"string","title":"Id"},"framework":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Framework"},"owner":{"type":"string","title":"Owner"},"trust_tier":{"type":"string","title":"Trust Tier"}},"type":"object","required":["id","owner","trust_tier"],"title":"AuditAgent","description":"Agent identity as captured in the audit trail. Audit-spec §3.2."},"AuditAlternativeAction":{"properties":{"description":{"type":"string","title":"Description"},"compliance_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Compliance Status"}},"type":"object","required":["description"],"title":"AuditAlternativeAction","description":"Alternative action in the audit trail."},"AuditApplicablePolicy":{"properties":{"id":{"type":"string","title":"Id"},"version":{"type":"string","title":"Version"},"tier":{"type":"integer","maximum":4.0,"minimum":1.0,"title":"Tier"},"name":{"type":"string","title":"Name"}},"type":"object","required":["id","version","tier","name"],"title":"AuditApplicablePolicy","description":"Policy reference in the audit trail."},"AuditContradiction":{"properties":{"id":{"type":"string","title":"Id"},"type":{"type":"string","title":"Type"},"field":{"type":"string","title":"Field"},"agent_declared":{"title":"Agent Declared"},"enriched_value":{"title":"Enriched Value"},"severity":{"type":"string","title":"Severity"},"source":{"type":"string","title":"Source"},"description":{"type":"string","title":"Description"}},"type":"object","required":["id","type","field","severity","source","description"],"title":"AuditContradiction","description":"Contradiction as captured in the audit trail."},"AuditEnvelope":{"properties":{"audit":{"$ref":"#/components/schemas/AuditRecord"}},"type":"object","required":["audit"],"title":"AuditEnvelope"},"AuditEstimatedImpact":{"properties":{"reversible":{"type":"boolean","title":"Reversible"},"financial_exposure_usd":{"type":"number","title":"Financial Exposure Usd","default":0.0},"audience_size":{"type":"integer","title":"Audience Size","default":1},"regulatory_domains":{"items":{"type":"string"},"type":"array","title":"Regulatory Domains"},"data_categories":{"items":{"type":"string"},"type":"array","title":"Data Categories"}},"type":"object","required":["reversible"],"title":"AuditEstimatedImpact","description":"Impact assessment as captured in the audit trail."},"AuditExecution":{"properties":{"status":{"$ref":"#/components/schemas/ExecutionStatus"},"agent_notified_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Agent Notified At"},"agent_acknowledged":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Agent Acknowledged"},"agent_took_alternative":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Took Alternative"},"human_review":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Human Review"}},"type":"object","required":["status"],"title":"AuditExecution","description":"Post-decision execution tracking. Audit-spec §3.2 execution."},"AuditExportDetail":{"properties":{"records":{"items":{"$ref":"#/components/schemas/AuditRecord"},"type":"array","title":"Records"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"export_metadata":{"$ref":"#/components/schemas/AuditExportMetadata"}},"type":"object","required":["records","total","limit","offset","export_metadata"],"title":"AuditExportDetail"},"AuditExportEnvelope":{"properties":{"export":{"$ref":"#/components/schemas/AuditExportDetail"}},"type":"object","required":["export"],"title":"AuditExportEnvelope"},"AuditExportMetadata":{"properties":{"exported_at":{"type":"string","format":"date-time","title":"Exported At"},"format":{"type":"string","title":"Format"},"filters":{"additionalProperties":true,"type":"object","title":"Filters"},"chain_valid":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Chain Valid"}},"type":"object","required":["exported_at","format","filters"],"title":"AuditExportMetadata"},"AuditGovernanceRequest":{"properties":{"urgency":{"type":"string","title":"Urgency"},"max_latency_ms":{"type":"integer","title":"Max Latency Ms"},"fallback_on_timeout":{"type":"string","title":"Fallback On Timeout"}},"type":"object","required":["urgency","max_latency_ms","fallback_on_timeout"],"title":"AuditGovernanceRequest","description":"Governance request as captured in the audit trail."},"AuditHumanOverride":{"properties":{"override_id":{"type":"string","title":"Override Id"},"blocked_intent_id":{"type":"string","title":"Blocked Intent Id","description":"The blocked intent a person approved."},"approved_by":{"type":"string","title":"Approved By","description":"Who approved it, as recorded at approval time."},"approved_at":{"type":"string","format":"date-time","title":"Approved At"},"policies_overridden":{"items":{"type":"string"},"type":"array","title":"Policies Overridden","description":"The blocking policies the approval set aside for this retry."}},"type":"object","required":["override_id","blocked_intent_id","approved_by","approved_at"],"title":"AuditHumanOverride","description":"A person's approval that turned this retry's BLOCK into APPROVE (single use, 24 hours)."},"AuditOrganization":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"}},"type":"object","required":["id","name"],"title":"AuditOrganization","description":"Organization identity in the audit record."},"AuditPipelineMetadata":{"properties":{"total_latency_ms":{"type":"integer","minimum":0.0,"title":"Total Latency Ms"},"stage_latencies":{"$ref":"#/components/schemas/StageLatencies"},"governance_version":{"type":"string","title":"Governance Version"},"pipeline_mode":{"$ref":"#/components/schemas/PipelineMode"},"policy_epoch":{"type":"integer","title":"Policy Epoch","default":0},"epoch_stale":{"type":"boolean","title":"Epoch Stale","default":false}},"type":"object","required":["total_latency_ms","stage_latencies","governance_version","pipeline_mode"],"title":"AuditPipelineMetadata","description":"Pipeline metadata in the audit record. Audit-spec §3.2."},"AuditPolicyVerdict":{"properties":{"policy_id":{"type":"string","title":"Policy Id"},"verdict":{"type":"string","title":"Verdict"},"severity":{"type":"string","title":"Severity"},"reasoning":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reasoning"}},"type":"object","required":["policy_id","verdict","severity"],"title":"AuditPolicyVerdict","description":"Per-policy verdict in the audit trail."},"AuditRecord":{"properties":{"id":{"type":"string","title":"Id"},"version":{"type":"string","title":"Version","default":"1.0"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hash"},"previous_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Previous Hash"},"signature":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signature"},"organization":{"$ref":"#/components/schemas/AuditOrganization"},"stage_1_intent":{"$ref":"#/components/schemas/AuditStageIntent"},"stage_2_enrichment":{"$ref":"#/components/schemas/AuditStageEnrichment"},"stage_3_policy_evaluation":{"$ref":"#/components/schemas/AuditStagePolicyEvaluation"},"stage_4_deliberation":{"$ref":"#/components/schemas/AuditStageDeliberation"},"stage_5_decision":{"$ref":"#/components/schemas/AuditStageDecision"},"execution":{"$ref":"#/components/schemas/AuditExecution"},"pipeline_metadata":{"$ref":"#/components/schemas/AuditPipelineMetadata"},"signing_metadata":{"anyOf":[{"$ref":"#/components/schemas/AuditSigningMetadata"},{"type":"null"}]},"a2a_context":{"anyOf":[{"$ref":"#/components/schemas/AuditA2AContext"},{"type":"null"}]},"ap2_context":{"anyOf":[{"$ref":"#/components/schemas/AuditAP2Context"},{"type":"null"}]},"human_override":{"anyOf":[{"$ref":"#/components/schemas/AuditHumanOverride"},{"type":"null"}]}},"type":"object","required":["id","created_at","organization","stage_1_intent","stage_2_enrichment","stage_3_policy_evaluation","stage_4_deliberation","stage_5_decision","execution","pipeline_metadata"],"title":"AuditRecord","description":"The immutable audit record — one per governance decision.\n\nContains the complete reconstruction of the governance pipeline:\nintent, enrichment, policy evaluation, deliberation, decision,\nand post-decision execution status.\nSpec: decision-audit-service-spec.md Section 3."},"AuditRiskAssessment":{"properties":{"score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Score"},"classification":{"$ref":"#/components/schemas/RiskClassification"},"dimensions":{"$ref":"#/components/schemas/AuditRiskDimensions"}},"type":"object","required":["score","classification","dimensions"],"title":"AuditRiskAssessment","description":"Risk assessment in the audit trail."},"AuditRiskDimension":{"properties":{"score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Score"},"weight":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Weight"},"contribution":{"type":"number","minimum":0.0,"title":"Contribution"}},"type":"object","required":["score","weight","contribution"],"title":"AuditRiskDimension","description":"Risk dimension detail in the audit trail."},"AuditRiskDimensions":{"properties":{"reversibility":{"$ref":"#/components/schemas/AuditRiskDimension"},"financial_exposure":{"$ref":"#/components/schemas/AuditRiskDimension"},"regulatory_density":{"$ref":"#/components/schemas/AuditRiskDimension"},"audience_impact":{"$ref":"#/components/schemas/AuditRiskDimension"},"context_confidence":{"$ref":"#/components/schemas/AuditRiskDimension"},"novelty":{"$ref":"#/components/schemas/AuditRiskDimension"}},"type":"object","required":["reversibility","financial_exposure","regulatory_density","audience_impact","context_confidence","novelty"],"title":"AuditRiskDimensions","description":"All risk dimensions in the audit trail."},"AuditSigningMetadata":{"properties":{"signing_mode":{"type":"string","title":"Signing Mode","default":"gaas_only"},"customer_signature":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Signature"},"customer_key_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Key Id"},"unsigned_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unsigned Reason"}},"type":"object","title":"AuditSigningMetadata","description":"Multi-party signing metadata for co-signed audit records."},"AuditSourceResult":{"properties":{"source_id":{"type":"string","title":"Source Id"},"status":{"type":"string","title":"Status"},"latency_ms":{"type":"integer","minimum":0.0,"title":"Latency Ms"},"source_confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Source Confidence"}},"type":"object","required":["source_id","status","latency_ms","source_confidence"],"title":"AuditSourceResult","description":"Source query result in the audit trail."},"AuditStageDecision":{"properties":{"verdict":{"$ref":"#/components/schemas/Verdict"},"decided_at":{"type":"string","format":"date-time","title":"Decided At"},"decision_path":{"$ref":"#/components/schemas/DecisionPath"},"reasoning":{"type":"string","title":"Reasoning"},"blocking_policies":{"items":{"type":"string"},"type":"array","title":"Blocking Policies"},"modifications_applied":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Modifications Applied"},"alternative_actions_suggested":{"items":{"$ref":"#/components/schemas/AuditAlternativeAction"},"type":"array","title":"Alternative Actions Suggested"}},"type":"object","required":["verdict","decided_at","decision_path","reasoning"],"title":"AuditStageDecision","description":"Stage 5 snapshot in the audit record. Audit-spec §3.2 stage_5_decision."},"AuditStageDeliberation":{"properties":{"triggered":{"type":"boolean","title":"Triggered"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"},"skip_reason":{"anyOf":[{"type":"string","enum":["NOT_TRIGGERED","SHADOW_MODE","LLM_FAILURE"]},{"type":"null"}],"title":"Skip Reason"},"deliberation_record":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Deliberation Record"}},"type":"object","required":["triggered"],"title":"AuditStageDeliberation","description":"Stage 4 snapshot in the audit record. Audit-spec §3.2 stage_4_deliberation."},"AuditStageEnrichment":{"properties":{"enriched_at":{"type":"string","format":"date-time","title":"Enriched At"},"enrichment_latency_ms":{"type":"integer","minimum":0.0,"title":"Enrichment Latency Ms"},"sources_queried":{"items":{"$ref":"#/components/schemas/AuditSourceResult"},"type":"array","title":"Sources Queried"},"sources_failed":{"items":{"$ref":"#/components/schemas/AuditSourceResult"},"type":"array","title":"Sources Failed"},"enriched_context":{"additionalProperties":true,"type":"object","title":"Enriched Context"},"contradictions":{"items":{"$ref":"#/components/schemas/AuditContradiction"},"type":"array","title":"Contradictions"},"missing_context":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Missing Context"},"context_confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Context Confidence"}},"type":"object","required":["enriched_at","enrichment_latency_ms","context_confidence"],"title":"AuditStageEnrichment","description":"Stage 2 snapshot in the audit record. Audit-spec §3.2 stage_2_enrichment."},"AuditStageIntent":{"properties":{"intent_id":{"type":"string","title":"Intent Id"},"received_at":{"type":"string","format":"date-time","title":"Received At"},"agent":{"$ref":"#/components/schemas/AuditAgent"},"action":{"$ref":"#/components/schemas/AuditAction"},"governance_request":{"$ref":"#/components/schemas/AuditGovernanceRequest"},"context_provided":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Context Provided"}},"type":"object","required":["intent_id","received_at","agent","action","governance_request"],"title":"AuditStageIntent","description":"Stage 1 snapshot in the audit record. Audit-spec §3.2 stage_1_intent."},"AuditStagePolicyEvaluation":{"properties":{"evaluated_at":{"type":"string","format":"date-time","title":"Evaluated At"},"evaluation_latency_ms":{"type":"integer","minimum":0.0,"title":"Evaluation Latency Ms"},"applicable_policies":{"items":{"$ref":"#/components/schemas/AuditApplicablePolicy"},"type":"array","title":"Applicable Policies"},"verdicts":{"items":{"$ref":"#/components/schemas/AuditPolicyVerdict"},"type":"array","title":"Verdicts"},"overall_verdict":{"type":"string","title":"Overall Verdict"},"risk_assessment":{"$ref":"#/components/schemas/AuditRiskAssessment"}},"type":"object","required":["evaluated_at","evaluation_latency_ms","overall_verdict","risk_assessment"],"title":"AuditStagePolicyEvaluation","description":"Stage 3 snapshot in the audit record. Audit-spec §3.2 stage_3_policy_evaluation."},"AuditTarget":{"properties":{"type":{"type":"string","title":"Type"},"identifier":{"type":"string","title":"Identifier"},"sensitivity":{"type":"string","title":"Sensitivity"}},"type":"object","required":["type","identifier","sensitivity"],"title":"AuditTarget","description":"Action target as captured in the audit trail."},"BacktestChangedDecision":{"properties":{"audit_id":{"type":"string","title":"Audit Id"},"original_verdict":{"type":"string","title":"Original Verdict"},"hypothetical_verdict":{"type":"string","title":"Hypothetical Verdict"},"risk_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Risk Score"},"action_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Action Type"}},"type":"object","required":["audit_id","original_verdict","hypothetical_verdict"],"title":"BacktestChangedDecision"},"BacktestRequest":{"properties":{"parameter":{"type":"string","title":"Parameter"},"current_value":{"type":"number","title":"Current Value"},"proposed_value":{"type":"number","title":"Proposed Value"}},"type":"object","required":["parameter","current_value","proposed_value"],"title":"BacktestRequest"},"BacktestResult":{"properties":{"change_rate":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Change Rate"},"changed_decisions":{"items":{"$ref":"#/components/schemas/BacktestChangedDecision"},"type":"array","title":"Changed Decisions"},"total_decisions":{"type":"integer","title":"Total Decisions","default":0},"requires_human_review":{"type":"boolean","title":"Requires Human Review","default":false},"auto_apply_eligible":{"type":"boolean","title":"Auto Apply Eligible","default":true}},"type":"object","required":["change_rate"],"title":"BacktestResult","description":"Result of backtesting a proposed change. Spec §4.3."},"BacktestResultEnvelope":{"properties":{"backtest_result":{"$ref":"#/components/schemas/BacktestResult"}},"type":"object","required":["backtest_result"],"title":"BacktestResultEnvelope"},"BlockDetail":{"properties":{"reasons":{"items":{"$ref":"#/components/schemas/BlockReason"},"type":"array","title":"Reasons"},"alternative_actions":{"items":{"$ref":"#/components/schemas/AlternativeAction"},"type":"array","title":"Alternative Actions"},"resubmit_guidance":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resubmit Guidance"}},"type":"object","required":["reasons"],"title":"BlockDetail","description":"Details for a block decision. Decision-audit-spec §2.3 BLOCK."},"BlockReason":{"properties":{"policy_ref":{"type":"string","title":"Policy Ref"},"policy_name":{"type":"string","title":"Policy Name"},"tier":{"type":"integer","title":"Tier"},"severity":{"type":"string","title":"Severity"},"description":{"type":"string","title":"Description"},"regulatory_citation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Regulatory Citation"}},"type":"object","required":["policy_ref","policy_name","tier","severity","description"],"title":"BlockReason","description":"A single reason for a block. Decision-audit-spec §2.3 BLOCK."},"Body_appeal_submit_v1_intents__intent_id__appeal_post":{"properties":{"action":{"type":"string","title":"Action"},"token":{"type":"string","title":"Token"},"decision_id":{"type":"string","title":"Decision Id"},"reason":{"type":"string","title":"Reason","default":""}},"type":"object","required":["action","token","decision_id"],"title":"Body_appeal_submit_v1_intents__intent_id__appeal_post"},"Body_create_change_v1_subprocessor_changes_post":{"properties":{"vendor_name":{"type":"string","title":"Vendor Name"},"change_type":{"type":"string","title":"Change Type"},"purpose":{"type":"string","title":"Purpose"},"data_processed":{"type":"string","title":"Data Processed"},"region":{"type":"string","title":"Region"},"effective_date":{"type":"string","title":"Effective Date"},"security_certifications":{"type":"string","title":"Security Certifications","default":""},"dpa_status":{"type":"string","title":"Dpa Status","default":""},"vendor_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vendor Url"},"privacy_policy_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Privacy Policy Url"},"notes":{"type":"string","title":"Notes","default":""}},"type":"object","required":["vendor_name","change_type","purpose","data_processed","region","effective_date"],"title":"Body_create_change_v1_subprocessor_changes_post"},"Body_create_sequence_v1_drip_sequences_post":{"properties":{"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description","default":""},"steps":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Steps"}},"type":"object","required":["name"],"title":"Body_create_sequence_v1_drip_sequences_post"},"Body_submit_objection_v1_subprocessor_object_post":{"properties":{"token":{"type":"string","title":"Token"},"reason":{"type":"string","title":"Reason"},"contact_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contact Email"},"contact_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contact Name"}},"type":"object","required":["token","reason"],"title":"Body_submit_objection_v1_subprocessor_object_post"},"Body_update_sequence_v1_drip_sequences__sequence_id__put":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"steps":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Steps"},"active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Active"}},"type":"object","title":"Body_update_sequence_v1_drip_sequences__sequence_id__put"},"BulkDecisionEnvelope":{"properties":{"results":{"items":{"$ref":"#/components/schemas/BulkDecisionResult"},"type":"array","title":"Results"},"total":{"type":"integer","title":"Total"},"succeeded":{"type":"integer","title":"Succeeded"},"failed":{"type":"integer","title":"Failed"}},"type":"object","required":["results","total","succeeded","failed"],"title":"BulkDecisionEnvelope"},"BulkDecisionResult":{"properties":{"intent_id":{"type":"string","title":"Intent Id"},"decision":{"anyOf":[{"$ref":"#/components/schemas/GovernanceDecision"},{"type":"null"}]},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["intent_id"],"title":"BulkDecisionResult","description":"Result for a single intent within a bulk submission."},"BulkIntentSubmission":{"properties":{"intents":{"items":{"$ref":"#/components/schemas/IntentDeclaration"},"type":"array","maxItems":50,"minItems":1,"title":"Intents"}},"type":"object","required":["intents"],"title":"BulkIntentSubmission"},"BundleSubmission":{"properties":{"files":{"additionalProperties":{"type":"string"},"type":"object","minProperties":1,"title":"Files"},"attestation":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Attestation"}},"type":"object","required":["files"],"title":"BundleSubmission","description":"The .gaas/ bundle, submitted as file contents (max 256 KiB per file)."},"BurnRate":{"properties":{"slo_name":{"type":"string","title":"Slo Name"},"window":{"type":"string","enum":["1h","6h","24h","72h"],"title":"Window"},"burn_rate":{"type":"number","title":"Burn Rate","description":"Multiple of expected consumption rate"},"severity":{"$ref":"#/components/schemas/SLOSeverity"},"threshold_warning":{"type":"number","title":"Threshold Warning","description":"Burn rate that triggers warning","default":2.0},"threshold_critical":{"type":"number","title":"Threshold Critical","description":"Burn rate that triggers critical alert","default":10.0}},"type":"object","required":["slo_name","window","burn_rate","severity"],"title":"BurnRate","description":"Error budget burn rate.\n\nIndicates how quickly error budget is being consumed.\nA burn rate of 1.0 means consuming budget at exactly the expected rate.\nA burn rate of 2.0 means consuming budget twice as fast (budget will exhaust early)."},"BurnRateResponse":{"properties":{"burn_rates":{"items":{"$ref":"#/components/schemas/BurnRate"},"type":"array","title":"Burn Rates"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp"}},"type":"object","required":["burn_rates"],"title":"BurnRateResponse","description":"Response envelope for burn rate."},"CMMCComplianceStatus":{"properties":{"org_id":{"type":"string","title":"Org Id"},"assessed_at":{"type":"string","format":"date-time","title":"Assessed At"},"assessed_level":{"$ref":"#/components/schemas/CMMCLevel","default":2},"overall_status":{"$ref":"#/components/schemas/ComplianceStatus"},"implemented_count":{"type":"integer","title":"Implemented Count"},"partial_count":{"type":"integer","title":"Partial Count"},"requires_action_count":{"type":"integer","title":"Requires Action Count"},"level_1_complete":{"type":"boolean","title":"Level 1 Complete"},"level_2_complete":{"type":"boolean","title":"Level 2 Complete"},"practices":{"items":{"$ref":"#/components/schemas/CMMCPractice"},"type":"array","title":"Practices"}},"type":"object","required":["org_id","assessed_at","overall_status","implemented_count","partial_count","requires_action_count","level_1_complete","level_2_complete","practices"],"title":"CMMCComplianceStatus"},"CMMCDomain":{"type":"string","enum":["Access Control","Audit and Accountability","Configuration Management","Identification and Authentication","Incident Response","Maintenance","Media Protection","Personnel Security","Physical Protection","Recovery","Risk Management","Security Assessment","Situational Awareness","System and Communications Protection","System and Information Integrity"],"title":"CMMCDomain"},"CMMCLevel":{"type":"integer","enum":[1,2,3],"title":"CMMCLevel"},"CMMCPractice":{"properties":{"practice_id":{"type":"string","title":"Practice Id","description":"e.g. 'AC.1.001'"},"domain":{"$ref":"#/components/schemas/CMMCDomain"},"cmmc_level":{"$ref":"#/components/schemas/CMMCLevel"},"title":{"type":"string","title":"Title"},"requirement":{"type":"string","title":"Requirement"},"nist_mapping":{"type":"string","title":"Nist Mapping","description":"e.g. 'NIST SP 800-171 3.1.1'"},"status":{"$ref":"#/components/schemas/ComplianceStatus"},"gaas_capability":{"type":"string","title":"Gaas Capability"},"evidence":{"items":{"type":"string"},"type":"array","title":"Evidence"},"policy_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Policy Id"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"}},"type":"object","required":["practice_id","domain","cmmc_level","title","requirement","nist_mapping","status","gaas_capability"],"title":"CMMCPractice"},"CMMCReport":{"properties":{"org_id":{"type":"string","title":"Org Id"},"generated_at":{"type":"string","format":"date-time","title":"Generated At"},"report_version":{"type":"string","title":"Report Version","default":"1.0"},"framework_ref":{"type":"string","title":"Framework Ref","default":"CMMC 2.0 Model"},"assessed_level":{"$ref":"#/components/schemas/CMMCLevel","default":2},"compliance_status":{"$ref":"#/components/schemas/CMMCComplianceStatus"},"active_policies":{"items":{"type":"string"},"type":"array","title":"Active Policies"},"certification_body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Certification Body"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"}},"type":"object","required":["org_id","generated_at","compliance_status","active_policies","recommendations"],"title":"CMMCReport"},"CMMCReportEnvelope":{"properties":{"report":{"$ref":"#/components/schemas/CMMCReport"}},"type":"object","required":["report"],"title":"CMMCReportEnvelope"},"CMMCStatusEnvelope":{"properties":{"compliance":{"$ref":"#/components/schemas/CMMCComplianceStatus"}},"type":"object","required":["compliance"],"title":"CMMCStatusEnvelope"},"CalibrationActivity":{"properties":{"adjustments_applied":{"type":"integer","title":"Adjustments Applied","default":0},"adjustments_blocked_by_backtest":{"type":"integer","title":"Adjustments Blocked By Backtest","default":0},"insights_generated":{"type":"integer","title":"Insights Generated","default":0},"insights_actioned":{"type":"integer","title":"Insights Actioned","default":0}},"type":"object","title":"CalibrationActivity"},"CalibrationEnvelope":{"properties":{"calibration":{"$ref":"#/components/schemas/CalibrationState"}},"type":"object","required":["calibration"],"title":"CalibrationEnvelope"},"CalibrationHistoryEnvelope":{"properties":{"history":{"items":{"$ref":"#/components/schemas/CalibrationReport"},"type":"array","title":"History"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"}},"type":"object","required":["history","total","limit","offset"],"title":"CalibrationHistoryEnvelope"},"CalibrationReport":{"properties":{"date":{"type":"string","title":"Date"},"observations_analyzed":{"type":"integer","title":"Observations Analyzed","default":0},"weight_adjustments":{"items":{"$ref":"#/components/schemas/WeightAdjustment"},"type":"array","title":"Weight Adjustments"},"threshold_adjustments":{"items":{"$ref":"#/components/schemas/ThresholdAdjustment"},"type":"array","title":"Threshold Adjustments"},"no_adjustments_for":{"items":{"type":"string"},"type":"array","title":"No Adjustments For"}},"type":"object","required":["date"],"title":"CalibrationReport","description":"Daily calibration report. Spec §3.1."},"CalibrationState":{"properties":{"agent_weights":{"additionalProperties":{"type":"number"},"type":"object","title":"Agent Weights"},"deliberation_threshold":{"type":"number","title":"Deliberation Threshold","default":0.6},"risk_dimension_weights":{"additionalProperties":{"type":"number"},"type":"object","title":"Risk Dimension Weights"},"risk_thresholds":{"additionalProperties":{"type":"number"},"type":"object","title":"Risk Thresholds"},"last_calibrated":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Calibrated"},"circuit_breaker":{"$ref":"#/components/schemas/CircuitBreakerState","default":"normal"}},"type":"object","title":"CalibrationState","description":"Current calibration state. Spec §4.1."},"ChainVerificationDetail":{"properties":{"valid":{"type":"boolean","title":"Valid"},"total_records":{"type":"integer","title":"Total Records"},"verified_count":{"type":"integer","title":"Verified Count"},"first_broken_record_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Broken Record Id"},"errors":{"items":{"type":"string"},"type":"array","title":"Errors"},"forks":{"items":{"type":"string"},"type":"array","title":"Forks","description":"Your records whose predecessor also has another successor: written at the same moment as another record. Content and links are intact; not a break."}},"type":"object","required":["valid","total_records","verified_count"],"title":"ChainVerificationDetail"},"ChainVerificationEnvelope":{"properties":{"verification":{"$ref":"#/components/schemas/ChainVerificationDetail"}},"type":"object","required":["verification"],"title":"ChainVerificationEnvelope"},"CircuitBreakerState":{"type":"string","enum":["normal","frozen"],"title":"CircuitBreakerState","description":"Learning engine circuit breaker state. Learning-spec §7.3."},"CkbUpdatesEnvelope":{"properties":{"updates":{"items":{},"type":"array","title":"Updates"},"message":{"type":"string","title":"Message"}},"type":"object","required":["message"],"title":"CkbUpdatesEnvelope"},"CommandCenterEnvelope":{"properties":{"command_center":{"$ref":"#/components/schemas/CommandCenterResponse"}},"type":"object","required":["command_center"],"title":"CommandCenterEnvelope"},"CommandCenterMetrics":{"properties":{"decisions_today":{"type":"integer","title":"Decisions Today","default":0},"blocked_today":{"type":"integer","title":"Blocked Today","default":0},"escalations_pending":{"type":"integer","title":"Escalations Pending","default":0},"risk_index":{"type":"number","title":"Risk Index","default":0.0},"block_rate":{"type":"number","title":"Block Rate","default":0.0},"override_rate":{"type":"number","title":"Override Rate","default":0.0},"false_block_rate":{"type":"number","title":"False Block Rate","default":0.0},"pipeline_latency_p50":{"type":"integer","title":"Pipeline Latency P50","default":0},"pipeline_latency_p99":{"type":"integer","title":"Pipeline Latency P99","default":0},"deliberation_rate":{"type":"number","title":"Deliberation Rate","default":0.0},"shadow_mode_skipped_count":{"type":"integer","title":"Shadow Mode Skipped Count","default":0},"shadow_mode_skipped_rate":{"type":"number","title":"Shadow Mode Skipped Rate","default":0.0},"current_pipeline_mode":{"type":"string","title":"Current Pipeline Mode","default":"LIVE"}},"type":"object","title":"CommandCenterMetrics","description":"Key operational metrics. Spec Section 3.2."},"CommandCenterResponse":{"properties":{"metrics":{"$ref":"#/components/schemas/CommandCenterMetrics"},"recent_high_risk":{"items":{"$ref":"#/components/schemas/RecentHighRiskDecision"},"type":"array","title":"Recent High Risk"},"trends":{"items":{"$ref":"#/components/schemas/TrendPoint"},"type":"array","title":"Trends"},"generated_at":{"type":"string","format":"date-time","title":"Generated At"}},"type":"object","required":["metrics","generated_at"],"title":"CommandCenterResponse","description":"Full Command Center payload. Spec Section 10.3."},"ComplianceStatus":{"type":"string","enum":["implemented","partial","not_applicable","requires_action"],"title":"ComplianceStatus","description":"Status of a compliance requirement."},"ConsentBasis":{"type":"string","enum":["consent","contract","legal_obligation","legitimate_interest"],"title":"ConsentBasis","description":"Legal basis for processing under GDPR Article 6."},"ConsentGrantRequest":{"properties":{"purpose":{"$ref":"#/components/schemas/ConsentPurpose"},"basis":{"$ref":"#/components/schemas/ConsentBasis","default":"consent"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["purpose"],"title":"ConsentGrantRequest","description":"Request to grant consent for a purpose."},"ConsentPurpose":{"type":"string","enum":["governance_pipeline","analytics","learning_engine","communications","third_party_sharing"],"title":"ConsentPurpose","description":"GDPR-recognized processing purposes."},"ConsentRecord":{"properties":{"id":{"type":"string","title":"Id"},"org_id":{"type":"string","title":"Org Id"},"purpose":{"$ref":"#/components/schemas/ConsentPurpose"},"basis":{"$ref":"#/components/schemas/ConsentBasis"},"granted":{"type":"boolean","title":"Granted"},"granted_at":{"type":"string","format":"date-time","title":"Granted At"},"revoked_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Revoked At"},"ip_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ip Address"},"user_agent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Agent"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["id","org_id","purpose","basis","granted","granted_at"],"title":"ConsentRecord","description":"A single consent grant or revocation event."},"ConsentRecordEnvelope":{"properties":{"consent_record":{"$ref":"#/components/schemas/ConsentRecord"}},"type":"object","required":["consent_record"],"title":"ConsentRecordEnvelope"},"ConsentRevokedEnvelope":{"properties":{"status":{"type":"string","title":"Status"},"purpose":{"type":"string","title":"Purpose"},"revoked_at":{"type":"string","format":"date-time","title":"Revoked At"}},"type":"object","required":["status","purpose","revoked_at"],"title":"ConsentRevokedEnvelope"},"ConsentStatus":{"properties":{"org_id":{"type":"string","title":"Org Id"},"consents":{"items":{"$ref":"#/components/schemas/ConsentRecord"},"type":"array","title":"Consents"},"summary":{"additionalProperties":{"type":"boolean"},"type":"object","title":"Summary"}},"type":"object","required":["org_id","consents","summary"],"title":"ConsentStatus","description":"Current consent state for an org across all purposes."},"ConsentStatusEnvelope":{"properties":{"consent":{"$ref":"#/components/schemas/ConsentStatus"}},"type":"object","required":["consent"],"title":"ConsentStatusEnvelope"},"ContactAccepted":{"properties":{"id":{"type":"string","title":"Id"},"received_at":{"type":"string","format":"date-time","title":"Received At"}},"type":"object","required":["id","received_at"],"title":"ContactAccepted","description":"Response of ``POST /v1/contact`` (202)."},"ContactRequest":{"properties":{"name":{"type":"string","maxLength":200,"minLength":1,"title":"Name"},"email":{"type":"string","maxLength":254,"minLength":5,"pattern":"^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$","title":"Email"},"company":{"type":"string","maxLength":200,"minLength":1,"title":"Company"},"title":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Title"},"company_size":{"type":"string","enum":["1-50","51-200","201-1000","1001-5000","5000+"],"title":"Company Size"},"agents_in_production":{"anyOf":[{"type":"string","enum":["none","1-5","6-25","26+"]},{"type":"null"}],"title":"Agents In Production"},"topic":{"type":"string","enum":["sales","demo","security_review","partnership","other"],"title":"Topic"},"message":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Message"},"consent":{"type":"boolean","const":true,"title":"Consent","description":"Visitor accepted the privacy policy"},"source":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Source","default":"website"},"page":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Page"},"referrer":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Referrer"},"utm":{"anyOf":[{"$ref":"#/components/schemas/ContactUTM"},{"type":"null"}]},"website":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Website"},"ts":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ts"}},"type":"object","required":["name","email","company","company_size","topic","consent"],"title":"ContactRequest","description":"Body of ``POST /v1/contact``."},"ContactUTM":{"properties":{"utm_source":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Utm Source"},"utm_medium":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Utm Medium"},"utm_campaign":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Utm Campaign"},"utm_content":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Utm Content"},"utm_term":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Utm Term"}},"type":"object","title":"ContactUTM","description":"Marketing attribution captured by the page (all optional)."},"ContestStats":{"properties":{"pool_total":{"type":"integer","title":"Pool Total","description":"Total free decisions in the pool","default":250000000},"pool_used":{"type":"integer","title":"Pool Used","description":"Live decisions consumed across all orgs"},"pool_remaining":{"type":"integer","title":"Pool Remaining"},"pool_used_pct":{"type":"number","title":"Pool Used Pct","description":"Percentage of pool consumed (0-100)"},"active_participants":{"type":"integer","title":"Active Participants","description":"Agents with >= 10 live decisions (leaderboard-eligible)","default":0},"top_agent":{"anyOf":[{"$ref":"#/components/schemas/TopAgent"},{"type":"null"}]},"contest_ends_at":{"type":"string","format":"date-time","title":"Contest Ends At"},"days_left":{"type":"integer","title":"Days Left"},"generated_at":{"type":"string","format":"date-time","title":"Generated At"}},"type":"object","required":["pool_used","pool_remaining","pool_used_pct","contest_ends_at","days_left","generated_at"],"title":"ContestStats","description":"Snapshot of the 250M free-decisions promotion."},"ContestStatsEnvelope":{"properties":{"contest":{"$ref":"#/components/schemas/ContestStats"}},"type":"object","required":["contest"],"title":"ContestStatsEnvelope"},"ContextIntake":{"properties":{"org_id":{"type":"string","title":"Org Id"},"intake_id":{"type":"string","title":"Intake Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"inputs":{"$ref":"#/components/schemas/IntakeInputs"},"status":{"$ref":"#/components/schemas/IntakeInputStatus","default":"provided"}},"type":"object","required":["org_id","intake_id","created_at"],"title":"ContextIntake","description":"Customer context intake. Spec §2.1."},"ContextPackage":{"properties":{"intent_summary":{"type":"string","title":"Intent Summary"},"action_type":{"type":"string","title":"Action Type"},"agent_id":{"type":"string","title":"Agent Id"},"target_summary":{"type":"string","title":"Target Summary"},"stakes_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stakes Summary"},"key_facts":{"items":{"$ref":"#/components/schemas/KeyFact"},"type":"array","title":"Key Facts"},"contradictions":{"items":{"$ref":"#/components/schemas/ContradictionSummary"},"type":"array","title":"Contradictions"},"policy_evaluation_summary":{"anyOf":[{"$ref":"#/components/schemas/PolicyEvalSummary"},{"type":"null"}]},"deliberation_summary":{"anyOf":[{"$ref":"#/components/schemas/DeliberationSummary"},{"type":"null"}]},"audit_ref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Audit Ref"}},"type":"object","required":["intent_summary","action_type","agent_id","target_summary"],"title":"ContextPackage","description":"Full context package for the human reviewer. Spec §2.1 context_package."},"ContextPackageEnvelope":{"properties":{"context_package":{"$ref":"#/components/schemas/ContextPackage"}},"type":"object","required":["context_package"],"title":"ContextPackageEnvelope"},"ContextProvided":{"properties":{"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"},"conversation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conversation Id"},"user_state":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"User State"},"environment":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Environment"},"prior_intents":{"items":{"type":"string"},"type":"array","title":"Prior Intents"},"custom":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Custom"}},"type":"object","title":"ContextProvided","description":"Context the agent chooses to share. Spec §3.2 intent.context_provided."},"ContradictionSummary":{"properties":{"description":{"type":"string","title":"Description"},"severity":{"type":"string","title":"Severity"}},"type":"object","required":["description","severity"],"title":"ContradictionSummary"},"ControlEvidencePackage":{"properties":{"control_id":{"type":"string","title":"Control Id"},"control_family":{"type":"string","title":"Control Family"},"framework":{"type":"string","title":"Framework"},"title":{"type":"string","title":"Title"},"requirement":{"type":"string","title":"Requirement"},"implementation_status":{"$ref":"#/components/schemas/ComplianceStatus"},"gaas_capability_description":{"type":"string","title":"Gaas Capability Description"},"evidence_artifacts":{"items":{"$ref":"#/components/schemas/EvidenceArtifactRef"},"type":"array","title":"Evidence Artifacts"},"api_evidence_endpoints":{"items":{"type":"string"},"type":"array","title":"Api Evidence Endpoints"},"enforcing_policy_ids":{"items":{"type":"string"},"type":"array","title":"Enforcing Policy Ids"},"assessment_procedures":{"items":{"type":"string"},"type":"array","title":"Assessment Procedures","description":"NIST SP 800-53A format: '[EXAMINE/TEST] [object] to verify [criterion]'"},"last_assessed_at":{"type":"string","format":"date-time","title":"Last Assessed At"},"assessment_notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assessment Notes"}},"type":"object","required":["control_id","control_family","framework","title","requirement","implementation_status","gaas_capability_description","evidence_artifacts","api_evidence_endpoints","enforcing_policy_ids","assessment_procedures","last_assessed_at"],"title":"ControlEvidencePackage"},"ControlEvidencePackageEnvelope":{"properties":{"evidence":{"$ref":"#/components/schemas/ControlEvidencePackage"}},"type":"object","required":["evidence"],"title":"ControlEvidencePackageEnvelope"},"CreateKeyRequest":{"properties":{"label":{"type":"string","maxLength":128,"title":"Label","default":"default"},"expires_in_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Expires In Days","description":"Days until expiration (None = default from env, 0 = never)"},"role":{"type":"string","enum":["admin","operator","viewer"],"title":"Role","description":"Role granted to this key. Admin keys require the caller to have admin role.","default":"operator"}},"type":"object","title":"CreateKeyRequest"},"DailyDigestEnvelope":{"properties":{"daily_digest":{"$ref":"#/components/schemas/DailyDigestResponse"}},"type":"object","required":["daily_digest"],"title":"DailyDigestEnvelope"},"DailyDigestResponse":{"properties":{"period":{"type":"string","title":"Period"},"decisions_total":{"type":"integer","title":"Decisions Total","default":0},"decisions_blocked":{"type":"integer","title":"Decisions Blocked","default":0},"decisions_modified":{"type":"integer","title":"Decisions Modified","default":0},"decisions_escalated":{"type":"integer","title":"Decisions Escalated","default":0},"decisions_approved":{"type":"integer","title":"Decisions Approved","default":0},"escalations_pending":{"type":"integer","title":"Escalations Pending","default":0},"notable_events":{"items":{"type":"string"},"type":"array","title":"Notable Events"},"risk_index":{"type":"number","title":"Risk Index","default":0.0},"generated_at":{"type":"string","format":"date-time","title":"Generated At"}},"type":"object","required":["period","generated_at"],"title":"DailyDigestResponse","description":"Daily digest content. Spec Section 9.2."},"DashboardApproval":{"properties":{"org_id":{"type":"string","maxLength":128,"title":"Org Id"},"approved_by":{"type":"string","maxLength":254,"minLength":3,"title":"Approved By","description":"The signed-in person's email."},"role":{"type":"string","title":"Role"},"mfa_verified":{"type":"boolean","title":"Mfa Verified"}},"type":"object","required":["org_id","approved_by","role","mfa_verified"],"title":"DashboardApproval"},"DataExportCategory":{"properties":{"category":{"type":"string","title":"Category"},"record_count":{"type":"integer","title":"Record Count"},"data":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Data"}},"type":"object","required":["category","record_count","data"],"title":"DataExportCategory","description":"A category of exported data with record count."},"DataExportEnvelope":{"properties":{"export":{"$ref":"#/components/schemas/DataExportResult"}},"type":"object","required":["export"],"title":"DataExportEnvelope"},"DataExportResult":{"properties":{"org_id":{"type":"string","title":"Org Id"},"exported_at":{"type":"string","format":"date-time","title":"Exported At"},"categories":{"items":{"$ref":"#/components/schemas/DataExportCategory"},"type":"array","title":"Categories"},"total_records":{"type":"integer","title":"Total Records"},"format":{"type":"string","title":"Format","default":"json"},"gdpr_article":{"type":"string","title":"Gdpr Article","default":"Article 20 — Right to Data Portability"}},"type":"object","required":["org_id","exported_at","categories","total_records"],"title":"DataExportResult","description":"The full GDPR data export package."},"DataPart":{"properties":{"type":{"type":"string","const":"data","title":"Type","default":"data"},"mimeType":{"type":"string","maxLength":128,"title":"Mimetype","default":"application/json"},"data":{"additionalProperties":true,"type":"object","title":"Data"}},"type":"object","title":"DataPart","description":"Structured data content part (JSON payload). Spec v0.3 §4.1."},"DataProfile":{"properties":{"data_types_handled":{"items":{"$ref":"#/components/schemas/DataTypeMatch"},"type":"array","title":"Data Types Handled"},"sensitivity_level":{"type":"string","title":"Sensitivity Level","default":"internal"}},"type":"object","title":"DataProfile"},"DataTypeMatch":{"properties":{"type":{"type":"string","title":"Type"},"confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence"},"source":{"type":"string","title":"Source","default":""}},"type":"object","required":["type","confidence"],"title":"DataTypeMatch"},"DeactivationRequest":{"properties":{"mode":{"type":"string","title":"Mode","default":"shadow"},"reason":{"type":"string","title":"Reason","default":""}},"type":"object","title":"DeactivationRequest"},"DecisionEnvelope":{"properties":{"decision":{"$ref":"#/components/schemas/GovernanceDecision"},"enforcement":{"anyOf":[{"$ref":"#/components/schemas/EnforcementStatus"},{"type":"null"}]}},"type":"object","required":["decision"],"title":"DecisionEnvelope"},"DecisionExplanation":{"properties":{"decision_id":{"type":"string","title":"Decision Id"},"intent_id":{"type":"string","title":"Intent Id"},"org_id":{"type":"string","title":"Org Id"},"explained_at":{"type":"string","format":"date-time","title":"Explained At"},"verdict":{"type":"string","title":"Verdict"},"verdict_reason":{"type":"string","title":"Verdict Reason"},"sections":{"items":{"$ref":"#/components/schemas/ExplanationSection"},"type":"array","title":"Sections"},"data_used":{"items":{"type":"string"},"type":"array","title":"Data Used"},"logic_summary":{"type":"string","title":"Logic Summary"},"risk_factors":{"items":{"type":"string"},"type":"array","title":"Risk Factors"},"human_review_available":{"type":"boolean","title":"Human Review Available"},"escalation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Escalation Id"},"gdpr_article":{"type":"string","title":"Gdpr Article","default":"Article 22 — Right to Explanation"}},"type":"object","required":["decision_id","intent_id","org_id","explained_at","verdict","verdict_reason","sections","data_used","logic_summary","risk_factors","human_review_available"],"title":"DecisionExplanation","description":"Full GDPR-compliant explanation of an automated decision."},"DecisionExplanationEnvelope":{"properties":{"explanation":{"$ref":"#/components/schemas/DecisionExplanation"}},"type":"object","required":["explanation"],"title":"DecisionExplanationEnvelope"},"DecisionPath":{"type":"string","enum":["policy_engine_direct","deliberation","human_override"],"title":"DecisionPath","description":"How the final decision was reached. Audit-spec §3.2."},"DecisionReasoning":{"properties":{"summary":{"type":"string","title":"Summary"},"policies_evaluated":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Policies Evaluated"},"policies_passed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Policies Passed"},"policies_conditional":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Policies Conditional"},"policies_failed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Policies Failed"},"risk_classification":{"anyOf":[{"$ref":"#/components/schemas/RiskClassification"},{"type":"null"}]},"deliberation_verdict":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Deliberation Verdict"},"deliberation_required":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Deliberation Required"},"consensus_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Consensus Type"},"panel_votes":{"anyOf":[{"additionalProperties":{"type":"integer"},"type":"object"},{"type":"null"}],"title":"Panel Votes"},"blocking_policy_tier":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Blocking Policy Tier"},"blocking_policies":{"items":{"type":"string"},"type":"array","title":"Blocking Policies"},"blocking_policy_reasons":{"items":{"type":"string"},"type":"array","title":"Blocking Policy Reasons"}},"type":"object","required":["summary"],"title":"DecisionReasoning","description":"Human-readable reasoning for the decision. Decision-audit-spec §2.3."},"DecisionStreamEntry":{"properties":{"intent_id":{"type":"string","title":"Intent Id"},"decision_id":{"type":"string","title":"Decision Id"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp"},"verdict":{"type":"string","title":"Verdict"},"risk_score":{"type":"number","title":"Risk Score"},"risk_classification":{"type":"string","title":"Risk Classification"},"agent_id":{"type":"string","title":"Agent Id"},"agent_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Name"},"action_type":{"type":"string","title":"Action Type"},"action_summary":{"type":"string","title":"Action Summary"},"deliberation_triggered":{"type":"boolean","title":"Deliberation Triggered"},"policies_evaluated":{"type":"integer","title":"Policies Evaluated","default":0},"policies_failed":{"type":"integer","title":"Policies Failed","default":0},"audit_ref":{"type":"string","title":"Audit Ref"},"pipeline_mode":{"type":"string","title":"Pipeline Mode","default":"live"}},"type":"object","required":["intent_id","decision_id","timestamp","verdict","risk_score","risk_classification","agent_id","action_type","action_summary","deliberation_triggered","audit_ref"],"title":"DecisionStreamEntry","description":"A single entry in the decision stream. Spec Section 4.1."},"DecisionStreamEnvelope":{"properties":{"decision_stream":{"$ref":"#/components/schemas/DecisionStreamResponse"}},"type":"object","required":["decision_stream"],"title":"DecisionStreamEnvelope"},"DecisionStreamResponse":{"properties":{"decisions":{"items":{"$ref":"#/components/schemas/DecisionStreamEntry"},"type":"array","title":"Decisions"},"total":{"type":"integer","title":"Total","default":0},"limit":{"type":"integer","title":"Limit","default":20},"offset":{"type":"integer","title":"Offset","default":0}},"type":"object","title":"DecisionStreamResponse","description":"Paginated decision stream. Spec Section 4.1."},"DeliberationSummary":{"properties":{"occurred":{"type":"boolean","title":"Occurred","default":false},"panel":{"items":{"type":"string"},"type":"array","title":"Panel"},"result":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Result"},"key_positions":{"items":{"$ref":"#/components/schemas/DeliberationSummaryEntry"},"type":"array","title":"Key Positions"}},"type":"object","title":"DeliberationSummary"},"DeliberationSummaryEntry":{"properties":{"agent":{"type":"string","title":"Agent"},"verdict":{"type":"string","title":"Verdict"},"summary":{"type":"string","title":"Summary"}},"type":"object","required":["agent","verdict","summary"],"title":"DeliberationSummaryEntry"},"DocumentUpload":{"properties":{"documents":{"items":{"$ref":"#/components/schemas/IntakeDocument"},"type":"array","title":"Documents"}},"type":"object","required":["documents"],"title":"DocumentUpload"},"DocumentsReceivedEnvelope":{"properties":{"status":{"type":"string","title":"Status"},"intake_id":{"type":"string","title":"Intake Id"},"documents_added":{"type":"integer","title":"Documents Added"},"analysis":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Analysis"}},"type":"object","required":["status","intake_id","documents_added"],"title":"DocumentsReceivedEnvelope"},"DomainClassification":{"properties":{"primary":{"type":"string","title":"Primary"},"secondary":{"items":{"type":"string"},"type":"array","title":"Secondary"},"confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence","default":0.5},"inferred_from":{"items":{"type":"string"},"type":"array","title":"Inferred From"}},"type":"object","required":["primary"],"title":"DomainClassification"},"DraftPolicy":{"properties":{"id":{"type":"string","title":"Id"},"org_id":{"type":"string","title":"Org Id"},"description":{"type":"string","title":"Description"},"generated_code":{"type":"string","title":"Generated Code"},"condition_explanation":{"type":"string","title":"Condition Explanation"},"suggested_name":{"type":"string","title":"Suggested Name"},"recommended_severity":{"type":"string","title":"Recommended Severity"},"recommended_verdict":{"type":"string","title":"Recommended Verdict"},"recommended_scope":{"additionalProperties":true,"type":"object","title":"Recommended Scope"},"smoke_test_results":{"items":{"$ref":"#/components/schemas/SmokeTestResult"},"type":"array","title":"Smoke Test Results"},"smoke_tests_passed":{"type":"boolean","title":"Smoke Tests Passed","default":true},"created_at":{"type":"string","format":"date-time","title":"Created At"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"},"matcher_tree":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Matcher Tree"},"export_notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Export Notes"},"draft_id":{"type":"string","title":"Draft Id","description":"Alias for ``id`` — matches the frontend DraftPolicy interface.","readOnly":true},"explanation":{"type":"string","title":"Explanation","description":"Alias for ``condition_explanation`` — matches the frontend interface.","readOnly":true},"smoke_tests_total":{"type":"integer","title":"Smoke Tests Total","description":"Total number of smoke tests run (length of results list).","readOnly":true}},"type":"object","required":["id","org_id","description","generated_code","condition_explanation","suggested_name","recommended_severity","recommended_verdict","created_at","expires_at","draft_id","explanation","smoke_tests_total"],"title":"DraftPolicy","description":"A policy drafted by Claude from a plain-English description.\n\nExpires after 7 days.  Must be reviewed by a human operator before\nactivation via ``POST /v1/policy-authoring/activate``."},"EUAIActArticle":{"properties":{"article":{"type":"string","title":"Article","description":"Article reference, e.g. 'Article 9'"},"title":{"type":"string","title":"Title","description":"Official article title"},"requirement":{"type":"string","title":"Requirement","description":"Plain-English summary of the obligation"},"status":{"$ref":"#/components/schemas/ComplianceStatus"},"gaas_capability":{"type":"string","title":"Gaas Capability","description":"How GaaS satisfies this requirement"},"evidence":{"items":{"type":"string"},"type":"array","title":"Evidence","description":"GaaS features / API endpoints providing evidence"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"}},"type":"object","required":["article","title","requirement","status","gaas_capability"],"title":"EUAIActArticle","description":"Mapping of a single EU AI Act article to GaaS capabilities."},"EUAIActComplianceStatus":{"properties":{"org_id":{"type":"string","title":"Org Id"},"assessed_at":{"type":"string","format":"date-time","title":"Assessed At"},"overall_status":{"$ref":"#/components/schemas/ComplianceStatus"},"implemented_count":{"type":"integer","title":"Implemented Count"},"partial_count":{"type":"integer","title":"Partial Count"},"requires_action_count":{"type":"integer","title":"Requires Action Count"},"not_applicable_count":{"type":"integer","title":"Not Applicable Count"},"high_risk_ai_detected":{"type":"boolean","title":"High Risk Ai Detected","description":"Whether any high-risk AI systems (Annex III) are detected"},"enforcement_deadline":{"type":"string","title":"Enforcement Deadline","description":"Date the high-risk (Annex III) requirements apply, under the Digital Omnibus on AI, Regulation (EU) 2026/1744. AI in Annex I products: 2028-08-02. Was 2026-08-02 before the Omnibus.","default":"2027-12-02"},"articles":{"items":{"$ref":"#/components/schemas/EUAIActArticle"},"type":"array","title":"Articles"}},"type":"object","required":["org_id","assessed_at","overall_status","implemented_count","partial_count","requires_action_count","not_applicable_count","high_risk_ai_detected","articles"],"title":"EUAIActComplianceStatus","description":"High-level EU AI Act compliance posture for an organisation."},"EUAIActReport":{"properties":{"org_id":{"type":"string","title":"Org Id"},"generated_at":{"type":"string","format":"date-time","title":"Generated At"},"report_version":{"type":"string","title":"Report Version","default":"1.0"},"regulation_ref":{"type":"string","title":"Regulation Ref","default":"Regulation (EU) 2024/1689"},"enforcement_date":{"type":"string","title":"Enforcement Date","description":"Annex III high-risk requirements apply from this date (Regulation (EU) 2026/1744).","default":"2027-12-02"},"compliance_status":{"$ref":"#/components/schemas/EUAIActComplianceStatus"},"active_policies":{"items":{"type":"string"},"type":"array","title":"Active Policies","description":"EU AI Act policy IDs active in this org's governance membrane"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations","description":"Prioritised actions to reach full compliance"}},"type":"object","required":["org_id","generated_at","compliance_status","active_policies","recommendations"],"title":"EUAIActReport","description":"Full EU AI Act compliance report with per-article evidence."},"EUAIActReportEnvelope":{"properties":{"report":{"$ref":"#/components/schemas/EUAIActReport"}},"type":"object","required":["report"],"title":"EUAIActReportEnvelope"},"EUAIActStatusEnvelope":{"properties":{"compliance":{"$ref":"#/components/schemas/EUAIActComplianceStatus"}},"type":"object","required":["compliance"],"title":"EUAIActStatusEnvelope"},"EfficiencyMetrics":{"properties":{"unnecessary_deliberation_rate":{"$ref":"#/components/schemas/TrendMetric"},"avg_pipeline_latency_ms":{"$ref":"#/components/schemas/TrendMetric"},"escalation_resolution_rate":{"$ref":"#/components/schemas/TrendMetric"}},"type":"object","required":["unnecessary_deliberation_rate","avg_pipeline_latency_ms","escalation_resolution_rate"],"title":"EfficiencyMetrics"},"EndpointSettings":{"properties":{"url":{"type":"string","maxLength":2048,"title":"Url","description":"HTTPS URL GaaS POSTs to (port 443)."},"categories":{"items":{"type":"string"},"type":"array","maxItems":6,"minItems":1,"title":"Categories","description":"Any of ['environmental', 'entity_state', 'regulatory', 'organizational', 'identity', 'security']."},"auth_type":{"type":"string","title":"Auth Type","description":"none | bearer | header","default":"none"},"auth_header_name":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Auth Header Name","description":"For auth_type=header."},"auth_secret":{"anyOf":[{"type":"string","maxLength":4096},{"type":"null"}],"title":"Auth Secret","description":"Write-only. Omit or leave empty to keep the saved secret. Never returned."},"timeout_ms":{"anyOf":[{"type":"integer","maximum":3000.0,"minimum":200.0},{"type":"null"}],"title":"Timeout Ms"},"enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enabled","description":"true needs a passing test on these settings."}},"type":"object","required":["url","categories"],"title":"EndpointSettings"},"EnforcementConfig":{"properties":{"enforce":{"type":"boolean","title":"Enforce","default":false},"on_block":{"type":"string","const":"reject","title":"On Block","default":"reject"},"require_outcome_report":{"type":"boolean","title":"Require Outcome Report","default":false},"deviation_action":{"type":"string","enum":["flag","suspend","quarantine"],"title":"Deviation Action","default":"flag"}},"type":"object","title":"EnforcementConfig","description":"Per-org enforcement contract (Phase II — the gate).\n\nEnforce is a membrane property, NOT a pipeline mode: requests still\narrive as mode=live, and when the org's membrane is enforcing the\ndecision envelope carries an `enforcement` block so callers and\nauditors can distinguish advisory-live from enforced-live. Activating\nenforce requires a paid plan (require_plan(\"developer\") at the route)."},"EnforcementConfigUpdate":{"properties":{"enforce":{"type":"boolean","title":"Enforce","default":false},"require_outcome_report":{"type":"boolean","title":"Require Outcome Report","default":false},"deviation_action":{"type":"string","title":"Deviation Action","default":"flag"}},"type":"object","title":"EnforcementConfigUpdate"},"EnforcementStatus":{"properties":{"enforced":{"type":"boolean","title":"Enforced"},"on_block":{"type":"string","title":"On Block"},"outcome_report_required":{"type":"boolean","title":"Outcome Report Required"}},"type":"object","required":["enforced","on_block","outcome_report_required"],"title":"EnforcementStatus","description":"Present on decisions for orgs whose membrane is enforcing —\ndistinguishes enforced-live from advisory-live for callers and auditors."},"ErasureCategoryPreview":{"properties":{"category":{"type":"string","title":"Category"},"record_count":{"type":"integer","title":"Record Count"},"will_retain":{"type":"integer","title":"Will Retain","default":0},"retention_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Retention Reason"}},"type":"object","required":["category","record_count"],"title":"ErasureCategoryPreview","description":"Preview count for a single data category."},"ErasureCategoryResult":{"properties":{"category":{"type":"string","title":"Category"},"records_deleted":{"type":"integer","title":"Records Deleted"},"retained":{"type":"integer","title":"Retained","default":0},"retention_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Retention Reason"}},"type":"object","required":["category","records_deleted"],"title":"ErasureCategoryResult","description":"Deletion result for a single data category."},"ErasureEnvelope":{"properties":{"erasure":{"$ref":"#/components/schemas/ErasureResult"}},"type":"object","required":["erasure"],"title":"ErasureEnvelope"},"ErasurePreview":{"properties":{"org_id":{"type":"string","title":"Org Id"},"categories":{"items":{"$ref":"#/components/schemas/ErasureCategoryPreview"},"type":"array","title":"Categories"},"total_records":{"type":"integer","title":"Total Records"},"warning":{"type":"string","title":"Warning","default":"This action is irreversible. All data for this organization will be permanently deleted."}},"type":"object","required":["org_id","categories","total_records"],"title":"ErasurePreview","description":"Returned before erasure to show what will be deleted."},"ErasurePreviewEnvelope":{"properties":{"erasure_preview":{"$ref":"#/components/schemas/ErasurePreview"}},"type":"object","required":["erasure_preview"],"title":"ErasurePreviewEnvelope"},"ErasureResult":{"properties":{"org_id":{"type":"string","title":"Org Id"},"request_id":{"type":"string","title":"Request Id"},"status":{"$ref":"#/components/schemas/ErasureStatus"},"requested_at":{"type":"string","format":"date-time","title":"Requested At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"},"categories":{"items":{"$ref":"#/components/schemas/ErasureCategoryResult"},"type":"array","title":"Categories"},"total_deleted":{"type":"integer","title":"Total Deleted"},"total_retained":{"type":"integer","title":"Total Retained"},"retention_reasons":{"items":{"type":"string"},"type":"array","title":"Retention Reasons"},"gdpr_article":{"type":"string","title":"Gdpr Article","default":"Article 17 — Right to Erasure"}},"type":"object","required":["org_id","request_id","status","requested_at","categories","total_deleted","total_retained"],"title":"ErasureResult","description":"Result of a GDPR erasure request."},"ErasureStatus":{"type":"string","enum":["pending","in_progress","completed","partially_completed"],"title":"ErasureStatus","description":"Status of an erasure request."},"ErrorBudget":{"properties":{"slo_name":{"type":"string","title":"Slo Name"},"target":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Target","description":"SLO target (e.g., 0.999)"},"actual":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Actual","description":"Actual performance (e.g., 0.9995)"},"error_budget_total":{"type":"number","title":"Error Budget Total","description":"Total allowed error budget"},"error_budget_consumed":{"type":"number","title":"Error Budget Consumed","description":"Error budget consumed so far"},"error_budget_remaining":{"type":"number","title":"Error Budget Remaining","description":"Error budget remaining"},"error_budget_pct_remaining":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Error Budget Pct Remaining","description":"Percentage of budget left"},"window":{"$ref":"#/components/schemas/TimeWindow"},"window_start":{"type":"string","format":"date-time","title":"Window Start"},"window_end":{"type":"string","format":"date-time","title":"Window End"}},"type":"object","required":["slo_name","target","actual","error_budget_total","error_budget_consumed","error_budget_remaining","error_budget_pct_remaining","window","window_start","window_end"],"title":"ErrorBudget","description":"Error budget calculation for an SLO.\n\nTracks how much failure is allowed within the target window."},"ErrorBudgetResponse":{"properties":{"error_budget":{"$ref":"#/components/schemas/ErrorBudget"}},"type":"object","required":["error_budget"],"title":"ErrorBudgetResponse","description":"Response envelope for error budget."},"EscalationAssignment":{"properties":{"assigned_to":{"items":{"$ref":"#/components/schemas/ReviewerAssignment"},"type":"array","title":"Assigned To"},"assignment_method":{"type":"string","title":"Assignment Method","default":"role_based"},"escalation_chain":{"items":{"$ref":"#/components/schemas/EscalationChainLevel"},"type":"array","title":"Escalation Chain"},"current_level":{"type":"integer","title":"Current Level","default":1}},"type":"object","title":"EscalationAssignment","description":"Assignment state for an escalation. Spec §2.1 assignment."},"EscalationChainLevel":{"properties":{"level":{"type":"integer","minimum":1.0,"title":"Level"},"reviewers":{"items":{"type":"string"},"type":"array","title":"Reviewers"},"timeout_hours":{"type":"integer","minimum":1.0,"title":"Timeout Hours","default":4},"timeout_behavior":{"$ref":"#/components/schemas/TimeoutBehavior","default":"re_escalate"},"assignment_mode":{"$ref":"#/components/schemas/AssignmentMode","default":"any"}},"type":"object","required":["level","reviewers"],"title":"EscalationChainLevel","description":"One level in an escalation chain. Spec §3.2."},"EscalationConfigUpdate":{"properties":{"default_chain":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Default Chain","default":[]},"notification_channel":{"type":"string","title":"Notification Channel","default":"email"},"working_hours":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Working Hours"}},"type":"object","title":"EscalationConfigUpdate"},"EscalationDetail":{"properties":{"escalation_id":{"type":"string","title":"Escalation Id"},"reason":{"type":"string","title":"Reason"},"urgency":{"type":"string","title":"Urgency"},"assigned_to":{"items":{"type":"string"},"type":"array","title":"Assigned To"},"assignment_channel":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assignment Channel"},"timeout_hours":{"type":"integer","minimum":1.0,"title":"Timeout Hours","default":4},"timeout_behavior":{"type":"string","title":"Timeout Behavior","default":"block"},"review_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Review Url"},"context_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Context Summary"}},"type":"object","required":["escalation_id","reason","urgency"],"title":"EscalationDetail","description":"Details for an escalation decision. Decision-audit-spec §2.3 ESCALATE."},"EscalationEnvelope":{"properties":{"escalation":{"$ref":"#/components/schemas/EscalationObject"}},"type":"object","required":["escalation"],"title":"EscalationEnvelope"},"EscalationListEnvelope":{"properties":{"escalations":{"items":{"$ref":"#/components/schemas/EscalationObject"},"type":"array","title":"Escalations"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"}},"type":"object","required":["escalations","total","limit","offset"],"title":"EscalationListEnvelope"},"EscalationObject":{"properties":{"id":{"type":"string","title":"Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"status":{"$ref":"#/components/schemas/EscalationStatus","default":"pending"},"intent_id":{"type":"string","title":"Intent Id"},"audit_ref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Audit Ref"},"organization_id":{"type":"string","title":"Organization Id","default":"org_default"},"trigger":{"$ref":"#/components/schemas/EscalationTrigger"},"context_package":{"$ref":"#/components/schemas/ContextPackage"},"assignment":{"$ref":"#/components/schemas/EscalationAssignment"},"timeout":{"$ref":"#/components/schemas/EscalationTimeoutConfig"},"review":{"anyOf":[{"$ref":"#/components/schemas/HumanReviewDecision"},{"type":"null"}]},"resolution":{"$ref":"#/components/schemas/EscalationResolution"},"override":{"anyOf":[{"$ref":"#/components/schemas/OverrideRecord"},{"type":"null"}]}},"type":"object","required":["id","created_at","intent_id","trigger","context_package"],"title":"EscalationObject","description":"The complete escalation lifecycle object. Spec §2.1."},"EscalationResolution":{"properties":{"status":{"type":"string","title":"Status","default":"pending"},"resolved_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Resolved At"},"resolved_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resolved By"},"resolution_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resolution Type"},"total_time_to_resolution_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Time To Resolution Ms"}},"type":"object","title":"EscalationResolution","description":"Resolution state. Spec §2.1 resolution."},"EscalationStatsEnvelope":{"properties":{"stats":{"additionalProperties":true,"type":"object","title":"Stats"}},"type":"object","required":["stats"],"title":"EscalationStatsEnvelope"},"EscalationStatus":{"type":"string","enum":["pending","assigned","in_review","decided","timed_out","cancelled"],"title":"EscalationStatus","description":"Escalation lifecycle status. Escalation-spec §2.2."},"EscalationTimeoutConfig":{"properties":{"deadline":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Deadline"},"timeout_hours":{"type":"integer","minimum":1.0,"title":"Timeout Hours","default":4},"timeout_behavior":{"$ref":"#/components/schemas/TimeoutBehavior","default":"block"},"warning_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Warning At"},"warning_sent":{"type":"boolean","title":"Warning Sent","default":false}},"type":"object","title":"EscalationTimeoutConfig","description":"Timeout configuration for an escalation. Spec §2.1 timeout."},"EscalationTrigger":{"properties":{"source":{"$ref":"#/components/schemas/EscalationTriggerSource"},"reason":{"type":"string","title":"Reason"},"risk_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Risk Score"},"risk_classification":{"type":"string","title":"Risk Classification"},"pipeline_recommendation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pipeline Recommendation"},"dissent_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dissent Summary"}},"type":"object","required":["source","reason","risk_score","risk_classification"],"title":"EscalationTrigger","description":"Why the pipeline escalated this action. Spec §2.1 trigger."},"EscalationTriggerSource":{"type":"string","enum":["deliberation_no_consensus","deliberation_escalate_vote","policy_escalation","risk_threshold"],"title":"EscalationTriggerSource","description":"What triggered the escalation. Escalation-spec §1.2."},"EstimatedImpact":{"properties":{"reversible":{"type":"boolean","title":"Reversible"},"financial_exposure_usd":{"type":"number","minimum":0.0,"title":"Financial Exposure Usd","default":0.0},"audience_size":{"type":"integer","minimum":0.0,"title":"Audience Size","default":1},"regulatory_domains":{"items":{"type":"string"},"type":"array","title":"Regulatory Domains"},"data_categories":{"items":{"type":"string"},"type":"array","title":"Data Categories"}},"type":"object","required":["reversible"],"title":"EstimatedImpact","description":"Agent's self-assessed impact of the action. Spec §3.2 estimated_impact."},"EvidenceArtifactRef":{"properties":{"artifact_type":{"$ref":"#/components/schemas/EvidenceArtifactType"},"description":{"type":"string","title":"Description"},"endpoint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Endpoint"},"field_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Field Path"},"sample_value":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sample Value"}},"type":"object","required":["artifact_type","description"],"title":"EvidenceArtifactRef"},"EvidenceArtifactType":{"type":"string","enum":["audit_record","policy_verdict","verification_bundle","governance_proof","membrane_config","slo_report","escalation_record"],"title":"EvidenceArtifactType"},"EvidencePackageEnvelope":{"properties":{"evidence_package":{"$ref":"#/components/schemas/EvidencePackageResponse"}},"type":"object","required":["evidence_package"],"title":"EvidencePackageEnvelope"},"EvidencePackageMetadata":{"properties":{"id":{"type":"string","title":"Id"},"status":{"type":"string","title":"Status","default":"ready"},"requested_at":{"type":"string","format":"date-time","title":"Requested At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"},"period_days":{"type":"integer","title":"Period Days","default":30},"record_count":{"type":"integer","title":"Record Count","default":0}},"type":"object","required":["id","requested_at"],"title":"EvidencePackageMetadata","description":"Metadata for a generated evidence package."},"EvidencePackageRequest":{"properties":{"period_days":{"type":"integer","maximum":365.0,"minimum":1.0,"title":"Period Days","default":30},"audit_sample_size":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Audit Sample Size","default":10}},"type":"object","title":"EvidencePackageRequest","description":"Request body for evidence package generation."},"EvidencePackageResponse":{"properties":{"metadata":{"$ref":"#/components/schemas/EvidencePackageMetadata"},"sections":{"items":{"$ref":"#/components/schemas/EvidencePackageSection"},"type":"array","title":"Sections"}},"type":"object","required":["metadata"],"title":"EvidencePackageResponse","description":"A completed evidence package. Spec Section 5.4."},"EvidencePackageSection":{"properties":{"title":{"type":"string","title":"Title"},"content":{"additionalProperties":true,"type":"object","title":"Content"}},"type":"object","required":["title"],"title":"EvidencePackageSection","description":"A section of the evidence package."},"ExecutionStatus":{"type":"string","enum":["executed","execution_failed","skipped","denied","unknown"],"title":"ExecutionStatus","description":"Post-decision execution status. Audit-spec §6.1."},"ExplanationPending":{"properties":{"status":{"type":"string","const":"pending","title":"Status","default":"pending"},"intent_id":{"type":"string","title":"Intent Id"},"retry_after_seconds":{"type":"integer","title":"Retry After Seconds","description":"Wait this long before polling again (also sent as Retry-After)."},"poll_until":{"type":"string","format":"date-time","title":"Poll Until","description":"Stop polling after this time: if no explanation exists by then, the endpoint answers 404 and none will be produced."},"message":{"type":"string","title":"Message"}},"type":"object","required":["intent_id","retry_after_seconds","poll_until","message"],"title":"ExplanationPending","description":"202 body of ``GET /v1/intents/{intent_id}/explanation`` while generating."},"ExplanationSection":{"properties":{"title":{"type":"string","title":"Title"},"content":{"type":"string","title":"Content"},"details":{"additionalProperties":true,"type":"object","title":"Details"}},"type":"object","required":["title","content"],"title":"ExplanationSection","description":"One section of a human-readable explanation."},"FallbackOnTimeout":{"type":"string","enum":["block","allow_with_flag","escalate"],"title":"FallbackOnTimeout","description":"Behavior when governance decision times out. Spec §3.2."},"FeatureFlagCheckResponse":{"properties":{"name":{"type":"string","title":"Name"},"enabled":{"type":"boolean","title":"Enabled"},"org_id":{"type":"string","title":"Org Id"}},"type":"object","required":["name","enabled","org_id"],"title":"FeatureFlagCheckResponse","description":"Feature flag check result."},"FeatureFlagCreate":{"properties":{"name":{"type":"string","maxLength":128,"minLength":1,"title":"Name","description":"Unique flag name"},"enabled":{"type":"boolean","title":"Enabled","description":"Whether the flag is enabled","default":true},"description":{"type":"string","minLength":1,"title":"Description","description":"Human-readable description"},"org_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Org Id","description":"Organization scope (None = global)"},"rollout_percentage":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Rollout Percentage","description":"Gradual rollout percentage (0-100)","default":100}},"type":"object","required":["name","description"],"title":"FeatureFlagCreate","description":"Request body for creating a feature flag."},"FeatureFlagListResponse":{"properties":{"flags":{"items":{"$ref":"#/components/schemas/FeatureFlagResponse"},"type":"array","title":"Flags"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["flags","total"],"title":"FeatureFlagListResponse","description":"List of feature flags."},"FeatureFlagResponse":{"properties":{"name":{"type":"string","title":"Name"},"enabled":{"type":"boolean","title":"Enabled"},"description":{"type":"string","title":"Description"},"org_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Org Id"},"rollout_percentage":{"type":"integer","title":"Rollout Percentage"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["name","enabled","description","org_id","rollout_percentage","created_at","updated_at"],"title":"FeatureFlagResponse","description":"Single feature flag response."},"FeatureFlagUpdate":{"properties":{"enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enabled"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"rollout_percentage":{"anyOf":[{"type":"integer","maximum":100.0,"minimum":0.0},{"type":"null"}],"title":"Rollout Percentage"}},"type":"object","title":"FeatureFlagUpdate","description":"Request body for updating a feature flag."},"FedRAMPComplianceStatus":{"properties":{"org_id":{"type":"string","title":"Org Id"},"assessed_at":{"type":"string","format":"date-time","title":"Assessed At"},"impact_level":{"$ref":"#/components/schemas/FedRAMPImpactLevel","default":"moderate"},"ato_status":{"$ref":"#/components/schemas/ATOStatus","default":"not_started"},"overall_status":{"$ref":"#/components/schemas/ComplianceStatus"},"implemented_count":{"type":"integer","title":"Implemented Count"},"partial_count":{"type":"integer","title":"Partial Count"},"requires_action_count":{"type":"integer","title":"Requires Action Count"},"three_pao_ready_count":{"type":"integer","title":"Three Pao Ready Count"},"controls":{"items":{"$ref":"#/components/schemas/FedRAMPControl"},"type":"array","title":"Controls"}},"type":"object","required":["org_id","assessed_at","overall_status","implemented_count","partial_count","requires_action_count","three_pao_ready_count","controls"],"title":"FedRAMPComplianceStatus"},"FedRAMPControl":{"properties":{"control_id":{"type":"string","title":"Control Id","description":"e.g. 'CA-6'"},"nist_family":{"type":"string","title":"Nist Family"},"title":{"type":"string","title":"Title"},"requirement":{"type":"string","title":"Requirement"},"impact_level":{"$ref":"#/components/schemas/FedRAMPImpactLevel","default":"moderate"},"status":{"$ref":"#/components/schemas/ComplianceStatus"},"gaas_capability":{"type":"string","title":"Gaas Capability"},"evidence":{"items":{"type":"string"},"type":"array","title":"Evidence"},"policy_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Policy Id"},"three_pao_ready":{"type":"boolean","title":"Three Pao Ready","default":false},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"}},"type":"object","required":["control_id","nist_family","title","requirement","status","gaas_capability"],"title":"FedRAMPControl"},"FedRAMPImpactLevel":{"type":"string","enum":["low","moderate","high"],"title":"FedRAMPImpactLevel"},"FedRAMPReport":{"properties":{"org_id":{"type":"string","title":"Org Id"},"generated_at":{"type":"string","format":"date-time","title":"Generated At"},"report_version":{"type":"string","title":"Report Version","default":"1.0"},"framework_ref":{"type":"string","title":"Framework Ref","default":"FedRAMP Moderate Baseline Rev. 5"},"impact_level":{"$ref":"#/components/schemas/FedRAMPImpactLevel","default":"moderate"},"ato_status":{"$ref":"#/components/schemas/ATOStatus","default":"not_started"},"compliance_status":{"$ref":"#/components/schemas/FedRAMPComplianceStatus"},"active_policies":{"items":{"type":"string"},"type":"array","title":"Active Policies"},"authorization_boundary":{"type":"string","title":"Authorization Boundary","default":"GaaS governance middleware layer"},"scope_note":{"type":"string","title":"Scope Note","default":"GaaS enforces AI-agent-specific FedRAMP controls. Infrastructure-layer controls are covered by GaaS's own ATO package."},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"},"three_pao_package_available":{"type":"boolean","title":"Three Pao Package Available","default":true}},"type":"object","required":["org_id","generated_at","compliance_status","active_policies","recommendations"],"title":"FedRAMPReport"},"FedRAMPReportEnvelope":{"properties":{"report":{"$ref":"#/components/schemas/FedRAMPReport"}},"type":"object","required":["report"],"title":"FedRAMPReportEnvelope"},"FedRAMPStatusEnvelope":{"properties":{"compliance":{"$ref":"#/components/schemas/FedRAMPComplianceStatus"}},"type":"object","required":["compliance"],"title":"FedRAMPStatusEnvelope"},"FederalComplianceSummary":{"properties":{"org_id":{"type":"string","title":"Org Id"},"assessed_at":{"type":"string","format":"date-time","title":"Assessed At"},"federal_procurement_ready":{"type":"boolean","title":"Federal Procurement Ready"},"frameworks":{"items":{"$ref":"#/components/schemas/FrameworkSummary"},"type":"array","title":"Frameworks"},"combined_active_policies":{"items":{"type":"string"},"type":"array","title":"Combined Active Policies"},"priority_recommendations":{"items":{"type":"string"},"type":"array","title":"Priority Recommendations"}},"type":"object","required":["org_id","assessed_at","federal_procurement_ready","frameworks","combined_active_policies","priority_recommendations"],"title":"FederalComplianceSummary"},"FederalSummaryEnvelope":{"properties":{"summary":{"$ref":"#/components/schemas/FederalComplianceSummary"}},"type":"object","required":["summary"],"title":"FederalSummaryEnvelope"},"FeedbackSubmission":{"properties":{"audit_ref":{"type":"string","title":"Audit Ref"},"feedback_type":{"$ref":"#/components/schemas/FeedbackType"},"description":{"type":"string","title":"Description"},"suggested_improvement":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Suggested Improvement"}},"type":"object","required":["audit_ref","feedback_type","description"],"title":"FeedbackSubmission"},"FeedbackType":{"type":"string","enum":["too_permissive","too_restrictive","wrong_context","missing_policy","good_catch"],"title":"FeedbackType","description":"Type of customer feedback on a governance decision. Learning-spec §5.3."},"FilePart":{"properties":{"type":{"type":"string","const":"file","title":"Type","default":"file"},"mimeType":{"type":"string","maxLength":128,"title":"Mimetype"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"uri":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Uri"},"data":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data"}},"type":"object","required":["mimeType"],"title":"FilePart","description":"File content part (inline or URI reference). Spec v0.3 §4.1."},"FrameworkSummary":{"properties":{"framework":{"type":"string","title":"Framework"},"overall_status":{"$ref":"#/components/schemas/ComplianceStatus"},"implemented_count":{"type":"integer","title":"Implemented Count"},"total_controls":{"type":"integer","title":"Total Controls"},"compliance_percentage":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Compliance Percentage"},"report_endpoint":{"type":"string","title":"Report Endpoint"}},"type":"object","required":["framework","overall_status","implemented_count","total_controls","compliance_percentage","report_endpoint"],"title":"FrameworkSummary"},"GeneratePolicyRequest":{"properties":{"description":{"type":"string","maxLength":2000,"minLength":20,"title":"Description","description":"Plain-English description of the compliance requirement.","examples":["Block agents from accessing patient records without documented HIPAA consent."]}},"type":"object","required":["description"],"title":"GeneratePolicyRequest"},"GovernanceDecision":{"properties":{"id":{"type":"string","title":"Id"},"intent_id":{"type":"string","title":"Intent Id"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp"},"verdict":{"$ref":"#/components/schemas/Verdict"},"verdict_reason":{"type":"string","title":"Verdict Reason"},"payload":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Payload"},"modifications":{"items":{"$ref":"#/components/schemas/Modification"},"type":"array","title":"Modifications"},"conditions":{"items":{"type":"string"},"type":"array","title":"Conditions"},"risk_assessment":{"$ref":"#/components/schemas/RiskAssessment"},"governance_metadata":{"$ref":"#/components/schemas/GovernanceMetadata"},"audit_ref":{"type":"string","title":"Audit Ref"},"block":{"anyOf":[{"$ref":"#/components/schemas/BlockDetail"},{"type":"null"}]},"escalation":{"anyOf":[{"$ref":"#/components/schemas/EscalationDetail"},{"type":"null"}]},"reasoning":{"anyOf":[{"$ref":"#/components/schemas/DecisionReasoning"},{"type":"null"}]},"pipeline_latency_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Pipeline Latency Ms"},"pipeline_mode":{"$ref":"#/components/schemas/PipelineMode","default":"live"},"session_trust_remaining":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Session Trust Remaining"},"governance_proof_token":{"anyOf":[{},{"type":"null"}],"title":"Governance Proof Token","description":"ECDSA-signed Governance Proof Token. Cryptographic proof that governance was active during this decision. Present this to auditors, regulators, insurers, and courts as evidence of adequate AI governance controls."},"explanation":{"anyOf":[{"$ref":"#/components/schemas/GovernanceExplanation"},{"type":"null"}],"description":"Plain-English explanation of this governance decision generated by Claude. Generated for BLOCK, ESCALATE, APPROVE_MODIFIED, and high-risk APPROVE decisions (risk_score >= 0.5). Suitable for regulatory submission and legal proceedings. Anchored to this decision's audit hash chain."},"human_override":{"anyOf":[{"$ref":"#/components/schemas/HumanOverride"},{"type":"null"}],"description":"Set when this decision is APPROVE only because a person approved an earlier block of the same action (single use, within 24 hours). The policies still ran; their verdicts are in the audit record."},"retry_context":{"anyOf":[{"$ref":"#/components/schemas/RetryContext"},{"type":"null"}],"description":"Populated when the agent signalled a retry via context_provided.prior_intents and a prior intent was found to have a BLOCK verdict. Tracks retry attempt count and the previous blocked intent ID."}},"type":"object","required":["id","intent_id","timestamp","verdict","verdict_reason","risk_assessment","governance_metadata","audit_ref"],"title":"GovernanceDecision","description":"The governance decision returned to the requesting agent.\n\nThis is the response body for POST /v1/intents.\nSpec: intent-declaration-api-spec.md Section 4.1,\n      decision-audit-service-spec.md Section 2.3."},"GovernanceExplanation":{"properties":{"decision_id":{"type":"string","title":"Decision Id","description":"The GovernanceDecision this explanation refers to."},"narrative":{"type":"string","title":"Narrative","description":"2–3 sentence plain-English explanation of why this governance decision was made. Written for compliance officers and legal audiences, not engineers."},"risk_factors":{"items":{"type":"string"},"type":"array","title":"Risk Factors","description":"Key risk factors identified in the decision context (2–4 bullets)."},"policy_citations":{"items":{"type":"string"},"type":"array","title":"Policy Citations","description":"Policy IDs cited in plain-English form, e.g. 'pol_t1_007: Delegation Limit Exceeded'."},"recommendation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recommendation","description":"What the agent or operator should do to resolve a BLOCK or ESCALATE. None for APPROVE decisions."},"generated_at":{"type":"string","format":"date-time","title":"Generated At","description":"UTC timestamp when this explanation was generated."},"model":{"type":"string","title":"Model","description":"Claude model ID used to generate this explanation."},"generation_latency_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Generation Latency Ms","description":"Time taken to generate this explanation in milliseconds."}},"type":"object","required":["decision_id","narrative","risk_factors","policy_citations","generated_at","model"],"title":"GovernanceExplanation","description":"Plain-English explanation of a governance decision.\n\nGenerated by Claude (Haiku) from the decision context.  Suitable for\nregulatory audit submissions, legal proceedings, and compliance review.\nEach explanation is anchored to the parent decision's audit hash chain\nvia the ``decision_id`` reference."},"GovernanceExplanationEnvelope":{"properties":{"explanation":{"$ref":"#/components/schemas/GovernanceExplanation"}},"type":"object","required":["explanation"],"title":"GovernanceExplanationEnvelope"},"GovernanceMembrane":{"properties":{"membrane_id":{"type":"string","title":"Membrane Id"},"org_id":{"type":"string","title":"Org Id"},"generated_at":{"type":"string","format":"date-time","title":"Generated At"},"status":{"$ref":"#/components/schemas/MembraneStatus","default":"draft"},"version":{"type":"string","title":"Version","default":"0.1.0"},"generated_from":{"anyOf":[{"$ref":"#/components/schemas/MembraneGeneratedFrom"},{"type":"null"}]},"policy_graph":{"$ref":"#/components/schemas/PolicyGraph"},"agent_governance_profiles":{"additionalProperties":{"$ref":"#/components/schemas/AgentRiskProfile"},"type":"object","title":"Agent Governance Profiles"},"enrichment_config":{"additionalProperties":true,"type":"object","title":"Enrichment Config"},"deliberation_config":{"$ref":"#/components/schemas/MembraneDeliberationConfig"},"risk_config":{"$ref":"#/components/schemas/MembraneRiskConfig"},"escalation_config":{"$ref":"#/components/schemas/MembraneEscalationConfig"},"signing_config":{"additionalProperties":true,"type":"object","title":"Signing Config"},"enforcement_config":{"$ref":"#/components/schemas/EnforcementConfig"},"validation_questions":{"items":{"type":"string"},"type":"array","title":"Validation Questions"}},"type":"object","required":["membrane_id","org_id","generated_at"],"title":"GovernanceMembrane","description":"The generated governance membrane. Spec §3.2."},"GovernanceMetadata":{"properties":{"pipeline_stages_executed":{"items":{"type":"string"},"type":"array","title":"Pipeline Stages Executed"},"deliberation_triggered":{"type":"boolean","title":"Deliberation Triggered"},"policies_evaluated":{"type":"integer","minimum":0.0,"title":"Policies Evaluated"},"policies_passed":{"type":"integer","minimum":0.0,"title":"Policies Passed"},"policies_warned":{"type":"integer","minimum":0.0,"title":"Policies Warned","default":0},"policies_failed":{"type":"integer","minimum":0.0,"title":"Policies Failed","default":0},"context_contradictions":{"type":"integer","minimum":0.0,"title":"Context Contradictions","default":0},"pipeline_latency_ms":{"type":"integer","minimum":0.0,"title":"Pipeline Latency Ms"}},"type":"object","required":["pipeline_stages_executed","deliberation_triggered","policies_evaluated","policies_passed","pipeline_latency_ms"],"title":"GovernanceMetadata","description":"Pipeline execution metadata. Spec §4.1 decision.governance_metadata."},"GovernanceRequest":{"properties":{"urgency":{"$ref":"#/components/schemas/Urgency","default":"routine"},"max_latency_ms":{"type":"integer","maximum":30000.0,"minimum":50.0,"title":"Max Latency Ms","default":500},"fallback_on_timeout":{"$ref":"#/components/schemas/FallbackOnTimeout","default":"escalate"},"require_deliberation":{"type":"boolean","title":"Require Deliberation","default":false},"require_human_review":{"type":"boolean","title":"Require Human Review","default":false}},"type":"object","title":"GovernanceRequest","description":"Agent's governance preferences. Spec §3.2 intent.governance_request."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HealthChecks":{"properties":{"database":{"type":"string","title":"Database"},"circuit_breaker":{"type":"string","title":"Circuit Breaker"},"llm":{"type":"string","title":"Llm"},"connectors":{"type":"string","title":"Connectors"}},"type":"object","required":["database","circuit_breaker","llm","connectors"],"title":"HealthChecks"},"HealthEnvelope":{"properties":{"status":{"type":"string","title":"Status"},"version":{"type":"string","title":"Version"},"database":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Database"}},"type":"object","required":["status","version"],"title":"HealthEnvelope"},"HealthLiveEnvelope":{"properties":{"status":{"type":"string","title":"Status"}},"type":"object","required":["status"],"title":"HealthLiveEnvelope"},"HealthReadyEnvelope":{"properties":{"status":{"type":"string","title":"Status"},"version":{"type":"string","title":"Version"},"checks":{"$ref":"#/components/schemas/HealthChecks"}},"type":"object","required":["status","version","checks"],"title":"HealthReadyEnvelope"},"HealthStartupEnvelope":{"properties":{"status":{"type":"string","title":"Status"},"version":{"type":"string","title":"Version"}},"type":"object","required":["status","version"],"title":"HealthStartupEnvelope"},"HumanOverride":{"properties":{"override_id":{"type":"string","title":"Override Id"},"blocked_intent_id":{"type":"string","title":"Blocked Intent Id","description":"The blocked intent a person approved."},"approved_by":{"type":"string","title":"Approved By","description":"Who approved it, as recorded at approval time."},"approved_at":{"type":"string","format":"date-time","title":"Approved At"},"policies_overridden":{"items":{"type":"string"},"type":"array","title":"Policies Overridden","description":"The blocking policies the approval set aside for this retry."}},"type":"object","required":["override_id","blocked_intent_id","approved_by","approved_at"],"title":"HumanOverride","description":"A person's approval of a blocked action, used by a retry of that action."},"HumanReviewDecision":{"properties":{"decision":{"$ref":"#/components/schemas/ReviewDecision"},"reviewer":{"type":"string","title":"Reviewer"},"decided_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Decided At"},"notes":{"type":"string","title":"Notes","default":""},"modifications":{"items":{"$ref":"#/components/schemas/ReviewModification"},"type":"array","title":"Modifications"},"conditions":{"items":{"type":"string"},"type":"array","title":"Conditions"},"suggested_response":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Suggested Response"}},"type":"object","required":["decision","reviewer"],"title":"HumanReviewDecision","description":"The human reviewer's decision. Spec §5.2."},"IncidentSubmission":{"properties":{"audit_ref":{"type":"string","title":"Audit Ref"},"severity":{"type":"string","title":"Severity"},"category":{"type":"string","title":"Category"},"description":{"type":"string","title":"Description"},"outcome":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Outcome"},"linked_governance_decisions":{"items":{"type":"string"},"type":"array","title":"Linked Governance Decisions","default":[]}},"type":"object","required":["audit_ref","severity","category","description"],"title":"IncidentSubmission"},"Insight":{"properties":{"id":{"type":"string","title":"Id"},"generated_at":{"type":"string","format":"date-time","title":"Generated At"},"type":{"$ref":"#/components/schemas/InsightCategory"},"severity":{"$ref":"#/components/schemas/InsightSeverity","default":"informational"},"summary":{"type":"string","title":"Summary"},"evidence":{"$ref":"#/components/schemas/InsightEvidence"},"recommendation":{"anyOf":[{"$ref":"#/components/schemas/InsightRecommendation"},{"type":"null"}]}},"type":"object","required":["id","generated_at","type","summary"],"title":"Insight","description":"A learning insight from pattern recognition. Spec §3.2."},"InsightCategory":{"type":"string","enum":["policy_hotspot","contradiction_cluster","override_pattern","reformulation_loop","temporal_pattern","risk_drift","latency_bottleneck"],"title":"InsightCategory","description":"Category of a detected pattern. Learning-spec §3.2."},"InsightEnvelope":{"properties":{"insight":{"$ref":"#/components/schemas/Insight"}},"type":"object","required":["insight"],"title":"InsightEnvelope"},"InsightEvidence":{"properties":{"observation_count":{"type":"integer","title":"Observation Count","default":0},"time_period":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time Period"},"key_data_points":{"items":{"type":"string"},"type":"array","title":"Key Data Points"},"statistical_significance":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Statistical Significance"}},"type":"object","title":"InsightEvidence"},"InsightListEnvelope":{"properties":{"insights":{"items":{"$ref":"#/components/schemas/Insight"},"type":"array","title":"Insights"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"}},"type":"object","required":["insights","total","limit","offset"],"title":"InsightListEnvelope"},"InsightRecommendation":{"properties":{"action":{"type":"string","title":"Action"},"rationale":{"type":"string","title":"Rationale","default":""},"backtest_result":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Backtest Result"},"requires_human_approval":{"type":"boolean","title":"Requires Human Approval","default":true}},"type":"object","required":["action"],"title":"InsightRecommendation"},"InsightSeverity":{"type":"string","enum":["informational","advisory","actionable","urgent"],"title":"InsightSeverity","description":"Severity of a learning insight. Learning-spec §3.2."},"IntakeAdditionalContext":{"properties":{"existing_compliance_certifications":{"items":{"type":"string"},"type":"array","title":"Existing Compliance Certifications"},"known_regulatory_requirements":{"items":{"type":"string"},"type":"array","title":"Known Regulatory Requirements"},"incident_history":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Incident History"},"risk_tolerance":{"type":"string","title":"Risk Tolerance","default":"moderate"}},"type":"object","title":"IntakeAdditionalContext"},"IntakeAgentProfile":{"properties":{"name":{"type":"string","title":"Name"},"framework":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Framework"},"description":{"type":"string","title":"Description","default":""},"action_types":{"items":{"type":"string"},"type":"array","title":"Action Types"},"domains":{"items":{"type":"string"},"type":"array","title":"Domains"},"integrations":{"items":{"type":"string"},"type":"array","title":"Integrations"},"estimated_daily_actions":{"type":"integer","title":"Estimated Daily Actions","default":0}},"type":"object","required":["name"],"title":"IntakeAgentProfile"},"IntakeDescription":{"properties":{"text":{"type":"string","title":"Text"},"status":{"$ref":"#/components/schemas/IntakeInputStatus","default":"provided"}},"type":"object","required":["text"],"title":"IntakeDescription"},"IntakeDocument":{"properties":{"id":{"type":"string","title":"Id"},"filename":{"type":"string","title":"Filename"},"type":{"type":"string","title":"Type","default":"general"},"size_bytes":{"type":"integer","title":"Size Bytes","default":0},"status":{"$ref":"#/components/schemas/IntakeInputStatus","default":"uploaded"}},"type":"object","required":["id","filename"],"title":"IntakeDocument"},"IntakeEnvelope":{"properties":{"intake":{"$ref":"#/components/schemas/ContextIntake"}},"type":"object","required":["intake"],"title":"IntakeEnvelope"},"IntakeInputStatus":{"type":"string","enum":["provided","crawled","analyzed","uploaded","parsed"],"title":"IntakeInputStatus","description":"Status of an intake input. Onboarding-spec §2.1."},"IntakeInputs":{"properties":{"urls":{"anyOf":[{"$ref":"#/components/schemas/IntakeURL"},{"type":"null"}]},"documents":{"items":{"$ref":"#/components/schemas/IntakeDocument"},"type":"array","title":"Documents"},"description":{"anyOf":[{"$ref":"#/components/schemas/IntakeDescription"},{"type":"null"}]},"agent_inventory":{"items":{"$ref":"#/components/schemas/IntakeAgentProfile"},"type":"array","title":"Agent Inventory"},"integrations":{"items":{"type":"string"},"type":"array","title":"Integrations"},"additional_context":{"anyOf":[{"$ref":"#/components/schemas/IntakeAdditionalContext"},{"type":"null"}]}},"type":"object","title":"IntakeInputs"},"IntakeSubmission":{"properties":{"org_id":{"type":"string","title":"Org Id"},"urls":{"anyOf":[{"$ref":"#/components/schemas/IntakeURL"},{"type":"null"}]},"documents":{"items":{"$ref":"#/components/schemas/IntakeDocument"},"type":"array","title":"Documents","default":[]},"description":{"anyOf":[{"$ref":"#/components/schemas/IntakeDescription"},{"type":"null"}]},"agent_inventory":{"items":{"$ref":"#/components/schemas/IntakeAgentProfile"},"type":"array","title":"Agent Inventory","default":[]},"integrations":{"items":{"type":"string"},"type":"array","title":"Integrations","default":[]},"additional_context":{"anyOf":[{"$ref":"#/components/schemas/IntakeAdditionalContext"},{"type":"null"}]}},"type":"object","required":["org_id"],"title":"IntakeSubmission"},"IntakeURL":{"properties":{"domain_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Url"},"api_docs_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Docs Url"},"status":{"$ref":"#/components/schemas/IntakeInputStatus","default":"provided"}},"type":"object","title":"IntakeURL"},"IntegrationInfo":{"properties":{"data_types":{"items":{"type":"string"},"type":"array","title":"Data Types"},"access_patterns":{"items":{"type":"string"},"type":"array","title":"Access Patterns"},"connector_available":{"type":"boolean","title":"Connector Available","default":false}},"type":"object","title":"IntegrationInfo"},"IntentDeclaration":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"timestamp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Timestamp"},"idempotency_key":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Idempotency Key"},"agent":{"$ref":"#/components/schemas/AgentInfo"},"action":{"$ref":"#/components/schemas/Action"},"context_provided":{"anyOf":[{"$ref":"#/components/schemas/ContextProvided"},{"type":"null"}]},"governance_request":{"anyOf":[{"$ref":"#/components/schemas/GovernanceRequest"},{"type":"null"}]}},"type":"object","required":["agent","action"],"title":"IntentDeclaration","description":"Full intent declaration submitted by an agent for governance evaluation.\n\nThis is the root schema for POST /v1/intents.\nSpec: intent-declaration-api-spec.md Section 3.1."},"IntentSubmission":{"properties":{"intent":{"$ref":"#/components/schemas/IntentDeclaration"}},"type":"object","required":["intent"],"title":"IntentSubmission"},"InternalActor":{"properties":{"org_id":{"type":"string","maxLength":128,"title":"Org Id"},"updated_by":{"type":"string","maxLength":254,"minLength":3,"title":"Updated By","description":"The signed-in person's email."},"role":{"type":"string","title":"Role"},"mfa_verified":{"type":"boolean","title":"Mfa Verified","default":false}},"type":"object","required":["org_id","updated_by","role"],"title":"InternalActor"},"InternalEmailRequest":{"properties":{"type":{"type":"string","title":"Type"},"to":{"type":"string","title":"To"},"params":{"additionalProperties":true,"type":"object","title":"Params"}},"type":"object","required":["type","to","params"],"title":"InternalEmailRequest"},"InternalEnable":{"properties":{"org_id":{"type":"string","maxLength":128,"title":"Org Id"},"updated_by":{"type":"string","maxLength":254,"minLength":3,"title":"Updated By","description":"The signed-in person's email."},"role":{"type":"string","title":"Role"},"mfa_verified":{"type":"boolean","title":"Mfa Verified","default":false},"enabled":{"type":"boolean","title":"Enabled"}},"type":"object","required":["org_id","updated_by","role","enabled"],"title":"InternalEnable"},"InternalSettings":{"properties":{"org_id":{"type":"string","maxLength":128,"title":"Org Id"},"updated_by":{"type":"string","maxLength":254,"minLength":3,"title":"Updated By","description":"The signed-in person's email."},"role":{"type":"string","title":"Role"},"mfa_verified":{"type":"boolean","title":"Mfa Verified","default":false},"url":{"type":"string","maxLength":2048,"title":"Url","description":"HTTPS URL GaaS POSTs to (port 443)."},"categories":{"items":{"type":"string"},"type":"array","maxItems":6,"minItems":1,"title":"Categories","description":"Any of ['environmental', 'entity_state', 'regulatory', 'organizational', 'identity', 'security']."},"auth_type":{"type":"string","title":"Auth Type","description":"none | bearer | header","default":"none"},"auth_header_name":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Auth Header Name","description":"For auth_type=header."},"auth_secret":{"anyOf":[{"type":"string","maxLength":4096},{"type":"null"}],"title":"Auth Secret","description":"Write-only. Omit or leave empty to keep the saved secret. Never returned."},"timeout_ms":{"anyOf":[{"type":"integer","maximum":3000.0,"minimum":200.0},{"type":"null"}],"title":"Timeout Ms"},"enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enabled","description":"true needs a passing test on these settings."}},"type":"object","required":["org_id","updated_by","role","url","categories"],"title":"InternalSettings"},"KeyFact":{"properties":{"label":{"type":"string","title":"Label"},"value":{"type":"string","title":"Value"}},"type":"object","required":["label","value"],"title":"KeyFact"},"LearningMetrics":{"properties":{"period":{"type":"string","title":"Period"},"accuracy":{"$ref":"#/components/schemas/AccuracyMetrics"},"efficiency":{"$ref":"#/components/schemas/EfficiencyMetrics"},"calibration_activity":{"$ref":"#/components/schemas/CalibrationActivity"}},"type":"object","required":["period","accuracy","efficiency"],"title":"LearningMetrics","description":"Governance improvement metrics. Spec §6.2."},"LearningMetricsEnvelope":{"properties":{"metrics":{"$ref":"#/components/schemas/LearningMetrics"}},"type":"object","required":["metrics"],"title":"LearningMetricsEnvelope"},"MembraneDeliberationConfig":{"properties":{"threshold":{"type":"number","title":"Threshold","default":0.6},"weights":{"additionalProperties":{"type":"number"},"type":"object","title":"Weights"},"domain_expert_specialization":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Expert Specialization"},"rationale":{"type":"string","title":"Rationale","default":""}},"type":"object","title":"MembraneDeliberationConfig"},"MembraneEnvelope":{"properties":{"membrane":{"$ref":"#/components/schemas/GovernanceMembrane"}},"type":"object","required":["membrane"],"title":"MembraneEnvelope"},"MembraneEscalationConfig":{"properties":{"default_chain":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Default Chain"},"notification_channel":{"type":"string","title":"Notification Channel","default":"email"},"working_hours":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Working Hours"}},"type":"object","title":"MembraneEscalationConfig"},"MembraneGeneratedFrom":{"properties":{"intake_id":{"type":"string","title":"Intake Id"},"ucm_version":{"type":"string","title":"Ucm Version","default":"1"},"generation_confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Generation Confidence","default":0.5},"gaps_at_generation":{"type":"integer","title":"Gaps At Generation","default":0}},"type":"object","required":["intake_id"],"title":"MembraneGeneratedFrom"},"MembraneHistoryEnvelope":{"properties":{"history":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"History"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"}},"type":"object","required":["history","total","limit","offset"],"title":"MembraneHistoryEnvelope"},"MembraneRiskConfig":{"properties":{"thresholds":{"additionalProperties":{"type":"number"},"type":"object","title":"Thresholds"},"rationale":{"type":"string","title":"Rationale","default":""}},"type":"object","title":"MembraneRiskConfig"},"MembraneStatus":{"type":"string","enum":["draft","validating","validated","shadow","live"],"title":"MembraneStatus","description":"Governance membrane lifecycle status. Onboarding-spec §3.2."},"MetricsHistoryEnvelope":{"properties":{"metrics_history":{"$ref":"#/components/schemas/MetricsHistoryResponse"}},"type":"object","required":["metrics_history"],"title":"MetricsHistoryEnvelope"},"MetricsHistoryResponse":{"properties":{"snapshots":{"items":{"$ref":"#/components/schemas/MetricsSnapshot"},"type":"array","title":"Snapshots"},"total":{"type":"integer","title":"Total","default":0},"granularity":{"type":"string","title":"Granularity","default":"hourly"},"period_start":{"type":"string","title":"Period Start","default":""},"period_end":{"type":"string","title":"Period End","default":""},"generated_at":{"type":"string","format":"date-time","title":"Generated At"}},"type":"object","required":["generated_at"],"title":"MetricsHistoryResponse","description":"Paginated response for historical metrics snapshots."},"MetricsSnapshot":{"properties":{"id":{"type":"string","title":"Id"},"snapshot_hour":{"type":"string","format":"date-time","title":"Snapshot Hour"},"decisions_total":{"type":"integer","title":"Decisions Total","default":0},"decisions_approved":{"type":"integer","title":"Decisions Approved","default":0},"decisions_blocked":{"type":"integer","title":"Decisions Blocked","default":0},"decisions_modified":{"type":"integer","title":"Decisions Modified","default":0},"decisions_escalated":{"type":"integer","title":"Decisions Escalated","default":0},"block_rate":{"type":"number","title":"Block Rate","default":0.0},"avg_risk":{"type":"number","title":"Avg Risk","default":0.0},"deliberation_rate":{"type":"number","title":"Deliberation Rate","default":0.0},"pipeline_latency_p50":{"type":"integer","title":"Pipeline Latency P50","default":0},"pipeline_latency_p99":{"type":"integer","title":"Pipeline Latency P99","default":0},"escalations_pending":{"type":"integer","title":"Escalations Pending","default":0},"escalations_created":{"type":"integer","title":"Escalations Created","default":0},"override_rate":{"type":"number","title":"Override Rate","default":0.0},"false_block_rate":{"type":"number","title":"False Block Rate","default":0.0},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","snapshot_hour","created_at"],"title":"MetricsSnapshot","description":"Hourly snapshot of governance metrics for historical persistence."},"ModelInventoryEntryEnvelope":{"properties":{"model":{"$ref":"#/components/schemas/SR117ModelEntry"}},"type":"object","required":["model"],"title":"ModelInventoryEntryEnvelope"},"ModelInventoryEnvelope":{"properties":{"inventory":{"$ref":"#/components/schemas/SR117Inventory"}},"type":"object","required":["inventory"],"title":"ModelInventoryEnvelope"},"Modification":{"properties":{"field":{"type":"string","title":"Field"},"type":{"$ref":"#/components/schemas/ModificationType"},"reason":{"type":"string","title":"Reason"},"policy_ref":{"type":"string","title":"Policy Ref"},"description":{"type":"string","title":"Description"}},"type":"object","required":["field","type","reason","policy_ref","description"],"title":"Modification","description":"A modification applied to the agent's original payload. Spec §4.1."},"ModificationType":{"type":"string","enum":["content_addition","content_removal","content_replacement","field_override","scope_reduction","recipient_change","timing_change"],"title":"ModificationType","description":"Type of modification applied to an action. Decision-audit-spec §2.3."},"NIST80053ComplianceStatus":{"properties":{"org_id":{"type":"string","title":"Org Id"},"assessed_at":{"type":"string","format":"date-time","title":"Assessed At"},"baseline":{"type":"string","title":"Baseline","default":"moderate"},"overall_status":{"$ref":"#/components/schemas/ComplianceStatus"},"implemented_count":{"type":"integer","title":"Implemented Count"},"partial_count":{"type":"integer","title":"Partial Count"},"requires_action_count":{"type":"integer","title":"Requires Action Count"},"controls":{"items":{"$ref":"#/components/schemas/NIST80053Control"},"type":"array","title":"Controls"}},"type":"object","required":["org_id","assessed_at","overall_status","implemented_count","partial_count","requires_action_count","controls"],"title":"NIST80053ComplianceStatus"},"NIST80053Control":{"properties":{"control_id":{"type":"string","title":"Control Id","description":"e.g. 'AC-6'"},"control_family":{"$ref":"#/components/schemas/NIST80053ControlFamily"},"title":{"type":"string","title":"Title"},"requirement":{"type":"string","title":"Requirement"},"baseline":{"type":"string","title":"Baseline","default":"moderate"},"status":{"$ref":"#/components/schemas/ComplianceStatus"},"gaas_capability":{"type":"string","title":"Gaas Capability"},"evidence":{"items":{"type":"string"},"type":"array","title":"Evidence"},"policy_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Policy Id"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"}},"type":"object","required":["control_id","control_family","title","requirement","status","gaas_capability"],"title":"NIST80053Control"},"NIST80053ControlFamily":{"type":"string","enum":["AC","AU","CA","CM","IA","IR","SC","SI","SR","PS"],"title":"NIST80053ControlFamily"},"NIST80053Report":{"properties":{"org_id":{"type":"string","title":"Org Id"},"generated_at":{"type":"string","format":"date-time","title":"Generated At"},"report_version":{"type":"string","title":"Report Version","default":"1.0"},"framework_ref":{"type":"string","title":"Framework Ref","default":"NIST SP 800-53 Rev. 5"},"baseline":{"type":"string","title":"Baseline","default":"moderate"},"compliance_status":{"$ref":"#/components/schemas/NIST80053ComplianceStatus"},"active_policies":{"items":{"type":"string"},"type":"array","title":"Active Policies"},"fedramp_readiness_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Fedramp Readiness Score"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"}},"type":"object","required":["org_id","generated_at","compliance_status","active_policies","fedramp_readiness_score","recommendations"],"title":"NIST80053Report"},"NIST80053ReportEnvelope":{"properties":{"report":{"$ref":"#/components/schemas/NIST80053Report"}},"type":"object","required":["report"],"title":"NIST80053ReportEnvelope"},"NIST80053StatusEnvelope":{"properties":{"compliance":{"$ref":"#/components/schemas/NIST80053ComplianceStatus"}},"type":"object","required":["compliance"],"title":"NIST80053StatusEnvelope"},"NISTAIRMFComplianceStatus":{"properties":{"org_id":{"type":"string","title":"Org Id"},"assessed_at":{"type":"string","format":"date-time","title":"Assessed At"},"overall_status":{"$ref":"#/components/schemas/ComplianceStatus"},"implemented_count":{"type":"integer","title":"Implemented Count"},"partial_count":{"type":"integer","title":"Partial Count"},"requires_action_count":{"type":"integer","title":"Requires Action Count"},"not_applicable_count":{"type":"integer","title":"Not Applicable Count"},"govern_count":{"type":"integer","title":"Govern Count"},"map_count":{"type":"integer","title":"Map Count"},"measure_count":{"type":"integer","title":"Measure Count"},"manage_count":{"type":"integer","title":"Manage Count"},"subcategories":{"items":{"$ref":"#/components/schemas/NISTAIRMFSubcategory"},"type":"array","title":"Subcategories"}},"type":"object","required":["org_id","assessed_at","overall_status","implemented_count","partial_count","requires_action_count","not_applicable_count","govern_count","map_count","measure_count","manage_count","subcategories"],"title":"NISTAIRMFComplianceStatus"},"NISTAIRMFReport":{"properties":{"org_id":{"type":"string","title":"Org Id"},"generated_at":{"type":"string","format":"date-time","title":"Generated At"},"report_version":{"type":"string","title":"Report Version","default":"1.0"},"framework_ref":{"type":"string","title":"Framework Ref","default":"NIST AI RMF 1.0 (NIST AI 100-1)"},"framework_url":{"type":"string","title":"Framework Url","default":"https://airc.nist.gov/RMF/about"},"compliance_status":{"$ref":"#/components/schemas/NISTAIRMFComplianceStatus"},"active_policies":{"items":{"type":"string"},"type":"array","title":"Active Policies"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"}},"type":"object","required":["org_id","generated_at","compliance_status","active_policies","recommendations"],"title":"NISTAIRMFReport"},"NISTAIRMFReportEnvelope":{"properties":{"report":{"$ref":"#/components/schemas/NISTAIRMFReport"}},"type":"object","required":["report"],"title":"NISTAIRMFReportEnvelope"},"NISTAIRMFStatusEnvelope":{"properties":{"compliance":{"$ref":"#/components/schemas/NISTAIRMFComplianceStatus"}},"type":"object","required":["compliance"],"title":"NISTAIRMFStatusEnvelope"},"NISTAIRMFSubcategory":{"properties":{"subcategory_id":{"type":"string","title":"Subcategory Id","description":"e.g. 'GV-1.1'"},"rmf_function":{"$ref":"#/components/schemas/RMFFunction"},"title":{"type":"string","title":"Title"},"requirement":{"type":"string","title":"Requirement","description":"Plain-English summary of the obligation"},"status":{"$ref":"#/components/schemas/ComplianceStatus"},"gaas_capability":{"type":"string","title":"Gaas Capability","description":"How GaaS satisfies this subcategory"},"evidence":{"items":{"type":"string"},"type":"array","title":"Evidence","description":"API endpoints or field references"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"}},"type":"object","required":["subcategory_id","rmf_function","title","requirement","status","gaas_capability"],"title":"NISTAIRMFSubcategory"},"OrgMembraneEnvelope":{"properties":{"membrane":{"anyOf":[{"$ref":"#/components/schemas/OrgMembraneInfo"},{"type":"null"}]}},"type":"object","title":"OrgMembraneEnvelope"},"OrgMembraneInfo":{"properties":{"membrane_id":{"type":"string","title":"Membrane Id"},"status":{"type":"string","title":"Status"},"generated_at":{"type":"string","title":"Generated At"}},"type":"object","required":["membrane_id","status","generated_at"],"title":"OrgMembraneInfo"},"OrgSettingsUpdate":{"properties":{"updated_by":{"type":"string","maxLength":254,"minLength":3,"title":"Updated By"},"role":{"type":"string","title":"Role"},"mfa_verified":{"type":"boolean","title":"Mfa Verified"},"approvals_require_dashboard_two_factor":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Approvals Require Dashboard Two Factor"},"audit_retention_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Audit Retention Days"}},"type":"object","required":["updated_by","role","mfa_verified"],"title":"OrgSettingsUpdate","description":"Only the fields sent are changed; ``audit_retention_days: null`` keeps records indefinitely."},"OutcomeReport":{"properties":{"executed":{"type":"boolean","title":"Executed"},"outcome":{"type":"string","pattern":"^(success|failure|skipped)$","title":"Outcome","default":"success"}},"type":"object","required":["executed"],"title":"OutcomeReport"},"OverrideDirection":{"type":"string","enum":["more_permissive","more_restrictive","scope_change","aligned"],"title":"OverrideDirection","description":"Direction of human override vs pipeline recommendation. Escalation-spec §7.3."},"OverrideRecord":{"properties":{"occurred":{"type":"boolean","title":"Occurred","default":false},"pipeline_recommendation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pipeline Recommendation"},"human_decision":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Human Decision"},"override_direction":{"anyOf":[{"$ref":"#/components/schemas/OverrideDirection"},{"type":"null"}]},"justification":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Justification"}},"type":"object","title":"OverrideRecord","description":"Tracks whether the human overrode the pipeline. Spec §7.3."},"PendingEscalationsEnvelope":{"properties":{"pending_escalations":{"items":{"$ref":"#/components/schemas/EscalationObject"},"type":"array","title":"Pending Escalations"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"}},"type":"object","required":["pending_escalations","total","limit","offset"],"title":"PendingEscalationsEnvelope"},"PipelineMode":{"type":"string","enum":["live","shadow","test"],"title":"PipelineMode","description":"Pipeline operating mode. Audit-spec §3.2."},"PolicyActivationRequest":{"properties":{"draft_id":{"type":"string","title":"Draft Id"},"policy_name":{"type":"string","maxLength":120,"minLength":3,"title":"Policy Name"},"policy_version":{"type":"string","pattern":"^\\d+\\.\\d+\\.\\d+$","title":"Policy Version","default":"1.0.0"},"confirmed_by":{"type":"string","title":"Confirmed By","description":"Email or user ID of the approving operator"}},"type":"object","required":["draft_id","policy_name","confirmed_by"],"title":"PolicyActivationRequest","description":"Request to compile and register a draft policy."},"PolicyActivationResult":{"properties":{"policy_id":{"type":"string","title":"Policy Id"},"registered":{"type":"boolean","title":"Registered"},"smoke_test_results":{"items":{"$ref":"#/components/schemas/SmokeTestResult"},"type":"array","title":"Smoke Test Results"},"smoke_tests_passed":{"type":"boolean","title":"Smoke Tests Passed"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["policy_id","registered","smoke_test_results","smoke_tests_passed"],"title":"PolicyActivationResult","description":"Result of activating a draft policy."},"PolicyConfig":{"properties":{"policy_id":{"type":"string","title":"Policy Id","description":"Unique policy identifier (e.g., pol_t3_001)"},"org_id":{"type":"string","title":"Org Id","description":"Organization identifier"},"enabled":{"type":"boolean","title":"Enabled","description":"Whether policy is active","default":true},"settings":{"additionalProperties":true,"type":"object","title":"Settings","description":"Policy-specific configuration"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Human-readable description"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"created_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created By","description":"User or agent that created the config"},"version":{"type":"integer","title":"Version","description":"Config version number, incremented on each update","default":1}},"type":"object","required":["policy_id","org_id"],"title":"PolicyConfig","description":"Organization-specific configuration for custom policies (Tier 3).\n\nTier 3 policies require org-specific settings (thresholds, routing rules,\nvalidation requirements) stored in the database. This model represents\nthe stored configuration."},"PolicyConfigCreate":{"properties":{"policy_id":{"type":"string","title":"Policy Id"},"enabled":{"type":"boolean","title":"Enabled","default":true},"settings":{"additionalProperties":true,"type":"object","title":"Settings"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"}},"type":"object","required":["policy_id"],"title":"PolicyConfigCreate","description":"Request model for creating a new policy configuration."},"PolicyConfigListResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"data":{"items":{"$ref":"#/components/schemas/PolicyConfig"},"type":"array","title":"Data"},"meta":{"additionalProperties":true,"type":"object","title":"Meta"}},"type":"object","required":["data"],"title":"PolicyConfigListResponse","description":"Response envelope for list of policy configs."},"PolicyConfigResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"data":{"$ref":"#/components/schemas/PolicyConfig"},"meta":{"additionalProperties":true,"type":"object","title":"Meta"}},"type":"object","required":["data"],"title":"PolicyConfigResponse","description":"Response envelope for single policy config."},"PolicyConfigUpdate":{"properties":{"enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enabled"},"settings":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Settings"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"}},"type":"object","title":"PolicyConfigUpdate","description":"Request model for updating an existing policy configuration."},"PolicyEvalSummary":{"properties":{"policies_evaluated":{"type":"integer","title":"Policies Evaluated","default":0},"policies_passed":{"type":"integer","title":"Policies Passed","default":0},"policies_conditional":{"type":"integer","title":"Policies Conditional","default":0},"policies_failed":{"type":"integer","title":"Policies Failed","default":0},"key_policy_findings":{"items":{"type":"string"},"type":"array","title":"Key Policy Findings"}},"type":"object","title":"PolicyEvalSummary"},"PolicyGraph":{"properties":{"tier_1_policies":{"items":{"type":"string"},"type":"array","title":"Tier 1 Policies"},"tier_2_policies":{"items":{"$ref":"#/components/schemas/PolicyGraphEntry"},"type":"array","title":"Tier 2 Policies"},"tier_3_policies":{"items":{"$ref":"#/components/schemas/PolicyGraphEntry"},"type":"array","title":"Tier 3 Policies"},"tier_4_policies":{"items":{"$ref":"#/components/schemas/PolicyGraphEntry"},"type":"array","title":"Tier 4 Policies"},"total_policies":{"type":"integer","title":"Total Policies","default":0}},"type":"object","title":"PolicyGraph"},"PolicyGraphEntry":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name","default":""},"framework":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Framework"},"confidence":{"type":"string","title":"Confidence","default":"high"},"source":{"type":"string","title":"Source","default":""},"needs_validation":{"type":"boolean","title":"Needs Validation","default":false}},"type":"object","required":["id"],"title":"PolicyGraphEntry"},"PolicyPackEntry":{"properties":{"metadata":{"$ref":"#/components/schemas/PolicyPackMetadata"},"org_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Org Id","description":"None = public pack available to all orgs; set = private org pack"},"install_count":{"type":"integer","minimum":0.0,"title":"Install Count","default":0},"verified":{"type":"boolean","title":"Verified","description":"GaaS-verified pack (all policies exist and are tested)","default":false}},"type":"object","required":["metadata"],"title":"PolicyPackEntry","description":"A policy pack entry as stored in the registry."},"PolicyPackEnvelope":{"properties":{"pack":{"$ref":"#/components/schemas/PolicyPackEntry"}},"type":"object","required":["pack"],"title":"PolicyPackEnvelope"},"PolicyPackInstallEnvelope":{"properties":{"result":{"$ref":"#/components/schemas/PolicyPackInstallResult"}},"type":"object","required":["result"],"title":"PolicyPackInstallEnvelope"},"PolicyPackInstallResult":{"properties":{"pack_id":{"type":"string","title":"Pack Id"},"org_id":{"type":"string","title":"Org Id"},"policies_installed":{"type":"integer","title":"Policies Installed"},"policy_ids":{"items":{"type":"string"},"type":"array","title":"Policy Ids"},"skipped":{"items":{"type":"string"},"type":"array","title":"Skipped","description":"Policy IDs that were already present (not duplicated)"},"installed_at":{"type":"string","format":"date-time","title":"Installed At"}},"type":"object","required":["pack_id","org_id","policies_installed","policy_ids"],"title":"PolicyPackInstallResult","description":"Result of installing a policy pack into an org's registry."},"PolicyPackMetadata":{"properties":{"pack_id":{"type":"string","title":"Pack Id","description":"Unique pack identifier, e.g. 'gaas-healthcare-v1'"},"name":{"type":"string","title":"Name"},"version":{"type":"string","title":"Version","default":"1.0.0"},"description":{"type":"string","title":"Description"},"author":{"type":"string","title":"Author","default":"GaaS"},"vertical":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vertical","description":"Target industry vertical (healthcare, financial, government, ...)"},"regulations":{"items":{"type":"string"},"type":"array","title":"Regulations","description":"Regulatory frameworks covered (HIPAA, EU AI Act, GDPR, ...)"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"policy_ids":{"items":{"type":"string"},"type":"array","title":"Policy Ids","description":"Ordered list of policy IDs included in this pack"},"published_at":{"type":"string","format":"date-time","title":"Published At"},"license":{"type":"string","title":"License","default":"Apache-2.0"},"homepage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Homepage"}},"type":"object","required":["pack_id","name","description","policy_ids"],"title":"PolicyPackMetadata","description":"Metadata for a policy pack in the registry."},"PolicyRegistryListEnvelope":{"properties":{"results":{"$ref":"#/components/schemas/PolicyRegistrySearchResult"}},"type":"object","required":["results"],"title":"PolicyRegistryListEnvelope"},"PolicyRegistrySearchResult":{"properties":{"total":{"type":"integer","title":"Total"},"packs":{"items":{"$ref":"#/components/schemas/PolicyPackEntry"},"type":"array","title":"Packs"},"query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query"},"vertical_filter":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vertical Filter"},"regulation_filter":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Regulation Filter"}},"type":"object","required":["total","packs"],"title":"PolicyRegistrySearchResult","description":"Search results from the policy registry."},"ProcessIntakeEnvelope":{"properties":{"ucm":{"$ref":"#/components/schemas/UnifiedContextModel"},"membrane":{"$ref":"#/components/schemas/GovernanceMembrane"}},"type":"object","required":["ucm","membrane"],"title":"ProcessIntakeEnvelope"},"QuickstartEnvelope":{"properties":{"membrane_id":{"type":"string","title":"Membrane Id"},"membrane_status":{"type":"string","title":"Membrane Status"},"org_id":{"type":"string","title":"Org Id"},"api_key":{"type":"string","title":"Api Key"},"key_id":{"type":"string","title":"Key Id"},"quickstart_snippet":{"type":"string","title":"Quickstart Snippet"},"next_steps":{"items":{"type":"string"},"type":"array","title":"Next Steps"}},"type":"object","required":["membrane_id","membrane_status","org_id","api_key","key_id","quickstart_snippet","next_steps"],"title":"QuickstartEnvelope"},"QuickstartRequest":{"properties":{"org_name":{"type":"string","title":"Org Name"},"email":{"type":"string","title":"Email"},"description":{"type":"string","title":"Description"}},"type":"object","required":["org_name","email","description"],"title":"QuickstartRequest"},"RMFFunction":{"type":"string","enum":["GOVERN","MAP","MEASURE","MANAGE"],"title":"RMFFunction"},"ReadinessBreakdownItem":{"properties":{"total":{"type":"integer","title":"Total","default":0},"resolved":{"type":"integer","title":"Resolved","default":0},"weight":{"type":"number","title":"Weight","default":0.0},"score":{"type":"number","title":"Score","default":0.0}},"type":"object","title":"ReadinessBreakdownItem"},"ReadinessEnvelope":{"properties":{"readiness":{"$ref":"#/components/schemas/ValidationReadiness"}},"type":"object","required":["readiness"],"title":"ReadinessEnvelope"},"ReassignRequest":{"properties":{"new_reviewers":{"items":{"type":"string"},"type":"array","title":"New Reviewers"}},"type":"object","required":["new_reviewers"],"title":"ReassignRequest"},"RecentHighRiskDecision":{"properties":{"timestamp":{"type":"string","format":"date-time","title":"Timestamp"},"verdict":{"type":"string","title":"Verdict"},"agent_id":{"type":"string","title":"Agent Id"},"agent_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Name"},"action_summary":{"type":"string","title":"Action Summary"},"risk_score":{"type":"number","title":"Risk Score"},"risk_classification":{"type":"string","title":"Risk Classification"},"audit_ref":{"type":"string","title":"Audit Ref"},"intent_id":{"type":"string","title":"Intent Id"}},"type":"object","required":["timestamp","verdict","agent_id","action_summary","risk_score","risk_classification","audit_ref","intent_id"],"title":"RecentHighRiskDecision","description":"A recent high-risk decision for the Command Center feed."},"RecordedEnvelope":{"properties":{"status":{"type":"string","title":"Status"},"audit_ref":{"type":"string","title":"Audit Ref"}},"type":"object","required":["status","audit_ref"],"title":"RecordedEnvelope","description":"Shared response for incident/feedback recording."},"RegisterAgentRequest":{"properties":{"agent_url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Agent Url"}},"type":"object","required":["agent_url"],"title":"RegisterAgentRequest"},"RegulatoryFrameworkMatch":{"properties":{"framework":{"type":"string","title":"Framework"},"confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence"},"source":{"type":"string","title":"Source","default":""}},"type":"object","required":["framework","confidence"],"title":"RegulatoryFrameworkMatch"},"RegulatoryProfile":{"properties":{"applicable_frameworks":{"items":{"$ref":"#/components/schemas/RegulatoryFrameworkMatch"},"type":"array","title":"Applicable Frameworks"},"jurisdictions":{"items":{"type":"string"},"type":"array","title":"Jurisdictions"},"regulatory_density":{"type":"string","title":"Regulatory Density","default":"low"}},"type":"object","title":"RegulatoryProfile"},"RetentionPurgeDetail":{"properties":{"purged_count":{"type":"integer","title":"Purged Count"},"cutoff_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Cutoff Date"},"remaining_count":{"type":"integer","title":"Remaining Count"}},"type":"object","required":["purged_count","remaining_count"],"title":"RetentionPurgeDetail"},"RetentionPurgeEnvelope":{"properties":{"purge":{"$ref":"#/components/schemas/RetentionPurgeDetail"}},"type":"object","required":["purge"],"title":"RetentionPurgeEnvelope"},"RetentionStatusDetail":{"properties":{"retention_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Retention Days"},"total_records":{"type":"integer","title":"Total Records"},"oldest_record":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Oldest Record"},"newest_record":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Newest Record"},"records_beyond_retention":{"type":"integer","title":"Records Beyond Retention","default":0}},"type":"object","required":["total_records"],"title":"RetentionStatusDetail"},"RetentionStatusEnvelope":{"properties":{"retention":{"$ref":"#/components/schemas/RetentionStatusDetail"}},"type":"object","required":["retention"],"title":"RetentionStatusEnvelope"},"RetryContext":{"properties":{"is_retry":{"type":"boolean","title":"Is Retry","default":false},"retry_attempt":{"type":"integer","minimum":0.0,"title":"Retry Attempt","description":"Number of prior blocked attempts.","default":0},"previous_intent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Previous Intent Id","description":"Intent ID of the most recent blocked attempt."},"previous_verdict":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Previous Verdict","description":"Verdict of the most recent prior intent."}},"type":"object","title":"RetryContext","description":"Populated when this intent is a retry of a previously-blocked intent.\n\nAgents signal a retry by including the prior intent ID(s) in\n``context_provided.prior_intents``.  The governance pipeline detects\nthat the most recent prior intent was blocked and surfaces this context."},"ReviewDecision":{"type":"string","enum":["approve","modify","deny"],"title":"ReviewDecision","description":"Human reviewer's decision. Escalation-spec §5.2."},"ReviewModification":{"properties":{"type":{"type":"string","title":"Type"},"description":{"type":"string","title":"Description"},"field":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Field"},"action":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Action"},"details":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Details"}},"type":"object","required":["type","description"],"title":"ReviewModification","description":"A modification applied by the human reviewer. Spec §5.2."},"ReviewResultDetail":{"properties":{"escalation_id":{"type":"string","title":"Escalation Id"},"status":{"type":"string","title":"Status"},"decision":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Decision"},"decided_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Decided At"},"decided_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Decided By"},"override_detected":{"type":"boolean","title":"Override Detected","default":false},"override_direction":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Override Direction"}},"type":"object","required":["escalation_id","status"],"title":"ReviewResultDetail","description":"The inner review result payload."},"ReviewResultEnvelope":{"properties":{"review_result":{"$ref":"#/components/schemas/ReviewResultDetail"}},"type":"object","required":["review_result"],"title":"ReviewResultEnvelope"},"ReviewSubmission":{"properties":{"decision":{"$ref":"#/components/schemas/ReviewDecision"},"reviewer":{"type":"string","title":"Reviewer"},"notes":{"type":"string","title":"Notes","default":""},"modifications":{"items":{"$ref":"#/components/schemas/ReviewModification"},"type":"array","title":"Modifications","default":[]},"conditions":{"items":{"type":"string"},"type":"array","title":"Conditions","default":[]},"suggested_response":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Suggested Response"}},"type":"object","required":["decision","reviewer"],"title":"ReviewSubmission"},"ReviewerAssignment":{"properties":{"user_id":{"type":"string","title":"User Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"},"notified_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Notified At"},"notification_acknowledged":{"type":"boolean","title":"Notification Acknowledged","default":false}},"type":"object","required":["user_id"],"title":"ReviewerAssignment","description":"A single reviewer assignment. Spec §2.1 assignment."},"RiskAppetite":{"properties":{"declared":{"type":"string","title":"Declared","default":"moderate"},"inferred":{"type":"string","title":"Inferred","default":"moderate"},"confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence","default":0.5},"evidence":{"type":"string","title":"Evidence","default":""}},"type":"object","title":"RiskAppetite"},"RiskAssessment":{"properties":{"score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Score"},"classification":{"$ref":"#/components/schemas/RiskClassification"},"dimensions":{"anyOf":[{"$ref":"#/components/schemas/RiskDimensions"},{"type":"null"}]}},"type":"object","required":["score","classification"],"title":"RiskAssessment","description":"Composite risk assessment. Spec §4.1 decision.risk_assessment."},"RiskClassification":{"type":"string","enum":["low","moderate","elevated","high","critical"],"title":"RiskClassification","description":"Composite risk score classification. Policy-engine-spec §4.6."},"RiskDimensions":{"properties":{"reversibility":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Reversibility"},"financial_exposure":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Financial Exposure"},"regulatory_density":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Regulatory Density"},"audience_impact":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Audience Impact"},"context_confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Context Confidence"},"novelty":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Novelty"}},"type":"object","required":["reversibility","financial_exposure","regulatory_density","audience_impact","context_confidence","novelty"],"title":"RiskDimensions","description":"Individual risk dimension scores. Spec §4.1 risk_assessment.dimensions."},"SLOReport":{"properties":{"org_id":{"type":"string","title":"Org Id"},"report_period_start":{"type":"string","format":"date-time","title":"Report Period Start"},"report_period_end":{"type":"string","format":"date-time","title":"Report Period End"},"slo_statuses":{"items":{"$ref":"#/components/schemas/SLOStatus"},"type":"array","title":"Slo Statuses"},"overall_compliance":{"type":"boolean","title":"Overall Compliance","description":"Whether all SLOs met"},"total_error_budget_consumed_pct":{"type":"number","minimum":0.0,"title":"Total Error Budget Consumed Pct","description":"Average error budget consumed"},"incidents_count":{"type":"integer","minimum":0.0,"title":"Incidents Count","description":"Number of SLO violations","default":0},"mtbf_hours":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Mtbf Hours","description":"Mean time between failures"},"generated_at":{"type":"string","format":"date-time","title":"Generated At"}},"type":"object","required":["org_id","report_period_start","report_period_end","overall_compliance","total_error_budget_consumed_pct"],"title":"SLOReport","description":"Comprehensive SLO report for a time period.\n\nUsed for monthly reviews and stakeholder reporting."},"SLOReportResponse":{"properties":{"report":{"$ref":"#/components/schemas/SLOReport"}},"type":"object","required":["report"],"title":"SLOReportResponse","description":"Response envelope for SLO report."},"SLOSeverity":{"type":"string","enum":["info","warning","critical"],"title":"SLOSeverity","description":"Severity of SLO violation."},"SLOStatus":{"properties":{"target":{"$ref":"#/components/schemas/SLOTarget"},"current_value":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Current Value","description":"Current measured value"},"is_compliant":{"type":"boolean","title":"Is Compliant","description":"Whether currently meeting SLO"},"error_budget":{"$ref":"#/components/schemas/ErrorBudget"},"severity":{"$ref":"#/components/schemas/SLOSeverity"},"last_violation":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Violation","description":"Timestamp of last SLO violation"},"violation_count_24h":{"type":"integer","minimum":0.0,"title":"Violation Count 24H","description":"Number of violations in last 24h","default":0}},"type":"object","required":["target","current_value","is_compliant","error_budget","severity"],"title":"SLOStatus","description":"Current SLO compliance status.\n\nCombines SLO target, current performance, and error budget."},"SLOStatusListResponse":{"properties":{"statuses":{"items":{"$ref":"#/components/schemas/SLOStatus"},"type":"array","title":"Statuses"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp"}},"type":"object","required":["statuses"],"title":"SLOStatusListResponse","description":"Response envelope for list of SLO statuses."},"SLOStatusResponse":{"properties":{"status":{"$ref":"#/components/schemas/SLOStatus"}},"type":"object","required":["status"],"title":"SLOStatusResponse","description":"Response envelope for SLO status."},"SLOTarget":{"properties":{"name":{"type":"string","title":"Name","description":"Human-readable SLO name"},"type":{"$ref":"#/components/schemas/SLOType","description":"Type of SLO"},"target":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Target","description":"Target percentage (0.0-1.0)"},"window":{"$ref":"#/components/schemas/TimeWindow","description":"Time window for measurement","default":"30d"},"enabled":{"type":"boolean","title":"Enabled","description":"Whether SLO is actively monitored","default":true}},"type":"object","required":["name","type","target"],"title":"SLOTarget","description":"Definition of a service level objective.\n\nExample:\n    {\n        \"name\": \"API Availability\",\n        \"type\": \"availability\",\n        \"target\": 0.999,\n        \"window\": \"30d\"\n    }"},"SLOType":{"type":"string","enum":["availability","latency","error_rate","durability"],"title":"SLOType","description":"Type of SLO being tracked."},"SR117Inventory":{"properties":{"org_id":{"type":"string","title":"Org Id"},"generated_at":{"type":"string","format":"date-time","title":"Generated At"},"guidance_ref":{"type":"string","title":"Guidance Ref","default":"Model risk management inventory. SR 11-7 / OCC 2011-12 were rescinded on 2026-04-17 by SR 26-2 / OCC 2026-13, which places generative and agentic AI models outside its scope."},"total_models":{"type":"integer","title":"Total Models"},"validated_models":{"type":"integer","title":"Validated Models"},"pending_validation":{"type":"integer","title":"Pending Validation"},"models":{"items":{"$ref":"#/components/schemas/SR117ModelEntry"},"type":"array","title":"Models"},"inventory_notes":{"items":{"type":"string"},"type":"array","title":"Inventory Notes","description":"Examiner-facing notes for supervisory review"}},"type":"object","required":["org_id","generated_at","total_models","validated_models","pending_validation","models"],"title":"SR117Inventory","description":"Full model inventory for an organisation."},"SR117ModelEntry":{"properties":{"model_id":{"type":"string","title":"Model Id","description":"Unique agent/model identifier"},"model_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model Name"},"model_purpose":{"type":"string","title":"Model Purpose","description":"Business purpose and intended use of this AI agent"},"trust_tier":{"type":"string","title":"Trust Tier","description":"GaaS trust tier: REGISTERED/VERIFIED/CERTIFIED"},"owner":{"type":"string","title":"Owner","description":"Responsible owner (org_id or team identifier)"},"framework":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Framework","description":"AI/ML framework (e.g. LangChain, AutoGPT)"},"known_action_types":{"items":{"type":"string"},"type":"array","title":"Known Action Types","description":"Action types this model is authorised to perform"},"allowed_sensitivity_levels":{"items":{"type":"string"},"type":"array","title":"Allowed Sensitivity Levels"},"restricted_data_categories":{"items":{"type":"string"},"type":"array","title":"Restricted Data Categories"},"delegation_limit_usd":{"type":"number","title":"Delegation Limit Usd","description":"Maximum monetary authority (financial exposure limit)"},"regulatory_domains":{"items":{"type":"string"},"type":"array","title":"Regulatory Domains","description":"Applicable regulatory frameworks (HIPAA, SOX, GDPR, etc.)"},"validation_status":{"$ref":"#/components/schemas/ValidationStatus","default":"pending_validation"},"total_decisions":{"type":"integer","minimum":0.0,"title":"Total Decisions","default":0},"approved_count":{"type":"integer","minimum":0.0,"title":"Approved Count","default":0},"blocked_count":{"type":"integer","minimum":0.0,"title":"Blocked Count","default":0},"escalated_count":{"type":"integer","minimum":0.0,"title":"Escalated Count","default":0},"block_rate":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Block Rate","default":0.0},"avg_risk_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Avg Risk Score","default":0.0},"registered_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Registered At"},"last_decision_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Decision At"},"membrane_status":{"type":"string","title":"Membrane Status","description":"Governance membrane lifecycle state (DRAFT/SHADOW/LIVE)","default":"unknown"}},"type":"object","required":["model_id","model_purpose","trust_tier","owner","known_action_types","allowed_sensitivity_levels","restricted_data_categories","delegation_limit_usd","regulatory_domains"],"title":"SR117ModelEntry","description":"Single model/agent entry in the model inventory."},"SendMessageConfiguration":{"properties":{"acceptedOutputModes":{"items":{"type":"string"},"type":"array","title":"Acceptedoutputmodes"},"pushNotificationConfig":{"anyOf":[{"$ref":"#/components/schemas/A2APushNotificationConfig"},{"type":"null"}]},"historyLength":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Historylength"},"blocking":{"type":"boolean","title":"Blocking","default":true},"pipelineMode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pipelinemode"}},"type":"object","title":"SendMessageConfiguration","description":"Client-side configuration for SendMessage requests. Spec v0.3 §4.4."},"Sensitivity":{"type":"string","enum":["public","internal","confidential","regulated"],"title":"Sensitivity","description":"Sensitivity classification. Spec §3.4."},"ShadowFeedback":{"properties":{"audit_ref":{"type":"string","title":"Audit Ref"},"shadow_verdict":{"$ref":"#/components/schemas/ShadowVerdict"},"feedback":{"$ref":"#/components/schemas/ShadowFeedbackType"},"customer_expected_verdict":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Expected Verdict"},"notes":{"type":"string","title":"Notes","default":""}},"type":"object","required":["audit_ref","shadow_verdict","feedback"],"title":"ShadowFeedback","description":"Customer feedback on a shadow-mode decision. Spec §5.3."},"ShadowFeedbackEnvelope":{"properties":{"feedback":{"$ref":"#/components/schemas/ShadowFeedback"}},"type":"object","required":["feedback"],"title":"ShadowFeedbackEnvelope"},"ShadowFeedbackSubmission":{"properties":{"audit_ref":{"type":"string","title":"Audit Ref"},"shadow_verdict":{"$ref":"#/components/schemas/ShadowVerdict"},"feedback":{"$ref":"#/components/schemas/ShadowFeedbackType"},"customer_expected_verdict":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Expected Verdict"},"notes":{"type":"string","title":"Notes","default":""}},"type":"object","required":["audit_ref","shadow_verdict","feedback"],"title":"ShadowFeedbackSubmission"},"ShadowFeedbackType":{"type":"string","enum":["correct","incorrect"],"title":"ShadowFeedbackType","description":"Customer feedback on a shadow decision. Onboarding-spec §5.3."},"ShadowStats":{"properties":{"total_decisions":{"type":"integer","title":"Total Decisions","default":0},"shadow_decision_count":{"type":"integer","title":"Shadow Decision Count","default":0},"by_verdict":{"additionalProperties":{"type":"integer"},"type":"object","title":"By Verdict"},"false_positive_rate":{"type":"number","title":"False Positive Rate","default":0.0},"most_triggered_policies":{"items":{"type":"string"},"type":"array","title":"Most Triggered Policies"},"feedback_count":{"type":"integer","title":"Feedback Count","default":0}},"type":"object","title":"ShadowStats","description":"Shadow mode aggregate statistics. Spec §5.2."},"ShadowStatsEnvelope":{"properties":{"shadow_stats":{"$ref":"#/components/schemas/ShadowStats"}},"type":"object","required":["shadow_stats"],"title":"ShadowStatsEnvelope"},"ShadowVerdict":{"type":"string","enum":["would_approve","would_block","would_modify","would_escalate"],"title":"ShadowVerdict","description":"What the pipeline would have done in shadow mode. Onboarding-spec §5.2."},"SmokeTestResult":{"properties":{"intent_id":{"type":"string","title":"Intent Id"},"intent_description":{"type":"string","title":"Intent Description"},"triggered":{"type":"boolean","title":"Triggered"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"intent_type":{"type":"string","title":"Intent Type","description":"Human-readable scenario label derived from the intent description.","readOnly":true},"passed":{"type":"boolean","title":"Passed","description":"True when the test ran without raising an exception.\n\nNote: ``triggered`` (condition fired) and ``passed`` (no error) are\nindependent — a test passes even if the condition does not trigger.","readOnly":true},"verdict":{"type":"string","title":"Verdict","description":"Display-ready outcome string for this test scenario.","readOnly":true},"reason":{"type":"string","title":"Reason","description":"Short explanation of why this test produced its result.","readOnly":true}},"type":"object","required":["intent_id","intent_description","triggered","intent_type","passed","verdict","reason"],"title":"SmokeTestResult","description":"Result of running the generated condition against one test intent."},"StageLatencies":{"properties":{"intent_parsing":{"type":"integer","minimum":0.0,"title":"Intent Parsing"},"context_enrichment":{"type":"integer","minimum":0.0,"title":"Context Enrichment"},"policy_evaluation":{"type":"integer","minimum":0.0,"title":"Policy Evaluation"},"deliberation":{"type":"integer","minimum":0.0,"title":"Deliberation","default":0},"decision_assembly":{"type":"integer","minimum":0.0,"title":"Decision Assembly"},"audit_write":{"type":"integer","minimum":0.0,"title":"Audit Write"}},"type":"object","required":["intent_parsing","context_enrichment","policy_evaluation","decision_assembly","audit_write"],"title":"StageLatencies","description":"Per-stage latency breakdown. Audit-spec §3.2 pipeline_metadata."},"TargetType":{"type":"string","enum":["person","system","account","device","platform","record","dataset","endpoint","resource"],"title":"TargetType","description":"What the action is directed at. Spec §3.2 intent.action.target.type."},"TextPart":{"properties":{"type":{"type":"string","const":"text","title":"Type","default":"text"},"text":{"type":"string","title":"Text"}},"type":"object","required":["text"],"title":"TextPart","description":"Plain text content part. Spec v0.3 §4.1."},"ThresholdAdjustment":{"properties":{"parameter":{"type":"string","title":"Parameter"},"current_value":{"type":"number","title":"Current Value"},"proposed_value":{"type":"number","title":"Proposed Value"},"adjustment":{"type":"number","title":"Adjustment"},"evidence":{"type":"string","title":"Evidence","default":""},"auto_applied":{"type":"boolean","title":"Auto Applied","default":false}},"type":"object","required":["parameter","current_value","proposed_value","adjustment"],"title":"ThresholdAdjustment"},"TimeWindow":{"type":"string","enum":["1h","24h","7d","30d","90d"],"title":"TimeWindow","description":"Time window for SLO calculation."},"TimeoutBehavior":{"type":"string","enum":["block","approve_with_flag","re_escalate","queue"],"title":"TimeoutBehavior","description":"What happens when an escalation times out. Escalation-spec §6.1."},"TopAgent":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"operator":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Operator"},"dqs":{"type":"number","title":"Dqs","description":"Decision Quality Score (0-100): % of live decisions that were approved"},"total_decisions":{"type":"integer","title":"Total Decisions"}},"type":"object","required":["agent_id","dqs","total_decisions"],"title":"TopAgent","description":"The highest-DQS agent in the contest pool."},"TrendMetric":{"properties":{"current":{"type":"number","title":"Current"},"previous":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Previous"},"trend":{"type":"string","title":"Trend","default":"stable"}},"type":"object","required":["current"],"title":"TrendMetric"},"TrendPoint":{"properties":{"date":{"type":"string","title":"Date"},"decisions":{"type":"integer","title":"Decisions","default":0},"blocked":{"type":"integer","title":"Blocked","default":0},"escalated":{"type":"integer","title":"Escalated","default":0},"block_rate":{"type":"number","title":"Block Rate","default":0.0},"avg_risk":{"type":"number","title":"Avg Risk","default":0.0}},"type":"object","required":["date"],"title":"TrendPoint","description":"A single data point in a governance trend series."},"TrustResetEnvelope":{"properties":{"reset":{"$ref":"#/components/schemas/TrustResetResult"}},"type":"object","required":["reset"],"title":"TrustResetEnvelope"},"TrustResetRequest":{"properties":{"reason":{"type":"string","maxLength":500,"title":"Reason","description":"Why the agent is being reset (logged).","default":""}},"type":"object","title":"TrustResetRequest"},"TrustResetResult":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"trust_budget":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Trust Budget","description":"The budget after the reset; null when there is no state store."},"profile_cleared":{"type":"boolean","title":"Profile Cleared"},"stored":{"type":"boolean","title":"Stored","description":"False when this deployment keeps no agent state (nothing to reset)."}},"type":"object","required":["agent_id","trust_budget","profile_cleared","stored"],"title":"TrustResetResult"},"TrustTier":{"type":"string","enum":["registered","verified","certified","unknown"],"title":"TrustTier","description":"GaaS trust classification. Spec §3.2 intent.agent.trust_tier."},"UCMGap":{"properties":{"gap":{"type":"string","title":"Gap"},"severity":{"type":"string","title":"Severity","default":"low"}},"type":"object","required":["gap"],"title":"UCMGap"},"UTMData":{"properties":{"utm_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Source"},"utm_medium":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Medium"},"utm_campaign":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Campaign"},"utm_term":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Term"},"utm_content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Content"},"referral_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Referral Source"}},"type":"object","title":"UTMData","description":"Marketing attribution data captured at signup."},"UnifiedContextModel":{"properties":{"intake_id":{"type":"string","title":"Intake Id"},"org_id":{"type":"string","title":"Org Id"},"domain_classification":{"$ref":"#/components/schemas/DomainClassification"},"regulatory_profile":{"$ref":"#/components/schemas/RegulatoryProfile"},"data_profile":{"$ref":"#/components/schemas/DataProfile"},"agent_profiles":{"items":{"$ref":"#/components/schemas/AgentRiskProfile"},"type":"array","title":"Agent Profiles"},"integration_map":{"additionalProperties":{"$ref":"#/components/schemas/IntegrationInfo"},"type":"object","title":"Integration Map"},"risk_appetite":{"$ref":"#/components/schemas/RiskAppetite"},"gaps_identified":{"items":{"$ref":"#/components/schemas/UCMGap"},"type":"array","title":"Gaps Identified"}},"type":"object","required":["intake_id","org_id","domain_classification"],"title":"UnifiedContextModel","description":"Unified Context Model — everything GaaS knows about the customer. Spec §2.3."},"UptimeMetrics":{"properties":{"check_name":{"type":"string","title":"Check Name"},"window_start":{"type":"string","format":"date-time","title":"Window Start"},"window_end":{"type":"string","format":"date-time","title":"Window End"},"uptime_pct":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Uptime Pct","description":"Percentage uptime"},"total_checks":{"type":"integer","minimum":0.0,"title":"Total Checks","description":"Total checks performed"},"successful_checks":{"type":"integer","minimum":0.0,"title":"Successful Checks","description":"Successful checks"},"failed_checks":{"type":"integer","minimum":0.0,"title":"Failed Checks","description":"Failed checks"},"avg_latency_ms":{"type":"number","minimum":0.0,"title":"Avg Latency Ms","description":"Average response latency"},"p95_latency_ms":{"type":"number","minimum":0.0,"title":"P95 Latency Ms","description":"95th percentile latency"},"p99_latency_ms":{"type":"number","minimum":0.0,"title":"P99 Latency Ms","description":"99th percentile latency"},"regions":{"additionalProperties":{"type":"number"},"type":"object","title":"Regions","description":"Per-region uptime percentages"}},"type":"object","required":["check_name","window_start","window_end","uptime_pct","total_checks","successful_checks","failed_checks","avg_latency_ms","p95_latency_ms","p99_latency_ms"],"title":"UptimeMetrics","description":"Uptime metrics for a synthetic check.\n\nCalculated over a time window (e.g., last 24 hours)."},"UptimeMetricsResponse":{"properties":{"metrics":{"$ref":"#/components/schemas/UptimeMetrics"}},"type":"object","required":["metrics"],"title":"UptimeMetricsResponse","description":"Response envelope for uptime metrics."},"Urgency":{"type":"string","enum":["routine","elevated","critical"],"title":"Urgency","description":"Time-sensitivity of the action. Spec §3.2 intent.governance_request.urgency."},"ValidateResponse":{"properties":{"conforms":{"type":"boolean","title":"Conforms"},"spec":{"type":"string","title":"Spec","default":"0.1"},"findings":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Findings"}},"type":"object","required":["conforms","findings"],"title":"ValidateResponse"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"ValidationReadiness":{"properties":{"membrane_id":{"type":"string","title":"Membrane Id"},"score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Score","default":0.0},"breakdown":{"additionalProperties":{"$ref":"#/components/schemas/ReadinessBreakdownItem"},"type":"object","title":"Breakdown"},"blocking_issues":{"items":{"type":"string"},"type":"array","title":"Blocking Issues"},"ready_for_shadow":{"type":"boolean","title":"Ready For Shadow","default":false},"ready_for_live":{"type":"boolean","title":"Ready For Live","default":false}},"type":"object","required":["membrane_id"],"title":"ValidationReadiness","description":"Validation readiness score. Spec §4.4."},"ValidationStatus":{"type":"string","enum":["validated","pending_validation","in_validation","validation_overdue","exempt"],"title":"ValidationStatus","description":"Model validation status."},"Verdict":{"type":"string","enum":["approve","approve_modified","escalate","block"],"title":"Verdict","description":"Final governance decision verdict. Spec §4.1."},"VerifyProofEnvelope":{"properties":{"token_id":{"type":"string","title":"Token Id"},"valid":{"type":"boolean","title":"Valid"},"signature_valid":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Signature Valid"},"chain_integrity":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Chain Integrity"},"verdict":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Verdict"},"agent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Id"},"org_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Org Id"},"issued_at":{"anyOf":[{},{"type":"null"}],"title":"Issued At"},"key_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Key Id"},"token":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Token","description":"The signed token, for checking offline against the published key."},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["token_id","valid"],"title":"VerifyProofEnvelope"},"WaitlistAnalytics":{"properties":{"total_entries":{"type":"integer","title":"Total Entries"},"by_status":{"additionalProperties":{"type":"integer"},"type":"object","title":"By Status"},"by_source":{"additionalProperties":{"type":"integer"},"type":"object","title":"By Source"},"by_campaign":{"additionalProperties":{"type":"integer"},"type":"object","title":"By Campaign"},"recent_signups_24h":{"type":"integer","title":"Recent Signups 24H"}},"type":"object","required":["total_entries","by_status","by_source","by_campaign","recent_signups_24h"],"title":"WaitlistAnalytics","description":"Waitlist analytics/attribution summary."},"WaitlistAnalyticsEnvelope":{"properties":{"analytics":{"$ref":"#/components/schemas/WaitlistAnalytics"}},"type":"object","required":["analytics"],"title":"WaitlistAnalyticsEnvelope"},"WaitlistBulkInviteEnvelope":{"properties":{"result":{"$ref":"#/components/schemas/WaitlistBulkInviteResult"}},"type":"object","required":["result"],"title":"WaitlistBulkInviteEnvelope"},"WaitlistBulkInviteRequest":{"properties":{"entry_ids":{"items":{"type":"string"},"type":"array","maxItems":100,"minItems":1,"title":"Entry Ids"}},"type":"object","required":["entry_ids"],"title":"WaitlistBulkInviteRequest","description":"Request body for bulk invite."},"WaitlistBulkInviteResult":{"properties":{"invited":{"items":{"type":"string"},"type":"array","title":"Invited"},"failed":{"items":{"type":"string"},"type":"array","title":"Failed"},"total_invited":{"type":"integer","title":"Total Invited"},"total_failed":{"type":"integer","title":"Total Failed"}},"type":"object","required":["invited","failed","total_invited","total_failed"],"title":"WaitlistBulkInviteResult","description":"Result of a bulk invite operation."},"WaitlistEntry":{"properties":{"id":{"type":"string","title":"Id"},"email":{"type":"string","title":"Email"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"company":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company"},"status":{"$ref":"#/components/schemas/WaitlistStatus","default":"pending"},"unsubscribed":{"type":"boolean","title":"Unsubscribed","default":false},"unsubscribed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Unsubscribed At"},"joined_at":{"type":"string","format":"date-time","title":"Joined At"},"verified_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Verified At"},"utm":{"anyOf":[{"$ref":"#/components/schemas/UTMData"},{"type":"null"}]}},"type":"object","required":["id","email","joined_at"],"title":"WaitlistEntry","description":"A waitlist entry."},"WaitlistEntryEnvelope":{"properties":{"entry":{"$ref":"#/components/schemas/WaitlistEntry"}},"type":"object","required":["entry"],"title":"WaitlistEntryEnvelope"},"WaitlistJoinEnvelope":{"properties":{"entry":{"$ref":"#/components/schemas/WaitlistEntry"}},"type":"object","required":["entry"],"title":"WaitlistJoinEnvelope"},"WaitlistJoinRequest":{"properties":{"email":{"type":"string","minLength":5,"title":"Email","description":"Email address"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"Contact name"},"company":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company","description":"Company or organization name"},"utm":{"anyOf":[{"$ref":"#/components/schemas/UTMData"},{"type":"null"}],"description":"Marketing attribution"}},"type":"object","required":["email"],"title":"WaitlistJoinRequest","description":"Request body for joining the waitlist."},"WaitlistListEnvelope":{"properties":{"entries":{"items":{"$ref":"#/components/schemas/WaitlistEntry"},"type":"array","title":"Entries"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"}},"type":"object","required":["entries","total","limit","offset"],"title":"WaitlistListEnvelope"},"WaitlistStatus":{"type":"string","enum":["pending","verified","approved","invited","rejected"],"title":"WaitlistStatus","description":"Waitlist entry lifecycle status."},"WaitlistUnsubscribeEnvelope":{"properties":{"entry":{"$ref":"#/components/schemas/WaitlistEntry"},"message":{"type":"string","title":"Message"}},"type":"object","required":["entry","message"],"title":"WaitlistUnsubscribeEnvelope"},"WaitlistUnsubscribeRequest":{"properties":{"token":{"type":"string","minLength":1,"title":"Token","description":"HMAC unsubscribe token"}},"type":"object","required":["token"],"title":"WaitlistUnsubscribeRequest","description":"Request body for email unsubscribe."},"WaitlistVerifyEnvelope":{"properties":{"entry":{"$ref":"#/components/schemas/WaitlistEntry"},"message":{"type":"string","title":"Message"}},"type":"object","required":["entry","message"],"title":"WaitlistVerifyEnvelope"},"WaitlistVerifyRequest":{"properties":{"token":{"type":"string","minLength":1,"title":"Token","description":"Verification token from email"}},"type":"object","required":["token"],"title":"WaitlistVerifyRequest","description":"Request body for email verification."},"WebhookDeliveriesEnvelope":{"properties":{"deliveries":{"items":{"$ref":"#/components/schemas/WebhookDelivery"},"type":"array","title":"Deliveries"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["deliveries","total"],"title":"WebhookDeliveriesEnvelope"},"WebhookDelivery":{"properties":{"id":{"type":"string","title":"Id"},"webhook_id":{"type":"string","title":"Webhook Id"},"event_type":{"type":"string","title":"Event Type"},"status":{"$ref":"#/components/schemas/WebhookDeliveryStatus","default":"pending"},"attempts":{"type":"integer","title":"Attempts","default":0},"max_attempts":{"type":"integer","title":"Max Attempts","default":3},"last_attempt_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Attempt At"},"response_status":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Response Status"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"escalation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Escalation Id"},"intent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Intent Id"},"entity_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Id"}},"type":"object","required":["id","webhook_id","event_type"],"title":"WebhookDelivery","description":"Tracks a single delivery attempt."},"WebhookDeliveryStatus":{"type":"string","enum":["pending","delivered","failed","retrying"],"title":"WebhookDeliveryStatus"},"WebhookEnvelope":{"properties":{"webhook":{"$ref":"#/components/schemas/WebhookRegistration"}},"type":"object","required":["webhook"],"title":"WebhookEnvelope"},"WebhookEventType":{"type":"string","enum":["escalation.decided","escalation.timed_out","escalation.cancelled","escalation.reassigned","decision.approved","decision.blocked","decision.escalated","decision.overridden","observation.recorded","policy.calibrated","pattern.detected","quota.exceeded","rate_limit.exceeded"],"title":"WebhookEventType","description":"Events that trigger webhook callbacks."},"WebhookListEnvelope":{"properties":{"webhooks":{"items":{"$ref":"#/components/schemas/WebhookRegistration"},"type":"array","title":"Webhooks"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["webhooks","total"],"title":"WebhookListEnvelope"},"WebhookRegisterRequest":{"properties":{"url":{"type":"string","title":"Url"},"organization_id":{"type":"string","title":"Organization Id","default":"org_default"},"escalation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Escalation Id"},"event_types":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Event Types"},"description":{"type":"string","title":"Description","default":""}},"type":"object","required":["url"],"title":"WebhookRegisterRequest"},"WebhookRegistration":{"properties":{"id":{"type":"string","title":"Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"url":{"type":"string","title":"Url"},"organization_id":{"type":"string","title":"Organization Id","default":"org_default"},"escalation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Escalation Id"},"event_types":{"items":{"$ref":"#/components/schemas/WebhookEventType"},"type":"array","title":"Event Types"},"secret":{"type":"string","title":"Secret"},"active":{"type":"boolean","title":"Active","default":true},"description":{"type":"string","title":"Description","default":""}},"type":"object","required":["id","created_at","url","secret"],"title":"WebhookRegistration","description":"A registered webhook endpoint."},"WebhookRetryResultEnvelope":{"properties":{"success":{"type":"boolean","title":"Success"},"delivery_id":{"type":"string","title":"Delivery Id"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","delivery_id","message"],"title":"WebhookRetryResultEnvelope"},"WebhookUnregisteredEnvelope":{"properties":{"status":{"type":"string","title":"Status"},"webhook_id":{"type":"string","title":"Webhook Id"}},"type":"object","required":["status","webhook_id"],"title":"WebhookUnregisteredEnvelope"},"WeeklySummaryEnvelope":{"properties":{"weekly_summary":{"$ref":"#/components/schemas/WeeklySummaryResponse"}},"type":"object","required":["weekly_summary"],"title":"WeeklySummaryEnvelope"},"WeeklySummaryResponse":{"properties":{"period_start":{"type":"string","title":"Period Start"},"period_end":{"type":"string","title":"Period End"},"decisions_total":{"type":"integer","title":"Decisions Total","default":0},"decisions_blocked":{"type":"integer","title":"Decisions Blocked","default":0},"decisions_escalated":{"type":"integer","title":"Decisions Escalated","default":0},"decisions_approved":{"type":"integer","title":"Decisions Approved","default":0},"block_rate":{"type":"number","title":"Block Rate","default":0.0},"override_rate":{"type":"number","title":"Override Rate","default":0.0},"false_block_rate":{"type":"number","title":"False Block Rate","default":0.0},"top_risks":{"items":{"$ref":"#/components/schemas/RecentHighRiskDecision"},"type":"array","title":"Top Risks"},"learning_insights_count":{"type":"integer","title":"Learning Insights Count","default":0},"calibration_adjustments_count":{"type":"integer","title":"Calibration Adjustments Count","default":0},"generated_at":{"type":"string","format":"date-time","title":"Generated At"}},"type":"object","required":["period_start","period_end","generated_at"],"title":"WeeklySummaryResponse","description":"Weekly executive summary content. Spec Section 9.2."},"WeightAdjustment":{"properties":{"parameter":{"type":"string","title":"Parameter"},"current_value":{"type":"number","title":"Current Value"},"proposed_value":{"type":"number","title":"Proposed Value"},"adjustment":{"type":"number","title":"Adjustment"},"evidence":{"type":"string","title":"Evidence","default":""},"backtest_impact":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Backtest Impact"},"auto_applied":{"type":"boolean","title":"Auto Applied","default":false}},"type":"object","required":["parameter","current_value","proposed_value","adjustment"],"title":"WeightAdjustment","description":"A proposed or applied weight adjustment. Spec §3.1."},"WelcomeRequest":{"properties":{"email":{"type":"string","title":"Email"},"org_id":{"type":"string","title":"Org Id"},"org_name":{"type":"string","title":"Org Name"},"api_key_preview":{"type":"string","title":"Api Key Preview"},"membrane_id":{"type":"string","title":"Membrane Id"}},"type":"object","required":["email","org_id","org_name","api_key_preview","membrane_id"],"title":"WelcomeRequest","description":"Onboarding follow-up for orgs provisioned outside quickstart.\n\nThe dashboard BFF provisions via the granular intake/membrane endpoints, so\nit never reaches quickstart's welcome + drip step. It calls this instead —\nit is the only component that reliably knows the user's email (from the\nsession), because the in-memory org registry is populated by quickstart only."},"_ProxyMessageBody":{"properties":{"role":{"$ref":"#/components/schemas/A2ARole"},"parts":{"items":{"anyOf":[{"$ref":"#/components/schemas/TextPart"},{"$ref":"#/components/schemas/FilePart"},{"$ref":"#/components/schemas/DataPart"}]},"type":"array","title":"Parts"},"contextId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contextid"},"taskId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Taskid"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"},"target_agent_url":{"type":"string","title":"Target Agent Url"},"configuration":{"anyOf":[{"$ref":"#/components/schemas/SendMessageConfiguration"},{"type":"null"}]}},"type":"object","required":["role","target_agent_url"],"title":"_ProxyMessageBody","description":"Request body for proxy endpoints."},"SendMessageRequest":{"type":"object","properties":{"tenant":{"type":"string","example":""},"message":{"$ref":"#/components/schemas/Message"},"configuration":{"oneOf":[{"$ref":"#/components/schemas/SendMessageConfiguration"},{"type":"null"}],"example":null},"metadata":{"type":"object"}}},"Message":{"type":"object","properties":{"message_id":{"type":"string","example":"message_id"},"context_id":{"type":"string","example":""},"task_id":{"type":"string","example":""},"role":{"type":"string","enum":["ROLE_UNSPECIFIED","ROLE_USER","ROLE_AGENT"],"example":"ROLE_USER"},"parts":{"type":"array","items":{"$ref":"#/components/schemas/Part"},"example":[{"text":""}]},"metadata":{"type":"object"},"extensions":{"type":"array","items":{"type":"string","example":""},"example":[""]},"reference_task_ids":{"type":"array","items":{"type":"string","example":""},"example":[""]}}},"Part":{"allOf":[{"type":"object","properties":{"metadata":{"type":"object"},"filename":{"type":"string","example":""},"media_type":{"type":"string","example":""}}},{"oneOf":[{"type":"object","properties":{"text":{"type":"string","example":""}},"required":["text"]},{"type":"object","properties":{"raw":{"type":"string","format":"byte"}},"required":["raw"]},{"type":"object","properties":{"url":{"type":"string","example":""}},"required":["url"]},{"type":"object","properties":{"data":{}},"required":["data"]}]}],"example":{"text":""}},"TaskPushNotificationConfig":{"type":"object","properties":{"tenant":{"type":"string","example":""},"id":{"type":"string","example":""},"task_id":{"type":"string","example":""},"url":{"type":"string","example":"url"},"token":{"type":"string","example":""},"authentication":{"oneOf":[{"$ref":"#/components/schemas/AuthenticationInfo"},{"type":"null"}],"example":null}}},"AuthenticationInfo":{"type":"object","properties":{"scheme":{"type":"string","example":"scheme"},"credentials":{"type":"string","example":""}}},"GetTaskRequest":{"type":"object","properties":{"tenant":{"type":"string","example":""},"id":{"type":"string","example":"id"},"history_length":{"type":"integer","format":"int32"}}},"ListTasksRequest":{"type":"object","properties":{"tenant":{"type":"string","example":""},"context_id":{"type":"string","example":""},"status":{"type":"string","enum":["TASK_STATE_UNSPECIFIED","TASK_STATE_SUBMITTED","TASK_STATE_WORKING","TASK_STATE_COMPLETED","TASK_STATE_FAILED","TASK_STATE_CANCELED","TASK_STATE_INPUT_REQUIRED","TASK_STATE_REJECTED","TASK_STATE_AUTH_REQUIRED"],"example":"TASK_STATE_SUBMITTED"},"page_size":{"type":"integer","format":"int32"},"page_token":{"type":"string","example":""},"history_length":{"type":"integer","format":"int32"},"status_timestamp_after":{"type":"string","format":"date-time"},"include_artifacts":{"type":"boolean","example":false}}},"CancelTaskRequest":{"type":"object","properties":{"tenant":{"type":"string","example":""},"id":{"type":"string","example":"id"},"metadata":{"type":"object"}}},"GetTaskPushNotificationConfigRequest":{"type":"object","properties":{"tenant":{"type":"string","example":""},"task_id":{"type":"string","example":"task_id"},"id":{"type":"string","example":"id"}}},"ListTaskPushNotificationConfigsRequest":{"type":"object","properties":{"tenant":{"type":"string","example":""},"task_id":{"type":"string","example":"task_id"},"page_size":{"type":"integer","format":"int32"},"page_token":{"type":"string","example":""}}},"DeleteTaskPushNotificationConfigRequest":{"type":"object","properties":{"tenant":{"type":"string","example":""},"task_id":{"type":"string","example":"task_id"},"id":{"type":"string","example":"id"}}},"SubscribeToTaskRequest":{"type":"object","properties":{"tenant":{"type":"string","example":""},"id":{"type":"string","example":"id"}}},"GetExtendedAgentCardRequest":{"type":"object","properties":{"tenant":{"type":"string","example":""}}},"A2ARequest":{"type":"object","required":["jsonrpc","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"integer"},{"type":"null"}]},"method":{"type":"string","enum":["SendMessage","SendStreamingMessage","GetTask","ListTasks","CancelTask","CreateTaskPushNotificationConfig","GetTaskPushNotificationConfig","ListTaskPushNotificationConfigs","DeleteTaskPushNotificationConfig","SubscribeToTask","GetExtendedAgentCard"]},"params":{"oneOf":[{"$ref":"#/components/schemas/SendMessageRequest"},{"$ref":"#/components/schemas/GetTaskRequest"},{"$ref":"#/components/schemas/ListTasksRequest"},{"$ref":"#/components/schemas/CancelTaskRequest"},{"$ref":"#/components/schemas/TaskPushNotificationConfig"},{"$ref":"#/components/schemas/GetTaskPushNotificationConfigRequest"},{"$ref":"#/components/schemas/ListTaskPushNotificationConfigsRequest"},{"$ref":"#/components/schemas/DeleteTaskPushNotificationConfigRequest"},{"$ref":"#/components/schemas/SubscribeToTaskRequest"},{"$ref":"#/components/schemas/GetExtendedAgentCardRequest"}]}}}}}}