{ "openapi": "3.1.0", "info": { "title": "Neumera Public API", "version": "1.1.0" }, "paths": { "/healthz": { "get": { "summary": "Healthz", "operationId": "healthz_healthz_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/v1/access/request": { "post": { "summary": "Request sandbox access", "operationId": "request_sandbox_access_v1_access_request_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SandboxAccessRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/": { "get": { "summary": "API root descriptor", "operationId": "api_root_descriptor__get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/readyz": { "get": { "summary": "Readyz", "operationId": "readyz_readyz_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/v1/runtime/status": { "get": { "summary": "Get runtime continuity and status", "operationId": "runtime_status_v1_runtime_status_get", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/runtime/summary": { "get": { "summary": "Get build-safe runtime summary", "operationId": "runtime_summary_v1_runtime_summary_get", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/platform/summary": { "get": { "summary": "Get build-safe platform summary", "operationId": "platform_summary_v1_platform_summary_get", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/sessions": { "post": { "summary": "Create communicative session", "operationId": "create_session_v1_sessions_post", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionCreateRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/sessions/{session_id}/step": { "post": { "summary": "Step communicative session", "operationId": "step_session_v1_sessions__session_id__step_post", "parameters": [ { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionStepRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/sessions/{session_id}": { "get": { "summary": "Inspect communicative session", "operationId": "inspect_session_v1_sessions__session_id__get", "parameters": [ { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/worlds/objects": { "get": { "summary": "List world objects", "operationId": "worlds_objects_v1_worlds_objects_get", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/worlds/objects/{object_id}": { "get": { "summary": "Inspect world object", "operationId": "world_object_v1_worlds_objects__object_id__get", "parameters": [ { "name": "object_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Object Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/worlds/state": { "get": { "summary": "Observe world state", "operationId": "world_state_v1_worlds_state_get", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/worlds/history": { "get": { "summary": "Get world history summary", "operationId": "worlds_history_v1_worlds_history_get", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/worlds/objects/{object_id}/relationships": { "get": { "summary": "Inspect world object relationships", "operationId": "world_relationships_v1_worlds_objects__object_id__relationships_get", "parameters": [ { "name": "object_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Object Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/worlds/external-state": { "get": { "summary": "Inspect reconciled external state by world object", "operationId": "world_external_state_v1_worlds_external_state_get", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/worlds/tasks": { "post": { "summary": "Create a world task", "operationId": "create_world_task_v1_worlds_tasks_post", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateWorldTaskRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/worlds/tasks/{task_id}": { "patch": { "summary": "Update world task state", "operationId": "update_world_task_v1_worlds_tasks__task_id__patch", "parameters": [ { "name": "task_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Task Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateWorldTaskRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/external-events/ingest": { "post": { "summary": "Ingest connector-neutral external event", "operationId": "external_events_ingest_v1_external_events_ingest_post", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExternalEventRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/external-events/ingest-batch": { "post": { "summary": "Ingest a batch of connector-neutral external events", "operationId": "external_events_ingest_batch_v1_external_events_ingest_batch_post", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExternalEventBatchRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/external-events/history": { "get": { "summary": "Inspect external event ingress history", "operationId": "external_events_history_v1_external_events_history_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 50, "title": "Limit" } }, { "name": "source_family", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source Family" } }, { "name": "world_object_ref", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "World Object Ref" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/external-events/{event_id}": { "get": { "summary": "Inspect external event envelope", "operationId": "external_event_get_v1_external_events__event_id__get", "parameters": [ { "name": "event_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Event Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/external-events/reconciliation/{event_id}": { "get": { "summary": "Inspect external event reconciliation output", "operationId": "external_event_reconciliation_v1_external_events_reconciliation__event_id__get", "parameters": [ { "name": "event_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Event Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/external-actions/propose": { "post": { "summary": "Propose bounded outbound action contract", "operationId": "external_actions_propose_v1_external_actions_propose_post", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExternalActionRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/external-actions/dry-run": { "post": { "summary": "Dry-run bounded outbound action contract", "operationId": "external_actions_dry_run_v1_external_actions_dry_run_post", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExternalActionRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/external-actions/{action_id}/approve": { "post": { "summary": "Approve bounded outbound action", "operationId": "external_actions_approve_v1_external_actions__action_id__approve_post", "parameters": [ { "name": "action_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Action Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExternalActionDecisionRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/external-actions/{action_id}/reject": { "post": { "summary": "Reject bounded outbound action", "operationId": "external_actions_reject_v1_external_actions__action_id__reject_post", "parameters": [ { "name": "action_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Action Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExternalActionDecisionRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/external-actions/{action_id}/execute": { "post": { "summary": "Execute bounded outbound action", "operationId": "external_actions_execute_v1_external_actions__action_id__execute_post", "parameters": [ { "name": "action_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Action Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExternalActionDecisionRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/external-actions/history": { "get": { "summary": "List bounded outbound action ledger history", "operationId": "external_actions_history_v1_external_actions_history_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 50, "title": "Limit" } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Status" } }, { "name": "action_kind", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Action Kind" } }, { "name": "shared_context_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Shared Context Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/external-actions/{action_id}": { "get": { "summary": "Inspect bounded outbound action", "operationId": "external_actions_get_v1_external_actions__action_id__get", "parameters": [ { "name": "action_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Action Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/continuous-ops/checkpoint": { "post": { "summary": "Create runtime checkpoint", "operationId": "continuous_ops_checkpoint_v1_continuous_ops_checkpoint_post", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CheckpointRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/assays/social/run": { "post": { "summary": "Run social/cultural assay", "operationId": "run_social_assay_v1_assays_social_run_post", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunSocialAssayRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/substrates/validate": { "post": { "summary": "Validate seeded substrate environment spec", "operationId": "substrate_validate_v1_substrates_validate_post", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SubstrateSpecRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/substrates/compile": { "post": { "summary": "Compile seeded substrate environment spec", "operationId": "substrate_compile_v1_substrates_compile_post", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SubstrateSpecRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/substrates/deploy": { "post": { "summary": "Deploy/bind seeded substrate environment", "operationId": "substrate_deploy_v1_substrates_deploy_post", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SubstrateDeployRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/substrates/observe": { "post": { "summary": "Observe deployed substrate environment state", "operationId": "substrate_observe_v1_substrates_observe_post", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SubstrateObserveRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/substrates/assay": { "post": { "summary": "Run assay pack against deployed substrate environment", "operationId": "substrate_assay_v1_substrates_assay_post", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SubstrateAssayRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/substrates/recognize": { "post": { "summary": "Inspect motif recognition outputs for deployed substrate environments", "operationId": "substrate_recognize_v1_substrates_recognize_post", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SubstrateRecognizeRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/substrates/render": { "post": { "summary": "Render substrate/world manifests and summaries", "operationId": "substrate_render_v1_substrates_render_post", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SubstrateRenderRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/substrates/deployments": { "get": { "summary": "List substrate deployment records", "operationId": "substrate_list_deployments_v1_substrates_deployments_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 50, "title": "Limit" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/substrates/deployments/{deployment_id}": { "get": { "summary": "Inspect substrate deployment record", "operationId": "substrate_get_deployment_v1_substrates_deployments__deployment_id__get", "parameters": [ { "name": "deployment_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Deployment Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/substrates/artifacts/{artifact_id}": { "get": { "summary": "Inspect substrate build/deployment artifact", "operationId": "substrate_get_artifact_v1_substrates_artifacts__artifact_id__get", "parameters": [ { "name": "artifact_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Artifact Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/substrates/scaffolds": { "get": { "summary": "List official scaffold packages", "operationId": "substrate_list_scaffolds_v1_substrates_scaffolds_get", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/substrates/scaffolds/{scaffold_id}": { "get": { "summary": "Inspect official scaffold package", "operationId": "substrate_get_scaffold_v1_substrates_scaffolds__scaffold_id__get", "parameters": [ { "name": "scaffold_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Scaffold Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/substrates/envelopes": { "get": { "summary": "List official constitutional envelopes", "operationId": "substrate_list_envelopes_v1_substrates_envelopes_get", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/substrates/envelopes/{envelope_id}": { "get": { "summary": "Inspect official constitutional envelope", "operationId": "substrate_get_envelope_v1_substrates_envelopes__envelope_id__get", "parameters": [ { "name": "envelope_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Envelope Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/substrates/recognizers": { "get": { "summary": "List official motif recognizer packs", "operationId": "substrate_list_recognizers_v1_substrates_recognizers_get", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/substrates/recognizers/{recognizer_id}": { "get": { "summary": "Inspect official motif recognizer pack", "operationId": "substrate_get_recognizer_v1_substrates_recognizers__recognizer_id__get", "parameters": [ { "name": "recognizer_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Recognizer Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/substrates/certification-packs": { "get": { "summary": "List official certification starter packs", "operationId": "substrate_list_certification_packs_v1_substrates_certification_packs_get", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/substrates/certification-packs/{pack_id}": { "get": { "summary": "Inspect official certification starter pack", "operationId": "substrate_get_certification_pack_v1_substrates_certification_packs__pack_id__get", "parameters": [ { "name": "pack_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Pack Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/proofs/status": { "get": { "summary": "Get bounded proof certification status", "operationId": "proofs_status_v1_proofs_status_get", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/proofs/summary": { "get": { "summary": "Get proof-layer summary", "operationId": "proofs_summary_v1_proofs_summary_get", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/proofs/checks": { "post": { "summary": "Run bounded proof checks", "operationId": "proofs_checks_v1_proofs_checks_post", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProofChecksRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/scenarios": { "get": { "summary": "List named research scenarios", "operationId": "scenarios_list_v1_scenarios_get", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/scenarios/run": { "post": { "summary": "Run a named research scenario", "operationId": "scenarios_run_v1_scenarios_run_post", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScenarioRunRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/dossiers/core": { "post": { "summary": "Build core dossier", "operationId": "dossiers_core_v1_dossiers_core_post", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DossierBuildRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/dossiers/full": { "post": { "summary": "Build full dossier", "operationId": "dossiers_full_v1_dossiers_full_post", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DossierBuildRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/runtime/self-report": { "get": { "summary": "Get runtime structured self report", "operationId": "runtime_self_report_v1_runtime_self_report_get", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/runtime/continuity": { "get": { "summary": "Get runtime continuity witness report", "operationId": "runtime_continuity_v1_runtime_continuity_get", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/runtime/integrated-self-world": { "get": { "summary": "Get integrated self-world witness report", "operationId": "runtime_integrated_self_world_v1_runtime_integrated_self_world_get", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/runtime/affect": { "get": { "summary": "Get affective witness readout", "operationId": "runtime_affect_v1_runtime_affect_get", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/runtime/development": { "get": { "summary": "Get developmental witness summary", "operationId": "runtime_development_v1_runtime_development_get", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/intentionality/threads": { "get": { "summary": "List intentional threads", "operationId": "intentionality_threads_v1_intentionality_threads_get", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/intentionality/threads/{thread_id}": { "get": { "summary": "Inspect intentional thread", "operationId": "intentionality_thread_v1_intentionality_threads__thread_id__get", "parameters": [ { "name": "thread_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Thread Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/aboutness": { "get": { "summary": "Inspect aboutness for a handle", "operationId": "aboutness_v1_aboutness_get", "parameters": [ { "name": "handle_kind", "in": "query", "required": true, "schema": { "type": "string", "title": "Handle Kind" } }, { "name": "handle_id", "in": "query", "required": true, "schema": { "type": "string", "title": "Handle Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/repair/request": { "post": { "summary": "Request bounded repair on an object", "operationId": "repair_request_v1_repair_request_post", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RepairRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/repair/state": { "get": { "summary": "Get latest repair witness state", "operationId": "repair_state_v1_repair_state_get", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/repair/certificate": { "get": { "summary": "Get repair certificate witness", "operationId": "repair_certificate_v1_repair_certificate_get", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/repairability/{object_id}": { "get": { "summary": "Inspect repairability for object", "operationId": "repairability_v1_repairability__object_id__get", "parameters": [ { "name": "object_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Object Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/membrane/render/runtime": { "post": { "summary": "Render runtime state through membrane", "operationId": "membrane_render_runtime_v1_membrane_render_runtime_post", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MembraneRenderRuntimeRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/membrane/render/assay": { "post": { "summary": "Render assay payload through membrane", "operationId": "membrane_render_assay_v1_membrane_render_assay_post", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MembraneRenderAssayRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/membrane/render/world": { "post": { "summary": "Render world state through membrane", "operationId": "membrane_render_world_v1_membrane_render_world_post", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/shared-contexts/{context_id}": { "get": { "summary": "Inspect shared context", "operationId": "shared_context_v1_shared_contexts__context_id__get", "parameters": [ { "name": "context_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Context Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/shared-contexts": { "post": { "summary": "Create shared context", "operationId": "create_shared_context_v1_shared_contexts_post", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SharedContextCreateRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/shared-contexts/{context_id}/participants": { "post": { "summary": "Attach participants to shared context", "operationId": "attach_shared_context_participants_v1_shared_contexts__context_id__participants_post", "parameters": [ { "name": "context_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Context Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SharedContextParticipantsPatchRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "summary": "Detach participant from shared context", "operationId": "detach_shared_context_participant_v1_shared_contexts__context_id__participants_delete", "parameters": [ { "name": "context_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Context Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SharedContextParticipantDetachRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/shared-contexts/{context_id}/mutations": { "post": { "summary": "Apply shared context coordination mutation", "operationId": "apply_shared_context_mutation_v1_shared_contexts__context_id__mutations_post", "parameters": [ { "name": "context_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Context Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SharedContextMutationRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/shared-contexts/{context_id}/workflow-summary": { "get": { "summary": "Get shared workflow summary", "operationId": "shared_context_workflow_summary_v1_shared_contexts__context_id__workflow_summary_get", "parameters": [ { "name": "context_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Context Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/shared-contexts/{context_id}/external-reconciliation": { "get": { "summary": "Inspect shared-context external reconciliations", "operationId": "shared_context_external_reconciliation_v1_shared_contexts__context_id__external_reconciliation_get", "parameters": [ { "name": "context_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Context Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/shared-contexts/{context_id}/commitments": { "get": { "summary": "Inspect shared commitments witness", "operationId": "shared_context_commitments_v1_shared_contexts__context_id__commitments_get", "parameters": [ { "name": "context_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Context Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/shared-contexts/{context_id}/disagreement": { "get": { "summary": "Inspect shared disagreement witness", "operationId": "shared_context_disagreement_v1_shared_contexts__context_id__disagreement_get", "parameters": [ { "name": "context_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Context Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/shared-contexts/{context_id}/evidence": { "get": { "summary": "Inspect shared evidence witness", "operationId": "shared_context_evidence_v1_shared_contexts__context_id__evidence_get", "parameters": [ { "name": "context_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Context Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/shared-contexts/{context_id}/aboutness": { "get": { "summary": "Inspect shared aboutness witness", "operationId": "shared_context_aboutness_v1_shared_contexts__context_id__aboutness_get", "parameters": [ { "name": "context_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Context Id" } }, { "name": "handle_kind", "in": "query", "required": true, "schema": { "type": "string", "title": "Handle Kind" } }, { "name": "handle_id", "in": "query", "required": true, "schema": { "type": "string", "title": "Handle Id" } }, { "name": "entity_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Entity Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/membrane/render/commitment": { "post": { "summary": "Render commitment witness payload", "operationId": "membrane_render_commitment_v1_membrane_render_commitment_post", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MembraneWitnessRenderRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/membrane/render/repair": { "post": { "summary": "Render repair witness payload", "operationId": "membrane_render_repair_v1_membrane_render_repair_post", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MembraneWitnessRenderRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/membrane/render/aboutness": { "post": { "summary": "Render aboutness witness payload", "operationId": "membrane_render_aboutness_v1_membrane_render_aboutness_post", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MembraneWitnessRenderRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/membrane/render/evidence": { "post": { "summary": "Render evidence witness payload", "operationId": "membrane_render_evidence_v1_membrane_render_evidence_post", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MembraneWitnessRenderRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/admin/service-health": { "get": { "summary": "Get service/runtime backend health state (admin)", "operationId": "service_health_v1_admin_service_health_get", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/artifacts/{artifact_path}/raw": { "get": { "summary": "Fetch full artifact bytes/text", "operationId": "read_artifact_raw_v1_artifacts__artifact_path__raw_get", "parameters": [ { "name": "artifact_path", "in": "path", "required": true, "schema": { "type": "string", "title": "Artifact Path" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/artifacts/{artifact_path}": { "get": { "summary": "Fetch generated artifact/report", "operationId": "read_artifact_v1_artifacts__artifact_path__get", "parameters": [ { "name": "artifact_path", "in": "path", "required": true, "schema": { "type": "string", "title": "Artifact Path" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/admin/organizations/create": { "post": { "summary": "Create organization (admin)", "operationId": "create_organization_v1_admin_organizations_create_post", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateOrganizationRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/admin/organizations": { "get": { "summary": "List organizations (admin)", "operationId": "list_organizations_v1_admin_organizations_get", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/admin/projects/create": { "post": { "summary": "Create project (admin)", "operationId": "create_project_v1_admin_projects_create_post", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateProjectRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/admin/projects": { "get": { "summary": "List projects (admin)", "operationId": "list_projects_v1_admin_projects_get", "parameters": [ { "name": "organization_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Organization Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/admin/principals/create": { "post": { "summary": "Create principal (admin)", "operationId": "create_principal_v1_admin_principals_create_post", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreatePrincipalRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/admin/principals": { "get": { "summary": "List principals (admin)", "operationId": "list_principals_v1_admin_principals_get", "parameters": [ { "name": "organization_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Organization Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/admin/policies/create": { "post": { "summary": "Create quota policy (admin)", "operationId": "create_policy_v1_admin_policies_create_post", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreatePolicyRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/admin/policies": { "get": { "summary": "List quota policies (admin)", "operationId": "list_policies_v1_admin_policies_get", "parameters": [ { "name": "organization_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Organization Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/admin/keys/create": { "post": { "summary": "Create API key (admin)", "operationId": "create_key_v1_admin_keys_create_post", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateKeyRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/admin/keys/rotate": { "post": { "summary": "Rotate API key (admin)", "operationId": "rotate_key_v1_admin_keys_rotate_post", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RotateKeyRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/admin/organizations/status": { "post": { "summary": "Set organization status (admin)", "operationId": "organization_status_v1_admin_organizations_status_post", "parameters": [ { "name": "organization_id", "in": "query", "required": true, "schema": { "type": "string", "title": "Organization Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetControlPlaneStatusRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/admin/projects/status": { "post": { "summary": "Set project status (admin)", "operationId": "project_status_v1_admin_projects_status_post", "parameters": [ { "name": "project_id", "in": "query", "required": true, "schema": { "type": "string", "title": "Project Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetControlPlaneStatusRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/admin/principals/status": { "post": { "summary": "Set principal status (admin)", "operationId": "principal_status_v1_admin_principals_status_post", "parameters": [ { "name": "principal_id", "in": "query", "required": true, "schema": { "type": "string", "title": "Principal Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetControlPlaneStatusRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/admin/policies/status": { "post": { "summary": "Set policy status (admin)", "operationId": "policy_status_v1_admin_policies_status_post", "parameters": [ { "name": "policy_id", "in": "query", "required": true, "schema": { "type": "string", "title": "Policy Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetControlPlaneStatusRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/admin/keys/status": { "post": { "summary": "Set API key status (admin)", "operationId": "key_status_v1_admin_keys_status_post", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetKeyStatusRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/admin/keys": { "get": { "summary": "List keys by tenant or organization (admin)", "operationId": "list_keys_v1_admin_keys_get", "parameters": [ { "name": "tenant_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Tenant Id" } }, { "name": "organization_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Organization Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/admin/usage/{key_id}": { "get": { "summary": "Get key usage stats (admin)", "operationId": "usage_v1_admin_usage__key_id__get", "parameters": [ { "name": "key_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Key Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/admin/usage": { "get": { "summary": "Get aggregated durable usage rollups (admin)", "operationId": "usage_summary_v1_admin_usage_get", "parameters": [ { "name": "organization_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Organization Id" } }, { "name": "project_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Project Id" } }, { "name": "principal_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Principal Id" } }, { "name": "route_class", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Route Class" } }, { "name": "key_class", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Key Class" } }, { "name": "days", "in": "query", "required": false, "schema": { "type": "integer", "default": 7, "title": "Days" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/admin/entitlements": { "get": { "summary": "Get entitlement classes and usage posture (admin)", "operationId": "entitlements_summary_v1_admin_entitlements_get", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/admin/access-layers": { "get": { "summary": "Get access-layer governance summary (admin)", "operationId": "access_layers_summary_v1_admin_access_layers_get", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/admin/audit": { "get": { "summary": "Get control-plane audit rows (admin)", "operationId": "audit_rows_v1_admin_audit_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 100, "title": "Limit" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/admin/requests": { "get": { "summary": "List durable request ledger rows (admin)", "operationId": "request_rows_v1_admin_requests_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 100, "title": "Limit" } }, { "name": "organization_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Organization Id" } }, { "name": "project_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Project Id" } }, { "name": "key_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Key Id" } }, { "name": "decision", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Decision" } }, { "name": "status_code", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Status Code" } }, { "name": "route_class", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Route Class" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/admin/service-events": { "get": { "summary": "List service event ledger rows (admin)", "operationId": "service_events_v1_admin_service_events_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 100, "title": "Limit" } }, { "name": "severity", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Severity" } }, { "name": "event_kind", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Event Kind" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/admin/overview": { "get": { "summary": "Get operational overview summary (admin)", "operationId": "admin_overview_v1_admin_overview_get", "parameters": [ { "name": "window_minutes", "in": "query", "required": false, "schema": { "type": "integer", "default": 60, "title": "Window Minutes" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/admin/prune-ledgers": { "post": { "summary": "Prune old service-side ledger rows (admin)", "operationId": "prune_ledgers_v1_admin_prune_ledgers_post", "parameters": [ { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PruneLedgersRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } } }, "components": { "schemas": { "CheckpointRequest": { "properties": { "path": { "type": "string", "title": "Path", "default": "./artifacts/runtime_checkpoint.json" }, "reason": { "type": "string", "title": "Reason", "default": "api_checkpoint" } }, "type": "object", "title": "CheckpointRequest" }, "CreateKeyRequest": { "properties": { "tenant_id": { "type": "string", "title": "Tenant Id" }, "label": { "type": "string", "title": "Label" }, "environment": { "type": "string", "title": "Environment", "default": "prod" }, "scopes": { "items": { "type": "string" }, "type": "array", "title": "Scopes" }, "quota_per_day": { "type": "integer", "title": "Quota Per Day", "default": 5000 }, "allowed_ips": { "items": { "type": "string" }, "type": "array", "title": "Allowed Ips" }, "allowed_origins": { "items": { "type": "string" }, "type": "array", "title": "Allowed Origins" }, "notes": { "type": "string", "title": "Notes", "default": "" }, "organization_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Organization Id" }, "project_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Project Id" }, "principal_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Principal Id" }, "key_class": { "type": "string", "title": "Key Class", "default": "general" }, "policy_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Policy Id" }, "minute_rate_limit_override": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Minute Rate Limit Override" } }, "type": "object", "required": [ "tenant_id", "label" ], "title": "CreateKeyRequest" }, "CreateOrganizationRequest": { "properties": { "organization_id": { "type": "string", "title": "Organization Id" }, "display_name": { "type": "string", "title": "Display Name" }, "default_environment": { "type": "string", "title": "Default Environment" }, "status": { "type": "string", "title": "Status", "default": "active" }, "notes": { "type": "string", "title": "Notes", "default": "" }, "entitlement_class": { "type": "string", "title": "Entitlement Class", "default": "sandbox" }, "access_layer_max": { "type": "integer", "title": "Access Layer Max", "default": 0 }, "monthly_usage_soft_limit": { "type": "integer", "title": "Monthly Usage Soft Limit", "default": 0 }, "monthly_usage_hard_limit": { "type": "integer", "title": "Monthly Usage Hard Limit", "default": 0 } }, "type": "object", "required": [ "organization_id", "display_name", "default_environment" ], "title": "CreateOrganizationRequest" }, "CreatePolicyRequest": { "properties": { "policy_id": { "type": "string", "title": "Policy Id" }, "organization_id": { "type": "string", "title": "Organization Id" }, "display_name": { "type": "string", "title": "Display Name" }, "environment": { "type": "string", "title": "Environment" }, "daily_quota": { "type": "integer", "title": "Daily Quota" }, "minute_rate_limit": { "type": "integer", "title": "Minute Rate Limit" }, "status": { "type": "string", "title": "Status", "default": "active" }, "notes": { "type": "string", "title": "Notes", "default": "" } }, "type": "object", "required": [ "policy_id", "organization_id", "display_name", "environment", "daily_quota", "minute_rate_limit" ], "title": "CreatePolicyRequest" }, "CreatePrincipalRequest": { "properties": { "principal_id": { "type": "string", "title": "Principal Id" }, "organization_id": { "type": "string", "title": "Organization Id" }, "display_name": { "type": "string", "title": "Display Name" }, "principal_role": { "type": "string", "title": "Principal Role", "default": "operator" }, "status": { "type": "string", "title": "Status", "default": "active" }, "notes": { "type": "string", "title": "Notes", "default": "" } }, "type": "object", "required": [ "principal_id", "organization_id", "display_name" ], "title": "CreatePrincipalRequest" }, "CreateProjectRequest": { "properties": { "project_id": { "type": "string", "title": "Project Id" }, "organization_id": { "type": "string", "title": "Organization Id" }, "display_name": { "type": "string", "title": "Display Name" }, "environment": { "type": "string", "title": "Environment" }, "status": { "type": "string", "title": "Status", "default": "active" }, "notes": { "type": "string", "title": "Notes", "default": "" }, "entitlement_class_override": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Entitlement Class Override" }, "access_layer_override": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Access Layer Override" }, "monthly_usage_soft_limit": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Monthly Usage Soft Limit" }, "monthly_usage_hard_limit": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Monthly Usage Hard Limit" } }, "type": "object", "required": [ "project_id", "organization_id", "display_name", "environment" ], "title": "CreateProjectRequest" }, "CreateWorldTaskRequest": { "properties": { "task_id": { "type": "string", "title": "Task Id" }, "title": { "type": "string", "title": "Title", "default": "generated_task" } }, "type": "object", "required": [ "task_id" ], "title": "CreateWorldTaskRequest" }, "DossierBuildRequest": { "properties": { "artifact_path": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Artifact Path" } }, "type": "object", "title": "DossierBuildRequest" }, "ExternalActionDecisionRequest": { "properties": { "actor": { "type": "string", "title": "Actor" } }, "type": "object", "required": [ "actor" ], "title": "ExternalActionDecisionRequest" }, "ExternalActionRequest": { "properties": { "action_id": { "type": "string", "title": "Action Id" }, "action_kind": { "type": "string", "title": "Action Kind" }, "target_system": { "type": "string", "title": "Target System" }, "target_ref": { "type": "string", "title": "Target Ref" }, "action_intent": { "type": "string", "title": "Action Intent" }, "action_payload": { "additionalProperties": true, "type": "object", "title": "Action Payload", "default": {} }, "requested_effect": { "additionalProperties": true, "type": "object", "title": "Requested Effect", "default": {} }, "safety_class": { "type": "string", "title": "Safety Class", "default": "bounded" }, "approval_required": { "type": "boolean", "title": "Approval Required", "default": true }, "dry_run_supported": { "type": "boolean", "title": "Dry Run Supported", "default": true }, "world_object_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "World Object Ref" }, "task_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Task Ref" }, "shared_context_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Shared Context Id" }, "commitment_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Commitment Ref" }, "correlation_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Correlation Ref" }, "proposed_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Proposed At" }, "proposed_by": { "type": "string", "title": "Proposed By", "default": "public_api" } }, "type": "object", "required": [ "action_id", "action_kind", "target_system", "target_ref", "action_intent" ], "title": "ExternalActionRequest" }, "ExternalEventBatchRequest": { "properties": { "events": { "items": { "$ref": "#/components/schemas/ExternalEventRequest" }, "type": "array", "title": "Events" } }, "type": "object", "required": [ "events" ], "title": "ExternalEventBatchRequest" }, "ExternalEventRequest": { "properties": { "event_id": { "type": "string", "title": "Event Id" }, "source_family": { "type": "string", "title": "Source Family" }, "source_system": { "type": "string", "title": "Source System" }, "source_ref": { "type": "string", "title": "Source Ref" }, "occurred_at": { "type": "string", "title": "Occurred At" }, "observed_at": { "type": "string", "title": "Observed At" }, "ingested_at": { "type": "string", "title": "Ingested At" }, "event_kind": { "type": "string", "title": "Event Kind" }, "event_action": { "type": "string", "title": "Event Action" }, "payload": { "additionalProperties": true, "type": "object", "title": "Payload" }, "world_object_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "World Object Ref" }, "task_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Task Ref" }, "shared_context_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Shared Context Id" }, "entity_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Entity Id" }, "commitment_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Commitment Ref" }, "correlation_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Correlation Ref" }, "summary": { "type": "string", "title": "Summary", "default": "" }, "external_version": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "External Version" }, "severity": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Severity" }, "priority": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Priority" }, "confidence": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Confidence" }, "ingest_idempotency_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Ingest Idempotency Key" } }, "type": "object", "required": [ "event_id", "source_family", "source_system", "source_ref", "occurred_at", "observed_at", "ingested_at", "event_kind", "event_action", "payload" ], "title": "ExternalEventRequest" }, "HTTPValidationError": { "properties": { "detail": { "items": { "$ref": "#/components/schemas/ValidationError" }, "type": "array", "title": "Detail" } }, "type": "object", "title": "HTTPValidationError" }, "MembraneRenderAssayRequest": { "properties": { "assay_payload": { "additionalProperties": true, "type": "object", "title": "Assay Payload" } }, "type": "object", "required": [ "assay_payload" ], "title": "MembraneRenderAssayRequest" }, "MembraneRenderRuntimeRequest": { "properties": { "mode": { "type": "string", "title": "Mode", "default": "brief" } }, "type": "object", "title": "MembraneRenderRuntimeRequest" }, "MembraneWitnessRenderRequest": { "properties": { "payload": { "additionalProperties": true, "type": "object", "title": "Payload" } }, "type": "object", "required": [ "payload" ], "title": "MembraneWitnessRenderRequest" }, "ProofChecksRequest": { "properties": { "include_non_gating_evidence": { "type": "boolean", "title": "Include Non Gating Evidence", "default": false }, "artifact_path": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Artifact Path" } }, "type": "object", "title": "ProofChecksRequest" }, "PruneLedgersRequest": { "properties": { "request_ledger_retention_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Ledger Retention Days" }, "service_event_retention_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Service Event Retention Days" }, "control_plane_audit_retention_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Control Plane Audit Retention Days" } }, "type": "object", "title": "PruneLedgersRequest" }, "RepairRequest": { "properties": { "object_id": { "type": "string", "title": "Object Id" }, "repair_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Repair Key" } }, "type": "object", "required": [ "object_id" ], "title": "RepairRequest" }, "RotateKeyRequest": { "properties": { "key_id": { "type": "string", "title": "Key Id" } }, "type": "object", "required": [ "key_id" ], "title": "RotateKeyRequest" }, "RunSocialAssayRequest": { "properties": { "max_steps": { "type": "integer", "title": "Max Steps", "default": 6 }, "output_dir": { "type": "string", "title": "Output Dir", "default": "./artifacts" }, "command": { "type": "string", "title": "Command", "default": "list_objects" } }, "type": "object", "title": "RunSocialAssayRequest" }, "SandboxAccessRequest": { "properties": { "name": { "type": "string", "maxLength": 120, "minLength": 2, "title": "Name" }, "email": { "type": "string", "maxLength": 160, "minLength": 5, "title": "Email" }, "intended_use": { "type": "string", "maxLength": 1200, "minLength": 8, "title": "Intended Use" } }, "type": "object", "required": [ "name", "email", "intended_use" ], "title": "SandboxAccessRequest" }, "ScenarioRunRequest": { "properties": { "scenario_name": { "type": "string", "title": "Scenario Name" }, "artifact_path": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Artifact Path" } }, "type": "object", "required": [ "scenario_name" ], "title": "ScenarioRunRequest" }, "SessionCreateRequest": { "properties": { "continuity_mode": { "type": "string", "title": "Continuity Mode", "default": "preserve" }, "parent_session_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Parent Session Id" } }, "type": "object", "title": "SessionCreateRequest" }, "SessionStepRequest": { "properties": { "input_packet": { "additionalProperties": true, "type": "object", "title": "Input Packet" } }, "type": "object", "required": [ "input_packet" ], "title": "SessionStepRequest" }, "SetControlPlaneStatusRequest": { "properties": { "status": { "type": "string", "title": "Status" } }, "type": "object", "required": [ "status" ], "title": "SetControlPlaneStatusRequest" }, "SetKeyStatusRequest": { "properties": { "key_id": { "type": "string", "title": "Key Id" }, "status": { "type": "string", "title": "Status" } }, "type": "object", "required": [ "key_id", "status" ], "title": "SetKeyStatusRequest" }, "SharedContextCreateRequest": { "properties": { "context_id": { "type": "string", "title": "Context Id" }, "context_kind": { "type": "string", "title": "Context Kind", "default": "coordination" }, "context_label": { "type": "string", "title": "Context Label", "default": "" }, "description": { "type": "string", "title": "Description", "default": "" }, "seed_input": { "additionalProperties": true, "type": "object", "title": "Seed Input" }, "metadata": { "additionalProperties": true, "type": "object", "title": "Metadata" }, "linkage": { "additionalProperties": true, "type": "object", "title": "Linkage" }, "participants": { "items": { "$ref": "#/components/schemas/SharedContextParticipantInput" }, "type": "array", "title": "Participants" }, "register_missing_entities": { "type": "boolean", "title": "Register Missing Entities", "default": true } }, "type": "object", "required": [ "context_id" ], "title": "SharedContextCreateRequest" }, "SharedContextMutationRequest": { "properties": { "mutation_type": { "type": "string", "title": "Mutation Type" }, "actor_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Actor Id" }, "payload": { "additionalProperties": true, "type": "object", "title": "Payload" } }, "type": "object", "required": [ "mutation_type" ], "title": "SharedContextMutationRequest" }, "SharedContextParticipantDetachRequest": { "properties": { "entity_id": { "type": "string", "title": "Entity Id" }, "actor_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Actor Id" }, "reason": { "type": "string", "title": "Reason", "default": "removed" } }, "type": "object", "required": [ "entity_id" ], "title": "SharedContextParticipantDetachRequest" }, "SharedContextParticipantInput": { "properties": { "entity_id": { "type": "string", "title": "Entity Id" }, "role": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Role" }, "metadata": { "additionalProperties": true, "type": "object", "title": "Metadata" } }, "type": "object", "required": [ "entity_id" ], "title": "SharedContextParticipantInput" }, "SharedContextParticipantsPatchRequest": { "properties": { "participants": { "items": { "$ref": "#/components/schemas/SharedContextParticipantInput" }, "type": "array", "title": "Participants" }, "actor_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Actor Id" }, "register_missing_entities": { "type": "boolean", "title": "Register Missing Entities", "default": true } }, "type": "object", "title": "SharedContextParticipantsPatchRequest" }, "SubstrateAssayRequest": { "properties": { "deployment_id": { "type": "string", "title": "Deployment Id" } }, "type": "object", "required": [ "deployment_id" ], "title": "SubstrateAssayRequest" }, "SubstrateDeployRequest": { "properties": { "spec": { "additionalProperties": true, "type": "object", "title": "Spec" } }, "type": "object", "required": [ "spec" ], "title": "SubstrateDeployRequest" }, "SubstrateObserveRequest": { "properties": { "deployment_id": { "type": "string", "title": "Deployment Id" } }, "type": "object", "required": [ "deployment_id" ], "title": "SubstrateObserveRequest" }, "SubstrateRecognizeRequest": { "properties": { "deployment_id": { "type": "string", "title": "Deployment Id" }, "motif_classes": { "items": { "type": "string" }, "type": "array", "title": "Motif Classes" } }, "type": "object", "required": [ "deployment_id" ], "title": "SubstrateRecognizeRequest" }, "SubstrateRenderRequest": { "properties": { "deployment_id": { "type": "string", "title": "Deployment Id" }, "render_kind": { "type": "string", "title": "Render Kind", "default": "manifest" } }, "type": "object", "required": [ "deployment_id" ], "title": "SubstrateRenderRequest" }, "SubstrateSpecRequest": { "properties": { "spec": { "additionalProperties": true, "type": "object", "title": "Spec" } }, "type": "object", "required": [ "spec" ], "title": "SubstrateSpecRequest" }, "UpdateWorldTaskRequest": { "properties": { "state_updates": { "additionalProperties": true, "type": "object", "title": "State Updates" } }, "type": "object", "required": [ "state_updates" ], "title": "UpdateWorldTaskRequest" }, "ValidationError": { "properties": { "loc": { "items": { "anyOf": [ { "type": "string" }, { "type": "integer" } ] }, "type": "array", "title": "Location" }, "msg": { "type": "string", "title": "Message" }, "type": { "type": "string", "title": "Error Type" } }, "type": "object", "required": [ "loc", "msg", "type" ], "title": "ValidationError" } } } }