{ "openapi": "3.1.0", "info": { "title": "Sakshi \u2014 Agent Governance API", "description": "Registry (KYA), decision flight recorder, bounded autonomy, evidence packs, fairness screens. Auth: bearer ingest keys create evidence; OIDC JWTs with governance roles mutate state.", "version": "0.1.0" }, "paths": { "/healthz": { "get": { "summary": "Healthz", "operationId": "healthz_healthz_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Healthz Healthz Get" } } } } } } }, "/status": { "get": { "summary": "Status", "description": "Public status: liveness + version only \u2014 never data, never\nchain state (those need a principal).", "operationId": "status_status_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Status Status Get" } } } } } } }, "/api/v1/register/_meta": { "get": { "tags": [ "register" ], "summary": "Meta", "operationId": "meta_api_v1_register__meta_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Meta Api V1 Register Meta Get" } } } } } } }, "/api/v1/agents": { "post": { "tags": [ "register" ], "summary": "Create Agent", "operationId": "create_agent_api_v1_agents_post", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentCreate" } } } }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "register" ], "summary": "List Agents", "operationId": "list_agents_api_v1_agents_get", "parameters": [ { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "enum": [ "draft", "active", "suspended", "decommissioned" ], "type": "string" }, { "type": "null" } ], "title": "Status" } }, { "name": "autonomy_tier", "in": "query", "required": false, "schema": { "anyOf": [ { "enum": [ "L0", "L1", "L2", "L3", "L4" ], "type": "string" }, { "type": "null" } ], "title": "Autonomy Tier" } }, { "name": "name", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ], "description": "Exact-name lookup (SDK idempotent register)", "title": "Name" }, "description": "Exact-name lookup (SDK idempotent register)" }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ], "description": "Name prefix search (console global search)", "title": "Q" }, "description": "Name prefix search (console global search)" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/AgentOut" }, "title": "Response List Agents Api V1 Agents Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/agents/{agent_id}/identity": { "post": { "tags": [ "register" ], "summary": "Attach Identity", "description": "Attach an external identity (#68): verify an A2A Signed Agent Card\n(Ed25519 over the card bytes) or record a declared identity (Entra\nAgent ID / workload identity \u2014 a claim, not proof). The verdict is\nattested; the agent carries its verification status.", "operationId": "attach_identity_api_v1_agents__agent_id__identity_post", "parameters": [ { "name": "agent_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Agent Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IdentityIn" } } } }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Attach Identity Api V1 Agents Agent Id Identity Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/agents/orphans": { "get": { "tags": [ "register" ], "summary": "List Orphans", "description": "Agents with no accountable owner. Design doc 2.1: no orphans \u2014 these\nget an owner within a week or get suspended.", "operationId": "list_orphans_api_v1_agents_orphans_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/AgentOut" }, "type": "array", "title": "Response List Orphans Api V1 Agents Orphans Get" } } } } } } }, "/api/v1/agents/{agent_id}": { "get": { "tags": [ "register" ], "summary": "Get Agent", "operationId": "get_agent_api_v1_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": { "$ref": "#/components/schemas/AgentOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "patch": { "tags": [ "register" ], "summary": "Update Agent", "operationId": "update_agent_api_v1_agents__agent_id__patch", "parameters": [ { "name": "agent_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Agent Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentUpdate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/agents/{agent_id}/transfer-ownership": { "post": { "tags": [ "register" ], "summary": "Transfer Ownership", "operationId": "transfer_ownership_api_v1_agents__agent_id__transfer_ownership_post", "parameters": [ { "name": "agent_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Agent Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OwnershipTransfer" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/agents/{agent_id}/suspend": { "post": { "tags": [ "register" ], "summary": "Suspend Agent", "operationId": "suspend_agent_api_v1_agents__agent_id__suspend_post", "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/AgentOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/agents/{agent_id}/provenance": { "post": { "tags": [ "register" ], "summary": "Add Provenance", "operationId": "add_provenance_api_v1_agents__agent_id__provenance_post", "parameters": [ { "name": "agent_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Agent Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProvenanceCreate" } } } }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProvenanceOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "register" ], "summary": "List Provenance", "operationId": "list_provenance_api_v1_agents__agent_id__provenance_get", "parameters": [ { "name": "agent_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Agent Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/ProvenanceOut" }, "title": "Response List Provenance Api V1 Agents Agent Id Provenance Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/models": { "get": { "tags": [ "register" ], "summary": "List Models", "operationId": "list_models_api_v1_models_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/ModelOut" }, "type": "array", "title": "Response List Models Api V1 Models Get" } } } } } }, "post": { "tags": [ "register" ], "summary": "Create Model", "operationId": "create_model_api_v1_models_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ModelCreate" } } }, "required": true }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ModelOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/attestations": { "get": { "tags": [ "register" ], "summary": "List Attestations", "operationId": "list_attestations_api_v1_attestations_get", "parameters": [ { "name": "subject_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Subject Id" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 1000, "minimum": 1, "default": 100, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/AttestationOut" }, "title": "Response List Attestations Api V1 Attestations Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "post": { "tags": [ "register" ], "summary": "Create Attestation", "operationId": "create_attestation_api_v1_attestations_post", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AttestationCreate" } } } }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AttestationOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/api-keys": { "post": { "tags": [ "register" ], "summary": "Mint Api Key", "description": "Mint a managed ingest key. The raw value appears in THIS response and\nnever again \u2014 only its SHA-256 is stored. Minting is itself evidence.", "operationId": "mint_api_key_api_v1_api_keys_post", "parameters": [ { "name": "label", "in": "query", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 120, "title": "Label" } }, { "name": "scope_org_unit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "maxLength": 100 }, { "type": "null" } ], "title": "Scope Org Unit" } } ], "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Mint Api Key Api V1 Api Keys Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "register" ], "summary": "List Api Keys", "operationId": "list_api_keys_api_v1_api_keys_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "title": "Response List Api Keys Api V1 Api Keys Get" } } } } } } }, "/api/v1/api-keys/{key_id}/revoke": { "post": { "tags": [ "register" ], "summary": "Revoke Api Key", "description": "Revocation takes effect on the next request \u2014 the auth layer reads\nthe row, there is no cache to flush. Also evidence.", "operationId": "revoke_api_key_api_v1_api_keys__key_id__revoke_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 Revoke Api Key Api V1 Api Keys Key Id Revoke Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/webhooks": { "post": { "tags": [ "register" ], "summary": "Create Webhook", "description": "Register a webhook endpoint. The signing secret appears in THIS\nresponse; receivers verify X-Sakshi-Signature with it. Registration is\nitself evidence (attested), like ingest keys.", "operationId": "create_webhook_api_v1_webhooks_post", "parameters": [ { "name": "url", "in": "query", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 500, "title": "Url" } }, { "name": "events", "in": "query", "required": true, "schema": { "type": "string", "minLength": 3, "maxLength": 200, "description": "comma-separated: kill_switch,breaker,incident,escalation", "title": "Events" }, "description": "comma-separated: kill_switch,breaker,incident,escalation" }, { "name": "description", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "maxLength": 300 }, { "type": "null" } ], "title": "Description" } } ], "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Create Webhook Api V1 Webhooks Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "register" ], "summary": "List Webhooks", "operationId": "list_webhooks_api_v1_webhooks_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "title": "Response List Webhooks Api V1 Webhooks Get" } } } } } } }, "/api/v1/webhooks/{webhook_id}/test": { "post": { "tags": [ "register" ], "summary": "Test Webhook", "description": "Send a signed test event to a webhook so the receiver can verify\nwiring + signature before a real governance event fires.", "operationId": "test_webhook_api_v1_webhooks__webhook_id__test_post", "parameters": [ { "name": "webhook_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Webhook Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Test Webhook Api V1 Webhooks Webhook Id Test Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/webhooks/{webhook_id}/revoke": { "post": { "tags": [ "register" ], "summary": "Revoke Webhook", "operationId": "revoke_webhook_api_v1_webhooks__webhook_id__revoke_post", "parameters": [ { "name": "webhook_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Webhook Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Revoke Webhook Api V1 Webhooks Webhook Id Revoke Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/witness/_meta": { "get": { "tags": [ "witness" ], "summary": "Meta", "operationId": "meta_api_v1_witness__meta_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Meta Api V1 Witness Meta Get" } } } } } } }, "/api/v1/decisions": { "post": { "tags": [ "witness" ], "summary": "Capture Decision", "operationId": "capture_decision_api_v1_decisions_post", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DecisionCreate" } } } }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DecisionOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "witness" ], "summary": "List Decisions", "operationId": "list_decisions_api_v1_decisions_get", "parameters": [ { "name": "agent_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agent Id" } }, { "name": "client_ref", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Client Ref" } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "maxLength": 120 }, { "type": "null" } ], "description": "Prefix search over client_ref or record hash", "title": "Q" }, "description": "Prefix search over client_ref or record hash" }, { "name": "before_seq", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 1 }, { "type": "null" } ], "description": "Seq cursor: records strictly older", "title": "Before Seq" }, "description": "Seq cursor: records strictly older" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 1000, "minimum": 1, "default": 100, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/DecisionOut" }, "title": "Response List Decisions Api V1 Decisions Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/decisions/{record_id}": { "get": { "tags": [ "witness" ], "summary": "Get Decision", "operationId": "get_decision_api_v1_decisions__record_id__get", "parameters": [ { "name": "record_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Record Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DecisionOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/chain/head": { "get": { "tags": [ "witness" ], "summary": "Chain Head", "operationId": "chain_head_api_v1_chain_head_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChainHead" } } } } } } }, "/api/v1/chain/verify": { "get": { "tags": [ "witness" ], "summary": "Verify Chain", "description": "Recompute every hash in the range and check linkage. A regulator, an\nauditor, or the customer can run this without trusting us.", "operationId": "verify_chain_api_v1_chain_verify_get", "parameters": [ { "name": "from_seq", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1, "title": "From Seq" } }, { "name": "to_seq", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 1 }, { "type": "null" } ], "title": "To Seq" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChainVerification" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bound/_meta": { "get": { "tags": [ "bound" ], "summary": "Meta", "operationId": "meta_api_v1_bound__meta_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Meta Api V1 Bound Meta Get" } } } } } } }, "/api/v1/bound/lint-envelope": { "post": { "tags": [ "bound" ], "summary": "Lint Envelope Spec", "description": "Formally lint an envelope spec WITHOUT publishing (#72) \u2014 check for\ndead rules, escalation-monotonicity violations, and default reach\nbefore it governs anything.", "operationId": "lint_envelope_spec_api_v1_bound_lint_envelope_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EnvelopeCreate" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Lint Envelope Spec Api V1 Bound Lint Envelope Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bound/agents/{agent_id}/envelope": { "post": { "tags": [ "bound" ], "summary": "Create Envelope", "description": "New envelope version; prior versions deactivate but are never deleted \u2014\nthe envelope in force at any past decision stays reconstructable.", "operationId": "create_envelope_api_v1_bound_agents__agent_id__envelope_post", "parameters": [ { "name": "agent_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Agent Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EnvelopeCreate" } } } }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EnvelopeOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "bound" ], "summary": "Get Active Envelope", "operationId": "get_active_envelope_api_v1_bound_agents__agent_id__envelope_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/EnvelopeOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bound/agents/{agent_id}/envelope/lint": { "get": { "tags": [ "bound" ], "summary": "Get Active Envelope Lint", "description": "Formal-lint verdict for the agent's ACTIVE envelope (#72).", "operationId": "get_active_envelope_lint_api_v1_bound_agents__agent_id__envelope_lint_get", "parameters": [ { "name": "agent_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Agent Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Active Envelope Lint Api V1 Bound Agents Agent Id Envelope Lint Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bound/agents/{agent_id}/envelope/versions": { "get": { "tags": [ "bound" ], "summary": "List Envelope Versions", "operationId": "list_envelope_versions_api_v1_bound_agents__agent_id__envelope_versions_get", "parameters": [ { "name": "agent_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Agent Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/EnvelopeOut" }, "title": "Response List Envelope Versions Api V1 Bound Agents Agent Id Envelope Versions Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bound/evaluate": { "post": { "tags": [ "bound" ], "summary": "Evaluate Action", "description": "Route one intended action through the agent's active envelope. Every\ncall is persisted \u2014 routing itself is evidence (paras 60\u201363).", "operationId": "evaluate_action_api_v1_bound_evaluate_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EvaluateRequest" } } }, "required": true }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EvaluationOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bound/handoff": { "post": { "tags": [ "bound" ], "summary": "Request Handoff", "description": "Customer-triggered human handoff (#65, RBI draft 59(iii)): the agent\nruntime calls this when a customer asks for a human. Creates a HANDOFF\nqueue item in the agent's org unit \u2014 a review a customer requested is\nstill a review, worked in the same queues, and its existence is the\ndisclosure-control evidence.", "operationId": "request_handoff_api_v1_bound_handoff_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HandoffRequest" } } }, "required": true }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Request Handoff Api V1 Bound Handoff Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bound/telemetry/usage": { "get": { "tags": [ "bound" ], "summary": "Telemetry Usage", "description": "Per-agent token usage + cost (when priced) + incident MTTR (#57).", "operationId": "telemetry_usage_api_v1_bound_telemetry_usage_get", "parameters": [ { "name": "window_days", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 365, "minimum": 1, "default": 30, "title": "Window Days" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Telemetry Usage Api V1 Bound Telemetry Usage Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bound/telemetry": { "get": { "tags": [ "bound" ], "summary": "Telemetry", "description": "Override rates, time-on-task, escalation and deep-review disagreement\nper reviewer and per agent \u2014 the anti-rubber-stamp evidence (paras 61-63).", "operationId": "telemetry_api_v1_bound_telemetry_get", "parameters": [ { "name": "window_days", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 365, "minimum": 1, "default": 30, "title": "Window Days" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Telemetry Api V1 Bound Telemetry Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bound/kill": { "post": { "tags": [ "bound" ], "summary": "Activate Kill Switch", "operationId": "activate_kill_switch_api_v1_bound_kill_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/KillActivate" } } }, "required": true }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/KillEventOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bound/kill/release": { "post": { "tags": [ "bound" ], "summary": "Release Kill Switch", "operationId": "release_kill_switch_api_v1_bound_kill_release_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/KillRelease" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/KillEventOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bound/kill/status": { "get": { "tags": [ "bound" ], "summary": "Kill Status", "description": "The SDK's polling endpoint (#25): cheap, cacheable, no side effects.", "operationId": "kill_status_api_v1_bound_kill_status_get", "parameters": [ { "name": "target_type", "in": "query", "required": true, "schema": { "type": "string", "pattern": "^(agent|model)$", "title": "Target Type" } }, { "name": "target_id", "in": "query", "required": true, "schema": { "type": "string", "minLength": 1, "title": "Target Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HaltStatus" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bound/kill/events": { "get": { "tags": [ "bound" ], "summary": "List Kill Events", "operationId": "list_kill_events_api_v1_bound_kill_events_get", "parameters": [ { "name": "target_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Target Id" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 1000, "minimum": 1, "default": 100, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/KillEventOut" }, "title": "Response List Kill Events Api V1 Bound Kill Events Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bound/kill/events/{activation_id}/attestation": { "post": { "tags": [ "bound" ], "summary": "Attest Drill", "description": "Assemble the drill attestation from the event timeline: activation,\nwhat was blocked while halted, release. Para 43/60(ii) evidence \u2014 an\nuntested kill switch is a compliance claim, not a control.", "operationId": "attest_drill_api_v1_bound_kill_events__activation_id__attestation_post", "parameters": [ { "name": "activation_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Activation Id" } } ], "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Attest Drill Api V1 Bound Kill Events Activation Id Attestation Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bound/agents/{agent_id}/response-policy": { "get": { "tags": [ "bound" ], "summary": "Get Response Policy", "description": "The configured policy (if any) plus the effective response \u2014 absent a\npolicy, blast radius decides, and the caller should see that too.", "operationId": "get_response_policy_api_v1_bound_agents__agent_id__response_policy_get", "parameters": [ { "name": "agent_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Agent Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Response Policy Api V1 Bound Agents Agent Id Response Policy Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "put": { "tags": [ "bound" ], "summary": "Set Response Policy", "description": "Append-only like envelopes: a change is a new version. Provenance pin\nis deliberately absent \u2014 that is a human recovery decision made during\nthe investigation, never a standing automatic response.", "operationId": "set_response_policy_api_v1_bound_agents__agent_id__response_policy_put", "parameters": [ { "name": "agent_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Agent Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResponsePolicyIn" } } } }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResponsePolicyOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bound/agents/{agent_id}/breakers": { "post": { "tags": [ "bound" ], "summary": "Create Breaker", "operationId": "create_breaker_api_v1_bound_agents__agent_id__breakers_post", "parameters": [ { "name": "agent_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Agent Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BreakerIn" } } } }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BreakerOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "bound" ], "summary": "List Breakers", "operationId": "list_breakers_api_v1_bound_agents__agent_id__breakers_get", "parameters": [ { "name": "agent_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Agent Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/BreakerOut" }, "title": "Response List Breakers Api V1 Bound Agents Agent Id Breakers Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bound/breakers/{breaker_id}": { "patch": { "tags": [ "bound" ], "summary": "Toggle Breaker", "operationId": "toggle_breaker_api_v1_bound_breakers__breaker_id__patch", "parameters": [ { "name": "breaker_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Breaker Id" } }, { "name": "enabled", "in": "query", "required": true, "schema": { "type": "boolean", "title": "Enabled" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BreakerOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bound/breakers/check": { "post": { "tags": [ "bound" ], "summary": "Run Breaker Check", "description": "Evaluate enabled breakers now; any that trip fire the SAME kill path\nwith actor 'breaker:'. Also run periodically in-process \u2014 this\nendpoint exists for drills, tests, and external schedulers.", "operationId": "run_breaker_check_api_v1_bound_breakers_check_post", "parameters": [ { "name": "agent_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agent Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "title": "Response Run Breaker Check Api V1 Bound Breakers Check Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bound/reviews": { "get": { "tags": [ "bound" ], "summary": "List Reviews", "operationId": "list_reviews_api_v1_bound_reviews_get", "parameters": [ { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": "pending", "title": "Status" } }, { "name": "kind", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Kind" } }, { "name": "agent_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agent Id" } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ], "description": "client_ref prefix (console global search)", "title": "Q" }, "description": "client_ref prefix (console global search)" }, { "name": "assigned_to_me", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Assigned To Me" } }, { "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", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/ReviewOut" }, "title": "Response List Reviews Api V1 Bound Reviews Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bound/reviews/{review_id}": { "get": { "tags": [ "bound" ], "summary": "Get Review", "operationId": "get_review_api_v1_bound_reviews__review_id__get", "parameters": [ { "name": "review_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Review Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReviewOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bound/reviews/{review_id}/claim": { "post": { "tags": [ "bound" ], "summary": "Claim Review", "description": "Marks when a reviewer actually started looking \u2014 time-on-task telemetry\n(#20) measures claim->resolve, not create->resolve.", "operationId": "claim_review_api_v1_bound_reviews__review_id__claim_post", "parameters": [ { "name": "review_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Review Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReviewOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bound/reviews/{review_id}/resolve": { "post": { "tags": [ "bound" ], "summary": "Resolve Review", "operationId": "resolve_review_api_v1_bound_reviews__review_id__resolve_post", "parameters": [ { "name": "review_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Review Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReviewResolve" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReviewOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bound/evaluations/{evaluation_id}": { "get": { "tags": [ "bound" ], "summary": "Get Evaluation", "operationId": "get_evaluation_api_v1_bound_evaluations__evaluation_id__get", "parameters": [ { "name": "evaluation_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Evaluation Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EvaluationOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bound/evaluations": { "get": { "tags": [ "bound" ], "summary": "List Evaluations", "operationId": "list_evaluations_api_v1_bound_evaluations_get", "parameters": [ { "name": "agent_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agent Id" } }, { "name": "outcome", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Outcome" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 1000, "minimum": 1, "default": 100, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/EvaluationOut" }, "title": "Response List Evaluations Api V1 Bound Evaluations Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/bound/safety": { "get": { "tags": [ "bound" ], "summary": "Fleet Safety", "description": "Fleet-wide safety posture in one view: every agent's halt state + its\narmed circuit breakers (per-agent detail lives on the agent page). The\nkill/drill LOG is /kill/events.", "operationId": "fleet_safety_api_v1_bound_safety_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Fleet Safety Api V1 Bound Safety Get" } } } } } } }, "/api/v1/vidhi/_meta": { "get": { "tags": [ "vidhi" ], "summary": "Meta", "operationId": "meta_api_v1_vidhi__meta_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Meta Api V1 Vidhi Meta Get" } } } } } } }, "/api/v1/vidhi/readiness": { "get": { "tags": [ "vidhi" ], "summary": "Get Readiness", "description": "Regulatory Readiness Score (#52): this deployment scored live against\neach clause map. Adoption moves the score; assertions do not.", "operationId": "get_readiness_api_v1_vidhi_readiness_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Get Readiness Api V1 Vidhi Readiness Get" } } } } } } }, "/api/v1/vidhi/clause-maps": { "get": { "tags": [ "vidhi" ], "summary": "List Clause Maps", "operationId": "list_clause_maps_api_v1_vidhi_clause_maps_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Response List Clause Maps Api V1 Vidhi Clause Maps Get" } } } } } } }, "/api/v1/vidhi/clause-maps/{name}": { "get": { "tags": [ "vidhi" ], "summary": "Get Clause Map", "operationId": "get_clause_map_api_v1_vidhi_clause_maps__name__get", "parameters": [ { "name": "name", "in": "path", "required": true, "schema": { "type": "string", "title": "Name" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Clause Map Api V1 Vidhi Clause Maps Name Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/vidhi/packs/{map_name}": { "get": { "tags": [ "vidhi" ], "summary": "Build Pack", "description": "Generate the evidence pack for a clause map, live: chain verification\nruns, telemetry computes, counts query \u2014 never a cached document.", "operationId": "build_pack_api_v1_vidhi_packs__map_name__get", "parameters": [ { "name": "map_name", "in": "path", "required": true, "schema": { "type": "string", "title": "Map Name" } }, { "name": "window_days", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 365, "minimum": 1, "default": 30, "title": "Window Days" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Build Pack Api V1 Vidhi Packs Map Name Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/vidhi/packs/{map_name}/export": { "get": { "tags": [ "vidhi" ], "summary": "Export Pack", "description": "The evidence bundle: a freshly generated pack, Ed25519-signed with\nthis deployment's key \u2014 verifiable offline by anyone with the public key.", "operationId": "export_pack_api_v1_vidhi_packs__map_name__export_get", "parameters": [ { "name": "map_name", "in": "path", "required": true, "schema": { "type": "string", "title": "Map Name" } }, { "name": "window_days", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 365, "minimum": 1, "default": 30, "title": "Window Days" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Export Pack Api V1 Vidhi Packs Map Name Export Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/vidhi/incidents": { "post": { "tags": [ "vidhi" ], "summary": "Create Incident", "description": "Declaring an incident is a human act (reviewer and above); the report\nassembles itself from the flight recorder.", "operationId": "create_incident_api_v1_vidhi_incidents_post", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IncidentCreate" } } } }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IncidentOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "vidhi" ], "summary": "List Incidents", "operationId": "list_incidents_api_v1_vidhi_incidents_get", "parameters": [ { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Status" } }, { "name": "agent_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agent Id" } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ], "description": "Title prefix search (console global search)", "title": "Q" }, "description": "Title prefix search (console global search)" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 1000, "minimum": 1, "default": 100, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/IncidentOut" }, "title": "Response List Incidents Api V1 Vidhi Incidents Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/vidhi/rti/decision": { "get": { "tags": [ "vidhi" ], "summary": "Rti Decision", "description": "RTI-shaped disclosure pack for one decision (#59): point-wise\nquery/reply/source answers assembled from the flight recorder.", "operationId": "rti_decision_api_v1_vidhi_rti_decision_get", "parameters": [ { "name": "client_ref", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Client Ref" } }, { "name": "seq", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 1 }, { "type": "null" } ], "title": "Seq" } }, { "name": "signed", "in": "query", "required": false, "schema": { "type": "boolean", "description": "wrap in the Ed25519 evidence-bundle envelope", "default": false, "title": "Signed" }, "description": "wrap in the Ed25519 evidence-bundle envelope" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Rti Decision Api V1 Vidhi Rti Decision Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/vidhi/incidents/{incident_id}/report": { "get": { "tags": [ "vidhi" ], "summary": "Incident Report", "operationId": "incident_report_api_v1_vidhi_incidents__incident_id__report_get", "parameters": [ { "name": "incident_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Incident Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Incident Report Api V1 Vidhi Incidents Incident Id Report Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/vidhi/incidents/{incident_id}/export": { "get": { "tags": [ "vidhi" ], "summary": "Incident Export", "description": "Signed incident bundle \u2014 same Ed25519 envelope as evidence packs.", "operationId": "incident_export_api_v1_vidhi_incidents__incident_id__export_get", "parameters": [ { "name": "incident_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Incident Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Incident Export Api V1 Vidhi Incidents Incident Id Export Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/vidhi/incidents/{incident_id}/resolve": { "post": { "tags": [ "vidhi" ], "summary": "Resolve Incident", "operationId": "resolve_incident_api_v1_vidhi_incidents__incident_id__resolve_post", "parameters": [ { "name": "incident_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Incident Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IncidentResolve" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IncidentOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/vidhi/eval-runs": { "post": { "tags": [ "vidhi" ], "summary": "Create Eval Run", "description": "Store a citable eval run. Metrics are supplied (scored offline by\nexact-match, the Indic judge, or humans \u2014 recorded in `scorer`); the\nplatform computes the GATE VERDICT against Wilson confidence intervals\nand stores the exact artifact. Packs cite it by id as validation\nevidence.", "operationId": "create_eval_run_api_v1_vidhi_eval_runs_post", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EvalRunIn" } } } }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Create Eval Run Api V1 Vidhi Eval Runs Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "vidhi" ], "summary": "List Eval Runs", "operationId": "list_eval_runs_api_v1_vidhi_eval_runs_get", "parameters": [ { "name": "agent_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agent Id" } }, { "name": "suite", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Suite" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "title": "Response List Eval Runs Api V1 Vidhi Eval Runs Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/vidhi/eval-runs/{run_id}": { "get": { "tags": [ "vidhi" ], "summary": "Get Eval Run", "operationId": "get_eval_run_api_v1_vidhi_eval_runs__run_id__get", "parameters": [ { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Run Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Eval Run Api V1 Vidhi Eval Runs Run Id Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/vidhi/dpia": { "get": { "tags": [ "vidhi" ], "summary": "Dpia Support", "description": "The algorithmic-processing sections of a DPDP Rule-13 DPIA,\npre-filled from live evidence.", "operationId": "dpia_support_api_v1_vidhi_dpia_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Dpia Support Api V1 Vidhi Dpia Get" } } } } } } }, "/api/v1/vidhi/audit-bundle": { "get": { "tags": [ "vidhi" ], "summary": "Audit Bundle", "description": "Independent-audit bundle (DPDP Rule 13(2)): DPIA substrate + every\nregulator pack + readiness snapshot, in one signed artifact for the\nauditor. Auditor-role principals (read-only) can pull this without\nbeing able to change anything \u2014 the 'hand the auditor a login' story\nextended to a portable, verifiable export.", "operationId": "audit_bundle_api_v1_vidhi_audit_bundle_get", "parameters": [ { "name": "signed", "in": "query", "required": false, "schema": { "type": "boolean", "description": "Ed25519 evidence-bundle envelope", "default": true, "title": "Signed" }, "description": "Ed25519 evidence-bundle envelope" }, { "name": "window_days", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 730, "minimum": 1, "default": 90, "title": "Window Days" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Audit Bundle Api V1 Vidhi Audit Bundle Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/vishwas/_meta": { "get": { "tags": [ "vishwas" ], "summary": "Meta", "operationId": "meta_api_v1_vishwas__meta_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Meta Api V1 Vishwas Meta Get" } } } } } } }, "/api/v1/vishwas/locality-screen": { "get": { "tags": [ "vishwas" ], "summary": "Get Locality Screen", "description": "Inference-free disparity screen: decision outcomes by locality against\ncensus SC/ST population shares (ETHICS.md \u00a71a). Flags, never proves \u2014\nthe caveats travel inside the payload.", "operationId": "get_locality_screen_api_v1_vishwas_locality_screen_get", "parameters": [ { "name": "agent_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agent Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Locality Screen Api V1 Vishwas Locality Screen Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/vishwas/declared-screen": { "get": { "tags": [ "vishwas" ], "summary": "Get Declared Screen", "description": "Declared-attribute fairness screen (#30) computed live off the flight\nrecorder \u2014 production-grounded monitoring, no inference.", "operationId": "get_declared_screen_api_v1_vishwas_declared_screen_get", "parameters": [ { "name": "agent_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agent Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Declared Screen Api V1 Vishwas Declared Screen Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/vishwas/predeploy-runs": { "post": { "tags": [ "vishwas" ], "summary": "Create Predeploy Run", "description": "Pre-deploy bias testing: screen a batch of candidate decisions with\ndeclared attributes BEFORE the agent goes live. The stored result is the\ncitable artifact; packs reference it by id.", "operationId": "create_predeploy_run_api_v1_vishwas_predeploy_runs_post", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PredeployRunIn" } } } }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Create Predeploy Run Api V1 Vishwas Predeploy Runs Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "vishwas" ], "summary": "List Predeploy Runs", "operationId": "list_predeploy_runs_api_v1_vishwas_predeploy_runs_get", "parameters": [ { "name": "agent_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agent Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "title": "Response List Predeploy Runs Api V1 Vishwas Predeploy Runs Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/vishwas/verify-disposition": { "post": { "tags": [ "vishwas" ], "summary": "Verify Disposition Endpoint", "description": "Verify a storage disposition (#80 D2) \u2014 a signed vault receipt or a\nreference key against the configured vault \u2014 without ever seeing the\nraw value.", "operationId": "verify_disposition_endpoint_api_v1_vishwas_verify_disposition_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DispositionIn" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Verify Disposition Endpoint Api V1 Vishwas Verify Disposition Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/vishwas/extraction-screen": { "get": { "tags": [ "vishwas" ], "summary": "Get Extraction Screen", "description": "Document/KYC extraction governance (#80): data-minimization +\nstorage-disposition findings computed live off the flight recorder.", "operationId": "get_extraction_screen_api_v1_vishwas_extraction_screen_get", "parameters": [ { "name": "agent_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agent Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Extraction Screen Api V1 Vishwas Extraction Screen Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/vishwas/mcp-screen": { "get": { "tags": [ "vishwas" ], "summary": "Get Mcp Screen", "description": "MCP governance (#58): tool calls + manifests witnessed off the flight\nrecorder, and the tool-poisoning findings (mcp_manifest_changed).", "operationId": "get_mcp_screen_api_v1_vishwas_mcp_screen_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Get Mcp Screen Api V1 Vishwas Mcp Screen Get" } } } } } } }, "/api/v1/vishwas/predeploy-runs/{run_id}": { "get": { "tags": [ "vishwas" ], "summary": "Get Predeploy Run", "operationId": "get_predeploy_run_api_v1_vishwas_predeploy_runs__run_id__get", "parameters": [ { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Run Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Predeploy Run Api V1 Vishwas Predeploy Runs Run Id Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/me/briefing": { "get": { "tags": [ "me" ], "summary": "Get Briefing", "description": "A scoped, grounded digest of what changed since this user was last\nhere and what needs them now \u2014 plus, when enabled, a sovereign-LLM\nnarration over ONLY those facts. The digest is authoritative.", "operationId": "get_briefing_api_v1_me_briefing_get", "parameters": [ { "name": "narrative", "in": "query", "required": false, "schema": { "type": "boolean", "description": "also generate the natural-language summary (the digest is always returned)", "default": true, "title": "Narrative" }, "description": "also generate the natural-language summary (the digest is always returned)" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Briefing Api V1 Me Briefing Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/me/entitlements": { "get": { "tags": [ "me" ], "summary": "My Entitlements", "description": "The caller's EFFECTIVE Sakshi entitlements after the access mapping is\napplied (ADR-021) \u2014 the console reads this at sign-in so nav matches what\nthe API authorizes. Any authenticated user; reflects the resolved principal,\nnot the raw IdP claims.", "operationId": "my_entitlements_api_v1_me_entitlements_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response My Entitlements Api V1 Me Entitlements Get" } } } } } } }, "/api/v1/admin/entitlement-rules": { "get": { "tags": [ "access" ], "summary": "List Rules", "operationId": "list_rules_api_v1_admin_entitlement_rules_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/RuleOut" }, "type": "array", "title": "Response List Rules Api V1 Admin Entitlement Rules Get" } } } } } }, "post": { "tags": [ "access" ], "summary": "Create Rule", "operationId": "create_rule_api_v1_admin_entitlement_rules_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RuleIn" } } }, "required": true }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RuleOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/admin/entitlement-rules/{rule_id}": { "patch": { "tags": [ "access" ], "summary": "Update Rule", "operationId": "update_rule_api_v1_admin_entitlement_rules__rule_id__patch", "parameters": [ { "name": "rule_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Rule Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RuleUpdate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RuleOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "access" ], "summary": "Delete Rule", "operationId": "delete_rule_api_v1_admin_entitlement_rules__rule_id__delete", "parameters": [ { "name": "rule_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Rule Id" } } ], "responses": { "204": { "description": "Successful Response" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/admin/entitlement-rules/resolve": { "post": { "tags": [ "access" ], "summary": "Resolve Preview", "description": "Dry-run: given a sample user's raw claims, show the entitlements the\ncurrent ruleset would grant \u2014 the wizard's preview (Slice C uses this).", "operationId": "resolve_preview_api_v1_admin_entitlement_rules_resolve_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResolveIn" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResolveOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/admin/entitlement-rules/resolve-draft": { "post": { "tags": [ "access" ], "summary": "Resolve Draft", "description": "Dry-run against DRAFT (unsaved) rules \u2014 the wizard previews a sample user\nbefore anything is written. No DB read; resolves the provided rules only.", "operationId": "resolve_draft_api_v1_admin_entitlement_rules_resolve_draft_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResolveDraftIn" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResolveOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/admin/observed-claims": { "get": { "tags": [ "access" ], "summary": "Observed Claims", "description": "Distinct IdP role/group names seen from real logins \u2014 seeds the wizard so\nan admin maps what their IdP actually sends, not a blank form. Names only.", "operationId": "observed_claims_api_v1_admin_observed_claims_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ObservedOut" } } } } } } }, "/api/v1/admin/access-config": { "get": { "tags": [ "access" ], "summary": "Get Access Config", "operationId": "get_access_config_api_v1_admin_access_config_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigOut" } } } } } }, "patch": { "tags": [ "access" ], "summary": "Update Access Config", "operationId": "update_access_config_api_v1_admin_access_config_patch", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigUpdate" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/admin/platform": { "get": { "tags": [ "access" ], "summary": "Platform Posture", "description": "Read-only view of the deployment's effective, NON-SECRET configuration \u2014\nso an admin can verify posture without shell access, and cite it as evidence.\nSecret VALUES are never returned (only 'configured' / 'not'); these settings\nare deploy-time env (SAKSHI_*), not runtime-editable here.", "operationId": "platform_posture_api_v1_admin_platform_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Platform Posture Api V1 Admin Platform Get" } } } } } } }, "/api/v1/admin/access-activity": { "get": { "tags": [ "access" ], "summary": "Access Activity", "description": "The attested log of access-control changes \u2014 every rule and toggle edit,\nwho made it and when. 'Who can approve' is change-controlled and evidenced.", "operationId": "access_activity_api_v1_admin_access_activity_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/ActivityOut" }, "type": "array", "title": "Response Access Activity Api V1 Admin Access Activity Get" } } } } } } }, "/api/v1/certify/runs": { "post": { "tags": [ "certify" ], "summary": "Create Certification", "description": "Run the certification battery over a candidate agent and issue a signed\ncertificate. A governance act (officer and above): certifying an agent as\nfit for production is a sign-off, not a read.", "operationId": "create_certification_api_v1_certify_runs_post", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CertifyRequest" } } } }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CertificationOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "certify" ], "summary": "List Certifications", "operationId": "list_certifications_api_v1_certify_runs_get", "parameters": [ { "name": "agent_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agent Id" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 200, "default": 50, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/CertificationOut" }, "title": "Response List Certifications Api V1 Certify Runs Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/certify/agents/{agent_id}/latest": { "get": { "tags": [ "certify" ], "summary": "Latest For Agent", "description": "The most recent certification for an agent \u2014 the one the C2 gate and the\nconsole badge read.", "operationId": "latest_for_agent_api_v1_certify_agents__agent_id__latest_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/CertificationOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/certify/runs/{cert_id}": { "get": { "tags": [ "certify" ], "summary": "Get Certification", "operationId": "get_certification_api_v1_certify_runs__cert_id__get", "parameters": [ { "name": "cert_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Cert Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CertificationOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/certify/runs/{cert_id}/export": { "get": { "tags": [ "certify" ], "summary": "Export Certification", "description": "The downloadable, independently verifiable certificate: the Ed25519-signed\nbundle whose signature covers the exact payload bytes.", "operationId": "export_certification_api_v1_certify_runs__cert_id__export_get", "parameters": [ { "name": "cert_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Cert Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Export Certification Api V1 Certify Runs Cert Id Export Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/behavior/fleet": { "get": { "tags": [ "behavior" ], "summary": "Fleet Change", "description": "Behavioural-change summary across the fleet \u2014 changed agents first.", "operationId": "fleet_change_api_v1_behavior_fleet_get", "parameters": [ { "name": "window", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 2000, "minimum": 10, "default": 100, "title": "Window" } }, { "name": "min_samples", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 1000, "minimum": 5, "default": 30, "title": "Min Samples" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "title": "Response Fleet Change Api V1 Behavior Fleet Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/behavior/agents/{agent_id}/change": { "get": { "tags": [ "behavior" ], "summary": "Agent Change", "description": "Per-dimension behavioural drift for one agent: the last `window` decisions\nvs the `window` before them.", "operationId": "agent_change_api_v1_behavior_agents__agent_id__change_get", "parameters": [ { "name": "agent_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Agent Id" } }, { "name": "window", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 2000, "minimum": 10, "default": 100, "title": "Window" } }, { "name": "min_samples", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 1000, "minimum": 5, "default": 30, "title": "Min Samples" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Agent Change Api V1 Behavior Agents Agent Id Change Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/behavior/agents/{agent_id}/report": { "post": { "tags": [ "behavior" ], "summary": "Create Report", "description": "Persist a signed behavioural-change report. A SILENT change (a flagged\ndimension no governance event explains) is the unauthorised-change finding:\nit flags the agent for re-certification and emits an agent_behavior_changed\nwebhook. A governance act \u2014 producing the signed artifact is a sign-off.", "operationId": "create_report_api_v1_behavior_agents__agent_id__report_post", "parameters": [ { "name": "agent_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Agent Id" } }, { "name": "window", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 2000, "minimum": 10, "default": 100, "title": "Window" } }, { "name": "min_samples", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 1000, "minimum": 5, "default": 30, "title": "Min Samples" } } ], "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChangeReportOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/behavior/reports": { "get": { "tags": [ "behavior" ], "summary": "List Reports", "operationId": "list_reports_api_v1_behavior_reports_get", "parameters": [ { "name": "agent_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agent Id" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 200, "default": 50, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/ChangeReportOut" }, "title": "Response List Reports Api V1 Behavior Reports Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/behavior/reports/{report_id}": { "get": { "tags": [ "behavior" ], "summary": "Get Report", "operationId": "get_report_api_v1_behavior_reports__report_id__get", "parameters": [ { "name": "report_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Report Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChangeReportDetail" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/behavior/reports/{report_id}/export": { "get": { "tags": [ "behavior" ], "summary": "Export Report", "description": "The Ed25519-signed change report \u2014 the tamper-evident unauthorised-change\nartifact (signature covers the exact payload bytes).", "operationId": "export_report_api_v1_behavior_reports__report_id__export_get", "parameters": [ { "name": "report_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Report Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Export Report Api V1 Behavior Reports Report Id Export Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/v1/guardian": { "get": { "tags": [ "guardian" ], "summary": "Overview", "description": "What the Guardian is watching across the fleet, and the interventions it\nhas fired (each on the chain, via the kill path).", "operationId": "overview_api_v1_guardian_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Overview Api V1 Guardian Get" } } } } } } }, "/api/v1/guardian/agents/{agent_id}/check": { "post": { "tags": [ "guardian" ], "summary": "Run Watches", "description": "Evaluate the agent's armed watches now. Any hard watch that trips fires the\nkill path (actor breaker:) \u2014 real-time intervention on demand, for a\ndrill or an operator. (Watches also run on the 60s in-process sweep.)", "operationId": "run_watches_api_v1_guardian_agents__agent_id__check_post", "parameters": [ { "name": "agent_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Agent Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Run Watches Api V1 Guardian Agents Agent Id Check Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } } }, "components": { "schemas": { "ActivityOut": { "properties": { "id": { "type": "string", "title": "Id" }, "subject_type": { "type": "string", "title": "Subject Type" }, "subject_id": { "type": "string", "title": "Subject Id" }, "statement": { "type": "string", "title": "Statement" }, "signed_by": { "type": "string", "title": "Signed By" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" } }, "type": "object", "required": [ "id", "subject_type", "subject_id", "statement", "signed_by", "created_at" ], "title": "ActivityOut" }, "AgentCreate": { "properties": { "name": { "type": "string", "maxLength": 200, "minLength": 1, "title": "Name" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" }, "owner_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Owner Name" }, "owner_email": { "anyOf": [ { "type": "string", "format": "email" }, { "type": "null" } ], "title": "Owner Email" }, "org_unit": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Org Unit" }, "autonomy_tier": { "type": "string", "enum": [ "L0", "L1", "L2", "L3", "L4" ], "title": "Autonomy Tier", "default": "L0" }, "blast_radius": { "additionalProperties": true, "type": "object", "title": "Blast Radius" }, "recert_due_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Recert Due At" } }, "type": "object", "required": [ "name" ], "title": "AgentCreate" }, "AgentOut": { "properties": { "id": { "type": "string", "title": "Id" }, "tenant_id": { "type": "string", "title": "Tenant Id" }, "name": { "type": "string", "title": "Name" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" }, "owner_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Owner Name" }, "owner_email": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Owner Email" }, "identity_verified": { "type": "boolean", "title": "Identity Verified", "default": false }, "identity_source": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Identity Source" }, "identity_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Identity Ref" }, "org_unit": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Org Unit" }, "autonomy_tier": { "type": "string", "title": "Autonomy Tier" }, "blast_radius": { "additionalProperties": true, "type": "object", "title": "Blast Radius" }, "status": { "type": "string", "title": "Status" }, "recert_due_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Recert Due At" }, "decommissioned_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Decommissioned At" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" } }, "type": "object", "required": [ "id", "tenant_id", "name", "description", "owner_name", "owner_email", "org_unit", "autonomy_tier", "blast_radius", "status", "recert_due_at", "decommissioned_at", "created_at" ], "title": "AgentOut" }, "AgentUpdate": { "properties": { "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" }, "org_unit": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Org Unit" }, "autonomy_tier": { "anyOf": [ { "type": "string", "enum": [ "L0", "L1", "L2", "L3", "L4" ] }, { "type": "null" } ], "title": "Autonomy Tier" }, "blast_radius": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Blast Radius" }, "status": { "anyOf": [ { "type": "string", "enum": [ "draft", "active", "suspended", "decommissioned" ] }, { "type": "null" } ], "title": "Status" }, "recert_due_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Recert Due At" } }, "type": "object", "title": "AgentUpdate" }, "AttestationCreate": { "properties": { "subject_type": { "type": "string", "enum": [ "agent", "model", "policy" ], "title": "Subject Type" }, "subject_id": { "type": "string", "title": "Subject Id" }, "statement": { "type": "string", "minLength": 1, "title": "Statement" }, "signed_by": { "type": "string", "format": "email", "title": "Signed By" }, "evidence_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Evidence Ref" } }, "type": "object", "required": [ "subject_type", "subject_id", "statement", "signed_by" ], "title": "AttestationCreate" }, "AttestationOut": { "properties": { "id": { "type": "string", "title": "Id" }, "subject_type": { "type": "string", "title": "Subject Type" }, "subject_id": { "type": "string", "title": "Subject Id" }, "statement": { "type": "string", "title": "Statement" }, "signed_by": { "type": "string", "title": "Signed By" }, "evidence_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Evidence Ref" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" } }, "type": "object", "required": [ "id", "subject_type", "subject_id", "statement", "signed_by", "evidence_ref", "created_at" ], "title": "AttestationOut" }, "BreakerIn": { "properties": { "name": { "type": "string", "maxLength": 120, "minLength": 1, "title": "Name" }, "metric": { "type": "string", "enum": [ "override_rate", "eval_volume", "model_change", "error_rate", "signal_drift", "mcp_poisoning", "behavioral_change" ], "title": "Metric" }, "params": { "additionalProperties": true, "type": "object", "title": "Params" }, "enabled": { "type": "boolean", "title": "Enabled", "default": true } }, "type": "object", "required": [ "name", "metric" ], "title": "BreakerIn" }, "BreakerOut": { "properties": { "id": { "type": "string", "title": "Id" }, "agent_id": { "type": "string", "title": "Agent Id" }, "name": { "type": "string", "title": "Name" }, "metric": { "type": "string", "title": "Metric" }, "params": { "additionalProperties": true, "type": "object", "title": "Params" }, "enabled": { "type": "boolean", "title": "Enabled" }, "created_by": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Created By" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "last_checked_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Last Checked At" }, "last_value": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Last Value" }, "fired_event_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Fired Event Id" } }, "type": "object", "required": [ "id", "agent_id", "name", "metric", "params", "enabled", "created_by", "created_at", "last_checked_at", "last_value", "fired_event_id" ], "title": "BreakerOut" }, "CertificationOut": { "properties": { "id": { "type": "string", "title": "Id" }, "agent_id": { "type": "string", "title": "Agent Id" }, "agent_name": { "type": "string", "title": "Agent Name" }, "status": { "type": "string", "title": "Status" }, "score": { "type": "number", "title": "Score" }, "checks": { "items": { "$ref": "#/components/schemas/CheckOut" }, "type": "array", "title": "Checks" }, "expires_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Expires At" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "ran_by": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Ran By" } }, "type": "object", "required": [ "id", "agent_id", "agent_name", "status", "score", "checks", "expires_at", "created_at", "ran_by" ], "title": "CertificationOut" }, "CertifyRequest": { "properties": { "agent_id": { "type": "string", "title": "Agent Id" }, "validity_days": { "type": "integer", "title": "Validity Days", "default": 90 } }, "type": "object", "required": [ "agent_id" ], "title": "CertifyRequest" }, "ChainHead": { "properties": { "seq": { "type": "integer", "title": "Seq" }, "record_hash": { "type": "string", "title": "Record Hash" } }, "type": "object", "required": [ "seq", "record_hash" ], "title": "ChainHead" }, "ChainVerification": { "properties": { "valid": { "type": "boolean", "title": "Valid" }, "checked": { "type": "integer", "title": "Checked" }, "first_invalid_seq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "First Invalid Seq" }, "detail": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Detail" } }, "type": "object", "required": [ "valid", "checked" ], "title": "ChainVerification" }, "ChangeReportDetail": { "properties": { "id": { "type": "string", "title": "Id" }, "agent_id": { "type": "string", "title": "Agent Id" }, "agent_name": { "type": "string", "title": "Agent Name" }, "status": { "type": "string", "title": "Status" }, "classification": { "type": "string", "title": "Classification" }, "top_psi": { "type": "number", "title": "Top Psi" }, "flagged_dimensions": { "items": { "type": "string" }, "type": "array", "title": "Flagged Dimensions" }, "recert_triggered": { "type": "boolean", "title": "Recert Triggered" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "ran_by": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Ran By" }, "analysis": { "additionalProperties": true, "type": "object", "title": "Analysis" } }, "type": "object", "required": [ "id", "agent_id", "agent_name", "status", "classification", "top_psi", "flagged_dimensions", "recert_triggered", "created_at", "ran_by", "analysis" ], "title": "ChangeReportDetail" }, "ChangeReportOut": { "properties": { "id": { "type": "string", "title": "Id" }, "agent_id": { "type": "string", "title": "Agent Id" }, "agent_name": { "type": "string", "title": "Agent Name" }, "status": { "type": "string", "title": "Status" }, "classification": { "type": "string", "title": "Classification" }, "top_psi": { "type": "number", "title": "Top Psi" }, "flagged_dimensions": { "items": { "type": "string" }, "type": "array", "title": "Flagged Dimensions" }, "recert_triggered": { "type": "boolean", "title": "Recert Triggered" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "ran_by": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Ran By" } }, "type": "object", "required": [ "id", "agent_id", "agent_name", "status", "classification", "top_psi", "flagged_dimensions", "recert_triggered", "created_at", "ran_by" ], "title": "ChangeReportOut" }, "CheckOut": { "properties": { "name": { "type": "string", "title": "Name" }, "status": { "type": "string", "title": "Status" }, "clause": { "type": "string", "title": "Clause" }, "detail": { "type": "string", "title": "Detail" }, "hard": { "type": "boolean", "title": "Hard" } }, "type": "object", "required": [ "name", "status", "clause", "detail", "hard" ], "title": "CheckOut" }, "ConfigOut": { "properties": { "trust_canonical_claims": { "type": "boolean", "title": "Trust Canonical Claims" }, "updated_by": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Updated By" }, "updated_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Updated At" } }, "type": "object", "required": [ "trust_canonical_claims", "updated_by", "updated_at" ], "title": "ConfigOut" }, "ConfigUpdate": { "properties": { "trust_canonical_claims": { "type": "boolean", "title": "Trust Canonical Claims" } }, "type": "object", "required": [ "trust_canonical_claims" ], "title": "ConfigUpdate" }, "DecisionCreate": { "properties": { "agent_id": { "type": "string", "title": "Agent Id" }, "client_ref": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ], "title": "Client Ref", "description": "Caller-supplied idempotency key" }, "model_identity": { "additionalProperties": true, "type": "object", "title": "Model Identity" }, "context": { "additionalProperties": true, "type": "object", "title": "Context" }, "decision_chain": { "items": {}, "type": "array", "title": "Decision Chain" }, "action": { "additionalProperties": true, "type": "object", "title": "Action" }, "policy_state": { "additionalProperties": true, "type": "object", "title": "Policy State" }, "human_touchpoints": { "items": {}, "type": "array", "title": "Human Touchpoints" } }, "type": "object", "required": [ "agent_id" ], "title": "DecisionCreate" }, "DecisionOut": { "properties": { "id": { "type": "string", "title": "Id" }, "tenant_id": { "type": "string", "title": "Tenant Id" }, "agent_id": { "type": "string", "title": "Agent Id" }, "seq": { "type": "integer", "title": "Seq" }, "client_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Client Ref" }, "captured_at": { "type": "string", "format": "date-time", "title": "Captured At" }, "model_identity": { "additionalProperties": true, "type": "object", "title": "Model Identity" }, "context": { "additionalProperties": true, "type": "object", "title": "Context" }, "decision_chain": { "items": {}, "type": "array", "title": "Decision Chain" }, "action": { "additionalProperties": true, "type": "object", "title": "Action" }, "policy_state": { "additionalProperties": true, "type": "object", "title": "Policy State" }, "human_touchpoints": { "items": {}, "type": "array", "title": "Human Touchpoints" }, "pii_manifest": { "additionalProperties": true, "type": "object", "title": "Pii Manifest" }, "prev_hash": { "type": "string", "title": "Prev Hash" }, "record_hash": { "type": "string", "title": "Record Hash" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" } }, "type": "object", "required": [ "id", "tenant_id", "agent_id", "seq", "client_ref", "captured_at", "model_identity", "context", "decision_chain", "action", "policy_state", "human_touchpoints", "pii_manifest", "prev_hash", "record_hash", "created_at" ], "title": "DecisionOut" }, "DispositionIn": { "properties": { "reference_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Reference Key" }, "vault_role": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Vault Role" }, "receipt": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Receipt" } }, "type": "object", "title": "DispositionIn" }, "DraftRule": { "properties": { "match_on": { "type": "string", "title": "Match On" }, "claim_value": { "type": "string", "title": "Claim Value" }, "match_mode": { "type": "string", "title": "Match Mode", "default": "exact" }, "grants_role": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Grants Role" }, "grants_org_unit": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Grants Org Unit" } }, "type": "object", "required": [ "match_on", "claim_value" ], "title": "DraftRule" }, "EnvelopeCreate": { "properties": { "rules": { "items": { "$ref": "#/components/schemas/EnvelopeRule" }, "type": "array", "minItems": 1, "title": "Rules" }, "default_outcome": { "type": "string", "enum": [ "auto", "async_review", "sync_review", "block" ], "title": "Default Outcome", "default": "sync_review" }, "deep_review_rate": { "type": "number", "maximum": 1.0, "minimum": 0.0, "title": "Deep Review Rate", "description": "Fraction of auto-executed decisions sampled into deep review", "default": 0.0 }, "note": { "anyOf": [ { "type": "string", "maxLength": 500 }, { "type": "null" } ], "title": "Note" } }, "type": "object", "required": [ "rules" ], "title": "EnvelopeCreate" }, "EnvelopeOut": { "properties": { "id": { "type": "string", "title": "Id" }, "agent_id": { "type": "string", "title": "Agent Id" }, "version": { "type": "integer", "title": "Version" }, "active": { "type": "boolean", "title": "Active" }, "rules": { "items": {}, "type": "array", "title": "Rules" }, "default_outcome": { "type": "string", "title": "Default Outcome" }, "deep_review_rate": { "type": "number", "title": "Deep Review Rate" }, "note": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Note" }, "created_by": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Created By" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" } }, "type": "object", "required": [ "id", "agent_id", "version", "active", "rules", "default_outcome", "deep_review_rate", "note", "created_by", "created_at" ], "title": "EnvelopeOut" }, "EnvelopeRule": { "properties": { "name": { "type": "string", "maxLength": 120, "minLength": 1, "title": "Name" }, "when": { "$ref": "#/components/schemas/RuleWhen" }, "outcome": { "type": "string", "enum": [ "auto", "async_review", "sync_review", "block" ], "title": "Outcome" } }, "type": "object", "required": [ "name", "outcome" ], "title": "EnvelopeRule" }, "EvalRunIn": { "properties": { "agent_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agent Id" }, "model_ref": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ], "title": "Model Ref" }, "suite": { "type": "string", "maxLength": 200, "minLength": 1, "title": "Suite" }, "data_source": { "anyOf": [ { "type": "string", "maxLength": 400 }, { "type": "null" } ], "title": "Data Source" }, "scorer": { "anyOf": [ { "type": "string", "maxLength": 120 }, { "type": "null" } ], "title": "Scorer", "description": "how metrics were produced: exact-match | judge-indic: | human- | debate \u2014 provenance, not a claim we ran it" }, "n_samples": { "type": "integer", "minimum": 1.0, "title": "N Samples" }, "metrics": { "additionalProperties": { "type": "number" }, "type": "object", "minProperties": 1, "title": "Metrics" }, "gates": { "items": { "$ref": "#/components/schemas/Gate" }, "type": "array", "title": "Gates" }, "detail": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Detail", "description": "optional structured evidence beyond scalar metrics (e.g. the red-team MAP-Elites grid + diverse evasions)" } }, "type": "object", "required": [ "suite", "n_samples", "metrics" ], "title": "EvalRunIn" }, "EvaluateRequest": { "properties": { "agent_id": { "type": "string", "title": "Agent Id" }, "signals": { "$ref": "#/components/schemas/Signals" }, "client_ref": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ], "title": "Client Ref" } }, "type": "object", "required": [ "agent_id", "signals" ], "title": "EvaluateRequest" }, "EvaluationOut": { "properties": { "id": { "type": "string", "title": "Id" }, "agent_id": { "type": "string", "title": "Agent Id" }, "envelope_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Envelope Id" }, "envelope_version": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Envelope Version" }, "client_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Client Ref" }, "signals": { "additionalProperties": true, "type": "object", "title": "Signals" }, "outcome": { "type": "string", "title": "Outcome" }, "matched_rule": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Matched Rule" }, "trace": { "items": {}, "type": "array", "title": "Trace" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" } }, "type": "object", "required": [ "id", "agent_id", "envelope_id", "envelope_version", "client_ref", "signals", "outcome", "matched_rule", "trace", "created_at" ], "title": "EvaluationOut" }, "Gate": { "properties": { "metric": { "type": "string", "maxLength": 80, "minLength": 1, "title": "Metric" }, "min": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Min" }, "max": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Max" } }, "type": "object", "required": [ "metric" ], "title": "Gate" }, "HTTPValidationError": { "properties": { "detail": { "items": { "$ref": "#/components/schemas/ValidationError" }, "type": "array", "title": "Detail" } }, "type": "object", "title": "HTTPValidationError" }, "HaltStatus": { "properties": { "target_type": { "type": "string", "enum": [ "agent", "model" ], "title": "Target Type" }, "target_id": { "type": "string", "title": "Target Id" }, "halted": { "type": "boolean", "title": "Halted" }, "drill": { "type": "boolean", "title": "Drill", "default": false }, "since": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Since" }, "activation_event": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Activation Event" }, "response": { "type": "string", "title": "Response", "default": "halt" } }, "type": "object", "required": [ "target_type", "target_id", "halted" ], "title": "HaltStatus" }, "HandoffRequest": { "properties": { "agent_id": { "type": "string", "title": "Agent Id" }, "client_ref": { "anyOf": [ { "type": "string", "maxLength": 120 }, { "type": "null" } ], "title": "Client Ref" }, "reason": { "anyOf": [ { "type": "string", "maxLength": 500 }, { "type": "null" } ], "title": "Reason" } }, "type": "object", "required": [ "agent_id" ], "title": "HandoffRequest" }, "IdentityIn": { "properties": { "signed_card": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Signed Card" }, "declared_source": { "anyOf": [ { "type": "string", "maxLength": 32 }, { "type": "null" } ], "title": "Declared Source" }, "declared_ref": { "anyOf": [ { "type": "string", "maxLength": 300 }, { "type": "null" } ], "title": "Declared Ref" } }, "type": "object", "title": "IdentityIn" }, "IncidentCreate": { "properties": { "agent_id": { "type": "string", "title": "Agent Id" }, "title": { "type": "string", "maxLength": 200, "minLength": 1, "title": "Title" }, "severity": { "type": "string", "enum": [ "low", "medium", "high", "critical" ], "title": "Severity" }, "description": { "type": "string", "maxLength": 4000, "minLength": 1, "title": "Description" }, "seq_from": { "anyOf": [ { "type": "integer", "minimum": 1.0 }, { "type": "null" } ], "title": "Seq From" }, "seq_to": { "anyOf": [ { "type": "integer", "minimum": 1.0 }, { "type": "null" } ], "title": "Seq To" }, "harm_categories": { "anyOf": [ { "items": { "type": "string", "enum": [ "health_harm", "critical_infrastructure", "rights_violation", "property_community_environment" ] }, "type": "array" }, { "type": "null" } ], "title": "Harm Categories" }, "detected_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Detected At" }, "occurred_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Occurred At" }, "use_case": { "anyOf": [ { "type": "string", "enum": [ "credit_decisioning", "fraud", "customer_support", "marketing", "others" ] }, { "type": "null" } ], "title": "Use Case" }, "affected_stakeholders": { "anyOf": [ { "type": "string", "enum": [ "internal", "external", "both" ] }, { "type": "null" } ], "title": "Affected Stakeholders" }, "root_cause_preliminary": { "anyOf": [ { "type": "string", "maxLength": 2000 }, { "type": "null" } ], "title": "Root Cause Preliminary" }, "immediate_actions": { "anyOf": [ { "type": "string", "maxLength": 2000 }, { "type": "null" } ], "title": "Immediate Actions" } }, "type": "object", "required": [ "agent_id", "title", "severity", "description" ], "title": "IncidentCreate" }, "IncidentOut": { "properties": { "id": { "type": "string", "title": "Id" }, "agent_id": { "type": "string", "title": "Agent Id" }, "title": { "type": "string", "title": "Title" }, "severity": { "type": "string", "title": "Severity" }, "description": { "type": "string", "title": "Description" }, "seq_from": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Seq From" }, "seq_to": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Seq To" }, "status": { "type": "string", "title": "Status" }, "created_by": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Created By" }, "resolved_by": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Resolved By" }, "resolution_note": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Resolution Note" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "resolved_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Resolved At" }, "report_due_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Report Due At" }, "detected_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Detected At" }, "occurred_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Occurred At" }, "use_case": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Use Case" } }, "type": "object", "required": [ "id", "agent_id", "title", "severity", "description", "seq_from", "seq_to", "status", "created_by", "resolved_by", "resolution_note", "created_at", "resolved_at" ], "title": "IncidentOut" }, "IncidentResolve": { "properties": { "note": { "type": "string", "maxLength": 4000, "minLength": 1, "title": "Note" }, "root_cause_preliminary": { "anyOf": [ { "type": "string", "maxLength": 2000 }, { "type": "null" } ], "title": "Root Cause Preliminary" }, "immediate_actions": { "anyOf": [ { "type": "string", "maxLength": 2000 }, { "type": "null" } ], "title": "Immediate Actions" } }, "type": "object", "required": [ "note" ], "title": "IncidentResolve" }, "KillActivate": { "properties": { "target_type": { "type": "string", "enum": [ "agent", "model" ], "title": "Target Type" }, "target_id": { "type": "string", "minLength": 1, "title": "Target Id" }, "drill": { "type": "boolean", "title": "Drill", "default": false }, "reason": { "type": "string", "maxLength": 500, "minLength": 1, "title": "Reason" }, "response": { "anyOf": [ { "type": "string", "enum": [ "halt", "safe_mode" ] }, { "type": "null" } ], "title": "Response" } }, "type": "object", "required": [ "target_type", "target_id", "reason" ], "title": "KillActivate" }, "KillEventOut": { "properties": { "id": { "type": "string", "title": "Id" }, "target_type": { "type": "string", "title": "Target Type" }, "target_id": { "type": "string", "title": "Target Id" }, "action": { "type": "string", "title": "Action" }, "drill": { "type": "boolean", "title": "Drill" }, "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Reason" }, "actor": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Actor" }, "response": { "type": "string", "title": "Response" }, "safe_envelope_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Safe Envelope Id" }, "releases_event": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Releases Event" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" } }, "type": "object", "required": [ "id", "target_type", "target_id", "action", "drill", "reason", "actor", "response", "safe_envelope_id", "releases_event", "created_at" ], "title": "KillEventOut" }, "KillRelease": { "properties": { "target_type": { "type": "string", "enum": [ "agent", "model" ], "title": "Target Type" }, "target_id": { "type": "string", "minLength": 1, "title": "Target Id" }, "note": { "anyOf": [ { "type": "string", "maxLength": 500 }, { "type": "null" } ], "title": "Note" } }, "type": "object", "required": [ "target_type", "target_id" ], "title": "KillRelease" }, "ModelCreate": { "properties": { "name": { "type": "string", "maxLength": 200, "minLength": 1, "title": "Name" }, "provider": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Provider" }, "version": { "type": "string", "maxLength": 100, "minLength": 1, "title": "Version" }, "model_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Model Type" }, "vendor_flag": { "type": "boolean", "title": "Vendor Flag", "default": false }, "validation_status": { "type": "string", "enum": [ "pending", "validated", "exception" ], "title": "Validation Status", "default": "pending" } }, "type": "object", "required": [ "name", "version" ], "title": "ModelCreate" }, "ModelOut": { "properties": { "id": { "type": "string", "title": "Id" }, "tenant_id": { "type": "string", "title": "Tenant Id" }, "name": { "type": "string", "title": "Name" }, "provider": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Provider" }, "version": { "type": "string", "title": "Version" }, "model_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Model Type" }, "vendor_flag": { "type": "boolean", "title": "Vendor Flag" }, "validation_status": { "type": "string", "title": "Validation Status" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" } }, "type": "object", "required": [ "id", "tenant_id", "name", "provider", "version", "model_type", "vendor_flag", "validation_status", "created_at" ], "title": "ModelOut" }, "ObservedOut": { "properties": { "roles": { "items": { "type": "string" }, "type": "array", "title": "Roles" }, "groups": { "items": { "type": "string" }, "type": "array", "title": "Groups" } }, "type": "object", "required": [ "roles", "groups" ], "title": "ObservedOut" }, "OwnershipTransfer": { "properties": { "owner_name": { "type": "string", "minLength": 1, "title": "Owner Name" }, "owner_email": { "type": "string", "format": "email", "title": "Owner Email" } }, "type": "object", "required": [ "owner_name", "owner_email" ], "title": "OwnershipTransfer" }, "PredeployRow": { "properties": { "declared": { "additionalProperties": { "type": "string" }, "type": "object", "title": "Declared" }, "approved": { "type": "boolean", "title": "Approved" } }, "type": "object", "required": [ "approved" ], "title": "PredeployRow" }, "PredeployRunIn": { "properties": { "agent_id": { "type": "string", "title": "Agent Id" }, "label": { "type": "string", "maxLength": 200, "title": "Label" }, "data_source": { "anyOf": [ { "type": "string", "maxLength": 400 }, { "type": "null" } ], "title": "Data Source", "description": "provenance of the batch (dataset name, extract date, system)" }, "rows": { "items": { "$ref": "#/components/schemas/PredeployRow" }, "type": "array", "maxItems": 100000, "minItems": 1, "title": "Rows" } }, "type": "object", "required": [ "agent_id", "label", "rows" ], "title": "PredeployRunIn" }, "ProvenanceCreate": { "properties": { "model_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Model Id" }, "prompt_version": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Prompt Version" }, "tool_manifest": { "additionalProperties": true, "type": "object", "title": "Tool Manifest" }, "knowledge_sources": { "additionalProperties": true, "type": "object", "title": "Knowledge Sources" } }, "type": "object", "title": "ProvenanceCreate" }, "ProvenanceOut": { "properties": { "id": { "type": "string", "title": "Id" }, "agent_id": { "type": "string", "title": "Agent Id" }, "version": { "type": "integer", "title": "Version" }, "model_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Model Id" }, "prompt_version": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Prompt Version" }, "tool_manifest": { "additionalProperties": true, "type": "object", "title": "Tool Manifest" }, "knowledge_sources": { "additionalProperties": true, "type": "object", "title": "Knowledge Sources" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" } }, "type": "object", "required": [ "id", "agent_id", "version", "model_id", "prompt_version", "tool_manifest", "knowledge_sources", "created_at" ], "title": "ProvenanceOut" }, "ResolveDraftIn": { "properties": { "rules": { "items": { "$ref": "#/components/schemas/DraftRule" }, "type": "array", "title": "Rules", "default": [] }, "roles": { "items": { "type": "string" }, "type": "array", "title": "Roles", "default": [] }, "groups": { "items": { "type": "string" }, "type": "array", "title": "Groups", "default": [] }, "user_ids": { "items": { "type": "string" }, "type": "array", "title": "User Ids", "default": [] }, "trust_canonical": { "type": "boolean", "title": "Trust Canonical", "default": true } }, "type": "object", "title": "ResolveDraftIn" }, "ResolveIn": { "properties": { "roles": { "items": { "type": "string" }, "type": "array", "title": "Roles", "default": [] }, "groups": { "items": { "type": "string" }, "type": "array", "title": "Groups", "default": [] }, "user_ids": { "items": { "type": "string" }, "type": "array", "title": "User Ids", "default": [] } }, "type": "object", "title": "ResolveIn" }, "ResolveOut": { "properties": { "roles": { "items": { "type": "string" }, "type": "array", "title": "Roles" }, "org_units": { "items": { "type": "string" }, "type": "array", "title": "Org Units" } }, "type": "object", "required": [ "roles", "org_units" ], "title": "ResolveOut" }, "ResponsePolicyIn": { "properties": { "response": { "type": "string", "enum": [ "halt", "safe_mode" ], "title": "Response" }, "safe_envelope_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Safe Envelope Id", "description": "Designated conservative envelope for safe mode; omitted = everything routes sync_review" }, "note": { "anyOf": [ { "type": "string", "maxLength": 500 }, { "type": "null" } ], "title": "Note" } }, "type": "object", "required": [ "response" ], "title": "ResponsePolicyIn" }, "ResponsePolicyOut": { "properties": { "id": { "type": "string", "title": "Id" }, "agent_id": { "type": "string", "title": "Agent Id" }, "response": { "type": "string", "title": "Response" }, "safe_envelope_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Safe Envelope Id" }, "note": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Note" }, "created_by": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Created By" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" } }, "type": "object", "required": [ "id", "agent_id", "response", "safe_envelope_id", "note", "created_by", "created_at" ], "title": "ResponsePolicyOut" }, "ReviewOut": { "properties": { "id": { "type": "string", "title": "Id" }, "agent_id": { "type": "string", "title": "Agent Id" }, "evaluation_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Evaluation Id" }, "escalated_from": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Escalated From" }, "client_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Client Ref" }, "org_unit": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Org Unit" }, "escalate_to_kind": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Escalate To Kind" }, "escalate_to": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Escalate To" }, "kind": { "type": "string", "title": "Kind" }, "status": { "type": "string", "title": "Status" }, "claimed_by": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Claimed By" }, "claimed_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Claimed At" }, "resolved_by": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Resolved By" }, "resolved_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Resolved At" }, "note": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Note" }, "corrected_action": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Corrected Action" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" } }, "type": "object", "required": [ "id", "agent_id", "evaluation_id", "escalated_from", "client_ref", "org_unit", "escalate_to_kind", "escalate_to", "kind", "status", "claimed_by", "claimed_at", "resolved_by", "resolved_at", "note", "corrected_action", "created_at" ], "title": "ReviewOut" }, "ReviewResolve": { "properties": { "verdict": { "type": "string", "enum": [ "approved", "overridden", "escalated" ], "title": "Verdict" }, "note": { "anyOf": [ { "type": "string", "maxLength": 2000 }, { "type": "null" } ], "title": "Note" }, "corrected_action": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Corrected Action", "description": "Required when the verdict is overridden" }, "escalate_to_kind": { "anyOf": [ { "type": "string", "enum": [ "role", "team", "user" ] }, { "type": "null" } ], "title": "Escalate To Kind" }, "escalate_to": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ], "title": "Escalate To" } }, "type": "object", "required": [ "verdict" ], "title": "ReviewResolve" }, "RuleIn": { "properties": { "match_on": { "type": "string", "title": "Match On" }, "claim_value": { "type": "string", "maxLength": 512, "minLength": 1, "title": "Claim Value" }, "match_mode": { "type": "string", "title": "Match Mode", "default": "exact" }, "grants_role": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Grants Role" }, "grants_org_unit": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Grants Org Unit" }, "priority": { "type": "integer", "title": "Priority", "default": 100 }, "enabled": { "type": "boolean", "title": "Enabled", "default": true }, "note": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Note" } }, "type": "object", "required": [ "match_on", "claim_value" ], "title": "RuleIn" }, "RuleOut": { "properties": { "id": { "type": "string", "title": "Id" }, "match_on": { "type": "string", "title": "Match On" }, "match_mode": { "type": "string", "title": "Match Mode" }, "claim_value": { "type": "string", "title": "Claim Value" }, "grants_role": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Grants Role" }, "grants_org_unit": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Grants Org Unit" }, "priority": { "type": "integer", "title": "Priority" }, "enabled": { "type": "boolean", "title": "Enabled" }, "note": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Note" }, "created_by": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Created By" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "updated_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Updated At" } }, "type": "object", "required": [ "id", "match_on", "match_mode", "claim_value", "grants_role", "grants_org_unit", "priority", "enabled", "note", "created_by", "created_at", "updated_at" ], "title": "RuleOut" }, "RuleUpdate": { "properties": { "match_on": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Match On" }, "claim_value": { "anyOf": [ { "type": "string", "maxLength": 512 }, { "type": "null" } ], "title": "Claim Value" }, "match_mode": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Match Mode" }, "grants_role": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Grants Role" }, "grants_org_unit": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Grants Org Unit" }, "priority": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Priority" }, "enabled": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Enabled" }, "note": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Note" } }, "type": "object", "title": "RuleUpdate" }, "RuleWhen": { "properties": { "actions": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Actions", "description": "Action names this rule applies to; None = any" }, "min_stakes": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Min Stakes" }, "max_stakes": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Max Stakes" }, "min_confidence": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Min Confidence" }, "max_confidence": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Max Confidence" }, "min_novelty": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Min Novelty" }, "max_novelty": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Max Novelty" }, "blast_radius": { "anyOf": [ { "additionalProperties": { "type": "boolean" }, "type": "object" }, { "type": "null" } ], "title": "Blast Radius", "description": "Flags that must match the agent's registered blast radius" } }, "type": "object", "title": "RuleWhen", "description": "Conditions ANDed together; omitted fields don't constrain. A rule with\nan empty `when` matches everything (useful as a terminal catch-all)." }, "Signals": { "properties": { "action": { "type": "string", "maxLength": 120, "minLength": 1, "title": "Action" }, "stakes": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Stakes", "description": "e.g. amount in INR" }, "confidence": { "anyOf": [ { "type": "number", "maximum": 1.0, "minimum": 0.0 }, { "type": "null" } ], "title": "Confidence" }, "novelty": { "anyOf": [ { "type": "number", "maximum": 1.0, "minimum": 0.0 }, { "type": "null" } ], "title": "Novelty" } }, "type": "object", "required": [ "action" ], "title": "Signals" }, "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" } }, "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "description": "Ingest API key or OIDC JWT. See /authentication." } } }, "servers": [ { "url": "https://demo.rotavision.com", "description": "Public demo (read-only, synthetic data)" }, { "url": "https://{host}", "description": "Your Sakshi deployment (single-tenant, in your environment)", "variables": { "host": { "default": "sakshi.your-company.internal" } } } ], "security": [ { "bearerAuth": [] } ] }