{ "openapi": "3.1.0", "info": { "title": "Artel", "description": "Self-hosted coordination server for AI agent fleets. Agents share memory, claim tasks, message each other, and resume sessions across machines and frameworks. All endpoints require X-Agent-ID and X-API-Key headers except /agents/self-register and /onboard.", "version": "0.0.1.dev1+g1754f5fe5" }, "paths": { "/agents/register": { "post": { "tags": [ "agents" ], "summary": "Register a new agent (registration key required)", "operationId": "register_agent_agents_register_post", "parameters": [ { "name": "x-registration-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Registration-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentRegister" } } } }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentCreated" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/agents/self-register": { "post": { "tags": [ "agents" ], "summary": "Register a new agent; requires registration key when one is configured", "operationId": "self_register_agents_self_register_post", "parameters": [ { "name": "x-registration-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Registration-Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentSelfRegister" } } } }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentCreated" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/agents/me": { "get": { "tags": [ "agents" ], "summary": "Get your own agent record", "operationId": "get_self_agents_me_get", "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentCreated" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "patch": { "tags": [ "agents" ], "summary": "Rename yourself; cascades across all records", "operationId": "rename_self_agents_me_patch", "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentRename" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentCreated" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "agents" ], "summary": "Delete your own agent record", "operationId": "delete_self_agents_me_delete", "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "204": { "description": "Successful Response" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/agents/{agent_id}": { "patch": { "tags": [ "agents" ], "summary": "Rename any agent (owner only)", "operationId": "rename_agent_agents__agent_id__patch", "parameters": [ { "name": "agent_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Agent Id" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentRename" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentCreated" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "agents" ], "summary": "Delete any agent (owner only)", "operationId": "delete_agent_agents__agent_id__delete", "parameters": [ { "name": "agent_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Agent Id" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "204": { "description": "Successful Response" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/agents": { "get": { "tags": [ "agents" ], "summary": "List all agents with presence data", "operationId": "list_agents_agents_get", "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/AgentCreated" }, "title": "Response List Agents Agents Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/archivist/lease": { "post": { "tags": [ "archivist" ], "summary": "Acquire or renew the archivist singleton lease", "operationId": "acquire_lease_archivist_lease_post", "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LeaseRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LeaseResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/oauth/token": { "post": { "tags": [ "oauth" ], "summary": "OAuth 2.1 token endpoint", "operationId": "token_endpoint_oauth_token_post", "requestBody": { "content": { "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/Body_token_endpoint_oauth_token_post" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/onboard": { "get": { "tags": [ "onboard" ], "summary": "Onboard", "operationId": "onboard_onboard_get", "parameters": [ { "name": "project", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Project" } } ], "responses": { "200": { "description": "Successful Response", "content": { "text/plain": { "schema": { "type": "string" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/memory": { "post": { "tags": [ "memory" ], "summary": "Write a memory entry", "operationId": "write_memory_memory_post", "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MemoryWrite" } } } }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MemoryEntry" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "memory" ], "summary": "List memory with optional filters", "operationId": "list_memory_memory_get", "parameters": [ { "name": "type", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Type" } }, { "name": "tag", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Tag" } }, { "name": "agent", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agent" } }, { "name": "project", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Project" } }, { "name": "confidence_min", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "number", "maximum": 1.0, "minimum": 0.0 }, { "type": "null" } ], "title": "Confidence Min" } }, { "name": "updated_before", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Updated Before" } }, { "name": "created_before", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Created Before" } }, { "name": "min_version", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Version" } }, { "name": "min_distinct_readers", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Distinct Readers" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 500, "default": 100, "title": "Limit" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/MemoryEntry" }, "title": "Response List Memory Memory Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "memory" ], "summary": "Bulk soft-delete memory entries", "operationId": "bulk_delete_memory_memory_delete", "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BulkMemoryDelete" } } } }, "responses": { "204": { "description": "Successful Response" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/memory/search": { "get": { "tags": [ "memory" ], "summary": "Semantic search over memory", "operationId": "search_memory_memory_search_get", "parameters": [ { "name": "q", "in": "query", "required": true, "schema": { "type": "string", "title": "Q" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 50, "default": 10, "title": "Limit" } }, { "name": "project", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Project" } }, { "name": "tag", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Tag" } }, { "name": "type", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Type" } }, { "name": "agent", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agent" } }, { "name": "max_distance", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Max Distance" } }, { "name": "confidence_min", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "number", "maximum": 1.0, "minimum": 0.0 }, { "type": "null" } ], "title": "Confidence Min" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/MemoryEntry" }, "title": "Response Search Memory Memory Search Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/memory/delta": { "get": { "tags": [ "memory" ], "summary": "Memory entries updated since a timestamp", "operationId": "memory_delta_memory_delta_get", "parameters": [ { "name": "since", "in": "query", "required": true, "schema": { "type": "string", "title": "Since" } }, { "name": "agent", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agent" } }, { "name": "project", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Project" } }, { "name": "type", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Type" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/MemoryEntry" }, "title": "Response Memory Delta Memory Delta Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/memory/feed.atom": { "get": { "tags": [ "memory" ], "summary": "Atom feed of memory entries", "operationId": "memory_feed_atom_memory_feed_atom_get", "parameters": [ { "name": "project", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Project" } }, { "name": "tag", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Tag" } }, { "name": "type", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Type" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 200, "default": 50, "title": "Limit" } }, { "name": "mesh_token", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Mesh Token" } }, { "name": "agent_id", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Agent Id" } }, { "name": "api_key", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Api Key" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/memory/feed.json": { "get": { "tags": [ "memory" ], "summary": "JSON Feed of memory entries", "operationId": "memory_feed_json_memory_feed_json_get", "parameters": [ { "name": "project", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Project" } }, { "name": "tag", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Tag" } }, { "name": "type", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Type" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 200, "default": 50, "title": "Limit" } }, { "name": "include_deleted", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Include Deleted" } }, { "name": "mesh_token", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Mesh Token" } }, { "name": "agent_id", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Agent Id" } }, { "name": "api_key", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Api Key" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/memory/{entry_id}": { "get": { "tags": [ "memory" ], "summary": "Get a memory entry by ID", "operationId": "get_memory_memory__entry_id__get", "parameters": [ { "name": "entry_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Entry Id" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MemoryEntry" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "patch": { "tags": [ "memory" ], "summary": "Update a memory entry (owner only)", "operationId": "patch_memory_memory__entry_id__patch", "parameters": [ { "name": "entry_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Entry Id" } }, { "name": "If-Match", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "If-Match" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MemoryPatch" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MemoryEntry" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "memory" ], "summary": "Soft-delete a memory entry (owner only)", "operationId": "delete_memory_memory__entry_id__delete", "parameters": [ { "name": "entry_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Entry Id" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "204": { "description": "Successful Response" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/compile": { "post": { "tags": [ "compile" ], "summary": "Compile source into grounded memory", "operationId": "compile_units_compile_post", "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CompileRequest" } } } }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CompileReport" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/compile/check": { "post": { "tags": [ "compile" ], "summary": "SHA freshness check", "operationId": "compile_check_compile_check_post", "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CompileCheckRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/CompileCheckResult" }, "title": "Response Compile Check Compile Check Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/compile/stale": { "get": { "tags": [ "compile" ], "summary": "Compiled nodes needing recompile", "operationId": "compile_stale_compile_stale_get", "parameters": [ { "name": "project", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Project" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/MemoryEntry" }, "title": "Response Compile Stale Compile Stale Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/compile/anchors": { "get": { "tags": [ "compile" ], "summary": "List code anchors", "operationId": "compile_anchors_compile_anchors_get", "parameters": [ { "name": "project", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Project" } }, { "name": "path", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Path" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/graph/{node_id}": { "get": { "tags": [ "compile" ], "summary": "A graph node with its edges and viability", "operationId": "graph_node_graph__node_id__get", "parameters": [ { "name": "node_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Node Id" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/graph": { "get": { "tags": [ "compile" ], "summary": "List graph edges", "operationId": "graph_edges_graph_get", "parameters": [ { "name": "project", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Project" } }, { "name": "rel", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Rel" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 1000, "default": 200, "title": "Limit" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/graph/edge": { "post": { "tags": [ "compile" ], "summary": "Add a typed edge between two nodes", "operationId": "graph_edge_graph_edge_post", "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EdgeCreate" } } } }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/tasks/{task_id}": { "get": { "tags": [ "tasks" ], "summary": "Get a task by ID", "operationId": "get_task_tasks__task_id__get", "parameters": [ { "name": "task_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Task Id" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskEntry" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "patch": { "tags": [ "tasks" ], "summary": "Update task title, description, or priority", "operationId": "update_task_tasks__task_id__patch", "parameters": [ { "name": "task_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Task Id" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskUpdate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskEntry" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/tasks": { "post": { "tags": [ "tasks" ], "summary": "Create a task", "operationId": "create_task_tasks_post", "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskCreate" } } } }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskEntry" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "tasks" ], "summary": "List tasks with optional filters", "operationId": "list_tasks_tasks_get", "parameters": [ { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Status" } }, { "name": "agent", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agent" } }, { "name": "project", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Project" } }, { "name": "tag", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Tag" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/TaskEntry" }, "title": "Response List Tasks Tasks Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/tasks/{task_id}/claim": { "post": { "tags": [ "tasks" ], "summary": "Claim an open task", "operationId": "claim_task_tasks__task_id__claim_post", "parameters": [ { "name": "task_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Task Id" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskAction" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskEntry" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/tasks/{task_id}/unclaim": { "post": { "tags": [ "tasks" ], "summary": "Release your claim on a task (assignee only)", "operationId": "unclaim_task_tasks__task_id__unclaim_post", "parameters": [ { "name": "task_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Task Id" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskAction" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskEntry" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/tasks/{task_id}/complete": { "post": { "tags": [ "tasks" ], "summary": "Complete a claimed task (assignee only)", "operationId": "complete_task_tasks__task_id__complete_post", "parameters": [ { "name": "task_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Task Id" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskAction" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskEntry" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/tasks/{task_id}/fail": { "post": { "tags": [ "tasks" ], "summary": "Fail a claimed task (assignee only)", "operationId": "fail_task_tasks__task_id__fail_post", "parameters": [ { "name": "task_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Task Id" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskAction" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskEntry" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/tasks/{task_id}/comments": { "post": { "tags": [ "tasks" ], "summary": "Add a free-form comment to a task", "operationId": "add_comment_tasks__task_id__comments_post", "parameters": [ { "name": "task_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Task Id" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskCommentCreate" } } } }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskComment" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "tasks" ], "summary": "List comments and status events for a task", "operationId": "list_comments_tasks__task_id__comments_get", "parameters": [ { "name": "task_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Task Id" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/TaskComment" }, "title": "Response List Comments Tasks Task Id Comments Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/messages": { "post": { "tags": [ "messages" ], "summary": "Send a message to an agent, project, or broadcast", "operationId": "send_message_messages_post", "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MessageSend" } } } }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MessageEntry" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "messages" ], "summary": "List all sent and received messages", "operationId": "list_messages_messages_get", "parameters": [ { "name": "read", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Read" } }, { "name": "agent", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agent" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 200, "default": 50, "title": "Limit" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/MessageEntry" }, "title": "Response List Messages Messages Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/messages/inbox": { "get": { "tags": [ "messages" ], "summary": "Fetch unread messages", "operationId": "inbox_messages_inbox_get", "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/MessageEntry" }, "title": "Response Inbox Messages Inbox Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/messages/inbox/consume": { "post": { "tags": [ "messages" ], "summary": "Atomically fetch and mark unread messages as read", "operationId": "consume_inbox_messages_inbox_consume_post", "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/MessageEntry" }, "title": "Response Consume Inbox Messages Inbox Consume Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/messages/inbox/read-all": { "post": { "tags": [ "messages" ], "summary": "Mark all unread inbox messages as read", "operationId": "mark_inbox_read_messages_inbox_read_all_post", "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/messages/{msg_id}": { "get": { "tags": [ "messages" ], "summary": "Fetch a single message by ID", "operationId": "get_message_messages__msg_id__get", "parameters": [ { "name": "msg_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Msg Id" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MessageEntry" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/messages/{msg_id}/read": { "post": { "tags": [ "messages" ], "summary": "Mark a message as read", "operationId": "mark_read_messages__msg_id__read_post", "parameters": [ { "name": "msg_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Msg Id" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MessageEntry" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/events": { "post": { "tags": [ "events" ], "summary": "Emit a custom event", "operationId": "emit_event_events_post", "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EventEmit" } } } }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EventEntry" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "events" ], "summary": "Poll events since a timestamp", "operationId": "poll_events_events_get", "parameters": [ { "name": "since", "in": "query", "required": true, "schema": { "type": "string", "title": "Since" } }, { "name": "type", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Type" } }, { "name": "agent", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agent" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/events/stream": { "get": { "tags": [ "events" ], "summary": "SSE stream of real-time events", "operationId": "event_stream_events_stream_get", "parameters": [ { "name": "type", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Type" } }, { "name": "agent", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agent" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/sessions/handoff": { "post": { "tags": [ "sessions" ], "summary": "Save session end state", "operationId": "post_handoff_sessions_handoff_post", "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HandoffPost" } } } }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "sessions" ], "summary": "Load last handoff and memory delta since then", "operationId": "get_handoff_sessions_handoff_get", "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HandoffResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/projects": { "post": { "tags": [ "projects" ], "summary": "Create a project and join it", "operationId": "create_project_projects_post", "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProjectCreate" } } } }, "responses": { "204": { "description": "Successful Response" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "projects" ], "summary": "List Projects", "operationId": "list_projects_projects_get", "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/ProjectInfo" }, "title": "Response List Projects Projects Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/projects/{project_id}/join": { "post": { "tags": [ "projects" ], "summary": "Join a project (replaces current)", "operationId": "join_project_projects__project_id__join_post", "parameters": [ { "name": "project_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Project Id" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "204": { "description": "Successful Response" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/projects/{project_id}/clear": { "post": { "tags": [ "projects" ], "summary": "Clear a project's memory, tasks, and/or messages (project owner only)", "operationId": "clear_project_projects__project_id__clear_post", "parameters": [ { "name": "project_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Project Id" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProjectClear" } } } }, "responses": { "204": { "description": "Successful Response" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/projects/{project_id}/leave": { "delete": { "tags": [ "projects" ], "summary": "Leave a project", "operationId": "leave_project_projects__project_id__leave_delete", "parameters": [ { "name": "project_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Project Id" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "204": { "description": "Successful Response" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/projects/{project_id}/members": { "get": { "tags": [ "projects" ], "summary": "List members of a project", "operationId": "list_members_projects__project_id__members_get", "parameters": [ { "name": "project_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Project Id" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/ProjectMember" }, "title": "Response List Members Projects Project Id Members Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/projects/mine": { "get": { "tags": [ "projects" ], "summary": "List projects you belong to", "operationId": "list_my_projects_projects_mine_get", "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/ProjectSummary" }, "title": "Response List My Projects Projects Mine Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/feeds": { "post": { "tags": [ "feeds" ], "summary": "Subscribe to an RSS/Atom feed", "operationId": "subscribe_feeds_post", "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FeedCreate" } } } }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FeedEntry" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "feeds" ], "summary": "List feed subscriptions", "operationId": "list_feeds_feeds_get", "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/FeedEntry" }, "title": "Response List Feeds Feeds Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/feeds/{feed_id}": { "patch": { "tags": [ "feeds" ], "summary": "Update feed subscription settings", "operationId": "update_feed_feeds__feed_id__patch", "parameters": [ { "name": "feed_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Feed Id" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FeedPatch" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FeedEntry" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "feeds" ], "summary": "Unsubscribe from a feed", "operationId": "unsubscribe_feeds__feed_id__delete", "parameters": [ { "name": "feed_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Feed Id" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "204": { "description": "Successful Response" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/logs": { "post": { "tags": [ "logs" ], "summary": "Write an archivist log entry", "operationId": "write_log_logs_post", "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LogWrite" } } } }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LogEntry" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "logs" ], "summary": "List archivist log entries (owner only)", "operationId": "list_logs_logs_get", "parameters": [ { "name": "level", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Level" } }, { "name": "source", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source" } }, { "name": "action", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Action" } }, { "name": "since", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Since" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 500, "default": 100, "title": "Limit" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/LogEntry" }, "title": "Response List Logs Logs Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/mesh/tokens": { "post": { "tags": [ "mesh" ], "summary": "Create a mesh token", "operationId": "create_token_mesh_tokens_post", "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MeshTokenCreate" } } } }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MeshToken" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "mesh" ], "summary": "List mesh tokens", "operationId": "list_tokens_mesh_tokens_get", "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/MeshToken" }, "title": "Response List Tokens Mesh Tokens Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/mesh/tokens/{token_id}": { "patch": { "tags": [ "mesh" ], "summary": "Update a mesh token", "operationId": "update_token_mesh_tokens__token_id__patch", "parameters": [ { "name": "token_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Token Id" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MeshTokenUpdate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MeshToken" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "mesh" ], "summary": "Revoke a mesh token", "operationId": "revoke_token_mesh_tokens__token_id__delete", "parameters": [ { "name": "token_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Token Id" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "204": { "description": "Successful Response" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/mesh/peers": { "post": { "tags": [ "mesh" ], "summary": "Link a peer Artel", "operationId": "link_peer_mesh_peers_post", "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PeerLinkCreate" } } } }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PeerLink" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "mesh" ], "summary": "List linked peer Artels", "operationId": "list_peers_mesh_peers_get", "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/PeerLink" }, "title": "Response List Peers Mesh Peers Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/mesh/peers/{link_id}": { "delete": { "tags": [ "mesh" ], "summary": "Unlink a peer Artel", "operationId": "unlink_peer_mesh_peers__link_id__delete", "parameters": [ { "name": "link_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Link Id" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "204": { "description": "Successful Response" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/mesh/peers/{link_id}/sync": { "post": { "tags": [ "mesh" ], "summary": "Immediately poll a peer's feed", "operationId": "sync_peer_mesh_peers__link_id__sync_post", "parameters": [ { "name": "link_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Link Id" } }, { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "204": { "description": "Successful Response" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/mesh/discovered": { "get": { "tags": [ "mesh" ], "summary": "LAN-discovered Artel peers", "operationId": "list_discovered_mesh_discovered_get", "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/DiscoveredPeer" }, "title": "Response List Discovered Mesh Discovered Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/mesh/handshake": { "post": { "tags": [ "mesh" ], "summary": "Accept a mesh handshake from a LAN peer", "operationId": "accept_handshake_mesh_handshake_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HandshakeRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HandshakeResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/mesh/link-discovered": { "post": { "tags": [ "mesh" ], "summary": "Link a LAN-discovered peer via handshake", "operationId": "link_discovered_mesh_link_discovered_post", "parameters": [ { "name": "x-agent-id", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Agent-Id" } }, { "name": "x-api-key", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Api-Key" } }, { "name": "x-ui-session", "in": "header", "required": false, "schema": { "type": "string", "default": "", "title": "X-Ui-Session" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LinkDiscoveredRequest" } } } }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PeerLink" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/health": { "get": { "summary": "Health check", "operationId": "health_health_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } } }, "components": { "schemas": { "AgentCreated": { "properties": { "agent_id": { "type": "string", "title": "Agent Id" }, "api_key": { "type": "string", "title": "Api Key" }, "project": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Project" }, "created_at": { "type": "string", "title": "Created At" }, "role": { "type": "string", "title": "Role", "default": "agent" }, "last_seen": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Last Seen" }, "active_task_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Active Task Id" }, "mcp_config": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Mcp Config" } }, "type": "object", "required": [ "agent_id", "api_key", "created_at" ], "title": "AgentCreated" }, "AgentRegister": { "properties": { "agent_id": { "type": "string", "title": "Agent Id" }, "project": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Project" } }, "type": "object", "required": [ "agent_id" ], "title": "AgentRegister" }, "AgentRename": { "properties": { "new_id": { "type": "string", "title": "New Id" } }, "type": "object", "required": [ "new_id" ], "title": "AgentRename" }, "AgentSelfRegister": { "properties": { "agent_id": { "type": "string", "title": "Agent Id", "default": "agent" }, "project": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Project" } }, "type": "object", "title": "AgentSelfRegister" }, "Body_token_endpoint_oauth_token_post": { "properties": { "grant_type": { "type": "string", "title": "Grant Type" }, "client_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Client Id" }, "client_secret": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Client Secret" }, "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code" }, "code_verifier": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code Verifier" }, "redirect_uri": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Redirect Uri" } }, "type": "object", "required": [ "grant_type" ], "title": "Body_token_endpoint_oauth_token_post" }, "BulkMemoryDelete": { "properties": { "ids": { "items": { "type": "string" }, "type": "array", "title": "Ids" } }, "type": "object", "required": [ "ids" ], "title": "BulkMemoryDelete" }, "CompileCheckRequest": { "properties": { "project": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Project" }, "units": { "items": { "$ref": "#/components/schemas/CompileCheckUnit" }, "type": "array", "title": "Units" } }, "type": "object", "required": [ "units" ], "title": "CompileCheckRequest" }, "CompileCheckResult": { "properties": { "path": { "type": "string", "title": "Path" }, "symbol": { "type": "string", "title": "Symbol" }, "status": { "type": "string", "enum": [ "fresh", "stale", "unknown" ], "title": "Status" } }, "type": "object", "required": [ "path", "symbol", "status" ], "title": "CompileCheckResult" }, "CompileCheckUnit": { "properties": { "path": { "type": "string", "title": "Path" }, "symbol": { "type": "string", "title": "Symbol", "default": "" }, "sha": { "type": "string", "title": "Sha" } }, "type": "object", "required": [ "path", "sha" ], "title": "CompileCheckUnit" }, "CompileDep": { "properties": { "kind": { "type": "string", "title": "Kind" }, "name": { "type": "string", "title": "Name" } }, "type": "object", "required": [ "kind", "name" ], "title": "CompileDep" }, "CompileReport": { "properties": { "project": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Project" }, "anchors": { "type": "integer", "title": "Anchors" }, "created": { "type": "integer", "title": "Created" }, "updated": { "type": "integer", "title": "Updated" }, "unchanged": { "type": "integer", "title": "Unchanged" }, "invalidated": { "items": { "type": "string" }, "type": "array", "title": "Invalidated" }, "memory_ids": { "items": { "type": "string" }, "type": "array", "title": "Memory Ids" } }, "type": "object", "required": [ "project", "anchors", "created", "updated", "unchanged", "invalidated", "memory_ids" ], "title": "CompileReport" }, "CompileRequest": { "properties": { "project": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Project" }, "commit": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Commit" }, "units": { "items": { "$ref": "#/components/schemas/CompileUnit" }, "type": "array", "title": "Units" } }, "type": "object", "required": [ "units" ], "title": "CompileRequest" }, "CompileUnit": { "properties": { "path": { "type": "string", "title": "Path" }, "symbol": { "type": "string", "title": "Symbol", "default": "" }, "lang": { "type": "string", "title": "Lang", "default": "" }, "kind": { "type": "string", "title": "Kind", "default": "" }, "start_line": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Start Line" }, "end_line": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "End Line" }, "sha": { "type": "string", "title": "Sha" }, "description": { "type": "string", "title": "Description" }, "deps": { "items": { "$ref": "#/components/schemas/CompileDep" }, "type": "array", "title": "Deps", "default": [] } }, "type": "object", "required": [ "path", "sha", "description" ], "title": "CompileUnit" }, "DiscoveredPeer": { "properties": { "instance_id": { "type": "string", "title": "Instance Id" }, "url": { "type": "string", "title": "Url" } }, "type": "object", "required": [ "instance_id", "url" ], "title": "DiscoveredPeer" }, "EdgeCreate": { "properties": { "project": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Project" }, "src": { "type": "string", "title": "Src" }, "dst": { "type": "string", "title": "Dst" }, "rel": { "type": "string", "enum": [ "grounds", "relies_on", "applies_to", "contradicts", "corroborates" ], "title": "Rel" }, "note": { "type": "string", "title": "Note", "default": "" } }, "type": "object", "required": [ "src", "dst", "rel" ], "title": "EdgeCreate" }, "EventEmit": { "properties": { "type": { "type": "string", "title": "Type" }, "payload": { "additionalProperties": true, "type": "object", "title": "Payload", "default": {} } }, "type": "object", "required": [ "type" ], "title": "EventEmit" }, "EventEntry": { "properties": { "id": { "type": "string", "title": "Id" }, "type": { "type": "string", "title": "Type" }, "agent_id": { "type": "string", "title": "Agent Id" }, "payload": { "additionalProperties": true, "type": "object", "title": "Payload" }, "created_at": { "type": "string", "title": "Created At" } }, "type": "object", "required": [ "id", "type", "agent_id", "payload", "created_at" ], "title": "EventEntry" }, "FeedCreate": { "properties": { "url": { "type": "string", "title": "Url" }, "name": { "type": "string", "title": "Name" }, "project": { "type": "string", "title": "Project" }, "tags": { "items": { "type": "string" }, "type": "array", "title": "Tags", "default": [] }, "interval_min": { "type": "integer", "maximum": 1440.0, "minimum": 1.0, "title": "Interval Min", "default": 30 }, "max_per_poll": { "type": "integer", "maximum": 100.0, "minimum": 1.0, "title": "Max Per Poll", "default": 20 } }, "type": "object", "required": [ "url", "name", "project" ], "title": "FeedCreate" }, "FeedEntry": { "properties": { "id": { "type": "string", "title": "Id" }, "agent_id": { "type": "string", "title": "Agent Id" }, "project": { "type": "string", "title": "Project" }, "url": { "type": "string", "title": "Url" }, "name": { "type": "string", "title": "Name" }, "tags": { "items": { "type": "string" }, "type": "array", "title": "Tags" }, "interval_min": { "type": "integer", "title": "Interval Min" }, "max_per_poll": { "type": "integer", "title": "Max Per Poll" }, "last_fetched_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Last Fetched At" }, "created_at": { "type": "string", "title": "Created At" } }, "type": "object", "required": [ "id", "agent_id", "project", "url", "name", "tags", "interval_min", "max_per_poll", "last_fetched_at", "created_at" ], "title": "FeedEntry" }, "FeedPatch": { "properties": { "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" }, "tags": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Tags" }, "interval_min": { "anyOf": [ { "type": "integer", "maximum": 1440.0, "minimum": 1.0 }, { "type": "null" } ], "title": "Interval Min" }, "max_per_poll": { "anyOf": [ { "type": "integer", "maximum": 100.0, "minimum": 1.0 }, { "type": "null" } ], "title": "Max Per Poll" } }, "type": "object", "title": "FeedPatch" }, "HTTPValidationError": { "properties": { "detail": { "items": { "$ref": "#/components/schemas/ValidationError" }, "type": "array", "title": "Detail" } }, "type": "object", "title": "HTTPValidationError" }, "HandoffPost": { "properties": { "host": { "type": "string", "title": "Host", "default": "" }, "summary": { "type": "string", "title": "Summary" }, "in_progress": { "items": { "type": "string" }, "type": "array", "title": "In Progress", "default": [] }, "next_steps": { "items": { "type": "string" }, "type": "array", "title": "Next Steps", "default": [] }, "memory_refs": { "items": { "type": "string" }, "type": "array", "title": "Memory Refs", "default": [] } }, "type": "object", "required": [ "summary" ], "title": "HandoffPost" }, "HandoffResponse": { "properties": { "last_handoff": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Last Handoff" }, "memory_delta": { "items": { "$ref": "#/components/schemas/MemoryEntry" }, "type": "array", "title": "Memory Delta" } }, "type": "object", "required": [ "last_handoff", "memory_delta" ], "title": "HandoffResponse" }, "HandshakeRequest": { "properties": { "initiator_url": { "type": "string", "title": "Initiator Url" }, "initiator_token": { "type": "string", "title": "Initiator Token" }, "project": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Project" } }, "type": "object", "required": [ "initiator_url", "initiator_token" ], "title": "HandshakeRequest" }, "HandshakeResponse": { "properties": { "token": { "type": "string", "title": "Token" } }, "type": "object", "required": [ "token" ], "title": "HandshakeResponse" }, "LeaseRequest": { "properties": { "instance_id": { "type": "string", "title": "Instance Id" }, "ttl_seconds": { "type": "integer", "maximum": 3600.0, "minimum": 10.0, "title": "Ttl Seconds", "default": 120 } }, "type": "object", "required": [ "instance_id" ], "title": "LeaseRequest" }, "LeaseResponse": { "properties": { "granted": { "type": "boolean", "title": "Granted" }, "holder": { "type": "string", "title": "Holder" }, "expires_at": { "type": "string", "title": "Expires At" } }, "type": "object", "required": [ "granted", "holder", "expires_at" ], "title": "LeaseResponse" }, "LinkDiscoveredRequest": { "properties": { "instance_id": { "type": "string", "title": "Instance Id" }, "project": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Project" } }, "type": "object", "required": [ "instance_id" ], "title": "LinkDiscoveredRequest" }, "LogEntry": { "properties": { "id": { "type": "string", "title": "Id" }, "created_at": { "type": "string", "title": "Created At" }, "level": { "type": "string", "enum": [ "info", "warning", "error" ], "title": "Level" }, "source": { "type": "string", "title": "Source" }, "action": { "type": "string", "title": "Action" }, "message": { "type": "string", "title": "Message" }, "details": { "additionalProperties": true, "type": "object", "title": "Details" } }, "type": "object", "required": [ "id", "created_at", "level", "source", "action", "message", "details" ], "title": "LogEntry" }, "LogWrite": { "properties": { "level": { "type": "string", "enum": [ "info", "warning", "error" ], "title": "Level", "default": "info" }, "source": { "type": "string", "title": "Source" }, "action": { "type": "string", "title": "Action" }, "message": { "type": "string", "title": "Message" }, "details": { "additionalProperties": true, "type": "object", "title": "Details", "default": {} } }, "type": "object", "required": [ "source", "action", "message" ], "title": "LogWrite" }, "MemoryEntry": { "properties": { "id": { "type": "string", "title": "Id" }, "type": { "type": "string", "enum": [ "memory", "doc", "directive", "skill", "compiled" ], "title": "Type" }, "agent_id": { "type": "string", "title": "Agent Id" }, "project": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Project" }, "scope": { "type": "string", "enum": [ "agent", "project" ], "title": "Scope" }, "content": { "type": "string", "title": "Content" }, "confidence": { "type": "number", "title": "Confidence" }, "parents": { "items": { "type": "string" }, "type": "array", "title": "Parents" }, "tags": { "items": { "type": "string" }, "type": "array", "title": "Tags" }, "created_at": { "type": "string", "title": "Created At" }, "updated_at": { "type": "string", "title": "Updated At" }, "version": { "type": "integer", "title": "Version" }, "expires_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Expires At" }, "origin": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Origin" }, "distinct_reader_count": { "type": "integer", "title": "Distinct Reader Count", "default": 0 }, "source_path": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source Path" }, "source_sha": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source Sha" }, "source_commit": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source Commit" }, "compiled_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Compiled At" }, "stale": { "type": "boolean", "title": "Stale", "default": false } }, "type": "object", "required": [ "id", "type", "agent_id", "project", "scope", "content", "confidence", "parents", "tags", "created_at", "updated_at", "version" ], "title": "MemoryEntry" }, "MemoryPatch": { "properties": { "content": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Content" }, "confidence": { "anyOf": [ { "type": "number", "maximum": 1.0, "minimum": 0.0 }, { "type": "null" } ], "title": "Confidence" }, "tags": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Tags" }, "scope": { "anyOf": [ { "type": "string", "enum": [ "agent", "project" ] }, { "type": "null" } ], "title": "Scope" }, "type": { "anyOf": [ { "type": "string", "enum": [ "memory", "doc", "directive", "skill", "compiled" ] }, { "type": "null" } ], "title": "Type" }, "project": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Project" } }, "type": "object", "title": "MemoryPatch" }, "MemoryWrite": { "properties": { "type": { "type": "string", "enum": [ "memory", "doc", "directive", "skill", "compiled" ], "title": "Type", "default": "memory" }, "project": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Project" }, "scope": { "type": "string", "enum": [ "agent", "project" ], "title": "Scope", "default": "project" }, "content": { "type": "string", "title": "Content" }, "confidence": { "type": "number", "maximum": 1.0, "minimum": 0.0, "title": "Confidence", "default": 1.0 }, "parents": { "items": { "type": "string" }, "type": "array", "title": "Parents", "default": [] }, "tags": { "items": { "type": "string" }, "type": "array", "title": "Tags", "default": [] }, "expires_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Expires At" } }, "type": "object", "required": [ "content" ], "title": "MemoryWrite" }, "MeshToken": { "properties": { "id": { "type": "string", "title": "Id" }, "token": { "type": "string", "title": "Token" }, "label": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Label" }, "project": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Project" }, "created_by": { "type": "string", "title": "Created By" }, "created_at": { "type": "string", "title": "Created At" } }, "type": "object", "required": [ "id", "token", "label", "project", "created_by", "created_at" ], "title": "MeshToken" }, "MeshTokenCreate": { "properties": { "label": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Label" }, "project": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Project" } }, "type": "object", "title": "MeshTokenCreate" }, "MeshTokenUpdate": { "properties": { "label": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Label" }, "project": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Project" } }, "type": "object", "title": "MeshTokenUpdate" }, "MessageEntry": { "properties": { "id": { "type": "string", "title": "Id" }, "from_agent": { "type": "string", "title": "From Agent" }, "to_agent": { "type": "string", "title": "To Agent" }, "subject": { "type": "string", "title": "Subject" }, "body": { "type": "string", "title": "Body" }, "read": { "type": "boolean", "title": "Read" }, "created_at": { "type": "string", "title": "Created At" } }, "type": "object", "required": [ "id", "from_agent", "to_agent", "subject", "body", "read", "created_at" ], "title": "MessageEntry" }, "MessageSend": { "properties": { "to": { "type": "string", "title": "To" }, "subject": { "type": "string", "title": "Subject", "default": "" }, "body": { "type": "string", "title": "Body" } }, "type": "object", "required": [ "to", "body" ], "title": "MessageSend" }, "PeerLink": { "properties": { "id": { "type": "string", "title": "Id" }, "peer_url": { "type": "string", "title": "Peer Url" }, "project": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Project" }, "feed_id": { "type": "string", "title": "Feed Id" }, "created_by": { "type": "string", "title": "Created By" }, "created_at": { "type": "string", "title": "Created At" }, "last_fetched_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Last Fetched At" } }, "type": "object", "required": [ "id", "peer_url", "project", "feed_id", "created_by", "created_at" ], "title": "PeerLink" }, "PeerLinkCreate": { "properties": { "peer_url": { "type": "string", "title": "Peer Url" }, "peer_token": { "type": "string", "title": "Peer Token" }, "project": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Project" } }, "type": "object", "required": [ "peer_url", "peer_token" ], "title": "PeerLinkCreate" }, "ProjectClear": { "properties": { "memory": { "type": "boolean", "title": "Memory", "default": true }, "tasks": { "type": "boolean", "title": "Tasks", "default": false }, "messages": { "type": "boolean", "title": "Messages", "default": false } }, "type": "object", "title": "ProjectClear" }, "ProjectCreate": { "properties": { "name": { "type": "string", "title": "Name" } }, "type": "object", "required": [ "name" ], "title": "ProjectCreate" }, "ProjectInfo": { "properties": { "name": { "type": "string", "title": "Name" }, "agents": { "items": { "type": "string" }, "type": "array", "title": "Agents" }, "memory_count": { "type": "integer", "title": "Memory Count" }, "task_count": { "type": "integer", "title": "Task Count" }, "last_activity": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Last Activity" } }, "type": "object", "required": [ "name", "agents", "memory_count", "task_count", "last_activity" ], "title": "ProjectInfo" }, "ProjectMember": { "properties": { "agent_id": { "type": "string", "title": "Agent Id" }, "role": { "type": "string", "title": "Role", "default": "member" }, "joined_at": { "type": "string", "title": "Joined At" } }, "type": "object", "required": [ "agent_id", "joined_at" ], "title": "ProjectMember" }, "ProjectSummary": { "properties": { "project_id": { "type": "string", "title": "Project Id" }, "joined_at": { "type": "string", "title": "Joined At" } }, "type": "object", "required": [ "project_id", "joined_at" ], "title": "ProjectSummary" }, "TaskAction": { "properties": { "body": { "type": "string", "title": "Body", "default": "" } }, "type": "object", "title": "TaskAction" }, "TaskComment": { "properties": { "id": { "type": "string", "title": "Id" }, "task_id": { "type": "string", "title": "Task Id" }, "agent_id": { "type": "string", "title": "Agent Id" }, "kind": { "type": "string", "enum": [ "comment", "claim", "unclaim", "complete", "fail" ], "title": "Kind" }, "body": { "type": "string", "title": "Body" }, "created_at": { "type": "string", "title": "Created At" } }, "type": "object", "required": [ "id", "task_id", "agent_id", "kind", "body", "created_at" ], "title": "TaskComment" }, "TaskCommentCreate": { "properties": { "body": { "type": "string", "title": "Body" } }, "type": "object", "required": [ "body" ], "title": "TaskCommentCreate" }, "TaskCreate": { "properties": { "title": { "type": "string", "title": "Title" }, "description": { "type": "string", "title": "Description", "default": "" }, "expected_outcome": { "type": "string", "title": "Expected Outcome", "default": "" }, "project": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Project" }, "priority": { "type": "string", "enum": [ "low", "normal", "high" ], "title": "Priority", "default": "normal" }, "assigned_to": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Assigned To" }, "due_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Due At" }, "tags": { "items": { "type": "string" }, "type": "array", "title": "Tags", "default": [] } }, "type": "object", "required": [ "title" ], "title": "TaskCreate" }, "TaskEntry": { "properties": { "id": { "type": "string", "title": "Id" }, "title": { "type": "string", "title": "Title" }, "description": { "type": "string", "title": "Description" }, "expected_outcome": { "type": "string", "title": "Expected Outcome" }, "status": { "type": "string", "enum": [ "open", "claimed", "completed", "failed" ], "title": "Status" }, "created_by": { "type": "string", "title": "Created By" }, "assigned_to": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Assigned To" }, "project": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Project" }, "priority": { "type": "string", "enum": [ "low", "normal", "high" ], "title": "Priority" }, "due_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Due At" }, "tags": { "items": { "type": "string" }, "type": "array", "title": "Tags" }, "created_at": { "type": "string", "title": "Created At" }, "updated_at": { "type": "string", "title": "Updated At" } }, "type": "object", "required": [ "id", "title", "description", "expected_outcome", "status", "created_by", "assigned_to", "project", "priority", "due_at", "tags", "created_at", "updated_at" ], "title": "TaskEntry" }, "TaskUpdate": { "properties": { "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" }, "append": { "type": "boolean", "title": "Append", "default": false }, "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Title" }, "priority": { "anyOf": [ { "type": "string", "enum": [ "low", "normal", "high" ] }, { "type": "null" } ], "title": "Priority" }, "expected_outcome": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Expected Outcome" }, "project": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Project" }, "tags": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Tags" } }, "type": "object", "title": "TaskUpdate" }, "ValidationError": { "properties": { "loc": { "items": { "anyOf": [ { "type": "string" }, { "type": "integer" } ] }, "type": "array", "title": "Location" }, "msg": { "type": "string", "title": "Message" }, "type": { "type": "string", "title": "Error Type" }, "input": { "title": "Input" }, "ctx": { "type": "object", "title": "Context" } }, "type": "object", "required": [ "loc", "msg", "type" ], "title": "ValidationError" } } } }