{ "openapi": "3.1.0", "info": { "title": "Noema API", "version": "0.1.0", "description": "HTTP API of the Noema cognitive runtime. Every route requires authentication: a bearer API token (Authorization: Bearer \u2026) or a browser session cookie plus the X-CSRF-Token header on unsafe methods. Roles: observer < operator < administrator; each operation lists the minimum role in x-required-role. Errors use one envelope: {\"error\":{\"code\",\"message\",\"request_id\"}}. Mind-scoped paths accept a slug or id. Streaming: GET /api/v1/events/stream and /api/v1/minds/{mind}/events/stream are Server-Sent Events." }, "servers": [ { "url": "/" } ], "security": [ { "bearerAuth": [] }, { "cookieAuth": [] } ], "components": { "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer" }, "cookieAuth": { "type": "apiKey", "in": "cookie", "name": "noema_session" } }, "responses": { "Error": { "description": "Error envelope", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "schemas": { "Error": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "paths": { "/api/v1/approvals": { "get": { "operationId": "approvalsList", "summary": "approvals list", "x-required-role": "observer", "tags": [ "approvals" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } } } }, "/api/v1/approvals/{id}": { "get": { "operationId": "approvalGet", "summary": "approval get", "x-required-role": "observer", "tags": [ "approvals" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ] } }, "/api/v1/approvals/{id}/approve": { "post": { "operationId": "approvalApprove", "summary": "approval approve", "x-required-role": "operator", "tags": [ "approvals" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/approvals/{id}/deny": { "post": { "operationId": "approvalDeny", "summary": "approval deny", "x-required-role": "operator", "tags": [ "approvals" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/audit": { "get": { "operationId": "auditList", "summary": "audit list", "x-required-role": "operator", "tags": [ "audit" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } } } }, "/api/v1/capabilities": { "get": { "operationId": "capabilitiesList", "summary": "capabilities list", "x-required-role": "observer", "tags": [ "capabilities" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } } } }, "/api/v1/consolidation/pause": { "post": { "operationId": "consolidationPause", "summary": "consolidation pause", "x-required-role": "administrator", "tags": [ "consolidation" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/dreams/pause": { "post": { "operationId": "dreamPause", "summary": "dream pause", "x-required-role": "administrator", "tags": [ "dreams" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/events/stream": { "get": { "operationId": "eventsStream", "summary": "events stream", "x-required-role": "observer", "tags": [ "events" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } } } }, "/api/v1/events/types": { "get": { "operationId": "eventTypes", "summary": "list event types", "x-required-role": "none", "tags": [ "events" ], "responses": { "200": { "description": "OK" }, "401": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" } } } }, "/api/v1/events/{id}": { "get": { "operationId": "eventGet", "summary": "event get", "x-required-role": "observer", "tags": [ "events" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ] } }, "/api/v1/events/{id}/chain": { "get": { "operationId": "eventChain", "summary": "bounded causal chain around an event (recorded links only)", "x-required-role": "observer", "tags": [ "events" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "direction", "in": "query", "schema": { "type": "string", "enum": [ "back", "forward", "both" ] } }, { "name": "depth", "in": "query", "schema": { "type": "integer", "maximum": 6 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" } } } }, "/api/v1/events/{id}/context": { "get": { "operationId": "eventContext", "summary": "event context", "x-required-role": "observer", "tags": [ "events" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ] } }, "/api/v1/executions": { "get": { "operationId": "executionsList", "summary": "executions list", "x-required-role": "observer", "tags": [ "executions" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } } } }, "/api/v1/experiments": { "get": { "operationId": "experimentsList", "summary": "experiments list", "x-required-role": "observer", "tags": [ "experiments" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } } }, "post": { "operationId": "experimentCreate", "summary": "experiment create", "x-required-role": "operator", "tags": [ "experiments" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/experiments/{id}": { "delete": { "operationId": "experimentDelete", "summary": "experiment delete", "x-required-role": "administrator", "tags": [ "experiments" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "204": { "description": "Deleted" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ] }, "get": { "operationId": "experimentGet", "summary": "experiment get", "x-required-role": "observer", "tags": [ "experiments" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ] } }, "/api/v1/experiments/{id}/export": { "get": { "operationId": "experimentExport", "summary": "experiment export", "x-required-role": "observer", "tags": [ "experiments" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ] } }, "/api/v1/experiments/{id}/run": { "post": { "operationId": "experimentRun", "summary": "experiment run", "x-required-role": "operator", "tags": [ "experiments" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/grants": { "get": { "operationId": "grantsList", "summary": "grants list", "x-required-role": "observer", "tags": [ "grants" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } } } }, "/api/v1/grants/{id}": { "delete": { "operationId": "grantRevoke", "summary": "grant revoke", "x-required-role": "operator", "tags": [ "grants" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "204": { "description": "Deleted" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ] } }, "/api/v1/integrations": { "get": { "operationId": "integrationsList", "summary": "integrations list", "x-required-role": "observer", "tags": [ "integrations" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } } }, "post": { "operationId": "integrationsCreate", "summary": "integrations create", "x-required-role": "administrator", "tags": [ "integrations" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/integrations/{id}": { "delete": { "operationId": "integrationDelete", "summary": "integration delete", "x-required-role": "administrator", "tags": [ "integrations" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "204": { "description": "Deleted" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ] }, "get": { "operationId": "integrationGet", "summary": "integration get", "x-required-role": "observer", "tags": [ "integrations" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ] }, "put": { "operationId": "integrationPut", "summary": "integration put", "x-required-role": "administrator", "tags": [ "integrations" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/integrations/{id}/documents": { "get": { "operationId": "integrationDocuments", "summary": "integration documents", "x-required-role": "observer", "tags": [ "integrations" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ] } }, "/api/v1/integrations/{id}/run": { "post": { "operationId": "integrationRun", "summary": "integration run", "x-required-role": "operator", "tags": [ "integrations" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/integrations/{id}/runs": { "get": { "operationId": "integrationRuns", "summary": "integration runs", "x-required-role": "observer", "tags": [ "integrations" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ] } }, "/api/v1/llm/calls": { "get": { "operationId": "callsList", "summary": "calls list", "x-required-role": "observer", "tags": [ "llm" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } } } }, "/api/v1/llm/calls/{id}": { "get": { "operationId": "callGet", "summary": "call get", "x-required-role": "observer", "tags": [ "llm" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ] } }, "/api/v1/llm/models": { "get": { "operationId": "modelsList", "summary": "models list", "x-required-role": "observer", "tags": [ "llm" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } } }, "post": { "operationId": "modelsCreate", "summary": "models create", "x-required-role": "administrator", "tags": [ "llm" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/llm/models/{id}": { "delete": { "operationId": "modelDelete", "summary": "model delete", "x-required-role": "administrator", "tags": [ "llm" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "204": { "description": "Deleted" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ] }, "put": { "operationId": "modelPut", "summary": "model put", "x-required-role": "administrator", "tags": [ "llm" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/llm/providers": { "get": { "operationId": "providersList", "summary": "providers list", "x-required-role": "observer", "tags": [ "llm" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } } }, "post": { "operationId": "providersCreate", "summary": "providers create", "x-required-role": "administrator", "tags": [ "llm" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/llm/providers/{id}": { "delete": { "operationId": "providerDelete", "summary": "provider delete", "x-required-role": "administrator", "tags": [ "llm" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "204": { "description": "Deleted" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ] }, "get": { "operationId": "providerGet", "summary": "provider get", "x-required-role": "observer", "tags": [ "llm" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ] }, "put": { "operationId": "providerPut", "summary": "provider put", "x-required-role": "administrator", "tags": [ "llm" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/llm/providers/{id}/test": { "post": { "operationId": "providerTest", "summary": "provider test", "x-required-role": "operator", "tags": [ "llm" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/llm/roles": { "get": { "operationId": "rolesList", "summary": "roles list", "x-required-role": "observer", "tags": [ "llm" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } } } }, "/api/v1/llm/roles/{role}": { "put": { "operationId": "rolePut", "summary": "role put", "x-required-role": "administrator", "tags": [ "llm" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "role", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/llm/usage": { "get": { "operationId": "usage", "summary": "usage", "x-required-role": "observer", "tags": [ "llm" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } } } }, "/api/v1/me": { "get": { "operationId": "me", "summary": "me", "x-required-role": "observer", "tags": [ "me" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } } } }, "/api/v1/me/sessions": { "get": { "operationId": "mySessions", "summary": "my sessions", "x-required-role": "observer", "tags": [ "me" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } } } }, "/api/v1/me/sessions/{id}": { "delete": { "operationId": "mySessionRevoke", "summary": "my session revoke", "x-required-role": "observer", "tags": [ "me" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "204": { "description": "Deleted" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ] } }, "/api/v1/me/tokens": { "get": { "operationId": "myTokens", "summary": "my tokens", "x-required-role": "observer", "tags": [ "me" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } } }, "post": { "operationId": "myTokenCreate", "summary": "my token create", "x-required-role": "observer", "tags": [ "me" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/me/tokens/{id}": { "delete": { "operationId": "myTokenRevoke", "summary": "my token revoke", "x-required-role": "observer", "tags": [ "me" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "204": { "description": "Deleted" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ] } }, "/api/v1/minds": { "get": { "operationId": "mindsList", "summary": "minds list", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } } }, "post": { "operationId": "mindsCreate", "summary": "minds create", "x-required-role": "administrator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/import": { "post": { "operationId": "mindImport", "summary": "mind import", "x-required-role": "administrator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/import-archive": { "post": { "operationId": "mindImportArchive", "summary": "mind import archive", "x-required-role": "administrator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}": { "get": { "operationId": "mindGet", "summary": "mind get", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ] }, "patch": { "operationId": "mindPatch", "summary": "mind patch", "x-required-role": "administrator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/ask": { "post": { "operationId": "ask", "summary": "ask", "x-required-role": "operator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/assertions": { "get": { "operationId": "assertionsList", "summary": "list assertions: who took what stance on which proposition", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" }, { "name": "actor", "in": "query", "schema": { "type": "string" } }, { "name": "belief", "in": "query", "schema": { "type": "string" } }, { "name": "stance", "in": "query", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "schema": { "type": "integer" } } ] } }, "/api/v1/minds/{mind}/assertions/actors": { "get": { "operationId": "assertionActors", "summary": "summarise asserting actors", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ] } }, "/api/v1/minds/{mind}/beliefs": { "get": { "operationId": "beliefsList", "summary": "beliefs list", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ] }, "post": { "operationId": "beliefsCreate", "summary": "beliefs create", "x-required-role": "operator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/beliefs/stats": { "get": { "operationId": "beliefsStats", "summary": "beliefs stats", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ] } }, "/api/v1/minds/{mind}/beliefs/{id}": { "get": { "operationId": "beliefGet", "summary": "belief get", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ] } }, "/api/v1/minds/{mind}/beliefs/{id}/alternatives": { "post": { "operationId": "beliefAlternative", "summary": "belief alternative", "x-required-role": "operator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/beliefs/{id}/evidence": { "post": { "operationId": "beliefEvidence", "summary": "belief evidence", "x-required-role": "operator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/beliefs/{id}/retract": { "post": { "operationId": "beliefRetract", "summary": "belief retract", "x-required-role": "operator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/capabilities": { "get": { "operationId": "mindCapabilities", "summary": "mind capabilities", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ] } }, "/api/v1/minds/{mind}/clone": { "post": { "operationId": "mindClone", "summary": "mind clone", "x-required-role": "administrator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/compare/{other}": { "get": { "operationId": "mindCompare", "summary": "mind compare", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" }, { "name": "other", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ] } }, "/api/v1/minds/{mind}/consolidation": { "get": { "operationId": "consolidationJobs", "summary": "consolidation jobs", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ] } }, "/api/v1/minds/{mind}/consolidation/reject": { "post": { "operationId": "consolidationReject", "summary": "consolidation reject", "x-required-role": "operator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/consolidation/run": { "post": { "operationId": "consolidationRun", "summary": "consolidation run", "x-required-role": "operator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/conversations": { "get": { "operationId": "conversationsList", "summary": "conversations list", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ] }, "post": { "operationId": "conversationsCreate", "summary": "conversations create", "x-required-role": "operator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/conversations/{id}": { "get": { "operationId": "conversationGet", "summary": "conversation get", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ] } }, "/api/v1/minds/{mind}/conversations/{id}/messages": { "post": { "operationId": "messagePost", "summary": "message post", "x-required-role": "operator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/corrections": { "get": { "operationId": "correctionsList", "summary": "corrections list", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ] }, "post": { "operationId": "correctionsCreate", "summary": "corrections create", "x-required-role": "operator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/cycle": { "post": { "operationId": "workspaceCycle", "summary": "workspace cycle", "x-required-role": "operator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/dreams": { "get": { "operationId": "dreamsList", "summary": "dreams list", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ] } }, "/api/v1/minds/{mind}/dreams/hypotheses/{id}/promote": { "post": { "operationId": "dreamReview", "summary": "dream review", "x-required-role": "operator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/dreams/hypotheses/{id}/reject": { "post": { "operationId": "dreamReview", "summary": "dream review", "x-required-role": "operator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/dreams/run": { "post": { "operationId": "dreamRun", "summary": "dream run", "x-required-role": "operator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/dreams/settings": { "post": { "operationId": "dreamSettings", "summary": "dream settings", "x-required-role": "administrator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/entities": { "get": { "operationId": "entitiesList", "summary": "entities list", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ] } }, "/api/v1/minds/{mind}/entities/{id}": { "get": { "operationId": "entityGet", "summary": "entity get", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ] }, "patch": { "operationId": "entityPatch", "summary": "entity patch", "x-required-role": "operator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/entities/{id}/distinct": { "post": { "operationId": "entityDistinct", "summary": "entity distinct", "x-required-role": "operator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/entities/{id}/merge": { "post": { "operationId": "entityMerge", "summary": "entity merge", "x-required-role": "operator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/entities/{id}/relationships": { "post": { "operationId": "entityRelate", "summary": "entity relate", "x-required-role": "operator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/events": { "get": { "operationId": "eventsList", "summary": "events list", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ] } }, "/api/v1/minds/{mind}/events/stats": { "get": { "operationId": "eventsStats", "summary": "events stats", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ] } }, "/api/v1/minds/{mind}/events/stream": { "get": { "operationId": "eventsStream", "summary": "events stream", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ] } }, "/api/v1/minds/{mind}/export": { "get": { "operationId": "mindExport", "summary": "mind export", "x-required-role": "operator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ] } }, "/api/v1/minds/{mind}/goals": { "get": { "operationId": "goalsList", "summary": "goals list", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ] }, "post": { "operationId": "goalsCreate", "summary": "goals create", "x-required-role": "operator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/goals/{id}": { "get": { "operationId": "goalGet", "summary": "goal get", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ] }, "patch": { "operationId": "goalPatch", "summary": "goal patch", "x-required-role": "operator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/graph": { "get": { "operationId": "graphGet", "summary": "graph get", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ] } }, "/api/v1/minds/{mind}/invoke": { "post": { "operationId": "invoke", "summary": "invoke", "x-required-role": "operator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/memories": { "get": { "operationId": "memoriesList", "summary": "memories list", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ] }, "post": { "operationId": "memoriesCreate", "summary": "memories create", "x-required-role": "operator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/memories/stats": { "get": { "operationId": "memoriesStats", "summary": "memories stats", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ] } }, "/api/v1/minds/{mind}/memories/{id}": { "get": { "operationId": "memoryGet", "summary": "memory get", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ] } }, "/api/v1/minds/{mind}/memories/{id}/relationships": { "post": { "operationId": "memoryRelate", "summary": "memory relate", "x-required-role": "operator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/memories/{id}/retract": { "post": { "operationId": "memoryRetract", "summary": "memory retract", "x-required-role": "operator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/mode": { "post": { "operationId": "workspaceMode", "summary": "workspace mode", "x-required-role": "operator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/narrative": { "get": { "operationId": "narrativeGet", "summary": "narrative get", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ] } }, "/api/v1/minds/{mind}/notifications": { "get": { "operationId": "notificationsList", "summary": "notifications list", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ] } }, "/api/v1/minds/{mind}/observations": { "post": { "operationId": "observationCreate", "summary": "observation create", "x-required-role": "operator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/personality": { "get": { "operationId": "personalityGet", "summary": "personality get", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ] }, "put": { "operationId": "personalityPut", "summary": "personality put", "x-required-role": "administrator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/personality/brief": { "get": { "operationId": "personalityBrief", "summary": "personality brief", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ] } }, "/api/v1/minds/{mind}/personality/diff": { "get": { "operationId": "personalityDiff", "summary": "personality diff", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ] } }, "/api/v1/minds/{mind}/personality/template": { "post": { "operationId": "personalityTemplate", "summary": "personality template", "x-required-role": "administrator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/personality/versions": { "get": { "operationId": "personalityVersions", "summary": "personality versions", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ] } }, "/api/v1/minds/{mind}/personality/versions/{n}": { "get": { "operationId": "personalityVersion", "summary": "personality version", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" }, { "name": "n", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ] } }, "/api/v1/minds/{mind}/personality/versions/{n}/restore": { "post": { "operationId": "personalityRestore", "summary": "personality restore", "x-required-role": "administrator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" }, { "name": "n", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/predictions": { "get": { "operationId": "predictionsList", "summary": "predictions list", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ] }, "post": { "operationId": "predictionsCreate", "summary": "predictions create", "x-required-role": "operator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/predictions/calibration": { "get": { "operationId": "predictionsCalibration", "summary": "predictions calibration", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ] } }, "/api/v1/minds/{mind}/predictions/{id}": { "get": { "operationId": "predictionGet", "summary": "prediction get", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ] } }, "/api/v1/minds/{mind}/predictions/{id}/resolve": { "post": { "operationId": "predictionResolve", "summary": "prediction resolve", "x-required-role": "operator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/redactions": { "get": { "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "201": { "description": "Redacted; irreversible" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" } } ], "operationId": "redactionsList", "summary": "list the redaction ledger", "x-required-role": "operator" }, "post": { "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "201": { "description": "Redacted; irreversible" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" } } ], "operationId": "redactionCreate", "summary": "redact a row's content irreversibly (event, memory, message, llm_call, belief, assertion), optionally cascading to derived rows", "x-required-role": "administrator", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "kind": { "type": "string" }, "id": { "type": "string" }, "reason": { "type": "string" }, "policy": { "type": "string" }, "cascade": { "type": "boolean" } }, "required": [ "kind", "id", "reason" ] } } } } } }, "/api/v1/minds/{mind}/reflections": { "get": { "operationId": "reflectionsList", "summary": "reflections list", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ] } }, "/api/v1/minds/{mind}/reflections/run": { "post": { "operationId": "reflectionRun", "summary": "reflection run", "x-required-role": "operator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/replays": { "get": { "operationId": "replaysList", "summary": "replays list", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ] }, "post": { "operationId": "replayStart", "summary": "replay start", "x-required-role": "operator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/reset": { "post": { "operationId": "workspaceReset", "summary": "workspace reset", "x-required-role": "operator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/selfmodel": { "get": { "operationId": "mindSelfModel", "summary": "mind self model", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ] } }, "/api/v1/minds/{mind}/snapshots": { "get": { "operationId": "snapshotsList", "summary": "snapshots list", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ] }, "post": { "operationId": "snapshotCreate", "summary": "snapshot create", "x-required-role": "operator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/state": { "get": { "operationId": "stateGet", "summary": "state get", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ] } }, "/api/v1/minds/{mind}/state/drives/{name}": { "put": { "operationId": "driveSet", "summary": "drive set", "x-required-role": "administrator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" }, { "name": "name", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/state/reset": { "post": { "operationId": "stateReset", "summary": "state reset", "x-required-role": "operator", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/minds/{mind}/workspace": { "get": { "operationId": "workspaceGet", "summary": "workspace get", "x-required-role": "observer", "tags": [ "minds" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "mind", "in": "path", "required": true, "schema": { "type": "string" }, "description": "mind slug or id" } ] } }, "/api/v1/notifications": { "get": { "operationId": "notificationsList", "summary": "notifications list", "x-required-role": "observer", "tags": [ "notifications" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } } } }, "/api/v1/notifications/read-all": { "post": { "operationId": "notificationsReadAll", "summary": "notifications read all", "x-required-role": "observer", "tags": [ "notifications" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/notifications/{id}/read": { "post": { "operationId": "notificationRead", "summary": "notification read", "x-required-role": "observer", "tags": [ "notifications" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/personality-templates": { "get": { "operationId": "templatesList", "summary": "templates list", "x-required-role": "observer", "tags": [ "personality-templates" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } } }, "post": { "operationId": "templatesCreate", "summary": "templates create", "x-required-role": "administrator", "tags": [ "personality-templates" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/personality-templates/{id}": { "delete": { "operationId": "templateDelete", "summary": "template delete", "x-required-role": "administrator", "tags": [ "personality-templates" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "204": { "description": "Deleted" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ] }, "get": { "operationId": "templateGet", "summary": "template get", "x-required-role": "observer", "tags": [ "personality-templates" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ] }, "put": { "operationId": "templatePut", "summary": "template put", "x-required-role": "administrator", "tags": [ "personality-templates" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/policies": { "get": { "operationId": "policiesList", "summary": "policies list", "x-required-role": "observer", "tags": [ "policies" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } } }, "post": { "operationId": "policiesCreate", "summary": "policies create", "x-required-role": "administrator", "tags": [ "policies" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/policies/{id}": { "delete": { "operationId": "policyDelete", "summary": "policy delete", "x-required-role": "administrator", "tags": [ "policies" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "204": { "description": "Deleted" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ] } }, "/api/v1/prompts": { "get": { "operationId": "promptsList", "summary": "prompts list", "x-required-role": "observer", "tags": [ "prompts" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } } }, "post": { "operationId": "promptsSave", "summary": "prompts save", "x-required-role": "administrator", "tags": [ "prompts" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/prompts/{name}": { "get": { "operationId": "promptGet", "summary": "prompt get", "x-required-role": "observer", "tags": [ "prompts" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "name", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ] }, "put": { "operationId": "promptsSave", "summary": "prompts save", "x-required-role": "administrator", "tags": [ "prompts" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "name", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/prompts/{name}/clone": { "post": { "operationId": "promptClone", "summary": "prompt clone", "x-required-role": "administrator", "tags": [ "prompts" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "name", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/prompts/{name}/test": { "post": { "operationId": "promptTest", "summary": "prompt test", "x-required-role": "operator", "tags": [ "prompts" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "name", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/prompts/{name}/versions": { "get": { "operationId": "promptVersions", "summary": "prompt versions", "x-required-role": "observer", "tags": [ "prompts" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "name", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ] } }, "/api/v1/prompts/{name}/versions/{n}/restore": { "post": { "operationId": "promptRestore", "summary": "prompt restore", "x-required-role": "administrator", "tags": [ "prompts" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "name", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" }, { "name": "n", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/replays/{id}": { "get": { "operationId": "replayGet", "summary": "replay get", "x-required-role": "observer", "tags": [ "replays" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ] } }, "/api/v1/snapshots/{id}": { "delete": { "operationId": "snapshotDelete", "summary": "snapshot delete", "x-required-role": "administrator", "tags": [ "snapshots" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "204": { "description": "Deleted" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ] }, "get": { "operationId": "snapshotGet", "summary": "snapshot get", "x-required-role": "observer", "tags": [ "snapshots" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ] } }, "/api/v1/snapshots/{id}/archive": { "get": { "operationId": "snapshotArchive", "summary": "snapshot archive", "x-required-role": "operator", "tags": [ "snapshots" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ] } }, "/api/v1/snapshots/{id}/fork": { "post": { "operationId": "snapshotFork", "summary": "snapshot fork", "x-required-role": "administrator", "tags": [ "snapshots" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/system/status": { "get": { "operationId": "systemStatus", "summary": "system status", "x-required-role": "observer", "tags": [ "system" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } } } }, "/api/v1/users": { "get": { "operationId": "usersList", "summary": "users list", "x-required-role": "administrator", "tags": [ "users" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" } } }, "post": { "operationId": "usersCreate", "summary": "users create", "x-required-role": "administrator", "tags": [ "users" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/users/{id}": { "patch": { "operationId": "usersPatch", "summary": "users patch", "x-required-role": "administrator", "tags": [ "users" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "$ref": "#/components/responses/Error" }, "403": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "422": { "$ref": "#/components/responses/Error" }, "201": { "description": "Created" }, "202": { "description": "Accepted (background work started)" } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "identifier" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object" } } } } } }, "/api/v1/webhooks/{id}": { "post": { "operationId": "webhookReceive", "summary": "receive a signed webhook delivery", "x-required-role": "none (HMAC-signed delivery)", "tags": [ "webhooks" ], "security": [], "description": "Body is JSON {title,text,reference,salience}. Headers X-Noema-Timestamp (unix seconds) and X-Noema-Signature: sha256=HMAC_SHA256(secret, timestamp + '.' + body). Unsigned, stale (\u00b1300 s) and replayed deliveries are refused; per-IP rate limited; body capped at 256 KiB.", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "webhook integration id" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "title": { "type": "string" }, "text": { "type": "string" }, "reference": { "type": "string" }, "salience": { "type": "number" } }, "required": [ "text" ] } } } }, "responses": { "202": { "description": "Accepted; returns {event_id}" }, "401": { "$ref": "#/components/responses/Error" }, "404": { "$ref": "#/components/responses/Error" }, "409": { "description": "Replay" }, "429": { "description": "Rate limited" } } } } } }