{ "components": { "schemas": { "AuditEventListResponse": { "additionalProperties": false, "description": "GET /v1/audit response body.", "properties": { "count": { "title": "Count", "type": "integer" }, "events": { "items": { "additionalProperties": true, "type": "object" }, "title": "Events", "type": "array" } }, "required": [ "events", "count" ], "title": "AuditEventListResponse", "type": "object" }, "CheckpointDiffResponse": { "additionalProperties": false, "description": "GET /v1/runs/{id}/checkpoints/diff response body.", "properties": { "added": { "items": { "additionalProperties": true, "type": "object" }, "title": "Added", "type": "array" }, "change_count": { "title": "Change Count", "type": "integer" }, "changed": { "items": { "additionalProperties": true, "type": "object" }, "title": "Changed", "type": "array" }, "from_checkpoint": { "additionalProperties": true, "title": "From Checkpoint", "type": "object" }, "removed": { "items": { "additionalProperties": true, "type": "object" }, "title": "Removed", "type": "array" }, "run_id": { "title": "Run Id", "type": "string" }, "to_checkpoint": { "additionalProperties": true, "title": "To Checkpoint", "type": "object" }, "truncated": { "default": false, "title": "Truncated", "type": "boolean" } }, "required": [ "run_id", "from_checkpoint", "to_checkpoint", "change_count" ], "title": "CheckpointDiffResponse", "type": "object" }, "CheckpointListResponse": { "additionalProperties": false, "description": "GET /v1/runs/{id}/checkpoints response body.", "properties": { "checkpoints": { "items": { "additionalProperties": true, "type": "object" }, "title": "Checkpoints", "type": "array" }, "count": { "default": 0, "title": "Count", "type": "integer" }, "limit": { "default": 100, "title": "Limit", "type": "integer" }, "offset": { "default": 0, "title": "Offset", "type": "integer" }, "run_id": { "title": "Run Id", "type": "string" }, "sort_by": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sort By" }, "sort_order": { "default": "asc", "enum": [ "asc", "desc" ], "title": "Sort Order", "type": "string" }, "total": { "default": 0, "title": "Total", "type": "integer" } }, "required": [ "run_id", "checkpoints" ], "title": "CheckpointListResponse", "type": "object" }, "CredentialInventoryResponse": { "additionalProperties": false, "description": "GET /v1/security/credentials response body (redacted inventory).", "properties": { "inventory": { "additionalProperties": true, "title": "Inventory", "type": "object" } }, "required": [ "inventory" ], "title": "CredentialInventoryResponse", "type": "object" }, "EnvironmentPolicyListResponse": { "additionalProperties": false, "description": "GET /v1/policies/environments response body.", "properties": { "count": { "title": "Count", "type": "integer" }, "policies": { "additionalProperties": { "additionalProperties": true, "type": "object" }, "title": "Policies", "type": "object" } }, "required": [ "policies", "count" ], "title": "EnvironmentPolicyListResponse", "type": "object" }, "EnvironmentPolicyRequest": { "additionalProperties": false, "description": "PUT /v1/policies/environments/{name} request body.", "properties": { "blocked_diagnostic_codes": { "items": { "type": "string" }, "title": "Blocked Diagnostic Codes", "type": "array" }, "deny_unrestricted_tools": { "default": false, "title": "Deny Unrestricted Tools", "type": "boolean" }, "enabled": { "default": true, "title": "Enabled", "type": "boolean" }, "fail_on_warnings": { "default": false, "title": "Fail On Warnings", "type": "boolean" }, "require_guardrails": { "default": false, "title": "Require Guardrails", "type": "boolean" }, "require_human_review": { "default": false, "title": "Require Human Review", "type": "boolean" }, "require_tool_permissions": { "default": false, "title": "Require Tool Permissions", "type": "boolean" } }, "title": "EnvironmentPolicyRequest", "type": "object" }, "EnvironmentPolicyResponse": { "additionalProperties": false, "description": "GET /v1/policies/environments/{name} response body.", "properties": { "environment": { "title": "Environment", "type": "string" }, "policy": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Policy" }, "previous_policy": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Previous Policy" } }, "required": [ "environment" ], "title": "EnvironmentPolicyResponse", "type": "object" }, "HTTPValidationError": { "properties": { "detail": { "items": { "$ref": "#/components/schemas/ValidationError" }, "title": "Detail", "type": "array" } }, "title": "HTTPValidationError", "type": "object" }, "HealthResponse": { "additionalProperties": false, "description": "GET /healthz / /readyz / /v1/health response body.", "properties": { "metadata": { "additionalProperties": true, "title": "Metadata", "type": "object" }, "ok": { "title": "Ok", "type": "boolean" }, "service": { "default": "kneo-serv-platform", "title": "Service", "type": "string" }, "version": { "title": "Version", "type": "string" } }, "required": [ "ok" ], "title": "HealthResponse", "type": "object" }, "HumanResumeRequest": { "additionalProperties": false, "description": "POST /v1/human/tasks/{id}/resume request body.", "properties": { "content": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Content" }, "decision": { "enum": [ "approved", "rejected", "edited", "selected", "provided" ], "title": "Decision", "type": "string" }, "metadata": { "additionalProperties": true, "title": "Metadata", "type": "object" }, "request_id": { "title": "Request Id", "type": "string" }, "selected_option": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Selected Option" } }, "required": [ "request_id", "decision" ], "title": "HumanResumeRequest", "type": "object" }, "HumanResumeResponse": { "additionalProperties": false, "description": "POST /v1/human/tasks/{id}/resume response body.", "properties": { "metadata": { "additionalProperties": true, "title": "Metadata", "type": "object" }, "output_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Output Text" }, "run_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Run Id" }, "status": { "title": "Status", "type": "string" } }, "required": [ "run_id", "status" ], "title": "HumanResumeResponse", "type": "object" }, "HumanTaskListResponse": { "additionalProperties": false, "description": "GET /v1/human/tasks response body.", "properties": { "count": { "title": "Count", "type": "integer" }, "limit": { "default": 100, "title": "Limit", "type": "integer" }, "offset": { "default": 0, "title": "Offset", "type": "integer" }, "sort_by": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sort By" }, "sort_order": { "default": "asc", "enum": [ "asc", "desc" ], "title": "Sort Order", "type": "string" }, "tasks": { "items": { "additionalProperties": true, "type": "object" }, "title": "Tasks", "type": "array" }, "total": { "default": 0, "title": "Total", "type": "integer" } }, "required": [ "tasks", "count" ], "title": "HumanTaskListResponse", "type": "object" }, "HumanTaskResponse": { "additionalProperties": false, "description": "GET /v1/human/tasks/{id} response body.", "properties": { "continuation_id": { "title": "Continuation Id", "type": "string" }, "request": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Request" } }, "required": [ "continuation_id", "request" ], "title": "HumanTaskResponse", "type": "object" }, "RunCreateRequest": { "additionalProperties": false, "description": "POST /v1/runs request body.", "properties": { "async_mode": { "default": false, "title": "Async Mode", "type": "boolean" }, "environment": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Environment" }, "input": { "title": "Input", "type": "string" }, "metadata": { "additionalProperties": true, "title": "Metadata", "type": "object" }, "overlays": { "items": { "type": "string" }, "title": "Overlays", "type": "array" }, "overrides": { "additionalProperties": true, "title": "Overrides", "type": "object" }, "spec": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Spec" }, "spec_path": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Spec Path" }, "target": { "default": "workflow", "enum": [ "agent", "workflow" ], "title": "Target", "type": "string" } }, "required": [ "input" ], "title": "RunCreateRequest", "type": "object" }, "RunCreateResponse": { "additionalProperties": false, "description": "POST /v1/runs response body.", "properties": { "continuation_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Continuation Id" }, "human_intervention_required": { "default": false, "title": "Human Intervention Required", "type": "boolean" }, "metadata": { "additionalProperties": true, "title": "Metadata", "type": "object" }, "output_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Output Text" }, "run_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Run Id" }, "status": { "title": "Status", "type": "string" } }, "required": [ "run_id", "status" ], "title": "RunCreateResponse", "type": "object" }, "RunListResponse": { "additionalProperties": false, "description": "GET /v1/runs response body.", "properties": { "count": { "title": "Count", "type": "integer" }, "limit": { "default": 100, "title": "Limit", "type": "integer" }, "offset": { "default": 0, "title": "Offset", "type": "integer" }, "runs": { "items": { "additionalProperties": true, "type": "object" }, "title": "Runs", "type": "array" }, "sort_by": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sort By" }, "sort_order": { "default": "desc", "enum": [ "asc", "desc" ], "title": "Sort Order", "type": "string" }, "total": { "default": 0, "title": "Total", "type": "integer" } }, "required": [ "runs", "count" ], "title": "RunListResponse", "type": "object" }, "RunRecoveryResponse": { "additionalProperties": false, "description": "GET /v1/runs/{id}/recovery response body.", "properties": { "checkpoint_count": { "default": 0, "title": "Checkpoint Count", "type": "integer" }, "continuation_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Continuation Id" }, "current_node_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Current Node Id" }, "current_step_index": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Current Step Index" }, "error": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Error" }, "pending_human_request": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Pending Human Request" }, "replay_context": { "additionalProperties": true, "title": "Replay Context", "type": "object" }, "run_id": { "title": "Run Id", "type": "string" }, "status": { "title": "Status", "type": "string" }, "visited_nodes": { "items": { "type": "string" }, "title": "Visited Nodes", "type": "array" }, "visited_steps": { "items": { "type": "string" }, "title": "Visited Steps", "type": "array" }, "workflow_kind": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Workflow Kind" }, "workflow_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Workflow Name" } }, "required": [ "run_id", "status" ], "title": "RunRecoveryResponse", "type": "object" }, "RunReplayResponse": { "additionalProperties": false, "description": "POST /v1/runs/{id}/replay response body.", "properties": { "agent_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agent Name" }, "checkpoint_count": { "default": 0, "title": "Checkpoint Count", "type": "integer" }, "replay_context": { "additionalProperties": true, "title": "Replay Context", "type": "object" }, "run_id": { "title": "Run Id", "type": "string" }, "status": { "title": "Status", "type": "string" }, "timeline": { "items": { "additionalProperties": true, "type": "object" }, "title": "Timeline", "type": "array" }, "workflow_kind": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Workflow Kind" }, "workflow_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Workflow Name" } }, "required": [ "run_id", "status" ], "title": "RunReplayResponse", "type": "object" }, "RunStatusResponse": { "additionalProperties": false, "description": "GET /v1/runs/{id} response body.", "properties": { "agent_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agent Name" }, "continuation_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Continuation Id" }, "current_node_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Current Node Id" }, "current_step_index": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Current Step Index" }, "error": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Error" }, "input_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Input Text" }, "metadata": { "additionalProperties": true, "title": "Metadata", "type": "object" }, "output_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Output Text" }, "pending_human_request": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Pending Human Request" }, "run_id": { "title": "Run Id", "type": "string" }, "status": { "title": "Status", "type": "string" }, "trace_event_count": { "default": 0, "title": "Trace Event Count", "type": "integer" }, "visited_nodes": { "items": { "type": "string" }, "title": "Visited Nodes", "type": "array" }, "visited_steps": { "items": { "type": "string" }, "title": "Visited Steps", "type": "array" }, "workflow_kind": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Workflow Kind" }, "workflow_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Workflow Name" } }, "required": [ "run_id", "status" ], "title": "RunStatusResponse", "type": "object" }, "SpecCompileRequest": { "additionalProperties": false, "description": "POST /v1/specs/compile request body.", "properties": { "environment": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Environment" }, "overlays": { "items": { "type": "string" }, "title": "Overlays", "type": "array" }, "overrides": { "additionalProperties": true, "title": "Overrides", "type": "object" }, "spec": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Spec" }, "spec_path": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Spec Path" }, "strict": { "default": true, "title": "Strict", "type": "boolean" } }, "title": "SpecCompileRequest", "type": "object" }, "SpecCompileResponse": { "additionalProperties": false, "description": "POST /v1/specs/compile response body.", "properties": { "diagnostics": { "items": { "additionalProperties": true, "type": "object" }, "title": "Diagnostics", "type": "array" }, "ok": { "title": "Ok", "type": "boolean" }, "summary": { "additionalProperties": true, "title": "Summary", "type": "object" } }, "required": [ "ok" ], "title": "SpecCompileResponse", "type": "object" }, "SpecExplainRequest": { "additionalProperties": false, "description": "POST /v1/specs/explain request body.", "properties": { "spec": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Spec" }, "spec_path": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Spec Path" } }, "title": "SpecExplainRequest", "type": "object" }, "SpecExplainResponse": { "additionalProperties": false, "description": "POST /v1/specs/explain response body.", "properties": { "summary": { "additionalProperties": true, "title": "Summary", "type": "object" } }, "required": [ "summary" ], "title": "SpecExplainResponse", "type": "object" }, "SpecPolicyReportRequest": { "additionalProperties": false, "description": "POST /v1/specs/policy-report request body.", "properties": { "environment": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Environment" }, "overlays": { "items": { "type": "string" }, "title": "Overlays", "type": "array" }, "overrides": { "additionalProperties": true, "title": "Overrides", "type": "object" }, "spec": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Spec" }, "spec_path": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Spec Path" } }, "title": "SpecPolicyReportRequest", "type": "object" }, "SpecPolicyReportResponse": { "additionalProperties": false, "description": "POST /v1/specs/policy-report response body.", "properties": { "report": { "additionalProperties": true, "title": "Report", "type": "object" }, "valid": { "default": true, "title": "Valid", "type": "boolean" } }, "required": [ "report" ], "title": "SpecPolicyReportResponse", "type": "object" }, "SpecValidateRequest": { "additionalProperties": false, "description": "POST /v1/specs/validate request body (also reused for compile / policy-report).", "properties": { "environment": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Environment" }, "overlays": { "items": { "type": "string" }, "title": "Overlays", "type": "array" }, "overrides": { "additionalProperties": true, "title": "Overrides", "type": "object" }, "spec": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Spec" }, "spec_path": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Spec Path" } }, "title": "SpecValidateRequest", "type": "object" }, "SpecValidateResponse": { "additionalProperties": false, "description": "POST /v1/specs/validate response body.", "properties": { "diagnostics": { "items": { "additionalProperties": true, "type": "object" }, "title": "Diagnostics", "type": "array" }, "valid": { "title": "Valid", "type": "boolean" } }, "required": [ "valid" ], "title": "SpecValidateResponse", "type": "object" }, "TraceResponse": { "additionalProperties": false, "description": "GET /v1/runs/{id}/trace response body.", "properties": { "count": { "default": 0, "title": "Count", "type": "integer" }, "events": { "items": { "additionalProperties": true, "type": "object" }, "title": "Events", "type": "array" }, "limit": { "default": 100, "title": "Limit", "type": "integer" }, "offset": { "default": 0, "title": "Offset", "type": "integer" }, "run_id": { "title": "Run Id", "type": "string" }, "sort_by": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sort By" }, "sort_order": { "default": "asc", "enum": [ "asc", "desc" ], "title": "Sort Order", "type": "string" }, "total": { "default": 0, "title": "Total", "type": "integer" } }, "required": [ "run_id", "events" ], "title": "TraceResponse", "type": "object" }, "ValidationError": { "properties": { "ctx": { "title": "Context", "type": "object" }, "input": { "title": "Input" }, "loc": { "items": { "anyOf": [ { "type": "string" }, { "type": "integer" } ] }, "title": "Location", "type": "array" }, "msg": { "title": "Message", "type": "string" }, "type": { "title": "Error Type", "type": "string" } }, "required": [ "loc", "msg", "type" ], "title": "ValidationError", "type": "object" } } }, "info": { "description": "Platform service API for Kneo Agent runs, specs, traces, checkpoints, and human-in-the-loop tasks.", "title": "Kneo Agent Platform API", "version": "0.4.0" }, "openapi": "3.1.0", "paths": { "/audit-events": { "get": { "operationId": "list_audit_events_audit_events_get", "parameters": [ { "in": "query", "name": "event_type", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Event Type" } }, { "in": "query", "name": "run_id", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Run Id" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 100, "maximum": 1000, "minimum": 1, "title": "Limit", "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AuditEventListResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "List Audit Events", "tags": [ "audit-events" ] } }, "/healthz": { "get": { "operationId": "healthz_healthz_get", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HealthResponse" } } }, "description": "Successful Response" } }, "summary": "Healthz", "tags": [ "health" ] } }, "/human-tasks": { "get": { "operationId": "list_human_tasks_human_tasks_get", "parameters": [ { "in": "query", "name": "run_id", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Run Id" } }, { "in": "query", "name": "workflow_kind", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Workflow Kind" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 100, "maximum": 1000, "minimum": 1, "title": "Limit", "type": "integer" } }, { "in": "query", "name": "offset", "required": false, "schema": { "default": 0, "maximum": 10000, "minimum": 0, "title": "Offset", "type": "integer" } }, { "in": "query", "name": "sort_by", "required": false, "schema": { "default": "id", "title": "Sort By", "type": "string" } }, { "in": "query", "name": "sort_order", "required": false, "schema": { "default": "asc", "enum": [ "asc", "desc" ], "title": "Sort Order", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HumanTaskListResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "List Human Tasks", "tags": [ "human-tasks" ] } }, "/human-tasks/{continuation_id}": { "get": { "operationId": "get_human_task_human_tasks__continuation_id__get", "parameters": [ { "in": "path", "name": "continuation_id", "required": true, "schema": { "title": "Continuation Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HumanTaskResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Human Task", "tags": [ "human-tasks" ] } }, "/human-tasks/{continuation_id}/resume": { "post": { "operationId": "resume_human_task_human_tasks__continuation_id__resume_post", "parameters": [ { "in": "path", "name": "continuation_id", "required": true, "schema": { "title": "Continuation Id", "type": "string" } }, { "in": "header", "name": "Idempotency-Key", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Idempotency-Key" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HumanResumeRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HumanResumeResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Resume Human Task", "tags": [ "human-tasks" ] } }, "/livez": { "get": { "operationId": "livez_livez_get", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HealthResponse" } } }, "description": "Successful Response" } }, "summary": "Livez", "tags": [ "health" ] } }, "/policies/environment": { "get": { "operationId": "list_environment_policies_policies_environment_get", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EnvironmentPolicyListResponse" } } }, "description": "Successful Response" } }, "summary": "List Environment Policies", "tags": [ "policies" ] } }, "/policies/environment/{environment}": { "get": { "operationId": "get_environment_policy_policies_environment__environment__get", "parameters": [ { "in": "path", "name": "environment", "required": true, "schema": { "maxLength": 128, "minLength": 1, "title": "Environment", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EnvironmentPolicyResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Environment Policy", "tags": [ "policies" ] }, "put": { "operationId": "put_environment_policy_policies_environment__environment__put", "parameters": [ { "in": "path", "name": "environment", "required": true, "schema": { "maxLength": 128, "minLength": 1, "title": "Environment", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EnvironmentPolicyRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EnvironmentPolicyResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Put Environment Policy", "tags": [ "policies" ] } }, "/readyz": { "get": { "operationId": "readyz_readyz_get", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HealthResponse" } } }, "description": "Successful Response" } }, "summary": "Readyz", "tags": [ "health" ] } }, "/runs": { "get": { "operationId": "list_runs_runs_get", "parameters": [ { "in": "query", "name": "status", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Status" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 100, "maximum": 1000, "minimum": 1, "title": "Limit", "type": "integer" } }, { "in": "query", "name": "offset", "required": false, "schema": { "default": 0, "maximum": 10000, "minimum": 0, "title": "Offset", "type": "integer" } }, { "in": "query", "name": "sort_by", "required": false, "schema": { "default": "updated_at", "title": "Sort By", "type": "string" } }, { "in": "query", "name": "sort_order", "required": false, "schema": { "default": "desc", "enum": [ "asc", "desc" ], "title": "Sort Order", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunListResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "List Runs", "tags": [ "runs" ] }, "post": { "operationId": "create_run_runs_post", "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Idempotency-Key" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunCreateRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunCreateResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Create Run", "tags": [ "runs" ] } }, "/runs/{run_id}": { "get": { "operationId": "get_run_runs__run_id__get", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunStatusResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Run", "tags": [ "runs" ] } }, "/runs/{run_id}/cancel": { "post": { "operationId": "cancel_run_runs__run_id__cancel_post", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunStatusResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Cancel Run", "tags": [ "runs" ] } }, "/runs/{run_id}/checkpoints": { "get": { "operationId": "list_checkpoints_runs__run_id__checkpoints_get", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } }, { "in": "query", "name": "type", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Type" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 100, "maximum": 1000, "minimum": 1, "title": "Limit", "type": "integer" } }, { "in": "query", "name": "offset", "required": false, "schema": { "default": 0, "maximum": 10000, "minimum": 0, "title": "Offset", "type": "integer" } }, { "in": "query", "name": "sort_by", "required": false, "schema": { "default": "sequence", "title": "Sort By", "type": "string" } }, { "in": "query", "name": "sort_order", "required": false, "schema": { "default": "asc", "enum": [ "asc", "desc" ], "title": "Sort Order", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CheckpointListResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "List Checkpoints", "tags": [ "runs" ] } }, "/runs/{run_id}/checkpoints/diff": { "get": { "operationId": "diff_checkpoints_runs__run_id__checkpoints_diff_get", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } }, { "in": "query", "name": "from_sequence", "required": false, "schema": { "anyOf": [ { "minimum": 1, "type": "integer" }, { "type": "null" } ], "title": "From Sequence" } }, { "in": "query", "name": "to_sequence", "required": false, "schema": { "anyOf": [ { "minimum": 1, "type": "integer" }, { "type": "null" } ], "title": "To Sequence" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CheckpointDiffResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Diff Checkpoints", "tags": [ "runs" ] } }, "/runs/{run_id}/continue": { "post": { "operationId": "continue_run_runs__run_id__continue_post", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunCreateResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Continue Run", "tags": [ "runs" ] } }, "/runs/{run_id}/policy-report": { "get": { "description": "Generate a policy report for the spec the run was started with.\n\nReturns the same shape as `POST /specs/policy-report` but pulls the\nspec out of the existing run's metadata, so operators don't need to\ncarry the spec bundle locally to audit a deployed run.", "operationId": "get_run_policy_report_runs__run_id__policy_report_get", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SpecPolicyReportResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Run Policy Report", "tags": [ "runs" ] } }, "/runs/{run_id}/recovery": { "get": { "operationId": "get_recovery_context_runs__run_id__recovery_get", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunRecoveryResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Recovery Context", "tags": [ "runs" ] } }, "/runs/{run_id}/replay": { "get": { "operationId": "get_replay_view_runs__run_id__replay_get", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunReplayResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Replay View", "tags": [ "runs" ] } }, "/runs/{run_id}/trace": { "get": { "operationId": "get_trace_runs__run_id__trace_get", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } }, { "in": "query", "name": "event_type", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Event Type" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 100, "maximum": 1000, "minimum": 1, "title": "Limit", "type": "integer" } }, { "in": "query", "name": "offset", "required": false, "schema": { "default": 0, "maximum": 10000, "minimum": 0, "title": "Offset", "type": "integer" } }, { "in": "query", "name": "sort_by", "required": false, "schema": { "default": "timestamp", "title": "Sort By", "type": "string" } }, { "in": "query", "name": "sort_order", "required": false, "schema": { "default": "asc", "enum": [ "asc", "desc" ], "title": "Sort Order", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TraceResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Trace", "tags": [ "runs" ] } }, "/security/credentials": { "get": { "operationId": "credential_inventory_security_credentials_get", "parameters": [ { "in": "query", "name": "providers", "required": false, "schema": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Providers" } }, { "in": "query", "name": "extras", "required": false, "schema": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Extras" } }, { "in": "query", "name": "include_service_tokens", "required": false, "schema": { "default": true, "title": "Include Service Tokens", "type": "boolean" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CredentialInventoryResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Credential Inventory", "tags": [ "security" ] } }, "/specs/compile": { "post": { "operationId": "compile_spec_specs_compile_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SpecCompileRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SpecCompileResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Compile Spec", "tags": [ "specs" ] } }, "/specs/explain": { "post": { "operationId": "explain_spec_specs_explain_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SpecExplainRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SpecExplainResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Explain Spec", "tags": [ "specs" ] } }, "/specs/policy-report": { "post": { "operationId": "policy_report_spec_specs_policy_report_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SpecPolicyReportRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SpecPolicyReportResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Policy Report Spec", "tags": [ "specs" ] } }, "/specs/run": { "post": { "operationId": "run_spec_specs_run_post", "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Idempotency-Key" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunCreateRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunCreateResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Run Spec", "tags": [ "specs" ] } }, "/specs/validate": { "post": { "operationId": "validate_spec_specs_validate_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SpecValidateRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SpecValidateResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Validate Spec", "tags": [ "specs" ] } }, "/v1/audit-events": { "get": { "operationId": "list_audit_events_v1_audit_events_get", "parameters": [ { "in": "query", "name": "event_type", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Event Type" } }, { "in": "query", "name": "run_id", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Run Id" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 100, "maximum": 1000, "minimum": 1, "title": "Limit", "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AuditEventListResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "List Audit Events", "tags": [ "audit-events" ] } }, "/v1/healthz": { "get": { "operationId": "healthz_v1_healthz_get", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HealthResponse" } } }, "description": "Successful Response" } }, "summary": "Healthz", "tags": [ "health" ] } }, "/v1/human-tasks": { "get": { "operationId": "list_human_tasks_v1_human_tasks_get", "parameters": [ { "in": "query", "name": "run_id", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Run Id" } }, { "in": "query", "name": "workflow_kind", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Workflow Kind" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 100, "maximum": 1000, "minimum": 1, "title": "Limit", "type": "integer" } }, { "in": "query", "name": "offset", "required": false, "schema": { "default": 0, "maximum": 10000, "minimum": 0, "title": "Offset", "type": "integer" } }, { "in": "query", "name": "sort_by", "required": false, "schema": { "default": "id", "title": "Sort By", "type": "string" } }, { "in": "query", "name": "sort_order", "required": false, "schema": { "default": "asc", "enum": [ "asc", "desc" ], "title": "Sort Order", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HumanTaskListResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "List Human Tasks", "tags": [ "human-tasks" ] } }, "/v1/human-tasks/{continuation_id}": { "get": { "operationId": "get_human_task_v1_human_tasks__continuation_id__get", "parameters": [ { "in": "path", "name": "continuation_id", "required": true, "schema": { "title": "Continuation Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HumanTaskResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Human Task", "tags": [ "human-tasks" ] } }, "/v1/human-tasks/{continuation_id}/resume": { "post": { "operationId": "resume_human_task_v1_human_tasks__continuation_id__resume_post", "parameters": [ { "in": "path", "name": "continuation_id", "required": true, "schema": { "title": "Continuation Id", "type": "string" } }, { "in": "header", "name": "Idempotency-Key", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Idempotency-Key" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HumanResumeRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HumanResumeResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Resume Human Task", "tags": [ "human-tasks" ] } }, "/v1/livez": { "get": { "operationId": "livez_v1_livez_get", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HealthResponse" } } }, "description": "Successful Response" } }, "summary": "Livez", "tags": [ "health" ] } }, "/v1/policies/environment": { "get": { "operationId": "list_environment_policies_v1_policies_environment_get", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EnvironmentPolicyListResponse" } } }, "description": "Successful Response" } }, "summary": "List Environment Policies", "tags": [ "policies" ] } }, "/v1/policies/environment/{environment}": { "get": { "operationId": "get_environment_policy_v1_policies_environment__environment__get", "parameters": [ { "in": "path", "name": "environment", "required": true, "schema": { "maxLength": 128, "minLength": 1, "title": "Environment", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EnvironmentPolicyResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Environment Policy", "tags": [ "policies" ] }, "put": { "operationId": "put_environment_policy_v1_policies_environment__environment__put", "parameters": [ { "in": "path", "name": "environment", "required": true, "schema": { "maxLength": 128, "minLength": 1, "title": "Environment", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EnvironmentPolicyRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EnvironmentPolicyResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Put Environment Policy", "tags": [ "policies" ] } }, "/v1/readyz": { "get": { "operationId": "readyz_v1_readyz_get", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HealthResponse" } } }, "description": "Successful Response" } }, "summary": "Readyz", "tags": [ "health" ] } }, "/v1/runs": { "get": { "operationId": "list_runs_v1_runs_get", "parameters": [ { "in": "query", "name": "status", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Status" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 100, "maximum": 1000, "minimum": 1, "title": "Limit", "type": "integer" } }, { "in": "query", "name": "offset", "required": false, "schema": { "default": 0, "maximum": 10000, "minimum": 0, "title": "Offset", "type": "integer" } }, { "in": "query", "name": "sort_by", "required": false, "schema": { "default": "updated_at", "title": "Sort By", "type": "string" } }, { "in": "query", "name": "sort_order", "required": false, "schema": { "default": "desc", "enum": [ "asc", "desc" ], "title": "Sort Order", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunListResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "List Runs", "tags": [ "runs" ] }, "post": { "operationId": "create_run_v1_runs_post", "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Idempotency-Key" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunCreateRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunCreateResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Create Run", "tags": [ "runs" ] } }, "/v1/runs/{run_id}": { "get": { "operationId": "get_run_v1_runs__run_id__get", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunStatusResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Run", "tags": [ "runs" ] } }, "/v1/runs/{run_id}/cancel": { "post": { "operationId": "cancel_run_v1_runs__run_id__cancel_post", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunStatusResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Cancel Run", "tags": [ "runs" ] } }, "/v1/runs/{run_id}/checkpoints": { "get": { "operationId": "list_checkpoints_v1_runs__run_id__checkpoints_get", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } }, { "in": "query", "name": "type", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Type" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 100, "maximum": 1000, "minimum": 1, "title": "Limit", "type": "integer" } }, { "in": "query", "name": "offset", "required": false, "schema": { "default": 0, "maximum": 10000, "minimum": 0, "title": "Offset", "type": "integer" } }, { "in": "query", "name": "sort_by", "required": false, "schema": { "default": "sequence", "title": "Sort By", "type": "string" } }, { "in": "query", "name": "sort_order", "required": false, "schema": { "default": "asc", "enum": [ "asc", "desc" ], "title": "Sort Order", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CheckpointListResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "List Checkpoints", "tags": [ "runs" ] } }, "/v1/runs/{run_id}/checkpoints/diff": { "get": { "operationId": "diff_checkpoints_v1_runs__run_id__checkpoints_diff_get", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } }, { "in": "query", "name": "from_sequence", "required": false, "schema": { "anyOf": [ { "minimum": 1, "type": "integer" }, { "type": "null" } ], "title": "From Sequence" } }, { "in": "query", "name": "to_sequence", "required": false, "schema": { "anyOf": [ { "minimum": 1, "type": "integer" }, { "type": "null" } ], "title": "To Sequence" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CheckpointDiffResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Diff Checkpoints", "tags": [ "runs" ] } }, "/v1/runs/{run_id}/continue": { "post": { "operationId": "continue_run_v1_runs__run_id__continue_post", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunCreateResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Continue Run", "tags": [ "runs" ] } }, "/v1/runs/{run_id}/policy-report": { "get": { "description": "Generate a policy report for the spec the run was started with.\n\nReturns the same shape as `POST /specs/policy-report` but pulls the\nspec out of the existing run's metadata, so operators don't need to\ncarry the spec bundle locally to audit a deployed run.", "operationId": "get_run_policy_report_v1_runs__run_id__policy_report_get", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SpecPolicyReportResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Run Policy Report", "tags": [ "runs" ] } }, "/v1/runs/{run_id}/recovery": { "get": { "operationId": "get_recovery_context_v1_runs__run_id__recovery_get", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunRecoveryResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Recovery Context", "tags": [ "runs" ] } }, "/v1/runs/{run_id}/replay": { "get": { "operationId": "get_replay_view_v1_runs__run_id__replay_get", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunReplayResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Replay View", "tags": [ "runs" ] } }, "/v1/runs/{run_id}/trace": { "get": { "operationId": "get_trace_v1_runs__run_id__trace_get", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } }, { "in": "query", "name": "event_type", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Event Type" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 100, "maximum": 1000, "minimum": 1, "title": "Limit", "type": "integer" } }, { "in": "query", "name": "offset", "required": false, "schema": { "default": 0, "maximum": 10000, "minimum": 0, "title": "Offset", "type": "integer" } }, { "in": "query", "name": "sort_by", "required": false, "schema": { "default": "timestamp", "title": "Sort By", "type": "string" } }, { "in": "query", "name": "sort_order", "required": false, "schema": { "default": "asc", "enum": [ "asc", "desc" ], "title": "Sort Order", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TraceResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Trace", "tags": [ "runs" ] } }, "/v1/security/credentials": { "get": { "operationId": "credential_inventory_v1_security_credentials_get", "parameters": [ { "in": "query", "name": "providers", "required": false, "schema": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Providers" } }, { "in": "query", "name": "extras", "required": false, "schema": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Extras" } }, { "in": "query", "name": "include_service_tokens", "required": false, "schema": { "default": true, "title": "Include Service Tokens", "type": "boolean" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CredentialInventoryResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Credential Inventory", "tags": [ "security" ] } }, "/v1/specs/compile": { "post": { "operationId": "compile_spec_v1_specs_compile_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SpecCompileRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SpecCompileResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Compile Spec", "tags": [ "specs" ] } }, "/v1/specs/explain": { "post": { "operationId": "explain_spec_v1_specs_explain_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SpecExplainRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SpecExplainResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Explain Spec", "tags": [ "specs" ] } }, "/v1/specs/policy-report": { "post": { "operationId": "policy_report_spec_v1_specs_policy_report_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SpecPolicyReportRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SpecPolicyReportResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Policy Report Spec", "tags": [ "specs" ] } }, "/v1/specs/run": { "post": { "operationId": "run_spec_v1_specs_run_post", "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Idempotency-Key" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunCreateRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunCreateResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Run Spec", "tags": [ "specs" ] } }, "/v1/specs/validate": { "post": { "operationId": "validate_spec_v1_specs_validate_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SpecValidateRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SpecValidateResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Validate Spec", "tags": [ "specs" ] } } } }