Files
noema/internal/api/openapi.json
T
Andy Dixon e7dc6dfe65 feat(api): volition, plans, forensic why, attribution and research routes
Observers can read wants (with effective strength), want conflicts,
commitments, intentions with their plans, subordinate intentions and
decisions, the decision ledger, plans with steps, "why" explanations for
executions, approvals, capability requests, plan steps, intentions and
events, attribution of an outcome event, the agency timeline, the
measure definitions with their disclaimer, agency metrics, metacognitive
calibration and raw research measurements.

Operators can create and close commitments, abandon an intention (its
plan is cancelled and pending requests withdrawn), cancel a plan and
release a blocked step. Every write is audited; none grants capability
authority. OpenAPI documents all 21 routes, and an end-to-end test
covers reads, writes and observer refusals.
2026-09-18 19:48:28 +01:00

9908 lines
184 KiB
JSON

{
"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"
}
}
}
},
"/api/v1/capability-requests": {
"get": {
"operationId": "capabilityRequestsList",
"summary": "capability requests list",
"x-required-role": "observer",
"tags": [
"capability-requests"
],
"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/capability-requests/{id}": {
"get": {
"operationId": "capabilityRequestGet",
"summary": "capability request get",
"x-required-role": "observer",
"tags": [
"capability-requests"
],
"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/capability-requests/{id}/grant": {
"post": {
"operationId": "capabilityRequestGrant",
"summary": "capability request grant",
"x-required-role": "operator",
"tags": [
"capability-requests"
],
"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"
}
},
"parameters": [
{
"name": "id",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"description": "identifier"
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
}
}
},
"/api/v1/capability-requests/{id}/deny": {
"post": {
"operationId": "capabilityRequestDeny",
"summary": "capability request deny",
"x-required-role": "operator",
"tags": [
"capability-requests"
],
"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"
}
},
"parameters": [
{
"name": "id",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"description": "identifier"
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
}
}
},
"/api/v1/scoped-grants": {
"get": {
"operationId": "scopedGrantsList",
"summary": "scoped grants list",
"x-required-role": "observer",
"tags": [
"scoped-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/minds/{mind}/scoped-grants": {
"post": {
"operationId": "scopedGrantCreate",
"summary": "scoped grant create",
"x-required-role": "operator",
"tags": [
"scoped-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"
},
"201": {
"description": "Created"
}
},
"parameters": [
{
"name": "mind",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"description": "mind"
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
}
}
},
"/api/v1/scoped-grants/{id}": {
"delete": {
"operationId": "scopedGrantRevoke",
"summary": "scoped grant revoke",
"x-required-role": "operator",
"tags": [
"scoped-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": "No Content"
}
},
"parameters": [
{
"name": "id",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"description": "identifier"
}
]
}
},
"/api/v1/minds/{mind}/wants": {
"get": {
"operationId": "wantsList",
"summary": "wants list",
"x-required-role": "observer",
"tags": [
"wants"
],
"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"
}
]
}
},
"/api/v1/minds/{mind}/wants/{id}": {
"get": {
"operationId": "wantGet",
"summary": "want get",
"x-required-role": "observer",
"tags": [
"wants"
],
"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"
},
{
"name": "id",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"description": "identifier"
}
]
}
},
"/api/v1/minds/{mind}/want-conflicts": {
"get": {
"operationId": "wantConflictsList",
"summary": "want conflicts list",
"x-required-role": "observer",
"tags": [
"want-conflicts"
],
"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"
}
]
}
},
"/api/v1/minds/{mind}/commitments": {
"get": {
"operationId": "commitmentsList",
"summary": "commitments list",
"x-required-role": "observer",
"tags": [
"commitments"
],
"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"
}
]
},
"post": {
"operationId": "commitmentCreate",
"summary": "commitment create",
"x-required-role": "operator",
"tags": [
"commitments"
],
"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"
}
},
"parameters": [
{
"name": "mind",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"description": "mind"
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
}
}
},
"/api/v1/minds/{mind}/commitments/{id}/close": {
"post": {
"operationId": "commitmentClose",
"summary": "commitment close",
"x-required-role": "operator",
"tags": [
"close"
],
"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"
}
},
"parameters": [
{
"name": "mind",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"description": "mind"
},
{
"name": "id",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"description": "identifier"
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
}
}
},
"/api/v1/minds/{mind}/intentions": {
"get": {
"operationId": "intentionsList",
"summary": "intentions list",
"x-required-role": "observer",
"tags": [
"intentions"
],
"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"
}
]
}
},
"/api/v1/minds/{mind}/intentions/{id}": {
"get": {
"operationId": "intentionGet",
"summary": "intention get",
"x-required-role": "observer",
"tags": [
"intentions"
],
"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"
},
{
"name": "id",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"description": "identifier"
}
]
}
},
"/api/v1/minds/{mind}/intentions/{id}/abandon": {
"post": {
"operationId": "intentionAbandon",
"summary": "intention abandon",
"x-required-role": "operator",
"tags": [
"abandon"
],
"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"
}
},
"parameters": [
{
"name": "mind",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"description": "mind"
},
{
"name": "id",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"description": "identifier"
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
}
}
},
"/api/v1/minds/{mind}/decisions": {
"get": {
"operationId": "decisionsList",
"summary": "decisions list",
"x-required-role": "observer",
"tags": [
"decisions"
],
"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"
}
]
}
},
"/api/v1/minds/{mind}/plans": {
"get": {
"operationId": "plansList",
"summary": "plans list",
"x-required-role": "observer",
"tags": [
"plans"
],
"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"
}
]
}
},
"/api/v1/minds/{mind}/plans/{id}": {
"get": {
"operationId": "planGet",
"summary": "plan get",
"x-required-role": "observer",
"tags": [
"plans"
],
"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"
},
{
"name": "id",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"description": "identifier"
}
]
}
},
"/api/v1/minds/{mind}/plans/{id}/cancel": {
"post": {
"operationId": "planCancel",
"summary": "plan cancel",
"x-required-role": "operator",
"tags": [
"cancel"
],
"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"
}
},
"parameters": [
{
"name": "mind",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"description": "mind"
},
{
"name": "id",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"description": "identifier"
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
}
}
},
"/api/v1/minds/{mind}/plans/{id}/steps/{step}/retry": {
"post": {
"operationId": "planStepRetry",
"summary": "plan step retry",
"x-required-role": "operator",
"tags": [
"retry"
],
"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"
}
},
"parameters": [
{
"name": "mind",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"description": "mind"
},
{
"name": "id",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"description": "identifier"
},
{
"name": "step",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"description": "step"
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
}
}
},
"/api/v1/minds/{mind}/why": {
"get": {
"operationId": "why",
"summary": "why",
"x-required-role": "observer",
"tags": [
"why"
],
"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"
}
]
}
},
"/api/v1/minds/{mind}/events/{id}/attribution": {
"get": {
"operationId": "attribution",
"summary": "attribution",
"x-required-role": "observer",
"tags": [
"attribution"
],
"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"
},
{
"name": "id",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"description": "identifier"
}
]
}
},
"/api/v1/minds/{mind}/agency/timeline": {
"get": {
"operationId": "agencyTimeline",
"summary": "agency timeline",
"x-required-role": "observer",
"tags": [
"agency"
],
"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"
}
]
}
},
"/api/v1/research/measures": {
"get": {
"operationId": "researchMeasures",
"summary": "research measures",
"x-required-role": "observer",
"tags": [
"measures"
],
"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/minds/{mind}/research/agency": {
"get": {
"operationId": "researchAgency",
"summary": "research agency",
"x-required-role": "observer",
"tags": [
"agency"
],
"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"
}
]
}
},
"/api/v1/minds/{mind}/research/calibration": {
"get": {
"operationId": "researchCalibration",
"summary": "research calibration",
"x-required-role": "observer",
"tags": [
"calibration"
],
"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"
}
]
}
},
"/api/v1/minds/{mind}/research/measurements": {
"get": {
"operationId": "researchMeasurements",
"summary": "research measurements",
"x-required-role": "observer",
"tags": [
"measurements"
],
"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"
}
]
}
}
}
}