{ "info": { "title": "SynthOrg API", "version": "0.6.1", "x-documentation": { "rfc9457": "## Error Handling (RFC 9457)\n\nAll error responses support content negotiation between two formats:\n\n- **`application/json`** (default): Standard `ApiResponse` envelope with `error`, `error_detail`, and `success` fields\n- **`application/problem+json`**: Bare RFC 9457 Problem Detail body -- send `Accept: application/problem+json`\n\nEvery error includes machine-readable metadata: `error_code` (4-digit category-grouped), `error_category`, `retryable`, and `retry_after` (seconds).\n\nSee the [Error Reference](https://synthorg.io/docs/errors) for the full error taxonomy and retry guidance." } }, "openapi": "3.1.0", "servers": [ { "url": "/" } ], "paths": { "/api/v1/health": { "get": { "tags": [ "health" ], "summary": "HealthCheck", "operationId": "ApiV1HealthHealthCheck", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_HealthStatus_" } } } }, "500": { "$ref": "#/components/responses/InternalError" } }, "deprecated": false } }, "/api/v1/company": { "get": { "tags": [ "company" ], "summary": "GetCompany", "operationId": "ApiV1CompanyGetCompany", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_dict_str_Any_" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/company/departments": { "get": { "tags": [ "company" ], "summary": "ListDepartments", "operationId": "ApiV1CompanyDepartmentsListDepartments", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_tuple_Department_..._" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/agents/{agent_name}": { "get": { "tags": [ "agents" ], "summary": "GetAgent", "operationId": "ApiV1AgentsAgentNameGetAgent", "parameters": [ { "name": "agent_name", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource name" }, "description": "Resource name", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_AgentConfig_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/agents/{agent_name}/activity": { "get": { "tags": [ "agents" ], "summary": "GetAgentActivity", "operationId": "ApiV1AgentsAgentNameActivityGetAgentActivity", "parameters": [ { "name": "agent_name", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource name" }, "description": "Resource name", "required": true, "deprecated": false }, { "name": "offset", "in": "query", "schema": { "type": "integer", "minimum": 0.0, "description": "Pagination offset", "default": 0 }, "description": "Pagination offset", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "limit", "in": "query", "schema": { "type": "integer", "maximum": 200.0, "minimum": 1.0, "description": "Page size", "default": 50 }, "description": "Page size", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_ActivityEvent_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/agents/{agent_name}/history": { "get": { "tags": [ "agents" ], "summary": "GetAgentHistory", "operationId": "ApiV1AgentsAgentNameHistoryGetAgentHistory", "parameters": [ { "name": "agent_name", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource name" }, "description": "Resource name", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_tuple_CareerEvent_..._" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/agents/{agent_name}/performance": { "get": { "tags": [ "agents" ], "summary": "GetAgentPerformance", "operationId": "ApiV1AgentsAgentNamePerformanceGetAgentPerformance", "parameters": [ { "name": "agent_name", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource name" }, "description": "Resource name", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_AgentPerformanceSummary_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/agents": { "get": { "tags": [ "agents" ], "summary": "ListAgents", "operationId": "ApiV1AgentsListAgents", "parameters": [ { "name": "offset", "in": "query", "schema": { "type": "integer", "minimum": 0.0, "description": "Pagination offset", "default": 0 }, "description": "Pagination offset", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "limit", "in": "query", "schema": { "type": "integer", "maximum": 200.0, "minimum": 1.0, "description": "Page size", "default": 50 }, "description": "Page size", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_AgentConfig_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/activities": { "get": { "tags": [ "activities" ], "summary": "ListActivities", "operationId": "ApiV1ActivitiesListActivities", "parameters": [ { "name": "offset", "in": "query", "schema": { "type": "integer", "minimum": 0.0, "description": "Pagination offset", "default": 0 }, "description": "Pagination offset", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "limit", "in": "query", "schema": { "type": "integer", "maximum": 200.0, "minimum": 1.0, "description": "Page size", "default": 50 }, "description": "Page size", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "type", "in": "query", "schema": { "description": "Filter by event_type", "type": [ "string", "null" ], "enum": [ "hired", "onboarded", "fired", "offboarded", "status_changed", "promoted", "demoted", "task_started", "task_completed", "cost_incurred", "tool_used", "delegation_sent", "delegation_received", null ] }, "description": "Filter by event_type", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "agent_id", "in": "query", "schema": { "maxLength": 128, "description": "Filter by agent_id", "type": [ "string", "null" ] }, "description": "Filter by agent_id", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "last_n_hours", "in": "query", "schema": { "$ref": "#/components/schemas/ActivityWindowHours" }, "description": "Time window (24, 48, or 168 hours)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_ActivityEvent_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/departments/{name}/ceremony-policy": { "get": { "tags": [ "departments" ], "summary": "GetDepartmentCeremonyPolicy", "operationId": "ApiV1DepartmentsNameCeremonyPolicyGetDepartmentCeremonyPolicy", "parameters": [ { "name": "name", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource name" }, "description": "Resource name", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_Union_dict_str_Any_NoneType_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false }, "put": { "tags": [ "departments" ], "summary": "UpdateDepartmentCeremonyPolicy", "operationId": "ApiV1DepartmentsNameCeremonyPolicyUpdateDepartmentCeremonyPolicy", "parameters": [ { "name": "name", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource name" }, "description": "Resource name", "required": true, "deprecated": false } ], "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": {}, "type": "object" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_dict_str_Any_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false }, "delete": { "tags": [ "departments" ], "summary": "DeleteDepartmentCeremonyPolicy", "operationId": "ApiV1DepartmentsNameCeremonyPolicyDeleteDepartmentCeremonyPolicy", "parameters": [ { "name": "name", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource name" }, "description": "Resource name", "required": true, "deprecated": false } ], "responses": { "204": { "description": "Request fulfilled, nothing follows", "headers": {} }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/departments/{name}": { "get": { "tags": [ "departments" ], "summary": "GetDepartment", "operationId": "ApiV1DepartmentsNameGetDepartment", "parameters": [ { "name": "name", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource name" }, "description": "Resource name", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_Department_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/departments/{name}/health": { "get": { "tags": [ "departments" ], "summary": "GetDepartmentHealth", "operationId": "ApiV1DepartmentsNameHealthGetDepartmentHealth", "parameters": [ { "name": "name", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource name" }, "description": "Resource name", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_DepartmentHealth_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "404": { "$ref": "#/components/responses/NotFound" }, "500": { "$ref": "#/components/responses/InternalError" } }, "deprecated": false } }, "/api/v1/departments": { "get": { "tags": [ "departments" ], "summary": "ListDepartments", "operationId": "ApiV1DepartmentsListDepartments", "parameters": [ { "name": "offset", "in": "query", "schema": { "type": "integer", "minimum": 0.0, "description": "Pagination offset", "default": 0 }, "description": "Pagination offset", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "limit", "in": "query", "schema": { "type": "integer", "maximum": 200.0, "minimum": 1.0, "description": "Page size", "default": 50 }, "description": "Page size", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_Department_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/projects": { "get": { "tags": [ "projects" ], "summary": "ListProjects", "operationId": "ApiV1ProjectsListProjects", "parameters": [ { "name": "offset", "in": "query", "schema": { "type": "integer", "minimum": 0.0, "description": "Pagination offset", "default": 0 }, "description": "Pagination offset", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "limit", "in": "query", "schema": { "type": "integer", "maximum": 200.0, "minimum": 1.0, "description": "Page size", "default": 50 }, "description": "Page size", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "status", "in": "query", "schema": { "maxLength": 128, "description": "Filter by project status", "minLength": 1, "type": [ "string", "null" ] }, "description": "Filter by project status", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "lead", "in": "query", "schema": { "maxLength": 128, "description": "Filter by project lead agent ID", "minLength": 1, "type": [ "string", "null" ] }, "description": "Filter by project lead agent ID", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_Project_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false }, "post": { "tags": [ "projects" ], "summary": "CreateProject", "operationId": "ApiV1ProjectsCreateProject", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateProjectRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_Project_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/projects/{project_id}": { "get": { "tags": [ "projects" ], "summary": "GetProject", "operationId": "ApiV1ProjectsProjectIdGetProject", "parameters": [ { "name": "project_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_Project_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/tasks/{task_id}/cancel": { "post": { "tags": [ "tasks" ], "summary": "CancelTask", "operationId": "ApiV1TasksTaskIdCancelCancelTask", "parameters": [ { "name": "task_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CancelTaskRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_Task_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/tasks": { "get": { "tags": [ "tasks" ], "summary": "ListTasks", "operationId": "ApiV1TasksListTasks", "parameters": [ { "name": "status", "in": "query", "schema": { "type": [ "string", "null" ], "enum": [ "created", "assigned", "in_progress", "in_review", "completed", "blocked", "failed", "interrupted", "cancelled", null ], "default": "created" }, "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "assigned_to", "in": "query", "schema": { "maxLength": 256, "type": [ "string", "null" ] }, "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "project", "in": "query", "schema": { "maxLength": 256, "type": [ "string", "null" ] }, "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "offset", "in": "query", "schema": { "type": "integer", "minimum": 0.0, "description": "Pagination offset", "default": 0 }, "description": "Pagination offset", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "limit", "in": "query", "schema": { "type": "integer", "maximum": 200.0, "minimum": 1.0, "description": "Page size", "default": 50 }, "description": "Page size", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_Task_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false }, "post": { "tags": [ "tasks" ], "summary": "CreateTask", "operationId": "ApiV1TasksCreateTask", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateTaskRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_Task_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/tasks/{task_id}": { "get": { "tags": [ "tasks" ], "summary": "GetTask", "operationId": "ApiV1TasksTaskIdGetTask", "parameters": [ { "name": "task_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_Task_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false }, "delete": { "tags": [ "tasks" ], "summary": "DeleteTask", "operationId": "ApiV1TasksTaskIdDeleteTask", "parameters": [ { "name": "task_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "responses": { "204": { "description": "Request fulfilled, nothing follows", "headers": {} }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false }, "patch": { "tags": [ "tasks" ], "summary": "UpdateTask", "operationId": "ApiV1TasksTaskIdUpdateTask", "parameters": [ { "name": "task_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateTaskRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_Task_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/tasks/{task_id}/transition": { "post": { "tags": [ "tasks" ], "summary": "TransitionTask", "operationId": "ApiV1TasksTaskIdTransitionTransitionTask", "parameters": [ { "name": "task_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransitionTaskRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_Task_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/messages/channels": { "get": { "tags": [ "messages" ], "summary": "ListChannels", "operationId": "ApiV1MessagesChannelsListChannels", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_tuple_Channel_..._" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/messages": { "get": { "tags": [ "messages" ], "summary": "ListMessages", "operationId": "ApiV1MessagesListMessages", "parameters": [ { "name": "channel", "in": "query", "schema": { "type": [ "string", "null" ] }, "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "offset", "in": "query", "schema": { "type": "integer", "minimum": 0.0, "description": "Pagination offset", "default": 0 }, "description": "Pagination offset", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "limit", "in": "query", "schema": { "type": "integer", "maximum": 200.0, "minimum": 1.0, "description": "Page size", "default": 50 }, "description": "Page size", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_Message_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/meetings/{meeting_id}": { "get": { "tags": [ "meetings" ], "summary": "GetMeeting", "operationId": "ApiV1MeetingsMeetingIdGetMeeting", "parameters": [ { "name": "meeting_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_MeetingResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/meetings": { "get": { "tags": [ "meetings" ], "summary": "ListMeetings", "operationId": "ApiV1MeetingsListMeetings", "parameters": [ { "name": "offset", "in": "query", "schema": { "type": "integer", "minimum": 0.0, "description": "Pagination offset", "default": 0 }, "description": "Pagination offset", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "limit", "in": "query", "schema": { "type": "integer", "maximum": 200.0, "minimum": 1.0, "description": "Page size", "default": 50 }, "description": "Page size", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "status", "in": "query", "schema": { "type": [ "string", "null" ], "enum": [ "scheduled", "in_progress", "completed", "failed", "cancelled", "budget_exhausted", null ] }, "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "meeting_type", "in": "query", "schema": { "maxLength": 128, "type": [ "string", "null" ] }, "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_MeetingResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/meetings/trigger": { "post": { "tags": [ "meetings" ], "summary": "TriggerMeeting", "operationId": "ApiV1MeetingsTriggerTriggerMeeting", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TriggerMeetingRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_tuple_MeetingResponse_..._" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/artifacts": { "get": { "tags": [ "artifacts" ], "summary": "ListArtifacts", "operationId": "ApiV1ArtifactsListArtifacts", "parameters": [ { "name": "offset", "in": "query", "schema": { "type": "integer", "minimum": 0.0, "description": "Pagination offset", "default": 0 }, "description": "Pagination offset", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "limit", "in": "query", "schema": { "type": "integer", "maximum": 200.0, "minimum": 1.0, "description": "Page size", "default": 50 }, "description": "Page size", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "task_id", "in": "query", "schema": { "maxLength": 128, "description": "Filter by originating task ID", "minLength": 1, "type": [ "string", "null" ] }, "description": "Filter by originating task ID", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "created_by", "in": "query", "schema": { "maxLength": 128, "description": "Filter by creator agent ID", "minLength": 1, "type": [ "string", "null" ] }, "description": "Filter by creator agent ID", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "type", "in": "query", "schema": { "maxLength": 128, "description": "Filter by artifact type", "minLength": 1, "type": [ "string", "null" ] }, "description": "Filter by artifact type", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_Artifact_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false }, "post": { "tags": [ "artifacts" ], "summary": "CreateArtifact", "operationId": "ApiV1ArtifactsCreateArtifact", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateArtifactRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_Artifact_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/artifacts/{artifact_id}": { "get": { "tags": [ "artifacts" ], "summary": "GetArtifact", "operationId": "ApiV1ArtifactsArtifactIdGetArtifact", "parameters": [ { "name": "artifact_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_Artifact_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false }, "delete": { "tags": [ "artifacts" ], "summary": "DeleteArtifact", "operationId": "ApiV1ArtifactsArtifactIdDeleteArtifact", "parameters": [ { "name": "artifact_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_NoneType_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/artifacts/{artifact_id}/content": { "get": { "tags": [ "artifacts" ], "summary": "DownloadContent", "operationId": "ApiV1ArtifactsArtifactIdContentDownloadContent", "parameters": [ { "name": "artifact_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/octet-stream": { "schema": { "type": "object" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false }, "put": { "tags": [ "artifacts" ], "summary": "UploadContent", "operationId": "ApiV1ArtifactsArtifactIdContentUploadContent", "parameters": [ { "name": "artifact_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "requestBody": { "content": { "multipart/form-data": { "schema": { "type": "string" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_Artifact_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/budget/agents/{agent_id}": { "get": { "tags": [ "budget" ], "summary": "GetAgentSpending", "operationId": "ApiV1BudgetAgentsAgentIdGetAgentSpending", "parameters": [ { "name": "agent_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_AgentSpending_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/budget/config": { "get": { "tags": [ "budget" ], "summary": "GetBudgetConfig", "operationId": "ApiV1BudgetConfigGetBudgetConfig", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_BudgetConfig_" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/budget/records": { "get": { "tags": [ "budget" ], "summary": "ListCostRecords", "operationId": "ApiV1BudgetRecordsListCostRecords", "parameters": [ { "name": "agent_id", "in": "query", "schema": { "maxLength": 128, "type": [ "string", "null" ] }, "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "task_id", "in": "query", "schema": { "maxLength": 128, "type": [ "string", "null" ] }, "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "offset", "in": "query", "schema": { "type": "integer", "minimum": 0.0, "description": "Pagination offset", "default": 0 }, "description": "Pagination offset", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "limit", "in": "query", "schema": { "type": "integer", "maximum": 200.0, "minimum": 1.0, "description": "Page size", "default": 50 }, "description": "Page size", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CostRecordListResponse" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/analytics/forecast": { "get": { "tags": [ "analytics" ], "summary": "GetForecast", "operationId": "ApiV1AnalyticsForecastGetForecast", "parameters": [ { "name": "horizon_days", "in": "query", "schema": { "type": "integer", "maximum": 90.0, "minimum": 1.0, "description": "Projection horizon in days", "default": 14 }, "description": "Projection horizon in days", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_ForecastResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/analytics/overview": { "get": { "tags": [ "analytics" ], "summary": "GetOverview", "operationId": "ApiV1AnalyticsOverviewGetOverview", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_OverviewMetrics_" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/analytics/trends": { "get": { "tags": [ "analytics" ], "summary": "GetTrends", "operationId": "ApiV1AnalyticsTrendsGetTrends", "parameters": [ { "name": "period", "in": "query", "schema": { "$ref": "#/components/schemas/TrendPeriod" }, "description": "Lookback period", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "metric", "in": "query", "schema": { "$ref": "#/components/schemas/TrendMetric" }, "description": "Metric to trend", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_TrendsResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/providers/discovery-policy/entries": { "post": { "tags": [ "providers" ], "summary": "AddAllowlistEntry", "operationId": "ApiV1ProvidersDiscoveryPolicyEntriesAddAllowlistEntry", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AddAllowlistEntryRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_DiscoveryPolicyResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/providers/from-preset": { "post": { "tags": [ "providers" ], "summary": "CreateFromPreset", "operationId": "ApiV1ProvidersFromPresetCreateFromPreset", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateFromPresetRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_ProviderResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/providers": { "get": { "tags": [ "providers" ], "summary": "ListProviders", "operationId": "ApiV1ProvidersListProviders", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_dict_str_ProviderResponse_" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false }, "post": { "tags": [ "providers" ], "summary": "CreateProvider", "operationId": "ApiV1ProvidersCreateProvider", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateProviderRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_ProviderResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/providers/{name}/models/{model_id}": { "delete": { "tags": [ "providers" ], "summary": "DeleteModel", "operationId": "ApiV1ProvidersNameModelsModelIdDeleteModel", "parameters": [ { "name": "name", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource name" }, "description": "Resource name", "required": true, "deprecated": false }, { "name": "model_id", "in": "path", "schema": { "type": "string", "maxLength": 256, "minLength": 1 }, "required": true, "deprecated": false } ], "responses": { "204": { "description": "Request fulfilled, nothing follows", "headers": {} }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/providers/{name}": { "get": { "tags": [ "providers" ], "summary": "GetProvider", "operationId": "ApiV1ProvidersNameGetProvider", "parameters": [ { "name": "name", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource name" }, "description": "Resource name", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_ProviderResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false }, "put": { "tags": [ "providers" ], "summary": "UpdateProvider", "operationId": "ApiV1ProvidersNameUpdateProvider", "parameters": [ { "name": "name", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource name" }, "description": "Resource name", "required": true, "deprecated": false } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateProviderRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_ProviderResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false }, "delete": { "tags": [ "providers" ], "summary": "DeleteProvider", "operationId": "ApiV1ProvidersNameDeleteProvider", "parameters": [ { "name": "name", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource name" }, "description": "Resource name", "required": true, "deprecated": false } ], "responses": { "204": { "description": "Request fulfilled, nothing follows", "headers": {} }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/providers/{name}/discover-models": { "post": { "tags": [ "providers" ], "summary": "DiscoverModels", "operationId": "ApiV1ProvidersNameDiscoverModelsDiscoverModels", "parameters": [ { "name": "name", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource name" }, "description": "Resource name", "required": true, "deprecated": false }, { "name": "preset_hint", "in": "query", "schema": { "maxLength": 64, "type": [ "string", "null" ] }, "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_DiscoverModelsResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/providers/discovery-policy": { "get": { "tags": [ "providers" ], "summary": "GetDiscoveryPolicy", "operationId": "ApiV1ProvidersDiscoveryPolicyGetDiscoveryPolicy", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_DiscoveryPolicyResponse_" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/providers/presets": { "get": { "tags": [ "providers" ], "summary": "GetPresets", "operationId": "ApiV1ProvidersPresetsGetPresets", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_tuple_ProviderPreset_..._" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/providers/{name}/health": { "get": { "tags": [ "providers" ], "summary": "GetProviderHealth", "operationId": "ApiV1ProvidersNameHealthGetProviderHealth", "parameters": [ { "name": "name", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource name" }, "description": "Resource name", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_ProviderHealthSummary_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "404": { "$ref": "#/components/responses/NotFound" }, "500": { "$ref": "#/components/responses/InternalError" } }, "deprecated": false } }, "/api/v1/providers/{name}/models": { "get": { "tags": [ "providers" ], "summary": "ListModels", "operationId": "ApiV1ProvidersNameModelsListModels", "parameters": [ { "name": "name", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource name" }, "description": "Resource name", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_tuple_ProviderModelResponse_..._" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/providers/probe-preset": { "post": { "tags": [ "providers" ], "summary": "ProbePreset", "operationId": "ApiV1ProvidersProbePresetProbePreset", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProbePresetRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_ProbePresetResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/providers/{name}/models/pull": { "post": { "tags": [ "providers" ], "summary": "PullModel", "operationId": "ApiV1ProvidersNameModelsPullPullModel", "parameters": [ { "name": "name", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource name" }, "description": "Resource name", "required": true, "deprecated": false } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PullModelRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "text/event-stream": { "schema": {} } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/providers/discovery-policy/remove-entry": { "post": { "tags": [ "providers" ], "summary": "RemoveAllowlistEntry", "operationId": "ApiV1ProvidersDiscoveryPolicyRemoveEntryRemoveAllowlistEntry", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RemoveAllowlistEntryRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_DiscoveryPolicyResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/providers/{name}/test": { "post": { "tags": [ "providers" ], "summary": "TestConnection", "operationId": "ApiV1ProvidersNameTestTestConnection", "parameters": [ { "name": "name", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource name" }, "description": "Resource name", "required": true, "deprecated": false } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TestConnectionRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_TestConnectionResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/providers/{name}/models/{model_id}/config": { "put": { "tags": [ "providers" ], "summary": "UpdateModelConfig", "operationId": "ApiV1ProvidersNameModelsModelIdConfigUpdateModelConfig", "parameters": [ { "name": "name", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource name" }, "description": "Resource name", "required": true, "deprecated": false }, { "name": "model_id", "in": "path", "schema": { "type": "string", "maxLength": 256, "minLength": 1 }, "required": true, "deprecated": false } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateModelConfigRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_ProviderModelResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/approvals/{approval_id}/approve": { "post": { "tags": [ "approvals" ], "summary": "Approve", "operationId": "ApiV1ApprovalsApprovalIdApproveApprove", "parameters": [ { "name": "approval_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApproveRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_ApprovalResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/approvals": { "get": { "tags": [ "approvals" ], "summary": "ListApprovals", "operationId": "ApiV1ApprovalsListApprovals", "parameters": [ { "name": "status", "in": "query", "schema": { "type": [ "string", "null" ], "enum": [ "pending", "approved", "rejected", "expired", null ], "default": "pending" }, "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "risk_level", "in": "query", "schema": { "type": [ "string", "null" ], "enum": [ "low", "medium", "high", "critical", null ] }, "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "action_type", "in": "query", "schema": { "maxLength": 128, "type": [ "string", "null" ] }, "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "offset", "in": "query", "schema": { "type": "integer", "minimum": 0.0, "description": "Pagination offset", "default": 0 }, "description": "Pagination offset", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "limit", "in": "query", "schema": { "type": "integer", "maximum": 200.0, "minimum": 1.0, "description": "Page size", "default": 50 }, "description": "Page size", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_ApprovalResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false }, "post": { "tags": [ "approvals" ], "summary": "CreateApproval", "operationId": "ApiV1ApprovalsCreateApproval", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateApprovalRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_ApprovalResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/approvals/{approval_id}": { "get": { "tags": [ "approvals" ], "summary": "GetApproval", "operationId": "ApiV1ApprovalsApprovalIdGetApproval", "parameters": [ { "name": "approval_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_ApprovalResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/approvals/{approval_id}/reject": { "post": { "tags": [ "approvals" ], "summary": "Reject", "operationId": "ApiV1ApprovalsApprovalIdRejectReject", "parameters": [ { "name": "approval_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RejectRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_ApprovalResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/agents/{agent_id}/autonomy": { "get": { "tags": [ "autonomy" ], "summary": "GetAutonomy", "operationId": "ApiV1AgentsAgentIdAutonomyGetAutonomy", "parameters": [ { "name": "agent_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_AutonomyLevelResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false }, "post": { "tags": [ "autonomy" ], "summary": "UpdateAutonomy", "operationId": "ApiV1AgentsAgentIdAutonomyUpdateAutonomy", "parameters": [ { "name": "agent_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AutonomyLevelRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_AutonomyLevelResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/auth/change-password": { "post": { "tags": [ "auth" ], "summary": "Change current user password", "operationId": "ApiV1AuthChangePasswordChangePassword", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChangePasswordRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_UserInfoResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/auth/sessions": { "get": { "tags": [ "auth" ], "summary": "List active sessions", "operationId": "ApiV1AuthSessionsListSessions", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_list_SessionResponse_" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/auth/login": { "post": { "tags": [ "auth" ], "summary": "Authenticate with credentials", "operationId": "ApiV1AuthLoginLogin", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LoginRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_TokenResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "409": { "$ref": "#/components/responses/Conflict" }, "500": { "$ref": "#/components/responses/InternalError" } }, "deprecated": false } }, "/api/v1/auth/logout": { "post": { "tags": [ "auth" ], "summary": "Logout current session", "operationId": "ApiV1AuthLogoutLogout", "responses": { "204": { "description": "Request fulfilled, nothing follows", "headers": {} }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/auth/me": { "get": { "tags": [ "auth" ], "summary": "Get current user info", "operationId": "ApiV1AuthMeMe", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_UserInfoResponse_" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/auth/sessions/{session_id}": { "delete": { "tags": [ "auth" ], "summary": "Revoke a session", "operationId": "ApiV1AuthSessionsSessionIdRevokeSession", "parameters": [ { "name": "session_id", "in": "path", "schema": { "type": "string" }, "required": true, "deprecated": false } ], "responses": { "204": { "description": "Request fulfilled, nothing follows", "headers": {} }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/auth/setup": { "post": { "tags": [ "auth" ], "summary": "First-run admin setup", "operationId": "ApiV1AuthSetupSetup", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetupRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_TokenResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "409": { "$ref": "#/components/responses/Conflict" }, "500": { "$ref": "#/components/responses/InternalError" } }, "deprecated": false } }, "/api/v1/auth/ws-ticket": { "post": { "tags": [ "auth" ], "summary": "Issue a one-time WebSocket connection ticket", "operationId": "ApiV1AuthWsTicketWsTicket", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_WsTicketResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/agents/{agent_id}/collaboration/override": { "get": { "tags": [ "collaboration" ], "summary": "GetOverride", "operationId": "ApiV1AgentsAgentIdCollaborationOverrideGetOverride", "parameters": [ { "name": "agent_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_OverrideResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false }, "post": { "tags": [ "collaboration" ], "summary": "SetOverride", "operationId": "ApiV1AgentsAgentIdCollaborationOverrideSetOverride", "parameters": [ { "name": "agent_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetOverrideRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_OverrideResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false }, "delete": { "tags": [ "collaboration" ], "summary": "ClearOverride", "operationId": "ApiV1AgentsAgentIdCollaborationOverrideClearOverride", "parameters": [ { "name": "agent_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "responses": { "204": { "description": "Request fulfilled, nothing follows", "headers": {} }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/agents/{agent_id}/collaboration/calibration": { "get": { "tags": [ "collaboration" ], "summary": "GetCalibration", "operationId": "ApiV1AgentsAgentIdCollaborationCalibrationGetCalibration", "parameters": [ { "name": "agent_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_CalibrationSummaryResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/agents/{agent_id}/collaboration/score": { "get": { "tags": [ "collaboration" ], "summary": "GetScore", "operationId": "ApiV1AgentsAgentIdCollaborationScoreGetScore", "parameters": [ { "name": "agent_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_CollaborationScoreResult_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/ceremony-policy/active": { "get": { "tags": [ "ceremony-policy" ], "summary": "GetActiveStrategy", "operationId": "ApiV1CeremonyPolicyActiveGetActiveStrategy", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_ActiveCeremonyStrategyResponse_" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/ceremony-policy": { "get": { "tags": [ "ceremony-policy" ], "summary": "GetProjectPolicy", "operationId": "ApiV1CeremonyPolicyGetProjectPolicy", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_dict_str_Any_" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/ceremony-policy/resolved": { "get": { "tags": [ "ceremony-policy" ], "summary": "GetResolvedPolicy", "operationId": "ApiV1CeremonyPolicyResolvedGetResolvedPolicy", "parameters": [ { "name": "department", "in": "query", "schema": { "maxLength": 128, "minLength": 1, "type": [ "string", "null" ] }, "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_ResolvedCeremonyPolicyResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/tasks/{task_id}/coordinate": { "post": { "tags": [ "coordination" ], "summary": "CoordinateTask", "operationId": "ApiV1TasksTaskIdCoordinateCoordinateTask", "parameters": [ { "name": "task_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CoordinateTaskRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_CoordinationResultResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/settings/{namespace}/{key}": { "get": { "tags": [ "settings" ], "summary": "GetSetting", "operationId": "ApiV1SettingsNamespaceKeyGetSetting", "parameters": [ { "name": "namespace", "in": "path", "schema": { "type": "string", "maxLength": 64, "minLength": 1, "description": "Settings namespace" }, "description": "Settings namespace", "required": true, "deprecated": false }, { "name": "key", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Settings key" }, "description": "Settings key", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_SettingEntry_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false }, "put": { "tags": [ "settings" ], "summary": "UpdateSetting", "operationId": "ApiV1SettingsNamespaceKeyUpdateSetting", "parameters": [ { "name": "namespace", "in": "path", "schema": { "type": "string", "maxLength": 64, "minLength": 1, "description": "Settings namespace" }, "description": "Settings namespace", "required": true, "deprecated": false }, { "name": "key", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Settings key" }, "description": "Settings key", "required": true, "deprecated": false } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateSettingRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_SettingEntry_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false }, "delete": { "tags": [ "settings" ], "summary": "DeleteSetting", "operationId": "ApiV1SettingsNamespaceKeyDeleteSetting", "parameters": [ { "name": "namespace", "in": "path", "schema": { "type": "string", "maxLength": 64, "minLength": 1, "description": "Settings namespace" }, "description": "Settings namespace", "required": true, "deprecated": false }, { "name": "key", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Settings key" }, "description": "Settings key", "required": true, "deprecated": false } ], "responses": { "204": { "description": "Request fulfilled, nothing follows", "headers": {} }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/settings/_schema": { "get": { "tags": [ "settings" ], "summary": "GetFullSchema", "operationId": "ApiV1SettingsSchemaGetFullSchema", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_tuple_SettingDefinition_..._" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/settings/_schema/{namespace}": { "get": { "tags": [ "settings" ], "summary": "GetNamespaceSchema", "operationId": "ApiV1SettingsSchemaNamespaceGetNamespaceSchema", "parameters": [ { "name": "namespace", "in": "path", "schema": { "type": "string", "maxLength": 64, "minLength": 1, "description": "Settings namespace" }, "description": "Settings namespace", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_tuple_SettingDefinition_..._" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/settings/{namespace}": { "get": { "tags": [ "settings" ], "summary": "GetNamespaceSettings", "operationId": "ApiV1SettingsNamespaceGetNamespaceSettings", "parameters": [ { "name": "namespace", "in": "path", "schema": { "type": "string", "maxLength": 64, "minLength": 1, "description": "Settings namespace" }, "description": "Settings namespace", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_tuple_SettingEntry_..._" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/settings": { "get": { "tags": [ "settings" ], "summary": "ListAllSettings", "operationId": "ApiV1SettingsListAllSettings", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_tuple_SettingEntry_..._" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/settings/observability/sinks": { "get": { "tags": [ "settings" ], "summary": "ListSinks", "operationId": "ApiV1SettingsObservabilitySinksListSinks", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_list_dict_str_Any_" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/settings/observability/sinks/_test": { "post": { "tags": [ "settings" ], "summary": "TestSinkConfig", "operationId": "ApiV1SettingsObservabilitySinksTestTestSinkConfig", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TestSinkConfigRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_TestSinkConfigResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/setup/complete": { "post": { "tags": [ "setup" ], "summary": "CompleteSetup", "operationId": "ApiV1SetupCompleteCompleteSetup", "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_SetupCompleteResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/setup/agent": { "post": { "tags": [ "setup" ], "summary": "CreateAgent", "operationId": "ApiV1SetupAgentCreateAgent", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetupAgentRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_SetupAgentResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/setup/company": { "post": { "tags": [ "setup" ], "summary": "CreateCompany", "operationId": "ApiV1SetupCompanyCreateCompany", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetupCompanyRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_SetupCompanyResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/setup/name-locales/available": { "get": { "tags": [ "setup" ], "summary": "GetAvailableLocales", "operationId": "ApiV1SetupNameLocalesAvailableGetAvailableLocales", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_AvailableLocalesResponse_" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/setup/name-locales": { "get": { "tags": [ "setup" ], "summary": "GetNameLocales", "operationId": "ApiV1SetupNameLocalesGetNameLocales", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_SetupNameLocalesResponse_" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false }, "put": { "tags": [ "setup" ], "summary": "SaveNameLocales", "operationId": "ApiV1SetupNameLocalesSaveNameLocales", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetupNameLocalesRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_SetupNameLocalesResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/setup/status": { "get": { "tags": [ "setup" ], "summary": "GetStatus", "operationId": "ApiV1SetupStatusGetStatus", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_SetupStatusResponse_" } } } }, "500": { "$ref": "#/components/responses/InternalError" } }, "deprecated": false } }, "/api/v1/setup/templates": { "get": { "tags": [ "setup" ], "summary": "GetTemplates", "operationId": "ApiV1SetupTemplatesGetTemplates", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_tuple_TemplateInfoResponse_..._" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/setup/agents": { "get": { "tags": [ "setup" ], "summary": "ListAgents", "operationId": "ApiV1SetupAgentsListAgents", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_SetupAgentsListResponse_" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/setup/agents/{agent_index}/randomize-name": { "post": { "tags": [ "setup" ], "summary": "RandomizeAgentName", "operationId": "ApiV1SetupAgentsAgentIndexRandomizeNameRandomizeAgentName", "parameters": [ { "name": "agent_index", "in": "path", "schema": { "type": "integer" }, "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_SetupAgentSummary_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/setup/agents/{agent_index}/model": { "put": { "tags": [ "setup" ], "summary": "UpdateAgentModel", "operationId": "ApiV1SetupAgentsAgentIndexModelUpdateAgentModel", "parameters": [ { "name": "agent_index", "in": "path", "schema": { "type": "integer" }, "required": true, "deprecated": false } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateAgentModelRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_SetupAgentSummary_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/setup/agents/{agent_index}/name": { "put": { "tags": [ "setup" ], "summary": "UpdateAgentName", "operationId": "ApiV1SetupAgentsAgentIndexNameUpdateAgentName", "parameters": [ { "name": "agent_index", "in": "path", "schema": { "type": "integer" }, "required": true, "deprecated": false } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateAgentNameRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_SetupAgentSummary_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/setup/personality-presets": { "get": { "tags": [ "setup" ], "summary": "ListPersonalityPresets", "operationId": "ApiV1SetupPersonalityPresetsListPersonalityPresets", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_PersonalityPresetsListResponse_" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/setup/agents/{agent_index}/personality": { "put": { "tags": [ "setup" ], "summary": "UpdateAgentPersonality", "operationId": "ApiV1SetupAgentsAgentIndexPersonalityUpdateAgentPersonality", "parameters": [ { "name": "agent_index", "in": "path", "schema": { "type": "integer" }, "required": true, "deprecated": false } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateAgentPersonalityRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_SetupAgentSummary_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/personalities/presets": { "get": { "tags": [ "personalities" ], "summary": "ListPresets", "operationId": "ApiV1PersonalitiesPresetsListPresets", "parameters": [ { "name": "offset", "in": "query", "schema": { "type": "integer", "minimum": 0.0, "description": "Pagination offset", "default": 0 }, "description": "Pagination offset", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "limit", "in": "query", "schema": { "type": "integer", "maximum": 200.0, "minimum": 1.0, "description": "Page size", "default": 50 }, "description": "Page size", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_PresetSummaryResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false }, "post": { "tags": [ "personalities" ], "summary": "CreatePreset", "operationId": "ApiV1PersonalitiesPresetsCreatePreset", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreatePresetRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_PresetDetailResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/personalities/presets/{name}": { "get": { "tags": [ "personalities" ], "summary": "GetPreset", "operationId": "ApiV1PersonalitiesPresetsNameGetPreset", "parameters": [ { "name": "name", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource name" }, "description": "Resource name", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_PresetDetailResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false }, "put": { "tags": [ "personalities" ], "summary": "UpdatePreset", "operationId": "ApiV1PersonalitiesPresetsNameUpdatePreset", "parameters": [ { "name": "name", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource name" }, "description": "Resource name", "required": true, "deprecated": false } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdatePresetRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_PresetDetailResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false }, "delete": { "tags": [ "personalities" ], "summary": "DeletePreset", "operationId": "ApiV1PersonalitiesPresetsNameDeletePreset", "parameters": [ { "name": "name", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource name" }, "description": "Resource name", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_NoneType_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/personalities/schema": { "get": { "tags": [ "personalities" ], "summary": "GetSchema", "operationId": "ApiV1PersonalitiesSchemaGetSchema", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_dict_str_Any_" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/admin/backups": { "get": { "tags": [ "admin", "backup" ], "summary": "ListBackups", "operationId": "ApiV1AdminBackupsListBackups", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_tuple_BackupInfo_..._" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false }, "post": { "tags": [ "admin", "backup" ], "summary": "CreateBackup", "operationId": "ApiV1AdminBackupsCreateBackup", "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_BackupManifest_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/admin/backups/{backup_id}": { "get": { "tags": [ "admin", "backup" ], "summary": "GetBackup", "operationId": "ApiV1AdminBackupsBackupIdGetBackup", "parameters": [ { "name": "backup_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_BackupManifest_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false }, "delete": { "tags": [ "admin", "backup" ], "summary": "DeleteBackup", "operationId": "ApiV1AdminBackupsBackupIdDeleteBackup", "parameters": [ { "name": "backup_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "responses": { "204": { "description": "Request fulfilled, nothing follows", "headers": {} }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/admin/backups/restore": { "post": { "tags": [ "admin", "backup" ], "summary": "RestoreBackup", "operationId": "ApiV1AdminBackupsRestoreRestoreBackup", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RestoreRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_RestoreResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/admin/memory/fine-tune/cancel": { "post": { "tags": [ "admin", "memory" ], "summary": "CancelFineTune", "operationId": "ApiV1AdminMemoryFineTuneCancelCancelFineTune", "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_FineTuneStatus_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/admin/memory/fine-tune/checkpoints/{checkpoint_id}": { "delete": { "tags": [ "admin", "memory" ], "summary": "DeleteCheckpoint", "operationId": "ApiV1AdminMemoryFineTuneCheckpointsCheckpointIdDeleteCheckpoint", "parameters": [ { "name": "checkpoint_id", "in": "path", "schema": { "type": "string" }, "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_NoneType_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/admin/memory/fine-tune/checkpoints/{checkpoint_id}/deploy": { "post": { "tags": [ "admin", "memory" ], "summary": "DeployCheckpoint", "operationId": "ApiV1AdminMemoryFineTuneCheckpointsCheckpointIdDeployDeployCheckpoint", "parameters": [ { "name": "checkpoint_id", "in": "path", "schema": { "type": "string" }, "required": true, "deprecated": false } ], "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_CheckpointRecord_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/admin/memory/embedder": { "get": { "tags": [ "admin", "memory" ], "summary": "GetActiveEmbedder", "operationId": "ApiV1AdminMemoryEmbedderGetActiveEmbedder", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_ActiveEmbedderResponse_" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/admin/memory/fine-tune/status": { "get": { "tags": [ "admin", "memory" ], "summary": "GetFineTuneStatus", "operationId": "ApiV1AdminMemoryFineTuneStatusGetFineTuneStatus", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_FineTuneStatus_" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/admin/memory/fine-tune/checkpoints": { "get": { "tags": [ "admin", "memory" ], "summary": "ListCheckpoints", "operationId": "ApiV1AdminMemoryFineTuneCheckpointsListCheckpoints", "parameters": [ { "name": "limit", "in": "query", "schema": { "type": "integer", "default": 50 }, "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "offset", "in": "query", "schema": { "type": "integer", "default": 0 }, "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_tuple_CheckpointRecord_..._" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/admin/memory/fine-tune/runs": { "get": { "tags": [ "admin", "memory" ], "summary": "ListRuns", "operationId": "ApiV1AdminMemoryFineTuneRunsListRuns", "parameters": [ { "name": "limit", "in": "query", "schema": { "type": "integer", "default": 50 }, "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "offset", "in": "query", "schema": { "type": "integer", "default": 0 }, "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_tuple_FineTuneRun_..._" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/admin/memory/fine-tune/resume/{run_id}": { "post": { "tags": [ "admin", "memory" ], "summary": "ResumeFineTune", "operationId": "ApiV1AdminMemoryFineTuneResumeRunIdResumeFineTune", "parameters": [ { "name": "run_id", "in": "path", "schema": { "type": "string" }, "required": true, "deprecated": false } ], "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_FineTuneStatus_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/admin/memory/fine-tune/checkpoints/{checkpoint_id}/rollback": { "post": { "tags": [ "admin", "memory" ], "summary": "RollbackCheckpoint", "operationId": "ApiV1AdminMemoryFineTuneCheckpointsCheckpointIdRollbackRollbackCheckpoint", "parameters": [ { "name": "checkpoint_id", "in": "path", "schema": { "type": "string" }, "required": true, "deprecated": false } ], "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_CheckpointRecord_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/admin/memory/fine-tune/preflight": { "post": { "tags": [ "admin", "memory" ], "summary": "RunPreflight", "operationId": "ApiV1AdminMemoryFineTunePreflightRunPreflight", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FineTuneRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_PreflightResult_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/admin/memory/fine-tune": { "post": { "tags": [ "admin", "memory" ], "summary": "StartFineTune", "operationId": "ApiV1AdminMemoryFineTuneStartFineTune", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FineTuneRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_FineTuneStatus_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/template-packs/apply": { "post": { "tags": [ "template-packs" ], "summary": "ApplyTemplatePack", "operationId": "ApiV1TemplatePacksApplyApplyTemplatePack", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApplyTemplatePackRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_ApplyTemplatePackResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/template-packs": { "get": { "tags": [ "template-packs" ], "summary": "ListTemplatePacks", "operationId": "ApiV1TemplatePacksListTemplatePacks", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_tuple_PackInfoResponse_..._" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/users": { "get": { "tags": [ "users" ], "summary": "ListUsers", "operationId": "ApiV1UsersListUsers", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_tuple_UserResponse_..._" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false }, "post": { "tags": [ "users" ], "summary": "CreateUser", "operationId": "ApiV1UsersCreateUser", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateUserRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_UserResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/users/{user_id}": { "get": { "tags": [ "users" ], "summary": "GetUser", "operationId": "ApiV1UsersUserIdGetUser", "parameters": [ { "name": "user_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_UserResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false }, "delete": { "tags": [ "users" ], "summary": "DeleteUser", "operationId": "ApiV1UsersUserIdDeleteUser", "parameters": [ { "name": "user_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "responses": { "204": { "description": "Request fulfilled, nothing follows", "headers": {} }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false }, "patch": { "tags": [ "users" ], "summary": "UpdateUserRole", "operationId": "ApiV1UsersUserIdUpdateUserRole", "parameters": [ { "name": "user_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateUserRoleRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_UserResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/workflows/from-blueprint": { "post": { "tags": [ "workflows" ], "summary": "CreateFromBlueprint", "operationId": "ApiV1WorkflowsFromBlueprintCreateFromBlueprint", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateFromBlueprintRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_WorkflowDefinition_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/workflows": { "get": { "tags": [ "workflows" ], "summary": "ListWorkflows", "operationId": "ApiV1WorkflowsListWorkflows", "parameters": [ { "name": "offset", "in": "query", "schema": { "type": "integer", "minimum": 0.0, "description": "Pagination offset", "default": 0 }, "description": "Pagination offset", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "limit", "in": "query", "schema": { "type": "integer", "maximum": 200.0, "minimum": 1.0, "description": "Page size", "default": 50 }, "description": "Page size", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "workflow_type", "in": "query", "schema": { "maxLength": 128, "description": "Filter by workflow type", "minLength": 1, "type": [ "string", "null" ] }, "description": "Filter by workflow type", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_WorkflowDefinition_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false }, "post": { "tags": [ "workflows" ], "summary": "CreateWorkflow", "operationId": "ApiV1WorkflowsCreateWorkflow", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateWorkflowDefinitionRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_WorkflowDefinition_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/workflows/{workflow_id}": { "get": { "tags": [ "workflows" ], "summary": "GetWorkflow", "operationId": "ApiV1WorkflowsWorkflowIdGetWorkflow", "parameters": [ { "name": "workflow_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_WorkflowDefinition_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false }, "delete": { "tags": [ "workflows" ], "summary": "DeleteWorkflow", "operationId": "ApiV1WorkflowsWorkflowIdDeleteWorkflow", "parameters": [ { "name": "workflow_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "responses": { "204": { "description": "Request fulfilled, nothing follows", "headers": {} }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false }, "patch": { "tags": [ "workflows" ], "summary": "UpdateWorkflow", "operationId": "ApiV1WorkflowsWorkflowIdUpdateWorkflow", "parameters": [ { "name": "workflow_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateWorkflowDefinitionRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_WorkflowDefinition_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/workflows/{workflow_id}/export": { "post": { "tags": [ "workflows" ], "summary": "ExportWorkflow", "operationId": "ApiV1WorkflowsWorkflowIdExportExportWorkflow", "parameters": [ { "name": "workflow_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": {} } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/workflows/blueprints": { "get": { "tags": [ "workflows" ], "summary": "ListWorkflowBlueprints", "operationId": "ApiV1WorkflowsBlueprintsListWorkflowBlueprints", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_tuple_BlueprintInfoResponse_..._" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/workflows/validate-draft": { "post": { "tags": [ "workflows" ], "summary": "ValidateDraft", "operationId": "ApiV1WorkflowsValidateDraftValidateDraft", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateWorkflowDefinitionRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_WorkflowValidationResult_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/workflows/{workflow_id}/validate": { "post": { "tags": [ "workflows" ], "summary": "ValidateWorkflow", "operationId": "ApiV1WorkflowsWorkflowIdValidateValidateWorkflow", "parameters": [ { "name": "workflow_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_WorkflowValidationResult_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/workflows/{workflow_id}/diff": { "get": { "tags": [ "workflows" ], "summary": "GetDiff", "operationId": "ApiV1WorkflowsWorkflowIdDiffGetDiff", "parameters": [ { "name": "workflow_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false }, { "name": "from_version", "in": "query", "schema": { "type": "integer", "minimum": 1.0, "description": "Source version" }, "description": "Source version", "required": true, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "to_version", "in": "query", "schema": { "type": "integer", "minimum": 1.0, "description": "Target version" }, "description": "Target version", "required": true, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_WorkflowDiff_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/workflows/{workflow_id}/versions/{version_num}": { "get": { "tags": [ "workflows" ], "summary": "GetVersion", "operationId": "ApiV1WorkflowsWorkflowIdVersionsVersionNumGetVersion", "parameters": [ { "name": "workflow_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false }, { "name": "version_num", "in": "path", "schema": { "type": "integer", "minimum": 1.0 }, "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_WorkflowDefinitionVersion_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/workflows/{workflow_id}/versions": { "get": { "tags": [ "workflows" ], "summary": "ListVersions", "operationId": "ApiV1WorkflowsWorkflowIdVersionsListVersions", "parameters": [ { "name": "workflow_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false }, { "name": "offset", "in": "query", "schema": { "type": "integer", "minimum": 0.0, "description": "Pagination offset", "default": 0 }, "description": "Pagination offset", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "limit", "in": "query", "schema": { "type": "integer", "maximum": 200.0, "minimum": 1.0, "description": "Page size", "default": 20 }, "description": "Page size", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_WorkflowDefinitionVersion_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/workflows/{workflow_id}/rollback": { "post": { "tags": [ "workflows" ], "summary": "RollbackWorkflow", "operationId": "ApiV1WorkflowsWorkflowIdRollbackRollbackWorkflow", "parameters": [ { "name": "workflow_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RollbackWorkflowRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_WorkflowDefinition_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/agents/{agent_id}/quality/override": { "get": { "tags": [ "quality" ], "summary": "GetOverride", "operationId": "ApiV1AgentsAgentIdQualityOverrideGetOverride", "parameters": [ { "name": "agent_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_QualityOverrideResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false }, "post": { "tags": [ "quality" ], "summary": "SetOverride", "operationId": "ApiV1AgentsAgentIdQualityOverrideSetOverride", "parameters": [ { "name": "agent_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetQualityOverrideRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_QualityOverrideResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false }, "delete": { "tags": [ "quality" ], "summary": "ClearOverride", "operationId": "ApiV1AgentsAgentIdQualityOverrideClearOverride", "parameters": [ { "name": "agent_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "responses": { "204": { "description": "Request fulfilled, nothing follows", "headers": {} }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/reports/generate": { "post": { "summary": "Generate an on-demand report", "description": "Trigger on-demand report generation for a given period.", "operationId": "ApiV1ReportsGenerateGenerateReport", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateReportRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_ReportResponse_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/reports/periods": { "get": { "summary": "List available report periods", "description": "Return the available report period options.", "operationId": "ApiV1ReportsPeriodsListPeriods", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_list_str_" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/workflow-executions/activate/{workflow_id}": { "post": { "tags": [ "workflow-executions" ], "summary": "ActivateWorkflow", "operationId": "ApiV1WorkflowExecutionsActivateWorkflowIdActivateWorkflow", "parameters": [ { "name": "workflow_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActivateWorkflowRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_WorkflowExecution_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/workflow-executions/{execution_id}/cancel": { "post": { "tags": [ "workflow-executions" ], "summary": "CancelExecution", "operationId": "ApiV1WorkflowExecutionsExecutionIdCancelCancelExecution", "parameters": [ { "name": "execution_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_WorkflowExecution_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/workflow-executions/{execution_id}": { "get": { "tags": [ "workflow-executions" ], "summary": "GetExecution", "operationId": "ApiV1WorkflowExecutionsExecutionIdGetExecution", "parameters": [ { "name": "execution_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_WorkflowExecution_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/workflow-executions/by-definition/{workflow_id}": { "get": { "tags": [ "workflow-executions" ], "summary": "ListExecutions", "operationId": "ApiV1WorkflowExecutionsByDefinitionWorkflowIdListExecutions", "parameters": [ { "name": "workflow_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_list_WorkflowExecution_" } } } }, "400": { "$ref": "#/components/responses/BadRequest" }, "401": { "$ref": "#/components/responses/Unauthorized" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } } }, "components": { "schemas": { "AcceptanceCriterion": { "properties": { "description": { "type": "string", "minLength": 1, "description": "Criterion text" }, "met": { "type": "boolean", "description": "Whether this criterion has been satisfied", "default": false } }, "type": "object", "required": [ "description" ], "title": "AcceptanceCriterion" }, "ActionItem": { "properties": { "description": { "type": "string", "minLength": 1, "description": "What needs to be done" }, "assignee_id": { "description": "Agent responsible for the action", "minLength": 1, "type": [ "string", "null" ] }, "priority": { "$ref": "#/components/schemas/Priority" } }, "type": "object", "required": [ "description" ], "title": "ActionItem" }, "ActivateWorkflowRequest": { "properties": { "project": { "type": "string", "minLength": 1, "description": "Project ID for created tasks" }, "context": { "items": { "oneOf": [ { "type": "string" }, { "type": [ "string", "integer", "number", "boolean", "null" ] } ] }, "type": "array", "maxLength": 64, "description": "Runtime context for condition evaluation" } }, "type": "object", "required": [ "project" ], "title": "ActivateWorkflowRequest" }, "ActiveCeremonyStrategyResponse": { "properties": { "strategy": { "description": "Active sprint strategy, null if no sprint running", "type": [ "string", "null" ], "enum": [ "task_driven", "calendar", "hybrid", "event_driven", "budget_driven", "throughput_adaptive", "external_trigger", "milestone_driven", null ] }, "sprint_id": { "description": "Active sprint ID, null if no sprint running", "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [], "title": "ActiveCeremonyStrategyResponse" }, "ActiveEmbedderResponse": { "properties": { "provider": { "description": "Embedding provider name", "minLength": 1, "type": [ "string", "null" ] }, "model": { "description": "Embedding model identifier", "minLength": 1, "type": [ "string", "null" ] }, "dims": { "minimum": 1, "description": "Embedding vector dimensions", "type": [ "integer", "null" ] } }, "type": "object", "required": [], "title": "ActiveEmbedderResponse" }, "ActivityEvent": { "properties": { "event_type": { "$ref": "#/components/schemas/ActivityEventType" }, "timestamp": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" }, "description": { "type": "string", "maxLength": 1024, "description": "Human-readable event description", "default": "" }, "related_ids": { "additionalProperties": { "type": "string" }, "type": "object", "description": "Related entity identifiers" } }, "type": "object", "required": [ "event_type", "timestamp" ], "title": "ActivityEvent" }, "ActivityEventType": { "type": "string", "enum": [ "hired", "onboarded", "fired", "offboarded", "status_changed", "promoted", "demoted", "task_started", "task_completed", "cost_incurred", "tool_used", "delegation_sent", "delegation_received" ], "title": "ActivityEventType", "description": "Event category" }, "ActivityWindowHours": { "type": "integer", "enum": [ 24, 48, 168 ], "title": "ActivityWindowHours", "description": "Time window (24, 48, or 168 hours)", "default": 24 }, "AddAllowlistEntryRequest": { "properties": { "host_port": { "type": "string", "maxLength": 256, "minLength": 1 } }, "type": "object", "required": [ "host_port" ], "title": "AddAllowlistEntryRequest" }, "AgentConfig": { "properties": { "name": { "type": "string", "minLength": 1, "description": "Agent display name" }, "role": { "type": "string", "minLength": 1, "description": "Role name" }, "department": { "type": "string", "minLength": 1, "description": "Department name" }, "level": { "$ref": "#/components/schemas/SeniorityLevel" }, "personality": { "additionalProperties": {}, "type": "object", "description": "Raw personality config" }, "model": { "additionalProperties": {}, "type": "object", "description": "Raw model config" }, "memory": { "additionalProperties": {}, "type": "object", "description": "Raw memory config" }, "tools": { "additionalProperties": {}, "type": "object", "description": "Raw tools config" }, "authority": { "additionalProperties": {}, "type": "object", "description": "Raw authority config" }, "autonomy_level": { "description": "Per-agent autonomy level override (D6)", "type": [ "string", "null" ], "enum": [ "full", "semi", "supervised", "locked", null ], "default": "semi" } }, "type": "object", "required": [ "department", "name", "role" ], "title": "AgentConfig" }, "AgentPerformanceSummary": { "properties": { "agent_name": { "type": "string", "minLength": 1, "description": "Agent display name" }, "tasks_completed_total": { "type": "integer", "minimum": 0.0, "description": "Best available completed task count (max across all time windows)" }, "tasks_completed_7d": { "type": "integer", "minimum": 0.0, "description": "Tasks completed in the last 7 days" }, "tasks_completed_30d": { "type": "integer", "minimum": 0.0, "description": "Tasks completed in the last 30 days" }, "avg_completion_time_seconds": { "description": "Average task duration in seconds (30d window, falling back to 7d)", "type": [ "number", "null" ] }, "success_rate_percent": { "maximum": 100.0, "description": "Task success rate as percentage (30d window, falling back to 7d)", "type": [ "number", "null" ] }, "cost_per_task_usd": { "description": "Average cost per task in USD (base currency) (30d window, falling back to 7d)", "type": [ "number", "null" ] }, "quality_score": { "maximum": 10.0, "description": "Overall quality score", "type": [ "number", "null" ] }, "collaboration_score": { "maximum": 10.0, "description": "Overall collaboration score", "type": [ "number", "null" ] }, "trend_direction": { "$ref": "#/components/schemas/TrendDirection" }, "windows": { "items": { "$ref": "#/components/schemas/WindowMetrics" }, "type": "array", "description": "Rolling window metrics", "default": [] }, "trends": { "items": { "$ref": "#/components/schemas/TrendResult" }, "type": "array", "description": "Trend detection results", "default": [] } }, "type": "object", "required": [ "agent_name", "tasks_completed_30d", "tasks_completed_7d", "tasks_completed_total", "trend_direction" ], "title": "AgentPerformanceSummary" }, "AgentSpending": { "properties": { "agent_id": { "type": "string", "minLength": 1, "description": "Agent identifier" }, "total_cost_usd": { "type": "number", "minimum": 0.0, "description": "Total cost in USD (base currency)" }, "currency": { "type": "string", "maxLength": 3, "minLength": 3, "description": "ISO 4217 currency code", "default": "EUR" } }, "type": "object", "required": [ "agent_id", "total_cost_usd" ], "title": "AgentSpending" }, "ApiResponse_ActiveCeremonyStrategyResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/ActiveCeremonyStrategyResponse" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[ActiveCeremonyStrategyResponse]" }, "ApiResponse_ActiveEmbedderResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/ActiveEmbedderResponse" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[ActiveEmbedderResponse]" }, "ApiResponse_AgentConfig_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/AgentConfig" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[AgentConfig]" }, "ApiResponse_AgentPerformanceSummary_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/AgentPerformanceSummary" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[AgentPerformanceSummary]" }, "ApiResponse_AgentSpending_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/AgentSpending" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[AgentSpending]" }, "ApiResponse_ApplyTemplatePackResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/ApplyTemplatePackResponse" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[ApplyTemplatePackResponse]" }, "ApiResponse_ApprovalResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/ApprovalResponse" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[ApprovalResponse]" }, "ApiResponse_Artifact_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/Artifact" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[Artifact]" }, "ApiResponse_AutonomyLevelResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/AutonomyLevelResponse" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[AutonomyLevelResponse]" }, "ApiResponse_AvailableLocalesResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/AvailableLocalesResponse" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[AvailableLocalesResponse]" }, "ApiResponse_BackupManifest_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/BackupManifest" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[BackupManifest]" }, "ApiResponse_BudgetConfig_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/BudgetConfig" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[BudgetConfig]" }, "ApiResponse_CalibrationSummaryResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/CalibrationSummaryResponse" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[CalibrationSummaryResponse]" }, "ApiResponse_CheckpointRecord_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/CheckpointRecord" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[CheckpointRecord]" }, "ApiResponse_CollaborationScoreResult_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/CollaborationScoreResult" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[CollaborationScoreResult]" }, "ApiResponse_CoordinationResultResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/CoordinationResultResponse" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[CoordinationResultResponse]" }, "ApiResponse_DepartmentHealth_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/DepartmentHealth" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[DepartmentHealth]" }, "ApiResponse_Department_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/Department" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[Department]" }, "ApiResponse_DiscoverModelsResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/DiscoverModelsResponse" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[DiscoverModelsResponse]" }, "ApiResponse_DiscoveryPolicyResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/DiscoveryPolicyResponse" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[DiscoveryPolicyResponse]" }, "ApiResponse_FineTuneStatus_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/FineTuneStatus" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[FineTuneStatus]" }, "ApiResponse_ForecastResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/ForecastResponse" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[ForecastResponse]" }, "ApiResponse_HealthStatus_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/HealthStatus" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[HealthStatus]" }, "ApiResponse_MeetingResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/MeetingResponse" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[MeetingResponse]" }, "ApiResponse_NoneType_": { "properties": { "data": { "type": "null" }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "data", "success" ], "title": "ApiResponse[NoneType]" }, "ApiResponse_OverrideResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/OverrideResponse" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[OverrideResponse]" }, "ApiResponse_OverviewMetrics_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/OverviewMetrics" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[OverviewMetrics]" }, "ApiResponse_PersonalityPresetsListResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/PersonalityPresetsListResponse" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[PersonalityPresetsListResponse]" }, "ApiResponse_PreflightResult_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/PreflightResult" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[PreflightResult]" }, "ApiResponse_PresetDetailResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/PresetDetailResponse" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[PresetDetailResponse]" }, "ApiResponse_ProbePresetResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/ProbePresetResponse" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[ProbePresetResponse]" }, "ApiResponse_Project_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/Project" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[Project]" }, "ApiResponse_ProviderHealthSummary_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/ProviderHealthSummary" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[ProviderHealthSummary]" }, "ApiResponse_ProviderModelResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/ProviderModelResponse" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[ProviderModelResponse]" }, "ApiResponse_ProviderResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/ProviderResponse" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[ProviderResponse]" }, "ApiResponse_QualityOverrideResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/QualityOverrideResponse" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[QualityOverrideResponse]" }, "ApiResponse_ReportResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/ReportResponse" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[ReportResponse]" }, "ApiResponse_ResolvedCeremonyPolicyResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/ResolvedCeremonyPolicyResponse" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[ResolvedCeremonyPolicyResponse]" }, "ApiResponse_RestoreResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/RestoreResponse" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[RestoreResponse]" }, "ApiResponse_SettingEntry_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/SettingEntry" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[SettingEntry]" }, "ApiResponse_SetupAgentResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/SetupAgentResponse" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[SetupAgentResponse]" }, "ApiResponse_SetupAgentSummary_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/SetupAgentSummary" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[SetupAgentSummary]" }, "ApiResponse_SetupAgentsListResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/SetupAgentsListResponse" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[SetupAgentsListResponse]" }, "ApiResponse_SetupCompanyResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/SetupCompanyResponse" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[SetupCompanyResponse]" }, "ApiResponse_SetupCompleteResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/SetupCompleteResponse" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[SetupCompleteResponse]" }, "ApiResponse_SetupNameLocalesResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/SetupNameLocalesResponse" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[SetupNameLocalesResponse]" }, "ApiResponse_SetupStatusResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/SetupStatusResponse" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[SetupStatusResponse]" }, "ApiResponse_Task_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/Task" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[Task]" }, "ApiResponse_TestConnectionResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/TestConnectionResponse" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[TestConnectionResponse]" }, "ApiResponse_TestSinkConfigResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/TestSinkConfigResponse" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[TestSinkConfigResponse]" }, "ApiResponse_TokenResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/TokenResponse" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[TokenResponse]" }, "ApiResponse_TrendsResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/TrendsResponse" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[TrendsResponse]" }, "ApiResponse_Union_dict_str_Any_NoneType_": { "properties": { "data": { "additionalProperties": {}, "type": [ "object", "null" ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[Union[dict[str, Any], NoneType]]" }, "ApiResponse_UserInfoResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/UserInfoResponse" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[UserInfoResponse]" }, "ApiResponse_UserResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/UserResponse" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[UserResponse]" }, "ApiResponse_WorkflowDefinitionVersion_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/WorkflowDefinitionVersion" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[WorkflowDefinitionVersion]" }, "ApiResponse_WorkflowDefinition_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/WorkflowDefinition" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[WorkflowDefinition]" }, "ApiResponse_WorkflowDiff_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/WorkflowDiff" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[WorkflowDiff]" }, "ApiResponse_WorkflowExecution_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/WorkflowExecution" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[WorkflowExecution]" }, "ApiResponse_WorkflowValidationResult_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/WorkflowValidationResult" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[WorkflowValidationResult]" }, "ApiResponse_WsTicketResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/WsTicketResponse" }, { "type": "null" } ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[WsTicketResponse]" }, "ApiResponse_dict_str_Any_": { "properties": { "data": { "additionalProperties": {}, "type": [ "object", "null" ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[dict[str, Any]]" }, "ApiResponse_dict_str_ProviderResponse_": { "properties": { "data": { "additionalProperties": { "$ref": "#/components/schemas/ProviderResponse" }, "type": [ "object", "null" ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[dict[str, ProviderResponse]]" }, "ApiResponse_list_SessionResponse_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/SessionResponse" }, "type": [ "array", "null" ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[list[SessionResponse]]" }, "ApiResponse_list_WorkflowExecution_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/WorkflowExecution" }, "type": [ "array", "null" ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[list[WorkflowExecution]]" }, "ApiResponse_list_dict_str_Any_": { "properties": { "data": { "items": { "additionalProperties": {}, "type": "object" }, "type": [ "array", "null" ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[list[dict[str, Any]]]" }, "ApiResponse_list_str_": { "properties": { "data": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[list[str]]" }, "ApiResponse_tuple_BackupInfo_..._": { "properties": { "data": { "items": { "$ref": "#/components/schemas/BackupInfo" }, "type": [ "array", "null" ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[tuple[BackupInfo, ...]]" }, "ApiResponse_tuple_BlueprintInfoResponse_..._": { "properties": { "data": { "items": { "$ref": "#/components/schemas/BlueprintInfoResponse" }, "type": [ "array", "null" ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[tuple[BlueprintInfoResponse, ...]]" }, "ApiResponse_tuple_CareerEvent_..._": { "properties": { "data": { "items": { "$ref": "#/components/schemas/CareerEvent" }, "type": [ "array", "null" ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[tuple[CareerEvent, ...]]" }, "ApiResponse_tuple_Channel_..._": { "properties": { "data": { "items": { "$ref": "#/components/schemas/Channel" }, "type": [ "array", "null" ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[tuple[Channel, ...]]" }, "ApiResponse_tuple_CheckpointRecord_..._": { "properties": { "data": { "items": { "$ref": "#/components/schemas/CheckpointRecord" }, "type": [ "array", "null" ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[tuple[CheckpointRecord, ...]]" }, "ApiResponse_tuple_Department_..._": { "properties": { "data": { "items": { "$ref": "#/components/schemas/Department" }, "type": [ "array", "null" ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[tuple[Department, ...]]" }, "ApiResponse_tuple_FineTuneRun_..._": { "properties": { "data": { "items": { "$ref": "#/components/schemas/FineTuneRun" }, "type": [ "array", "null" ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[tuple[FineTuneRun, ...]]" }, "ApiResponse_tuple_MeetingResponse_..._": { "properties": { "data": { "items": { "$ref": "#/components/schemas/MeetingResponse" }, "type": [ "array", "null" ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[tuple[MeetingResponse, ...]]" }, "ApiResponse_tuple_PackInfoResponse_..._": { "properties": { "data": { "items": { "$ref": "#/components/schemas/PackInfoResponse" }, "type": [ "array", "null" ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[tuple[PackInfoResponse, ...]]" }, "ApiResponse_tuple_ProviderModelResponse_..._": { "properties": { "data": { "items": { "$ref": "#/components/schemas/ProviderModelResponse" }, "type": [ "array", "null" ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[tuple[ProviderModelResponse, ...]]" }, "ApiResponse_tuple_ProviderPreset_..._": { "properties": { "data": { "items": { "$ref": "#/components/schemas/ProviderPreset" }, "type": [ "array", "null" ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[tuple[ProviderPreset, ...]]" }, "ApiResponse_tuple_SettingDefinition_..._": { "properties": { "data": { "items": { "$ref": "#/components/schemas/SettingDefinition" }, "type": [ "array", "null" ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[tuple[SettingDefinition, ...]]" }, "ApiResponse_tuple_SettingEntry_..._": { "properties": { "data": { "items": { "$ref": "#/components/schemas/SettingEntry" }, "type": [ "array", "null" ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[tuple[SettingEntry, ...]]" }, "ApiResponse_tuple_TemplateInfoResponse_..._": { "properties": { "data": { "items": { "$ref": "#/components/schemas/TemplateInfoResponse" }, "type": [ "array", "null" ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[tuple[TemplateInfoResponse, ...]]" }, "ApiResponse_tuple_UserResponse_..._": { "properties": { "data": { "items": { "$ref": "#/components/schemas/UserResponse" }, "type": [ "array", "null" ] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[tuple[UserResponse, ...]]" }, "ApplyTemplatePackRequest": { "properties": { "pack_name": { "type": "string", "minLength": 1, "description": "Pack to apply" } }, "type": "object", "required": [ "pack_name" ], "title": "ApplyTemplatePackRequest" }, "ApplyTemplatePackResponse": { "properties": { "pack_name": { "type": "string", "minLength": 1 }, "agents_added": { "type": "integer", "minimum": 0.0 }, "departments_added": { "type": "integer", "minimum": 0.0 } }, "type": "object", "required": [ "agents_added", "departments_added", "pack_name" ], "title": "ApplyTemplatePackResponse" }, "ApprovalChain": { "properties": { "action_type": { "type": "string", "minLength": 1, "description": "Action type for this chain" }, "approvers": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Ordered approver names" }, "min_approvals": { "type": "integer", "minimum": 0.0, "description": "Minimum approvals (0 = all required)", "default": 0 } }, "type": "object", "required": [ "action_type", "approvers" ], "title": "ApprovalChain" }, "ApprovalResponse": { "properties": { "id": { "type": "string", "minLength": 1 }, "action_type": { "type": "string", "minLength": 1 }, "title": { "type": "string", "minLength": 1 }, "description": { "type": "string", "minLength": 1 }, "requested_by": { "type": "string", "minLength": 1 }, "risk_level": { "$ref": "#/components/schemas/ApprovalRiskLevel" }, "status": { "$ref": "#/components/schemas/ApprovalStatus" }, "created_at": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" }, "expires_at": { "format": "date-time", "description": "datetime with the constraint that the value must have timezone info", "type": [ "string", "null" ] }, "decided_at": { "format": "date-time", "description": "datetime with the constraint that the value must have timezone info", "type": [ "string", "null" ] }, "decided_by": { "minLength": 1, "type": [ "string", "null" ] }, "decision_reason": { "minLength": 1, "type": [ "string", "null" ] }, "task_id": { "minLength": 1, "type": [ "string", "null" ] }, "metadata": { "additionalProperties": { "type": "string" }, "type": "object" }, "seconds_remaining": { "description": "Seconds until expiry (null if no TTL set)", "type": [ "number", "null" ] }, "urgency_level": { "$ref": "#/components/schemas/UrgencyLevel" } }, "type": "object", "required": [ "action_type", "created_at", "description", "id", "requested_by", "risk_level", "title", "urgency_level" ], "title": "ApprovalResponse" }, "ApprovalRiskLevel": { "type": "string", "enum": [ "low", "medium", "high", "critical" ], "title": "ApprovalRiskLevel", "description": "Risk level assigned to an approval item." }, "ApprovalStatus": { "type": "string", "enum": [ "pending", "approved", "rejected", "expired" ], "title": "ApprovalStatus", "description": "Status of a human approval item.", "default": "pending" }, "ApproveRequest": { "properties": { "comment": { "maxLength": 4096, "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [], "title": "ApproveRequest" }, "Artifact": { "properties": { "id": { "type": "string", "minLength": 1, "description": "Unique artifact identifier" }, "type": { "$ref": "#/components/schemas/ArtifactType" }, "path": { "type": "string", "minLength": 1, "description": "File or directory path of the artifact" }, "task_id": { "type": "string", "minLength": 1, "description": "ID of the task that produced this artifact" }, "created_by": { "type": "string", "minLength": 1, "description": "Agent ID of the creator" }, "description": { "type": "string", "description": "Human-readable description of the artifact", "default": "" }, "project_id": { "description": "ID of the project this artifact belongs to", "minLength": 1, "type": [ "string", "null" ] }, "content_type": { "type": "string", "description": "MIME content type (empty when no content stored)", "default": "" }, "size_bytes": { "type": "integer", "minimum": 0.0, "description": "Content size in bytes (zero when no content stored)", "default": 0 }, "created_at": { "description": "datetime with the constraint that the value must have timezone info", "format": "date-time", "type": [ "string", "null" ] } }, "type": "object", "required": [ "created_by", "id", "path", "task_id", "type" ], "title": "Artifact" }, "ArtifactType": { "type": "string", "enum": [ "code", "tests", "documentation" ], "title": "ArtifactType", "description": "Type of artifact expected" }, "Attachment": { "properties": { "type": { "$ref": "#/components/schemas/AttachmentType" }, "ref": { "type": "string", "minLength": 1, "description": "Reference identifier" } }, "type": "object", "required": [ "ref", "type" ], "title": "Attachment" }, "AttachmentType": { "type": "string", "enum": [ "artifact", "file", "link" ], "title": "AttachmentType", "description": "Kind of attachment" }, "AuthType": { "type": "string", "enum": [ "api_key", "oauth", "custom_header", "subscription", "none" ], "title": "AuthType", "description": "Authentication type for an LLM provider.", "default": "api_key" }, "AutoDowngradeConfig": { "properties": { "enabled": { "type": "boolean", "description": "Whether auto-downgrade is active", "default": false }, "threshold": { "type": "integer", "maximum": 100.0, "minimum": 0.0, "description": "Budget percent triggering downgrade", "default": 85 }, "downgrade_map": { "items": { "prefixItems": [ { "type": "string", "minLength": 1 }, { "type": "string", "minLength": 1 } ], "type": "array" }, "type": "array", "description": "Ordered pairs of (from_alias, to_alias)", "default": [] }, "boundary": { "type": "string", "const": "task_assignment", "description": "When to apply downgrade (task_assignment only, never mid-execution)", "default": "task_assignment" } }, "type": "object", "required": [], "title": "AutoDowngradeConfig", "description": "Automatic model downgrade configuration" }, "AutonomyLevel": { "type": "string", "enum": [ "full", "semi", "supervised", "locked" ], "title": "AutonomyLevel", "description": "Autonomy level controlling approval routing for agents.\n\nDetermines which actions an agent can execute autonomously vs.\nwhich require human or security-agent approval (see Operations design page).\n", "default": "semi" }, "AutonomyLevelRequest": { "properties": { "level": { "$ref": "#/components/schemas/AutonomyLevel" } }, "type": "object", "required": [ "level" ], "title": "AutonomyLevelRequest" }, "AutonomyLevelResponse": { "properties": { "agent_id": { "type": "string", "minLength": 1, "description": "Agent identifier" }, "level": { "$ref": "#/components/schemas/AutonomyLevel" }, "promotion_pending": { "type": "boolean", "description": "Whether a promotion request is pending approval", "default": false } }, "type": "object", "required": [ "agent_id", "level" ], "title": "AutonomyLevelResponse" }, "AvailableLocalesResponse": { "properties": { "regions": { "additionalProperties": { "items": { "type": "string" }, "type": "array" }, "type": "object" }, "display_names": { "additionalProperties": { "type": "string" }, "type": "object" } }, "type": "object", "required": [ "display_names", "regions" ], "title": "AvailableLocalesResponse" }, "BackupComponent": { "type": "string", "enum": [ "persistence", "memory", "config" ], "title": "BackupComponent", "description": "Identifiers for independently-backed-up data components." }, "BackupInfo": { "properties": { "backup_id": { "type": "string", "minLength": 1 }, "timestamp": { "type": "string", "minLength": 1 }, "trigger": { "$ref": "#/components/schemas/BackupTrigger" }, "components": { "items": { "$ref": "#/components/schemas/BackupComponent" }, "type": "array" }, "size_bytes": { "type": "integer", "minimum": 0.0 }, "compressed": { "type": "boolean" } }, "type": "object", "required": [ "backup_id", "components", "compressed", "size_bytes", "timestamp", "trigger" ], "title": "BackupInfo" }, "BackupManifest": { "properties": { "synthorg_version": { "type": "string", "minLength": 1 }, "timestamp": { "type": "string", "minLength": 1 }, "trigger": { "$ref": "#/components/schemas/BackupTrigger" }, "components": { "items": { "$ref": "#/components/schemas/BackupComponent" }, "type": "array" }, "size_bytes": { "type": "integer", "minimum": 0.0 }, "checksum": { "type": "string", "minLength": 1 }, "backup_id": { "type": "string", "minLength": 1 } }, "type": "object", "required": [ "backup_id", "checksum", "components", "size_bytes", "synthorg_version", "timestamp", "trigger" ], "title": "BackupManifest" }, "BackupTrigger": { "type": "string", "enum": [ "scheduled", "manual", "shutdown", "startup", "pre_migration" ], "title": "BackupTrigger", "description": "What initiated the backup." }, "BlueprintInfoResponse": { "properties": { "name": { "type": "string", "minLength": 1, "description": "Blueprint identifier" }, "display_name": { "type": "string", "minLength": 1, "description": "Human-readable name" }, "description": { "type": "string", "description": "Short description", "default": "" }, "source": { "type": "string", "enum": [ "builtin", "user" ], "description": "Origin: builtin or user" }, "tags": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Tags", "default": [] }, "workflow_type": { "$ref": "#/components/schemas/WorkflowType" }, "node_count": { "type": "integer", "minimum": 0.0, "description": "Number of nodes" }, "edge_count": { "type": "integer", "minimum": 0.0, "description": "Number of edges" } }, "type": "object", "required": [ "display_name", "edge_count", "name", "node_count", "source", "workflow_type" ], "title": "BlueprintInfoResponse" }, "BucketSize": { "type": "string", "enum": [ "hour", "day" ], "title": "BucketSize", "description": "Bucket granularity" }, "BudgetAlertConfig": { "properties": { "warn_at": { "type": "integer", "maximum": 100.0, "minimum": 0.0, "description": "Percent of budget triggering warning", "default": 75 }, "critical_at": { "type": "integer", "maximum": 100.0, "minimum": 0.0, "description": "Percent of budget triggering critical alert", "default": 90 }, "hard_stop_at": { "type": "integer", "maximum": 100.0, "minimum": 0.0, "description": "Percent of budget triggering hard stop", "default": 100 } }, "type": "object", "required": [], "title": "BudgetAlertConfig", "description": "Alert threshold configuration" }, "BudgetConfig": { "properties": { "total_monthly": { "type": "number", "minimum": 0.0, "description": "Monthly budget limit", "default": 100.0 }, "alerts": { "$ref": "#/components/schemas/BudgetAlertConfig" }, "per_task_limit": { "type": "number", "minimum": 0.0, "description": "Maximum cost per task", "default": 5.0 }, "per_agent_daily_limit": { "type": "number", "minimum": 0.0, "description": "Maximum cost per agent per day", "default": 10.0 }, "auto_downgrade": { "$ref": "#/components/schemas/AutoDowngradeConfig" }, "reset_day": { "type": "integer", "maximum": 28.0, "minimum": 1.0, "description": "Day of month when budget resets (1-28, avoids month-length issues)", "default": 1 }, "currency": { "type": "string", "maxLength": 3, "minLength": 3, "description": "ISO 4217 currency code for display formatting", "default": "EUR" }, "risk_budget": { "$ref": "#/components/schemas/RiskBudgetConfig" } }, "type": "object", "required": [], "title": "BudgetConfig" }, "CalibrationSummaryResponse": { "properties": { "agent_id": { "type": "string", "minLength": 1 }, "average_drift": { "maximum": 10.0, "type": [ "number", "null" ] }, "records": { "items": { "$ref": "#/components/schemas/LlmCalibrationRecord" }, "type": "array", "description": "Calibration records", "default": [] }, "record_count": { "type": "integer", "description": "Number of calibration records", "readOnly": true } }, "type": "object", "required": [ "agent_id", "record_count" ], "title": "CalibrationSummaryResponse" }, "CancelTaskRequest": { "properties": { "reason": { "type": "string", "maxLength": 4096, "minLength": 1, "description": "Reason for cancellation" } }, "type": "object", "required": [ "reason" ], "title": "CancelTaskRequest" }, "CareerEvent": { "properties": { "event_type": { "$ref": "#/components/schemas/LifecycleEventType" }, "timestamp": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" }, "description": { "type": "string", "maxLength": 1024, "description": "Human-readable event description", "default": "" }, "initiated_by": { "type": "string", "minLength": 1, "description": "Who triggered the event" }, "metadata": { "additionalProperties": { "type": "string" }, "type": "object", "description": "Additional structured metadata" } }, "type": "object", "required": [ "event_type", "initiated_by", "timestamp" ], "title": "CareerEvent" }, "CeremonyStrategyType": { "type": "string", "enum": [ "task_driven", "calendar", "hybrid", "event_driven", "budget_driven", "throughput_adaptive", "external_trigger", "milestone_driven" ], "title": "CeremonyStrategyType", "description": "Supported ceremony scheduling strategies.\n\nEach maps to a ``CeremonySchedulingStrategy`` implementation.\n\nMembers:\n TASK_DRIVEN: Ceremonies at task-count milestones.\n CALENDAR: Traditional time-based scheduling.\n HYBRID: Calendar + task-driven, whichever fires first.\n EVENT_DRIVEN: Ceremonies subscribe to engine events with debounce.\n BUDGET_DRIVEN: Ceremonies at cost-consumption thresholds.\n THROUGHPUT_ADAPTIVE: Ceremonies when throughput rate changes.\n EXTERNAL_TRIGGER: Ceremonies on external signals.\n MILESTONE_DRIVEN: Ceremonies at semantic project milestones.\n" }, "ChangePasswordRequest": { "properties": { "current_password": { "type": "string", "maxLength": 128, "minLength": 1 }, "new_password": { "type": "string", "maxLength": 128, "minLength": 1 } }, "type": "object", "required": [ "current_password", "new_password" ], "title": "ChangePasswordRequest" }, "Channel": { "properties": { "name": { "type": "string", "minLength": 1, "description": "Channel name" }, "type": { "$ref": "#/components/schemas/ChannelType" }, "subscribers": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Agent IDs subscribed to this channel", "default": [] } }, "type": "object", "required": [ "name" ], "title": "Channel" }, "ChannelType": { "type": "string", "enum": [ "topic", "direct", "broadcast" ], "title": "ChannelType", "description": "Channel delivery semantics", "default": "topic" }, "CheckpointRecord": { "properties": { "id": { "type": "string", "minLength": 1, "description": "Unique checkpoint ID" }, "run_id": { "type": "string", "minLength": 1, "description": "Originating run ID" }, "model_path": { "type": "string", "minLength": 1, "description": "Path to checkpoint" }, "base_model": { "type": "string", "minLength": 1, "description": "Base model identifier" }, "doc_count": { "type": "integer", "minimum": 0.0, "description": "Training document count" }, "eval_metrics": { "description": "Evaluation metrics", "anyOf": [ { "$ref": "#/components/schemas/EvalMetrics" }, { "type": "null" } ] }, "size_bytes": { "type": "integer", "minimum": 0.0, "description": "Checkpoint size on disk" }, "created_at": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" }, "is_active": { "type": "boolean", "description": "Currently deployed", "default": false }, "backup_config_json": { "description": "Pre-deployment config backup (JSON)", "type": [ "string", "null" ] } }, "type": "object", "required": [ "base_model", "created_at", "doc_count", "id", "model_path", "run_id", "size_bytes" ], "title": "CheckpointRecord" }, "CollaborationPreference": { "type": "string", "enum": [ "independent", "pair", "team" ], "title": "CollaborationPreference", "description": "Preferred collaboration mode for an agent.", "default": "team" }, "CollaborationScoreResult": { "properties": { "score": { "type": "number", "maximum": 10.0, "minimum": 0.0, "description": "Overall collaboration score" }, "strategy_name": { "type": "string", "minLength": 1, "description": "Scoring strategy used" }, "component_scores": { "items": { "prefixItems": [ { "type": "string", "minLength": 1 }, { "type": "number" } ], "type": "array" }, "type": "array", "description": "Per-component scores as (name, value) pairs", "default": [] }, "confidence": { "type": "number", "maximum": 1.0, "minimum": 0.0, "description": "Confidence in the score" }, "override_active": { "type": "boolean", "description": "Whether a human override is active", "default": false } }, "type": "object", "required": [ "confidence", "score", "strategy_name" ], "title": "CollaborationScoreResult" }, "CommunicationVerbosity": { "type": "string", "enum": [ "terse", "balanced", "verbose" ], "title": "CommunicationVerbosity", "description": "Communication verbosity level for an agent.", "default": "balanced" }, "Complexity": { "type": "string", "enum": [ "simple", "medium", "complex", "epic" ], "title": "Complexity", "description": "Task complexity estimate", "default": "medium" }, "ConflictApproach": { "type": "string", "enum": [ "avoid", "accommodate", "compete", "compromise", "collaborate" ], "title": "ConflictApproach", "description": "Conflict resolution approach used by an agent.", "default": "collaborate" }, "CoordinateTaskRequest": { "properties": { "agent_names": { "maxLength": 50, "minLength": 1, "description": "Agent names to coordinate with (None = all active)", "items": { "type": "string", "minLength": 1 }, "type": [ "array", "null" ] }, "max_subtasks": { "type": "integer", "maximum": 50.0, "minimum": 1.0, "default": 10 }, "max_concurrency_per_wave": { "maximum": 50, "minimum": 1, "type": [ "integer", "null" ] }, "fail_fast": { "type": [ "boolean", "null" ] } }, "type": "object", "required": [], "title": "CoordinateTaskRequest" }, "CoordinationPhaseResponse": { "properties": { "phase": { "type": "string", "minLength": 1 }, "success": { "type": "boolean" }, "duration_seconds": { "type": "number", "minimum": 0.0 }, "error": { "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [ "duration_seconds", "phase", "success" ], "title": "CoordinationPhaseResponse" }, "CoordinationResultResponse": { "properties": { "parent_task_id": { "type": "string", "maxLength": 128, "minLength": 1 }, "topology": { "type": "string", "minLength": 1 }, "total_duration_seconds": { "type": "number", "minimum": 0.0 }, "total_cost_usd": { "type": "number", "minimum": 0.0 }, "currency": { "type": "string", "maxLength": 3, "minLength": 3, "description": "ISO 4217 currency code", "default": "EUR" }, "phases": { "items": { "$ref": "#/components/schemas/CoordinationPhaseResponse" }, "type": "array", "minItems": 1 }, "wave_count": { "type": "integer", "minimum": 0.0 }, "is_success": { "type": "boolean", "description": "Whether all phases succeeded", "readOnly": true } }, "type": "object", "required": [ "is_success", "parent_task_id", "phases", "topology", "total_cost_usd", "total_duration_seconds", "wave_count" ], "title": "CoordinationResultResponse" }, "CoordinationTopology": { "type": "string", "enum": [ "sas", "centralized", "decentralized", "context_dependent", "auto" ], "title": "CoordinationTopology", "description": "Coordination topology for multi-agent execution", "default": "auto" }, "CostRecord": { "properties": { "agent_id": { "type": "string", "minLength": 1, "description": "Agent identifier" }, "task_id": { "type": "string", "minLength": 1, "description": "Task identifier" }, "provider": { "type": "string", "minLength": 1, "description": "LLM provider name" }, "model": { "type": "string", "minLength": 1, "description": "Model identifier" }, "input_tokens": { "type": "integer", "minimum": 0.0, "description": "Input token count" }, "output_tokens": { "type": "integer", "minimum": 0.0, "description": "Output token count" }, "cost_usd": { "type": "number", "minimum": 0.0, "description": "Cost in USD (base currency)" }, "timestamp": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" }, "call_category": { "description": "LLM call category (productive, coordination, system)", "type": [ "string", "null" ], "enum": [ "productive", "coordination", "system", null ] } }, "type": "object", "required": [ "agent_id", "cost_usd", "input_tokens", "model", "output_tokens", "provider", "task_id", "timestamp" ], "title": "CostRecord" }, "CostRecordListResponse": { "properties": { "data": { "items": { "$ref": "#/components/schemas/CostRecord" }, "type": "array", "default": [] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "pagination": { "$ref": "#/components/schemas/PaginationMeta" }, "daily_summary": { "items": { "$ref": "#/components/schemas/DailySummary" }, "type": "array", "default": [] }, "period_summary": { "$ref": "#/components/schemas/PeriodSummary" }, "currency": { "type": "string", "maxLength": 3, "minLength": 3, "description": "ISO 4217 currency code", "default": "EUR" }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "pagination", "period_summary", "success" ], "title": "CostRecordListResponse" }, "CreateApprovalRequest": { "properties": { "action_type": { "type": "string", "maxLength": 128, "minLength": 1 }, "title": { "type": "string", "maxLength": 256, "minLength": 1 }, "description": { "type": "string", "maxLength": 4096, "minLength": 1 }, "risk_level": { "$ref": "#/components/schemas/ApprovalRiskLevel" }, "ttl_seconds": { "maximum": 604800, "minimum": 60, "type": [ "integer", "null" ] }, "task_id": { "maxLength": 128, "minLength": 1, "type": [ "string", "null" ] }, "metadata": { "additionalProperties": { "type": "string" }, "type": "object" } }, "type": "object", "required": [ "action_type", "description", "risk_level", "title" ], "title": "CreateApprovalRequest" }, "CreateArtifactRequest": { "properties": { "type": { "$ref": "#/components/schemas/ArtifactType" }, "path": { "type": "string", "maxLength": 1024, "minLength": 1 }, "task_id": { "type": "string", "minLength": 1 }, "created_by": { "type": "string", "minLength": 1 }, "description": { "type": "string", "maxLength": 4096, "default": "" }, "content_type": { "type": "string", "maxLength": 256, "default": "" }, "project_id": { "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [ "created_by", "path", "task_id", "type" ], "title": "CreateArtifactRequest" }, "CreateFromBlueprintRequest": { "properties": { "blueprint_name": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Blueprint to instantiate" }, "name": { "maxLength": 256, "description": "Workflow name override", "minLength": 1, "type": [ "string", "null" ] }, "description": { "maxLength": 4096, "description": "Description override", "type": [ "string", "null" ] } }, "type": "object", "required": [ "blueprint_name" ], "title": "CreateFromBlueprintRequest" }, "CreateFromPresetRequest": { "properties": { "preset_name": { "type": "string", "minLength": 1 }, "name": { "type": "string", "maxLength": 64, "minLength": 1 }, "auth_type": { "type": [ "string", "null" ], "enum": [ "api_key", "oauth", "custom_header", "subscription", "none", null ], "default": "api_key" }, "api_key": { "minLength": 1, "type": [ "string", "null" ] }, "subscription_token": { "minLength": 1, "type": [ "string", "null" ] }, "tos_accepted": { "type": "boolean", "default": false }, "base_url": { "minLength": 1, "type": [ "string", "null" ] }, "models": { "items": { "$ref": "#/components/schemas/ProviderModelConfig" }, "type": [ "array", "null" ] } }, "type": "object", "required": [ "name", "preset_name" ], "title": "CreateFromPresetRequest" }, "CreatePresetRequest": { "properties": { "traits": { "items": { "type": "string", "minLength": 1 }, "type": "array", "maxItems": 50, "default": [] }, "communication_style": { "type": "string", "maxLength": 100, "minLength": 1, "default": "neutral" }, "risk_tolerance": { "$ref": "#/components/schemas/RiskTolerance" }, "creativity": { "$ref": "#/components/schemas/CreativityLevel" }, "description": { "type": "string", "maxLength": 500, "default": "" }, "openness": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.5 }, "conscientiousness": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.5 }, "extraversion": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.5 }, "agreeableness": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.5 }, "stress_response": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.5 }, "decision_making": { "$ref": "#/components/schemas/DecisionMakingStyle" }, "collaboration": { "$ref": "#/components/schemas/CollaborationPreference" }, "verbosity": { "$ref": "#/components/schemas/CommunicationVerbosity" }, "conflict_approach": { "$ref": "#/components/schemas/ConflictApproach" }, "name": { "type": "string", "maxLength": 100, "minLength": 1 } }, "type": "object", "required": [ "name" ], "title": "CreatePresetRequest" }, "CreateProjectRequest": { "properties": { "name": { "type": "string", "maxLength": 256, "minLength": 1 }, "description": { "type": "string", "maxLength": 4096, "default": "" }, "team": { "items": { "type": "string", "minLength": 1 }, "type": "array", "maxItems": 50, "default": [] }, "lead": { "minLength": 1, "type": [ "string", "null" ] }, "deadline": { "type": [ "string", "null" ] }, "budget": { "type": "number", "minimum": 0.0, "default": 0.0 } }, "type": "object", "required": [ "name" ], "title": "CreateProjectRequest" }, "CreateProviderRequest": { "properties": { "name": { "type": "string", "maxLength": 64, "minLength": 1 }, "driver": { "type": "string", "minLength": 1, "default": "litellm" }, "litellm_provider": { "minLength": 1, "type": [ "string", "null" ] }, "auth_type": { "$ref": "#/components/schemas/AuthType" }, "api_key": { "minLength": 1, "type": [ "string", "null" ] }, "subscription_token": { "minLength": 1, "type": [ "string", "null" ] }, "tos_accepted": { "type": "boolean", "default": false }, "base_url": { "minLength": 1, "type": [ "string", "null" ] }, "oauth_token_url": { "minLength": 1, "type": [ "string", "null" ] }, "oauth_client_id": { "minLength": 1, "type": [ "string", "null" ] }, "oauth_client_secret": { "minLength": 1, "type": [ "string", "null" ] }, "oauth_scope": { "minLength": 1, "type": [ "string", "null" ] }, "custom_header_name": { "minLength": 1, "type": [ "string", "null" ] }, "custom_header_value": { "minLength": 1, "type": [ "string", "null" ] }, "models": { "items": { "$ref": "#/components/schemas/ProviderModelConfig" }, "type": "array", "default": [] }, "preset_name": { "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [ "name" ], "title": "CreateProviderRequest" }, "CreateTaskRequest": { "properties": { "title": { "type": "string", "maxLength": 256, "minLength": 1 }, "description": { "type": "string", "maxLength": 4096, "minLength": 1 }, "type": { "$ref": "#/components/schemas/TaskType" }, "priority": { "$ref": "#/components/schemas/Priority" }, "project": { "type": "string", "minLength": 1 }, "created_by": { "type": "string", "minLength": 1 }, "assigned_to": { "minLength": 1, "type": [ "string", "null" ] }, "estimated_complexity": { "$ref": "#/components/schemas/Complexity" }, "budget_limit": { "type": "number", "minimum": 0.0, "default": 0.0 } }, "type": "object", "required": [ "created_by", "description", "project", "title", "type" ], "title": "CreateTaskRequest" }, "CreateUserRequest": { "properties": { "username": { "type": "string", "maxLength": 128, "minLength": 1 }, "password": { "type": "string", "maxLength": 128, "minLength": 1 }, "role": { "$ref": "#/components/schemas/HumanRole" } }, "type": "object", "required": [ "password", "role", "username" ], "title": "CreateUserRequest" }, "CreateWorkflowDefinitionRequest": { "properties": { "name": { "type": "string", "maxLength": 256, "minLength": 1, "description": "Workflow name" }, "description": { "type": "string", "maxLength": 4096, "description": "Description", "default": "" }, "workflow_type": { "$ref": "#/components/schemas/WorkflowType" }, "nodes": { "items": { "additionalProperties": {}, "type": "object" }, "type": "array", "maxItems": 500, "description": "Workflow nodes" }, "edges": { "items": { "additionalProperties": {}, "type": "object" }, "type": "array", "maxItems": 1000, "description": "Workflow edges" } }, "type": "object", "required": [ "edges", "name", "nodes", "workflow_type" ], "title": "CreateWorkflowDefinitionRequest" }, "CreativityLevel": { "type": "string", "enum": [ "low", "medium", "high" ], "title": "CreativityLevel", "description": "Creativity level for agent personality.", "default": "medium" }, "DailySummary": { "properties": { "date": { "type": "string", "minLength": 1, "description": "ISO date (YYYY-MM-DD)" }, "total_cost_usd": { "type": "number", "minimum": 0.0, "description": "Total cost in USD (base currency)" }, "currency": { "type": "string", "maxLength": 3, "minLength": 3, "description": "ISO 4217 currency code", "default": "EUR" }, "total_input_tokens": { "type": "integer", "minimum": 0.0, "description": "Total input tokens" }, "total_output_tokens": { "type": "integer", "minimum": 0.0, "description": "Total output tokens" }, "record_count": { "type": "integer", "minimum": 0.0, "description": "Number of records" } }, "type": "object", "required": [ "date", "record_count", "total_cost_usd", "total_input_tokens", "total_output_tokens" ], "title": "DailySummary" }, "DecisionMakingStyle": { "type": "string", "enum": [ "analytical", "intuitive", "consultative", "directive" ], "title": "DecisionMakingStyle", "description": "Decision-making approach used by an agent.", "default": "consultative" }, "Department": { "properties": { "name": { "type": "string", "minLength": 1, "description": "Department name" }, "head": { "description": "Department head role name or identifier", "minLength": 1, "type": [ "string", "null" ] }, "head_id": { "description": "Optional unique identifier for the department head", "minLength": 1, "type": [ "string", "null" ] }, "budget_percent": { "type": "number", "maximum": 100.0, "minimum": 0.0, "description": "Percentage of company budget allocated", "default": 0.0 }, "teams": { "items": { "$ref": "#/components/schemas/Team" }, "type": "array", "description": "Teams within this department", "default": [] }, "reporting_lines": { "items": { "$ref": "#/components/schemas/ReportingLine" }, "type": "array", "description": "Explicit reporting relationships", "default": [] }, "autonomy_level": { "description": "Per-department autonomy level override (D6)", "type": [ "string", "null" ], "enum": [ "full", "semi", "supervised", "locked", null ], "default": "semi" }, "policies": { "$ref": "#/components/schemas/DepartmentPolicies" }, "ceremony_policy": { "description": "Per-department ceremony policy override", "additionalProperties": {}, "type": [ "object", "null" ] } }, "type": "object", "required": [ "name" ], "title": "Department" }, "DepartmentHealth": { "properties": { "department_name": { "type": "string", "minLength": 1, "description": "Department name" }, "agent_count": { "type": "integer", "minimum": 0.0, "description": "Total agents" }, "active_agent_count": { "type": "integer", "minimum": 0.0, "description": "Active agents" }, "currency": { "type": "string", "maxLength": 3, "minLength": 3, "description": "ISO 4217 currency code", "default": "EUR" }, "avg_performance_score": { "maximum": 10.0, "description": "Mean quality score (0-10)", "type": [ "number", "null" ] }, "department_cost_7d": { "type": "number", "minimum": 0.0, "description": "Total cost in last 7 days" }, "cost_trend": { "items": { "$ref": "#/components/schemas/TrendDataPoint" }, "type": "array", "description": "7-day daily spend sparkline" }, "collaboration_score": { "maximum": 10.0, "description": "Mean collaboration score (0-10)", "type": [ "number", "null" ] }, "utilization_percent": { "type": "number", "description": "Percentage of agents that are active.", "readOnly": true } }, "type": "object", "required": [ "active_agent_count", "agent_count", "cost_trend", "department_cost_7d", "department_name", "utilization_percent" ], "title": "DepartmentHealth" }, "DepartmentPolicies": { "properties": { "review_requirements": { "$ref": "#/components/schemas/ReviewRequirements" }, "approval_chains": { "items": { "$ref": "#/components/schemas/ApprovalChain" }, "type": "array", "description": "Approval chains for action types", "default": [] } }, "type": "object", "required": [], "title": "DepartmentPolicies", "description": "Department-level operational policies" }, "DiscoverModelsResponse": { "properties": { "discovered_models": { "items": { "$ref": "#/components/schemas/ProviderModelConfig" }, "type": "array" }, "provider_name": { "type": "string", "minLength": 1 } }, "type": "object", "required": [ "discovered_models", "provider_name" ], "title": "DiscoverModelsResponse" }, "DiscoveryPolicyResponse": { "properties": { "host_port_allowlist": { "items": { "type": "string", "minLength": 1 }, "type": "array", "default": [] }, "block_private_ips": { "type": "boolean", "default": true }, "entry_count": { "type": "integer", "description": "Number of entries in the allowlist.", "readOnly": true } }, "type": "object", "required": [ "entry_count" ], "title": "DiscoveryPolicyResponse" }, "EdgeChange": { "properties": { "edge_id": { "type": "string", "minLength": 1 }, "change_type": { "type": "string", "enum": [ "added", "removed", "reconnected", "type_changed", "label_changed" ] }, "old_value": { "additionalProperties": {}, "type": [ "object", "null" ] }, "new_value": { "additionalProperties": {}, "type": [ "object", "null" ] } }, "type": "object", "required": [ "change_type", "edge_id" ], "title": "EdgeChange" }, "ErrorCategory": { "type": "string", "enum": [ "auth", "validation", "not_found", "conflict", "rate_limit", "budget_exhausted", "provider_error", "internal" ], "title": "ErrorCategory", "description": "High-level error category for structured error responses.\n\nValues are lowercase strings suitable for JSON serialization.\n" }, "ErrorCode": { "type": "integer", "enum": [ 1000, 1001, 1002, 2000, 2001, 3000, 3001, 3002, 4000, 4001, 4002, 5000, 6000, 7000, 8000, 8001, 8002 ], "title": "ErrorCode", "description": "Machine-readable error codes (4-digit, category-grouped).\n\nFirst digit encodes the category:\n1xxx = auth, 2xxx = validation, 3xxx = not_found, 4xxx = conflict,\n5xxx = rate_limit, 6xxx = budget_exhausted, 7xxx = provider_error,\n8xxx = internal.\n" }, "ErrorDetail": { "properties": { "detail": { "type": "string", "minLength": 1 }, "error_code": { "$ref": "#/components/schemas/ErrorCode" }, "error_category": { "$ref": "#/components/schemas/ErrorCategory" }, "retryable": { "type": "boolean", "default": false }, "retry_after": { "type": [ "integer", "null" ] }, "instance": { "type": "string", "minLength": 1 }, "title": { "type": "string", "minLength": 1 }, "type": { "type": "string", "minLength": 1 } }, "type": "object", "required": [ "detail", "error_category", "error_code", "instance", "title", "type" ], "title": "ErrorDetail" }, "EvalMetrics": { "properties": { "ndcg_at_10": { "type": "number", "maximum": 1.0, "minimum": 0.0, "description": "NDCG@10 fine-tuned" }, "recall_at_10": { "type": "number", "maximum": 1.0, "minimum": 0.0, "description": "Recall@10 fine-tuned" }, "base_ndcg_at_10": { "type": "number", "maximum": 1.0, "minimum": 0.0, "description": "NDCG@10 base" }, "base_recall_at_10": { "type": "number", "maximum": 1.0, "minimum": 0.0, "description": "Recall@10 base" }, "improvement_ndcg": { "type": "number", "description": "Relative improvement in NDCG@10.", "readOnly": true }, "improvement_recall": { "type": "number", "description": "Relative improvement in Recall@10.", "readOnly": true } }, "type": "object", "required": [ "base_ndcg_at_10", "base_recall_at_10", "improvement_ndcg", "improvement_recall", "ndcg_at_10", "recall_at_10" ], "title": "EvalMetrics" }, "ExpectedArtifact": { "properties": { "type": { "$ref": "#/components/schemas/ArtifactType" }, "path": { "type": "string", "minLength": 1, "description": "File or directory path for the artifact" } }, "type": "object", "required": [ "path", "type" ], "title": "ExpectedArtifact" }, "FineTuneRequest": { "properties": { "source_dir": { "type": "string", "minLength": 1, "description": "Directory containing org documents" }, "base_model": { "description": "Base model to fine-tune (None = active model)", "minLength": 1, "type": [ "string", "null" ] }, "output_dir": { "description": "Checkpoint output directory (None = default)", "minLength": 1, "type": [ "string", "null" ] }, "resume_run_id": { "description": "Resume a previous failed/cancelled run", "minLength": 1, "type": [ "string", "null" ] }, "epochs": { "minimum": 1, "description": "Override training epochs", "type": [ "integer", "null" ] }, "learning_rate": { "description": "Override learning rate", "type": [ "number", "null" ] }, "temperature": { "description": "Override InfoNCE temperature", "type": [ "number", "null" ] }, "top_k": { "minimum": 1, "description": "Override hard negative count per query", "type": [ "integer", "null" ] }, "batch_size": { "minimum": 1, "description": "Override training batch size", "type": [ "integer", "null" ] }, "validation_split": { "exclusiveMaximum": 1.0, "description": "Fraction of data held out for evaluation", "type": [ "number", "null" ] } }, "type": "object", "required": [ "source_dir" ], "title": "FineTuneRequest" }, "FineTuneRun": { "properties": { "id": { "type": "string", "minLength": 1, "description": "Unique run identifier" }, "stage": { "$ref": "#/components/schemas/FineTuneStage" }, "progress": { "maximum": 1.0, "description": "Progress within current stage", "type": [ "number", "null" ] }, "error": { "description": "Error message if failed", "minLength": 1, "type": [ "string", "null" ] }, "config": { "$ref": "#/components/schemas/FineTuneRunConfig" }, "started_at": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" }, "updated_at": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" }, "completed_at": { "description": "datetime with the constraint that the value must have timezone info", "format": "date-time", "type": [ "string", "null" ] }, "stages_completed": { "items": { "type": "string" }, "type": "array", "description": "Successfully completed stage names", "default": [] }, "duration_seconds": { "description": "Run duration in seconds (``None`` if not completed).", "readOnly": true, "type": [ "number", "null" ] } }, "type": "object", "required": [ "config", "id", "stage", "started_at", "updated_at" ], "title": "FineTuneRun" }, "FineTuneRunConfig": { "properties": { "source_dir": { "type": "string", "minLength": 1, "description": "Source document directory" }, "base_model": { "type": "string", "minLength": 1, "description": "Base embedding model" }, "output_dir": { "type": "string", "minLength": 1, "description": "Checkpoint output directory" }, "epochs": { "type": "integer", "minimum": 1.0, "description": "Training epochs", "default": 3 }, "learning_rate": { "type": "number", "exclusiveMinimum": 0.0, "description": "Learning rate", "default": 1e-05 }, "temperature": { "type": "number", "exclusiveMinimum": 0.0, "description": "InfoNCE temperature", "default": 0.02 }, "top_k": { "type": "integer", "minimum": 1.0, "description": "Hard negatives per query", "default": 4 }, "batch_size": { "type": "integer", "minimum": 1.0, "description": "Training batch size", "default": 128 }, "validation_split": { "type": "number", "exclusiveMaximum": 1.0, "exclusiveMinimum": 0.0, "description": "Fraction held out for evaluation", "default": 0.1 } }, "type": "object", "required": [ "base_model", "output_dir", "source_dir" ], "title": "FineTuneRunConfig", "description": "Configuration snapshot" }, "FineTuneStage": { "type": "string", "enum": [ "idle", "generating_data", "mining_negatives", "training", "evaluating", "deploying", "complete", "failed" ], "title": "FineTuneStage", "description": "Current pipeline stage", "default": "idle" }, "FineTuneStatus": { "properties": { "run_id": { "description": "Current or most recent run ID", "minLength": 1, "type": [ "string", "null" ] }, "stage": { "$ref": "#/components/schemas/FineTuneStage" }, "progress": { "maximum": 1.0, "description": "Progress fraction (0.0-1.0)", "type": [ "number", "null" ] }, "error": { "description": "Error message if failed", "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [], "title": "FineTuneStatus" }, "ForecastPoint": { "properties": { "day": { "type": "string", "format": "date", "description": "Calendar date" }, "projected_spend_usd": { "type": "number", "minimum": 0.0, "description": "Projected cumulative spend in USD (base currency)" } }, "type": "object", "required": [ "day", "projected_spend_usd" ], "title": "ForecastPoint" }, "ForecastResponse": { "properties": { "horizon_days": { "type": "integer", "minimum": 1.0, "description": "Projection horizon" }, "projected_total_usd": { "type": "number", "minimum": 0.0, "description": "Projected total spend over the horizon" }, "daily_projections": { "items": { "$ref": "#/components/schemas/ForecastPoint" }, "type": "array", "description": "Per-day cumulative spend projections" }, "days_until_exhausted": { "description": "Days until budget exhaustion", "type": [ "integer", "null" ] }, "confidence": { "type": "number", "maximum": 1.0, "minimum": 0.0, "description": "Confidence score based on data density" }, "avg_daily_spend_usd": { "type": "number", "minimum": 0.0, "description": "Average daily spend used for projection" }, "currency": { "type": "string", "maxLength": 3, "minLength": 3, "description": "ISO 4217 currency code", "default": "EUR" } }, "type": "object", "required": [ "avg_daily_spend_usd", "confidence", "daily_projections", "horizon_days", "projected_total_usd" ], "title": "ForecastResponse" }, "GenerateReportRequest": { "properties": { "period": { "$ref": "#/components/schemas/ReportPeriod" } }, "type": "object", "required": [ "period" ], "title": "GenerateReportRequest" }, "HealthStatus": { "properties": { "status": { "$ref": "#/components/schemas/ServiceStatus" }, "persistence": { "description": "Persistence backend healthy (None if not configured)", "type": [ "boolean", "null" ] }, "message_bus": { "description": "Message bus running (None if not configured)", "type": [ "boolean", "null" ] }, "version": { "type": "string", "description": "Application version" }, "uptime_seconds": { "type": "number", "description": "Seconds since startup" } }, "type": "object", "required": [ "status", "uptime_seconds", "version" ], "title": "HealthStatus" }, "HumanRole": { "type": "string", "enum": [ "ceo", "manager", "board_member", "pair_programmer", "observer", "system" ], "title": "HumanRole", "description": "Recognised human roles for access control." }, "LLMCallCategory": { "type": "string", "enum": [ "productive", "coordination", "system" ], "title": "LLMCallCategory", "description": "Purpose category for an LLM API call.\n\nUsed to distinguish direct task work from coordination overhead,\nenabling data-driven tuning of multi-agent orchestration.\n" }, "LifecycleEventType": { "type": "string", "enum": [ "hired", "onboarded", "fired", "offboarded", "status_changed", "promoted", "demoted" ], "title": "LifecycleEventType", "description": "Lifecycle event type" }, "LlmCalibrationRecord": { "properties": { "id": { "type": "string", "minLength": 1, "description": "Unique record identifier" }, "agent_id": { "type": "string", "minLength": 1, "description": "Agent being evaluated" }, "sampled_at": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" }, "interaction_record_id": { "type": "string", "minLength": 1, "description": "ID of the sampled CollaborationMetricRecord" }, "llm_score": { "type": "number", "maximum": 10.0, "minimum": 0.0, "description": "LLM-assigned collaboration score" }, "behavioral_score": { "type": "number", "maximum": 10.0, "minimum": 0.0, "description": "Behavioral strategy score at time of sampling" }, "rationale": { "type": "string", "maxLength": 2048, "minLength": 1, "description": "LLM's explanation for the score" }, "model_used": { "type": "string", "minLength": 1, "description": "Which LLM model was used for evaluation" }, "cost_usd": { "type": "number", "minimum": 0.0, "description": "Cost of the LLM call in USD (base currency)" }, "drift": { "type": "number", "description": "Absolute difference between LLM and behavioral scores", "readOnly": true } }, "type": "object", "required": [ "agent_id", "behavioral_score", "cost_usd", "drift", "interaction_record_id", "llm_score", "model_used", "rationale", "sampled_at" ], "title": "LlmCalibrationRecord" }, "LocalModelParams": { "properties": { "num_ctx": { "type": [ "integer", "null" ] }, "num_gpu_layers": { "type": [ "integer", "null" ] }, "num_threads": { "type": [ "integer", "null" ] }, "num_batch": { "type": [ "integer", "null" ] }, "repeat_penalty": { "description": "Repetition penalty", "type": [ "number", "null" ] } }, "type": "object", "required": [], "title": "LocalModelParams" }, "LoginRequest": { "properties": { "username": { "type": "string", "maxLength": 128, "minLength": 1 }, "password": { "type": "string", "maxLength": 128, "minLength": 1 } }, "type": "object", "required": [ "password", "username" ], "title": "LoginRequest" }, "MeetingAgenda": { "properties": { "title": { "type": "string", "minLength": 1, "description": "Meeting title" }, "context": { "type": "string", "description": "Background context for the meeting", "default": "" }, "items": { "items": { "$ref": "#/components/schemas/MeetingAgendaItem" }, "type": "array", "description": "Ordered agenda items", "default": [] } }, "type": "object", "required": [ "title" ], "title": "MeetingAgenda", "description": "Meeting agenda" }, "MeetingAgendaItem": { "properties": { "title": { "type": "string", "minLength": 1, "description": "Agenda topic title" }, "description": { "type": "string", "description": "Detailed topic description", "default": "" }, "presenter_id": { "description": "Agent who presents this item", "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [ "title" ], "title": "MeetingAgendaItem" }, "MeetingContribution": { "properties": { "agent_id": { "type": "string", "minLength": 1, "description": "Contributing agent" }, "content": { "type": "string", "description": "Contribution content" }, "phase": { "$ref": "#/components/schemas/MeetingPhase" }, "turn_number": { "type": "integer", "minimum": 0.0, "description": "Turn number" }, "input_tokens": { "type": "integer", "minimum": 0.0, "description": "Prompt tokens consumed", "default": 0 }, "output_tokens": { "type": "integer", "minimum": 0.0, "description": "Response tokens generated", "default": 0 }, "timestamp": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" } }, "type": "object", "required": [ "agent_id", "content", "phase", "timestamp", "turn_number" ], "title": "MeetingContribution" }, "MeetingMinutes": { "properties": { "meeting_id": { "type": "string", "minLength": 1, "description": "Unique meeting ID" }, "protocol_type": { "$ref": "#/components/schemas/MeetingProtocolType" }, "leader_id": { "type": "string", "minLength": 1, "description": "Meeting leader" }, "participant_ids": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Meeting participants" }, "agenda": { "$ref": "#/components/schemas/MeetingAgenda" }, "contributions": { "items": { "$ref": "#/components/schemas/MeetingContribution" }, "type": "array", "description": "All contributions in order", "default": [] }, "summary": { "type": "string", "description": "Final summary", "default": "" }, "decisions": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Decisions made", "default": [] }, "action_items": { "items": { "$ref": "#/components/schemas/ActionItem" }, "type": "array", "description": "Extracted action items", "default": [] }, "conflicts_detected": { "type": "boolean", "description": "Whether conflicts were detected", "default": false }, "total_input_tokens": { "type": "integer", "minimum": 0.0, "description": "Total prompt tokens", "default": 0 }, "total_output_tokens": { "type": "integer", "minimum": 0.0, "description": "Total response tokens", "default": 0 }, "started_at": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" }, "ended_at": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" }, "total_tokens": { "type": "integer", "description": "Total tokens consumed (input + output).", "readOnly": true } }, "type": "object", "required": [ "agenda", "ended_at", "leader_id", "meeting_id", "participant_ids", "protocol_type", "started_at", "total_tokens" ], "title": "MeetingMinutes" }, "MeetingPhase": { "type": "string", "enum": [ "agenda_broadcast", "round_robin_turn", "position_paper", "input_gathering", "discussion", "synthesis", "summary" ], "title": "MeetingPhase", "description": "Phase of contribution" }, "MeetingProtocolType": { "type": "string", "enum": [ "round_robin", "position_papers", "structured_phases" ], "title": "MeetingProtocolType", "description": "Protocol strategy used" }, "MeetingResponse": { "properties": { "meeting_id": { "type": "string", "minLength": 1, "description": "Unique meeting ID" }, "meeting_type_name": { "type": "string", "minLength": 1, "description": "Meeting type from config" }, "protocol_type": { "$ref": "#/components/schemas/MeetingProtocolType" }, "status": { "$ref": "#/components/schemas/MeetingStatus" }, "minutes": { "description": "Complete minutes on success", "anyOf": [ { "$ref": "#/components/schemas/MeetingMinutes" }, { "type": "null" } ] }, "error_message": { "description": "Error description on failure", "minLength": 1, "type": [ "string", "null" ] }, "token_budget": { "type": "integer", "exclusiveMinimum": 0.0, "description": "Token budget allocated" }, "token_usage_by_participant": { "additionalProperties": { "type": "integer" }, "type": "object", "description": "Total tokens consumed per participant" }, "contribution_rank": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Agent IDs sorted by contribution (descending)", "default": [] }, "meeting_duration_seconds": { "description": "Meeting duration in seconds (null if no minutes)", "type": [ "number", "null" ] } }, "type": "object", "required": [ "meeting_id", "meeting_type_name", "protocol_type", "status", "token_budget" ], "title": "MeetingResponse" }, "MeetingStatus": { "type": "string", "enum": [ "scheduled", "in_progress", "completed", "failed", "cancelled", "budget_exhausted" ], "title": "MeetingStatus", "description": "Final meeting status" }, "Message": { "properties": { "id": { "type": "string", "format": "uuid", "description": "Unique message identifier" }, "timestamp": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" }, "sender": { "type": "string", "minLength": 1, "description": "Sender agent ID" }, "to": { "type": "string", "minLength": 1, "description": "Recipient agent or channel" }, "type": { "$ref": "#/components/schemas/MessageType" }, "priority": { "$ref": "#/components/schemas/MessagePriority" }, "channel": { "type": "string", "minLength": 1, "description": "Channel the message is sent through" }, "content": { "type": "string", "minLength": 1, "description": "Message body text" }, "attachments": { "items": { "$ref": "#/components/schemas/Attachment" }, "type": "array", "description": "Attached references", "default": [] }, "metadata": { "$ref": "#/components/schemas/MessageMetadata" } }, "type": "object", "required": [ "channel", "content", "sender", "timestamp", "to", "type" ], "title": "Message" }, "MessageMetadata": { "properties": { "task_id": { "description": "Related task identifier", "minLength": 1, "type": [ "string", "null" ] }, "project_id": { "description": "Related project identifier", "minLength": 1, "type": [ "string", "null" ] }, "tokens_used": { "description": "LLM tokens consumed", "type": [ "integer", "null" ] }, "cost_usd": { "description": "Estimated cost in USD (base currency)", "type": [ "number", "null" ] }, "extra": { "items": { "prefixItems": [ { "type": "string" }, { "type": "string" } ], "type": "array" }, "type": "array", "description": "Immutable key-value pairs for arbitrary metadata", "default": [] } }, "type": "object", "required": [], "title": "MessageMetadata", "description": "Optional message metadata" }, "MessagePriority": { "type": "string", "enum": [ "low", "normal", "high", "urgent" ], "title": "MessagePriority", "description": "Message priority level", "default": "normal" }, "MessageType": { "type": "string", "enum": [ "task_update", "question", "announcement", "review_request", "approval", "delegation", "status_report", "escalation", "meeting_contribution", "hr_notification" ], "title": "MessageType", "description": "Message type classification" }, "MetadataChange": { "properties": { "field": { "type": "string", "minLength": 1 }, "old_value": { "type": "string" }, "new_value": { "type": "string" } }, "type": "object", "required": [ "field", "new_value", "old_value" ], "title": "MetadataChange" }, "NodeChange": { "properties": { "node_id": { "type": "string", "minLength": 1 }, "change_type": { "type": "string", "enum": [ "added", "removed", "moved", "config_changed", "label_changed", "type_changed" ] }, "old_value": { "additionalProperties": {}, "type": [ "object", "null" ] }, "new_value": { "additionalProperties": {}, "type": [ "object", "null" ] } }, "type": "object", "required": [ "change_type", "node_id" ], "title": "NodeChange" }, "OverrideResponse": { "properties": { "agent_id": { "type": "string", "minLength": 1 }, "score": { "type": "number", "maximum": 10.0, "minimum": 0.0 }, "reason": { "type": "string", "minLength": 1 }, "applied_by": { "type": "string", "minLength": 1 }, "applied_at": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" }, "expires_at": { "format": "date-time", "description": "datetime with the constraint that the value must have timezone info", "type": [ "string", "null" ] } }, "type": "object", "required": [ "agent_id", "applied_at", "applied_by", "reason", "score" ], "title": "OverrideResponse" }, "OverviewMetrics": { "properties": { "total_tasks": { "type": "integer", "minimum": 0.0, "description": "Total number of tasks" }, "tasks_by_status": { "additionalProperties": { "type": "integer" }, "type": "object", "description": "Task counts by status (keys are TaskStatus values)" }, "total_agents": { "type": "integer", "minimum": 0.0, "description": "Number of configured agents" }, "total_cost_usd": { "type": "number", "minimum": 0.0, "description": "Total cost in USD (base currency)" }, "budget_remaining_usd": { "type": "number", "minimum": 0.0, "description": "Remaining budget in USD (base currency)" }, "currency": { "type": "string", "maxLength": 3, "minLength": 3, "description": "ISO 4217 currency code", "default": "EUR" }, "budget_used_percent": { "type": "number", "minimum": 0.0, "description": "Percentage of monthly budget used (>100 = overrun)" }, "cost_7d_trend": { "items": { "$ref": "#/components/schemas/TrendDataPoint" }, "type": "array", "description": "Daily spend sparkline for the last 7 days" }, "active_agents_count": { "type": "integer", "minimum": 0.0, "description": "Number of active agents" }, "idle_agents_count": { "type": "integer", "minimum": 0.0, "description": "Number of non-active agents" } }, "type": "object", "required": [ "active_agents_count", "budget_remaining_usd", "budget_used_percent", "cost_7d_trend", "idle_agents_count", "tasks_by_status", "total_agents", "total_cost_usd", "total_tasks" ], "title": "OverviewMetrics" }, "PackInfoResponse": { "properties": { "name": { "type": "string", "minLength": 1 }, "display_name": { "type": "string" }, "description": { "type": "string" }, "source": { "type": "string", "enum": [ "builtin", "user" ] }, "tags": { "items": { "type": "string" }, "type": "array" }, "agent_count": { "type": "integer", "minimum": 0.0 }, "department_count": { "type": "integer", "minimum": 0.0 } }, "type": "object", "required": [ "agent_count", "department_count", "description", "display_name", "name", "source", "tags" ], "title": "PackInfoResponse" }, "PaginatedResponse_ActivityEvent_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/ActivityEvent" }, "type": "array", "default": [] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "pagination": { "$ref": "#/components/schemas/PaginationMeta" }, "degraded_sources": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Data sources that failed gracefully (partial data)", "default": [] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[ActivityEvent]" }, "PaginatedResponse_AgentConfig_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/AgentConfig" }, "type": "array", "default": [] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "pagination": { "$ref": "#/components/schemas/PaginationMeta" }, "degraded_sources": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Data sources that failed gracefully (partial data)", "default": [] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[AgentConfig]" }, "PaginatedResponse_ApprovalResponse_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/ApprovalResponse" }, "type": "array", "default": [] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "pagination": { "$ref": "#/components/schemas/PaginationMeta" }, "degraded_sources": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Data sources that failed gracefully (partial data)", "default": [] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[ApprovalResponse]" }, "PaginatedResponse_Artifact_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/Artifact" }, "type": "array", "default": [] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "pagination": { "$ref": "#/components/schemas/PaginationMeta" }, "degraded_sources": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Data sources that failed gracefully (partial data)", "default": [] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[Artifact]" }, "PaginatedResponse_Department_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/Department" }, "type": "array", "default": [] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "pagination": { "$ref": "#/components/schemas/PaginationMeta" }, "degraded_sources": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Data sources that failed gracefully (partial data)", "default": [] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[Department]" }, "PaginatedResponse_MeetingResponse_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/MeetingResponse" }, "type": "array", "default": [] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "pagination": { "$ref": "#/components/schemas/PaginationMeta" }, "degraded_sources": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Data sources that failed gracefully (partial data)", "default": [] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[MeetingResponse]" }, "PaginatedResponse_Message_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/Message" }, "type": "array", "default": [] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "pagination": { "$ref": "#/components/schemas/PaginationMeta" }, "degraded_sources": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Data sources that failed gracefully (partial data)", "default": [] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[Message]" }, "PaginatedResponse_PresetSummaryResponse_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/PresetSummaryResponse" }, "type": "array", "default": [] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "pagination": { "$ref": "#/components/schemas/PaginationMeta" }, "degraded_sources": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Data sources that failed gracefully (partial data)", "default": [] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[PresetSummaryResponse]" }, "PaginatedResponse_Project_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/Project" }, "type": "array", "default": [] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "pagination": { "$ref": "#/components/schemas/PaginationMeta" }, "degraded_sources": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Data sources that failed gracefully (partial data)", "default": [] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[Project]" }, "PaginatedResponse_Task_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/Task" }, "type": "array", "default": [] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "pagination": { "$ref": "#/components/schemas/PaginationMeta" }, "degraded_sources": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Data sources that failed gracefully (partial data)", "default": [] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[Task]" }, "PaginatedResponse_WorkflowDefinitionVersion_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/WorkflowDefinitionVersion" }, "type": "array", "default": [] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "pagination": { "$ref": "#/components/schemas/PaginationMeta" }, "degraded_sources": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Data sources that failed gracefully (partial data)", "default": [] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[WorkflowDefinitionVersion]" }, "PaginatedResponse_WorkflowDefinition_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/WorkflowDefinition" }, "type": "array", "default": [] }, "error": { "type": [ "string", "null" ] }, "error_detail": { "anyOf": [ { "$ref": "#/components/schemas/ErrorDetail" }, { "type": "null" } ] }, "pagination": { "$ref": "#/components/schemas/PaginationMeta" }, "degraded_sources": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Data sources that failed gracefully (partial data)", "default": [] }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[WorkflowDefinition]" }, "PaginationMeta": { "properties": { "total": { "type": "integer", "minimum": 0.0, "description": "Total matching items" }, "offset": { "type": "integer", "minimum": 0.0, "description": "Starting offset" }, "limit": { "type": "integer", "minimum": 1.0, "description": "Maximum items per page" } }, "type": "object", "required": [ "limit", "offset", "total" ], "title": "PaginationMeta" }, "PeriodSummary": { "properties": { "total_cost_usd": { "type": "number", "minimum": 0.0, "description": "Total cost in USD (base currency)" }, "currency": { "type": "string", "maxLength": 3, "minLength": 3, "description": "ISO 4217 currency code", "default": "EUR" }, "total_input_tokens": { "type": "integer", "minimum": 0.0, "description": "Total input tokens" }, "total_output_tokens": { "type": "integer", "minimum": 0.0, "description": "Total output tokens" }, "record_count": { "type": "integer", "minimum": 0.0, "description": "Number of records" }, "avg_cost_usd": { "type": "number", "description": "Average cost per record", "readOnly": true } }, "type": "object", "required": [ "avg_cost_usd", "record_count", "total_cost_usd", "total_input_tokens", "total_output_tokens" ], "title": "PeriodSummary" }, "PersonalityPresetInfoResponse": { "properties": { "name": { "type": "string", "minLength": 1 }, "description": { "type": "string", "default": "" } }, "type": "object", "required": [ "name" ], "title": "PersonalityPresetInfoResponse" }, "PersonalityPresetsListResponse": { "properties": { "presets": { "items": { "$ref": "#/components/schemas/PersonalityPresetInfoResponse" }, "type": "array" } }, "type": "object", "required": [ "presets" ], "title": "PersonalityPresetsListResponse" }, "PolicyFieldOrigin": { "type": "string", "enum": [ "project", "department", "default" ], "title": "PolicyFieldOrigin", "description": "Level that provided this value" }, "PreflightCheck": { "properties": { "name": { "type": "string", "minLength": 1, "description": "Check identifier" }, "status": { "type": "string", "enum": [ "pass", "warn", "fail" ], "description": "Result" }, "message": { "type": "string", "minLength": 1, "description": "Result description" }, "detail": { "description": "Additional detail", "type": [ "string", "null" ] } }, "type": "object", "required": [ "message", "name", "status" ], "title": "PreflightCheck" }, "PreflightResult": { "properties": { "checks": { "items": { "$ref": "#/components/schemas/PreflightCheck" }, "type": "array", "description": "Individual check results", "default": [] }, "recommended_batch_size": { "minimum": 1, "description": "VRAM-based batch size recommendation", "type": [ "integer", "null" ] }, "can_proceed": { "type": "boolean", "description": "True if no checks have ``\"fail\"`` status.", "readOnly": true } }, "type": "object", "required": [ "can_proceed" ], "title": "PreflightResult" }, "PresetDetailResponse": { "properties": { "name": { "type": "string", "minLength": 1 }, "source": { "$ref": "#/components/schemas/PresetSource" }, "description": { "type": "string", "default": "" }, "traits": { "items": { "type": "string", "minLength": 1 }, "type": "array", "default": [] }, "communication_style": { "type": "string", "minLength": 1, "default": "neutral" }, "risk_tolerance": { "$ref": "#/components/schemas/RiskTolerance" }, "creativity": { "$ref": "#/components/schemas/CreativityLevel" }, "openness": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.5 }, "conscientiousness": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.5 }, "extraversion": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.5 }, "agreeableness": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.5 }, "stress_response": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.5 }, "decision_making": { "$ref": "#/components/schemas/DecisionMakingStyle" }, "collaboration": { "$ref": "#/components/schemas/CollaborationPreference" }, "verbosity": { "$ref": "#/components/schemas/CommunicationVerbosity" }, "conflict_approach": { "$ref": "#/components/schemas/ConflictApproach" }, "created_at": { "type": [ "string", "null" ] }, "updated_at": { "type": [ "string", "null" ] } }, "type": "object", "required": [ "name", "source" ], "title": "PresetDetailResponse" }, "PresetSource": { "type": "string", "enum": [ "builtin", "custom" ], "title": "PresetSource", "description": "Origin of a personality preset." }, "PresetSummaryResponse": { "properties": { "name": { "type": "string", "minLength": 1 }, "description": { "type": "string", "default": "" }, "traits": { "items": { "type": "string", "minLength": 1 }, "type": "array", "default": [] }, "source": { "$ref": "#/components/schemas/PresetSource" } }, "type": "object", "required": [ "name", "source" ], "title": "PresetSummaryResponse" }, "Priority": { "type": "string", "enum": [ "critical", "high", "medium", "low" ], "title": "Priority", "description": "Task priority", "default": "medium" }, "ProbePresetRequest": { "properties": { "preset_name": { "type": "string", "maxLength": 64, "minLength": 1 } }, "type": "object", "required": [ "preset_name" ], "title": "ProbePresetRequest" }, "ProbePresetResponse": { "properties": { "url": { "minLength": 1, "type": [ "string", "null" ] }, "model_count": { "type": "integer", "minimum": 0.0, "default": 0 }, "candidates_tried": { "type": "integer", "minimum": 0.0, "default": 0 } }, "type": "object", "required": [], "title": "ProbePresetResponse" }, "Project": { "properties": { "id": { "type": "string", "minLength": 1, "description": "Unique project identifier" }, "name": { "type": "string", "minLength": 1, "description": "Project display name" }, "description": { "type": "string", "description": "Detailed project description", "default": "" }, "team": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Agent IDs assigned to this project", "default": [] }, "lead": { "description": "Agent ID of the project lead", "minLength": 1, "type": [ "string", "null" ] }, "task_ids": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "IDs of tasks belonging to this project", "default": [] }, "deadline": { "description": "Optional deadline (ISO 8601 string)", "type": [ "string", "null" ] }, "budget": { "type": "number", "minimum": 0.0, "description": "Total budget in base currency (configurable, defaults to EUR)", "default": 0.0 }, "status": { "$ref": "#/components/schemas/ProjectStatus" } }, "type": "object", "required": [ "id", "name" ], "title": "Project" }, "ProjectStatus": { "type": "string", "enum": [ "planning", "active", "on_hold", "completed", "cancelled" ], "title": "ProjectStatus", "description": "Current project status", "default": "planning" }, "ProviderHealthStatus": { "type": "string", "enum": [ "up", "degraded", "down", "unknown" ], "title": "ProviderHealthStatus", "description": "Derive health status from call count and error rate.", "readOnly": true }, "ProviderHealthSummary": { "properties": { "last_check_timestamp": { "description": "datetime with the constraint that the value must have timezone info", "format": "date-time", "type": [ "string", "null" ] }, "avg_response_time_ms": { "description": "Average response time in ms (24h window)", "type": [ "number", "null" ] }, "error_rate_percent_24h": { "type": "number", "maximum": 100.0, "minimum": 0.0, "description": "Error rate percentage (24h window)", "default": 0.0 }, "calls_last_24h": { "type": "integer", "minimum": 0.0, "description": "Total calls in the last 24h", "default": 0 }, "total_tokens_24h": { "type": "integer", "minimum": 0.0, "description": "Total tokens (input + output) in the last 24h", "default": 0 }, "total_cost_24h": { "type": "number", "minimum": 0.0, "description": "Total cost in the last 24h", "default": 0.0 }, "health_status": { "$ref": "#/components/schemas/ProviderHealthStatus" } }, "type": "object", "required": [ "health_status" ], "title": "ProviderHealthSummary" }, "ProviderModelConfig": { "properties": { "id": { "type": "string", "minLength": 1, "description": "Model identifier" }, "alias": { "description": "Short alias for routing rules", "minLength": 1, "type": [ "string", "null" ] }, "cost_per_1k_input": { "type": "number", "minimum": 0.0, "description": "Cost per 1k input tokens (base currency)", "default": 0.0 }, "cost_per_1k_output": { "type": "number", "minimum": 0.0, "description": "Cost per 1k output tokens (base currency)", "default": 0.0 }, "max_context": { "type": "integer", "exclusiveMinimum": 0.0, "description": "Maximum context window size in tokens", "default": 200000 }, "estimated_latency_ms": { "maximum": 300000, "description": "Estimated median latency in milliseconds", "type": [ "integer", "null" ] }, "local_params": { "description": "Per-model launch parameters for local providers", "anyOf": [ { "$ref": "#/components/schemas/LocalModelParams" }, { "type": "null" } ] } }, "type": "object", "required": [ "id" ], "title": "ProviderModelConfig" }, "ProviderModelResponse": { "properties": { "id": { "type": "string", "minLength": 1, "description": "Model identifier" }, "alias": { "description": "Short alias for routing rules", "minLength": 1, "type": [ "string", "null" ] }, "cost_per_1k_input": { "type": "number", "minimum": 0.0, "description": "Cost per 1k input tokens", "default": 0.0 }, "cost_per_1k_output": { "type": "number", "minimum": 0.0, "description": "Cost per 1k output tokens", "default": 0.0 }, "max_context": { "type": "integer", "exclusiveMinimum": 0.0, "description": "Max context window in tokens", "default": 200000 }, "estimated_latency_ms": { "maximum": 300000, "description": "Estimated median latency in ms", "type": [ "integer", "null" ] }, "local_params": { "description": "Per-model launch parameters for local providers", "anyOf": [ { "$ref": "#/components/schemas/LocalModelParams" }, { "type": "null" } ] }, "supports_tools": { "type": "boolean", "description": "Supports tool/function calling", "default": false }, "supports_vision": { "type": "boolean", "description": "Accepts image inputs", "default": false }, "supports_streaming": { "type": "boolean", "description": "Supports streaming responses", "default": true } }, "type": "object", "required": [ "id" ], "title": "ProviderModelResponse" }, "ProviderPreset": { "properties": { "name": { "type": "string", "minLength": 1 }, "display_name": { "type": "string", "minLength": 1 }, "description": { "type": "string", "minLength": 1 }, "driver": { "type": "string", "minLength": 1 }, "litellm_provider": { "type": "string", "minLength": 1 }, "auth_type": { "$ref": "#/components/schemas/AuthType" }, "supported_auth_types": { "items": { "$ref": "#/components/schemas/AuthType" }, "type": "array", "minItems": 1, "default": [ "api_key" ] }, "default_base_url": { "minLength": 1, "type": [ "string", "null" ] }, "requires_base_url": { "type": "boolean", "default": false }, "candidate_urls": { "items": { "type": "string", "minLength": 1 }, "type": "array", "default": [] }, "default_models": { "items": { "$ref": "#/components/schemas/ProviderModelConfig" }, "type": "array", "default": [] }, "supports_model_pull": { "type": "boolean", "default": false }, "supports_model_delete": { "type": "boolean", "default": false }, "supports_model_config": { "type": "boolean", "default": false } }, "type": "object", "required": [ "auth_type", "description", "display_name", "driver", "litellm_provider", "name" ], "title": "ProviderPreset" }, "ProviderResponse": { "properties": { "driver": { "type": "string", "minLength": 1 }, "litellm_provider": { "minLength": 1, "type": [ "string", "null" ] }, "auth_type": { "$ref": "#/components/schemas/AuthType" }, "base_url": { "minLength": 1, "type": [ "string", "null" ] }, "models": { "items": { "$ref": "#/components/schemas/ProviderModelConfig" }, "type": "array" }, "has_api_key": { "type": "boolean" }, "has_oauth_credentials": { "type": "boolean" }, "has_custom_header": { "type": "boolean" }, "has_subscription_token": { "type": "boolean", "default": false }, "tos_accepted_at": { "type": [ "string", "null" ] }, "oauth_token_url": { "minLength": 1, "type": [ "string", "null" ] }, "oauth_client_id": { "minLength": 1, "type": [ "string", "null" ] }, "oauth_scope": { "minLength": 1, "type": [ "string", "null" ] }, "custom_header_name": { "minLength": 1, "type": [ "string", "null" ] }, "preset_name": { "minLength": 1, "type": [ "string", "null" ] }, "supports_model_pull": { "type": "boolean", "default": false }, "supports_model_delete": { "type": "boolean", "default": false }, "supports_model_config": { "type": "boolean", "default": false } }, "type": "object", "required": [ "auth_type", "driver", "has_api_key", "has_custom_header", "has_oauth_credentials", "models" ], "title": "ProviderResponse" }, "PullModelRequest": { "properties": { "model_name": { "type": "string", "maxLength": 256, "minLength": 1, "description": "Model name/tag to pull" } }, "type": "object", "required": [ "model_name" ], "title": "PullModelRequest" }, "QualityOverrideResponse": { "properties": { "agent_id": { "type": "string", "minLength": 1, "description": "Agent whose quality score is overridden" }, "score": { "type": "number", "maximum": 10.0, "minimum": 0.0, "description": "Override score" }, "reason": { "type": "string", "minLength": 1, "description": "Why the override was applied" }, "applied_by": { "type": "string", "minLength": 1, "description": "Who applied the override" }, "applied_at": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" }, "expires_at": { "description": "datetime with the constraint that the value must have timezone info", "format": "date-time", "type": [ "string", "null" ] } }, "type": "object", "required": [ "agent_id", "applied_at", "applied_by", "reason", "score" ], "title": "QualityOverrideResponse" }, "RejectRequest": { "properties": { "reason": { "type": "string", "maxLength": 4096, "minLength": 1 } }, "type": "object", "required": [ "reason" ], "title": "RejectRequest" }, "RemoveAllowlistEntryRequest": { "properties": { "host_port": { "type": "string", "maxLength": 256, "minLength": 1 } }, "type": "object", "required": [ "host_port" ], "title": "RemoveAllowlistEntryRequest" }, "ReportPeriod": { "type": "string", "enum": [ "daily", "weekly", "monthly" ], "title": "ReportPeriod", "description": "Report period" }, "ReportResponse": { "properties": { "period": { "$ref": "#/components/schemas/ReportPeriod" }, "start": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" }, "end": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" }, "has_spending": { "type": "boolean", "default": false }, "has_performance": { "type": "boolean", "default": false }, "has_task_completion": { "type": "boolean", "default": false }, "has_risk_trends": { "type": "boolean", "default": false }, "generated_at": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" } }, "type": "object", "required": [ "end", "generated_at", "period", "start" ], "title": "ReportResponse" }, "ReportingLine": { "properties": { "subordinate": { "type": "string", "minLength": 1, "description": "Subordinate role name or identifier" }, "supervisor": { "type": "string", "minLength": 1, "description": "Supervisor role name or identifier" }, "subordinate_id": { "description": "Optional unique identifier for the subordinate", "minLength": 1, "type": [ "string", "null" ] }, "supervisor_id": { "description": "Optional unique identifier for the supervisor", "minLength": 1, "type": [ "string", "null" ] }, "subordinate_key": { "type": "string", "description": "Hierarchy lookup key: ``subordinate_id`` when set, else ``subordinate``.\n\nUnlike ``_identity_key()``, returns the raw value without\ncase-folding or namespace tagging.", "readOnly": true }, "supervisor_key": { "type": "string", "description": "Hierarchy lookup key: ``supervisor_id`` when set, else ``supervisor``.\n\nUnlike ``_identity_key()``, returns the raw value without\ncase-folding or namespace tagging.", "readOnly": true } }, "type": "object", "required": [ "subordinate", "subordinate_key", "supervisor", "supervisor_key" ], "title": "ReportingLine" }, "ResolvedCeremonyPolicyResponse": { "properties": { "strategy": { "$ref": "#/components/schemas/ResolvedPolicyField" }, "strategy_config": { "$ref": "#/components/schemas/ResolvedPolicyField" }, "velocity_calculator": { "$ref": "#/components/schemas/ResolvedPolicyField" }, "auto_transition": { "$ref": "#/components/schemas/ResolvedPolicyField" }, "transition_threshold": { "$ref": "#/components/schemas/ResolvedPolicyField" } }, "type": "object", "required": [ "auto_transition", "strategy", "strategy_config", "transition_threshold", "velocity_calculator" ], "title": "ResolvedCeremonyPolicyResponse" }, "ResolvedPolicyField": { "properties": { "value": { "oneOf": [ { "type": "string" }, { "additionalProperties": {}, "type": "object" }, { "type": "boolean" }, { "type": "number" } ], "description": "Resolved field value" }, "source": { "$ref": "#/components/schemas/PolicyFieldOrigin" } }, "type": "object", "required": [ "source", "value" ], "title": "ResolvedPolicyField", "description": "Ceremony scheduling strategy" }, "RestoreRequest": { "properties": { "backup_id": { "type": "string", "minLength": 1 }, "components": { "items": { "$ref": "#/components/schemas/BackupComponent" }, "type": [ "array", "null" ] }, "confirm": { "type": "boolean", "default": false } }, "type": "object", "required": [ "backup_id" ], "title": "RestoreRequest" }, "RestoreResponse": { "properties": { "manifest": { "$ref": "#/components/schemas/BackupManifest" }, "restored_components": { "items": { "$ref": "#/components/schemas/BackupComponent" }, "type": "array" }, "safety_backup_id": { "type": "string", "minLength": 1 }, "restart_required": { "type": "boolean", "default": true } }, "type": "object", "required": [ "manifest", "restored_components", "safety_backup_id" ], "title": "RestoreResponse" }, "ReviewRequirements": { "properties": { "min_reviewers": { "type": "integer", "minimum": 0.0, "description": "Minimum number of reviewers required", "default": 1 }, "required_reviewer_roles": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Role names that must be among reviewers", "default": [] }, "self_review_allowed": { "type": "boolean", "description": "Whether self-review is allowed", "default": false } }, "type": "object", "required": [], "title": "ReviewRequirements", "description": "Review policy" }, "RiskBudgetAlertConfig": { "properties": { "warn_at": { "type": "integer", "maximum": 100.0, "minimum": 0.0, "default": 75 }, "critical_at": { "type": "integer", "maximum": 100.0, "minimum": 0.0, "default": 90 } }, "type": "object", "required": [], "title": "RiskBudgetAlertConfig" }, "RiskBudgetConfig": { "properties": { "enabled": { "type": "boolean", "default": false }, "per_task_risk_limit": { "type": "number", "minimum": 0.0, "default": 5.0 }, "per_agent_daily_risk_limit": { "type": "number", "minimum": 0.0, "default": 20.0 }, "total_daily_risk_limit": { "type": "number", "minimum": 0.0, "default": 100.0 }, "alerts": { "$ref": "#/components/schemas/RiskBudgetAlertConfig" } }, "type": "object", "required": [], "title": "RiskBudgetConfig", "description": "Cumulative risk-unit action budget configuration" }, "RiskTolerance": { "type": "string", "enum": [ "low", "medium", "high" ], "title": "RiskTolerance", "description": "Risk tolerance level for agent personality.", "default": "medium" }, "RollbackWorkflowRequest": { "properties": { "target_version": { "type": "integer", "minimum": 1.0, "description": "Version to rollback to" }, "expected_version": { "type": "integer", "minimum": 1.0, "description": "Optimistic concurrency guard" } }, "type": "object", "required": [ "expected_version", "target_version" ], "title": "RollbackWorkflowRequest" }, "SeniorityLevel": { "type": "string", "enum": [ "junior", "mid", "senior", "lead", "principal", "director", "vp", "c_suite" ], "title": "SeniorityLevel", "description": "Seniority level", "default": "mid" }, "ServiceStatus": { "type": "string", "enum": [ "ok", "degraded", "down" ], "title": "ServiceStatus", "description": "Overall health status" }, "SessionResponse": { "properties": { "session_id": { "type": "string", "minLength": 1 }, "user_id": { "type": "string", "minLength": 1 }, "username": { "type": "string", "minLength": 1 }, "ip_address": { "type": "string" }, "user_agent": { "type": "string" }, "created_at": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" }, "last_active_at": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" }, "expires_at": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" }, "is_current": { "type": "boolean", "default": false } }, "type": "object", "required": [ "created_at", "expires_at", "ip_address", "last_active_at", "session_id", "user_agent", "user_id", "username" ], "title": "SessionResponse" }, "SetOverrideRequest": { "properties": { "score": { "type": "number", "maximum": 10.0, "minimum": 0.0, "description": "Override score" }, "reason": { "type": "string", "maxLength": 4096, "minLength": 1, "description": "Reason for the override" }, "expires_in_days": { "maximum": 365, "minimum": 1, "description": "Expiration in days (None = indefinite)", "type": [ "integer", "null" ] } }, "type": "object", "required": [ "reason", "score" ], "title": "SetOverrideRequest" }, "SetQualityOverrideRequest": { "properties": { "score": { "type": "number", "maximum": 10.0, "minimum": 0.0, "description": "Override score" }, "reason": { "type": "string", "maxLength": 4096, "minLength": 1, "description": "Reason for the override" }, "expires_in_days": { "maximum": 365, "minimum": 1, "description": "Expiration in days (None = indefinite)", "type": [ "integer", "null" ] } }, "type": "object", "required": [ "reason", "score" ], "title": "SetQualityOverrideRequest" }, "SettingDefinition": { "properties": { "namespace": { "$ref": "#/components/schemas/SettingNamespace" }, "key": { "type": "string", "minLength": 1, "description": "Setting key within namespace" }, "type": { "$ref": "#/components/schemas/SettingType" }, "default": { "description": "Default value as string", "type": [ "string", "null" ] }, "description": { "type": "string", "minLength": 1, "description": "Human-readable description" }, "group": { "type": "string", "minLength": 1, "description": "UI grouping label" }, "level": { "$ref": "#/components/schemas/SettingLevel" }, "sensitive": { "type": "boolean", "description": "Encrypt at rest and mask in UI", "default": false }, "restart_required": { "type": "boolean", "description": "Change takes effect after restart", "default": false }, "enum_values": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Allowed values for ENUM type", "default": [] }, "validator_pattern": { "maxLength": 256, "description": "Regex pattern for string validation", "minLength": 1, "type": [ "string", "null" ] }, "min_value": { "description": "Minimum value for numeric types", "type": [ "number", "null" ] }, "max_value": { "description": "Maximum value for numeric types", "type": [ "number", "null" ] }, "yaml_path": { "description": "Dotted path into RootConfig for YAML resolution", "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [ "description", "group", "key", "namespace", "type" ], "title": "SettingDefinition", "description": "Setting metadata" }, "SettingEntry": { "properties": { "definition": { "$ref": "#/components/schemas/SettingDefinition" }, "value": { "type": "string", "description": "Resolved value as string" }, "source": { "$ref": "#/components/schemas/SettingSource" }, "updated_at": { "description": "ISO 8601 timestamp (DB values only)", "type": [ "string", "null" ] } }, "type": "object", "required": [ "definition", "source", "value" ], "title": "SettingEntry" }, "SettingLevel": { "type": "string", "enum": [ "basic", "advanced" ], "title": "SettingLevel", "description": "Visibility level", "default": "basic" }, "SettingNamespace": { "type": "string", "enum": [ "api", "company", "providers", "memory", "budget", "security", "coordination", "observability", "backup", "engine" ], "title": "SettingNamespace", "description": "Setting namespace" }, "SettingSource": { "type": "string", "enum": [ "db", "env", "yaml", "default" ], "title": "SettingSource", "description": "Value origin" }, "SettingType": { "type": "string", "enum": [ "str", "int", "float", "bool", "enum", "json" ], "title": "SettingType", "description": "Value data type" }, "SetupAgentRequest": { "properties": { "name": { "type": "string", "maxLength": 200, "minLength": 1 }, "role": { "type": "string", "maxLength": 100, "minLength": 1 }, "level": { "$ref": "#/components/schemas/SeniorityLevel" }, "personality_preset": { "type": "string", "maxLength": 100, "minLength": 1, "default": "pragmatic_builder" }, "model_provider": { "type": "string", "maxLength": 100, "minLength": 1 }, "model_id": { "type": "string", "maxLength": 200, "minLength": 1 }, "department": { "type": "string", "maxLength": 100, "minLength": 1, "default": "engineering" }, "budget_limit_monthly": { "maximum": 1000000.0, "type": [ "number", "null" ] } }, "type": "object", "required": [ "model_id", "model_provider", "name", "role" ], "title": "SetupAgentRequest" }, "SetupAgentResponse": { "properties": { "name": { "type": "string", "minLength": 1 }, "role": { "type": "string", "minLength": 1 }, "department": { "type": "string", "minLength": 1 }, "model_provider": { "type": "string", "minLength": 1 }, "model_id": { "type": "string", "minLength": 1 } }, "type": "object", "required": [ "department", "model_id", "model_provider", "name", "role" ], "title": "SetupAgentResponse" }, "SetupAgentSummary": { "properties": { "name": { "type": "string", "minLength": 1 }, "role": { "type": "string", "minLength": 1 }, "department": { "type": "string", "minLength": 1 }, "level": { "type": [ "string", "null" ], "enum": [ "junior", "mid", "senior", "lead", "principal", "director", "vp", "c_suite", null ], "default": "mid" }, "model_provider": { "minLength": 1, "type": [ "string", "null" ] }, "model_id": { "minLength": 1, "type": [ "string", "null" ] }, "tier": { "type": "string", "enum": [ "large", "medium", "small" ], "default": "medium" }, "personality_preset": { "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [ "department", "name", "role" ], "title": "SetupAgentSummary" }, "SetupAgentsListResponse": { "properties": { "agents": { "items": { "$ref": "#/components/schemas/SetupAgentSummary" }, "type": "array" }, "agent_count": { "type": "integer", "description": "Number of agents currently configured.", "readOnly": true } }, "type": "object", "required": [ "agent_count", "agents" ], "title": "SetupAgentsListResponse" }, "SetupCompanyRequest": { "properties": { "company_name": { "type": "string", "maxLength": 200, "minLength": 1 }, "description": { "maxLength": 1000, "type": [ "string", "null" ] }, "template_name": { "maxLength": 100, "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [ "company_name" ], "title": "SetupCompanyRequest" }, "SetupCompanyResponse": { "properties": { "company_name": { "type": "string", "minLength": 1 }, "description": { "type": [ "string", "null" ] }, "template_applied": { "minLength": 1, "type": [ "string", "null" ] }, "department_count": { "type": "integer", "minimum": 0.0 }, "agents": { "items": { "$ref": "#/components/schemas/SetupAgentSummary" }, "type": "array", "default": [] }, "agent_count": { "type": "integer", "description": "Number of agents auto-created from template.", "readOnly": true } }, "type": "object", "required": [ "agent_count", "company_name", "department_count" ], "title": "SetupCompanyResponse" }, "SetupCompleteResponse": { "properties": { "setup_complete": { "type": "boolean", "const": true } }, "type": "object", "required": [ "setup_complete" ], "title": "SetupCompleteResponse" }, "SetupNameLocalesRequest": { "properties": { "locales": { "items": { "type": "string", "minLength": 1 }, "type": "array", "maxItems": 100, "minItems": 1 } }, "type": "object", "required": [ "locales" ], "title": "SetupNameLocalesRequest" }, "SetupNameLocalesResponse": { "properties": { "locales": { "items": { "type": "string", "minLength": 1 }, "type": "array" } }, "type": "object", "required": [ "locales" ], "title": "SetupNameLocalesResponse" }, "SetupRequest": { "properties": { "username": { "type": "string", "maxLength": 128, "minLength": 1 }, "password": { "type": "string", "maxLength": 128, "minLength": 1 } }, "type": "object", "required": [ "password", "username" ], "title": "SetupRequest" }, "SetupStatusResponse": { "properties": { "needs_admin": { "type": "boolean" }, "needs_setup": { "type": "boolean" }, "has_providers": { "type": "boolean" }, "has_name_locales": { "type": "boolean" }, "has_company": { "type": "boolean" }, "has_agents": { "type": "boolean" }, "min_password_length": { "type": "integer", "minimum": 8.0 } }, "type": "object", "required": [ "has_agents", "has_company", "has_name_locales", "has_providers", "min_password_length", "needs_admin", "needs_setup" ], "title": "SetupStatusResponse" }, "SkillPattern": { "type": "string", "enum": [ "tool_wrapper", "generator", "reviewer", "inversion", "pipeline" ], "title": "SkillPattern", "description": "Skill interaction patterns for company templates.\n\nBased on the five-pattern taxonomy: Tool Wrapper, Generator,\nReviewer, Inversion, and Pipeline.\n\nAttributes:\n TOOL_WRAPPER: On-demand domain expertise; agents\n self-direct using specialized context.\n GENERATOR: Consistent structured output from reusable\n templates.\n REVIEWER: Modular rubric-based evaluation; separates\n what to check from how to check it.\n INVERSION: Agent interviews user before acting;\n structured requirements gathering.\n PIPELINE: Strict sequential workflow with hard\n checkpoints between stages.\n" }, "Task": { "properties": { "id": { "type": "string", "minLength": 1, "description": "Unique task identifier" }, "title": { "type": "string", "minLength": 1, "description": "Short task title" }, "description": { "type": "string", "minLength": 1, "description": "Detailed task description" }, "type": { "$ref": "#/components/schemas/TaskType" }, "priority": { "$ref": "#/components/schemas/Priority" }, "project": { "type": "string", "minLength": 1, "description": "Project ID this task belongs to" }, "created_by": { "type": "string", "minLength": 1, "description": "Agent name of the task creator" }, "assigned_to": { "description": "Agent ID of the assignee", "minLength": 1, "type": [ "string", "null" ] }, "reviewers": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Agent IDs of designated reviewers", "default": [] }, "dependencies": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "IDs of tasks this task depends on", "default": [] }, "artifacts_expected": { "items": { "$ref": "#/components/schemas/ExpectedArtifact" }, "type": "array", "description": "Artifacts expected to be produced", "default": [] }, "acceptance_criteria": { "items": { "$ref": "#/components/schemas/AcceptanceCriterion" }, "type": "array", "description": "Structured acceptance criteria", "default": [] }, "estimated_complexity": { "$ref": "#/components/schemas/Complexity" }, "budget_limit": { "type": "number", "minimum": 0.0, "description": "Maximum spend for this task in USD (base currency)", "default": 0.0 }, "deadline": { "description": "Optional deadline (ISO 8601 string)", "type": [ "string", "null" ] }, "max_retries": { "type": "integer", "minimum": 0.0, "description": "Max reassignment attempts after failure", "default": 1 }, "status": { "$ref": "#/components/schemas/TaskStatus" }, "parent_task_id": { "description": "Parent task ID when created via delegation", "minLength": 1, "type": [ "string", "null" ] }, "delegation_chain": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Ordered agent names of delegators (root first)", "default": [] }, "task_structure": { "description": "Classification of subtask relationships (None = not classified)", "type": [ "string", "null" ], "enum": [ "sequential", "parallel", "mixed", null ] }, "coordination_topology": { "$ref": "#/components/schemas/CoordinationTopology" } }, "type": "object", "required": [ "created_by", "description", "id", "project", "title", "type" ], "title": "Task" }, "TaskStatus": { "type": "string", "enum": [ "created", "assigned", "in_progress", "in_review", "completed", "blocked", "failed", "interrupted", "cancelled" ], "title": "TaskStatus", "description": "Current lifecycle status", "default": "created" }, "TaskStructure": { "type": "string", "enum": [ "sequential", "parallel", "mixed" ], "title": "TaskStructure", "description": "Classification of how a task's subtasks relate to each other.\n\nUsed by the decomposition engine to determine coordination topology\nand execution ordering. See the Engine design page.\n" }, "TaskType": { "type": "string", "enum": [ "development", "design", "research", "review", "meeting", "admin" ], "title": "TaskType", "description": "Task work type" }, "Team": { "properties": { "name": { "type": "string", "minLength": 1, "description": "Team name" }, "lead": { "type": "string", "minLength": 1, "description": "Team lead agent name" }, "members": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Team member agent names", "default": [] } }, "type": "object", "required": [ "lead", "name" ], "title": "Team" }, "TemplateInfoResponse": { "properties": { "name": { "type": "string", "minLength": 1 }, "display_name": { "type": "string", "minLength": 1 }, "description": { "type": "string" }, "source": { "type": "string", "enum": [ "builtin", "user" ] }, "tags": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Categorization tags for filtering and discovery", "default": [] }, "skill_patterns": { "items": { "$ref": "#/components/schemas/SkillPattern" }, "type": "array", "description": "Skill design pattern identifiers", "default": [] }, "variables": { "items": { "$ref": "#/components/schemas/TemplateVariableResponse" }, "type": "array", "description": "User-configurable template variables", "default": [] }, "agent_count": { "type": "integer", "minimum": 0.0, "description": "Number of agents defined in the template", "default": 0 }, "department_count": { "type": "integer", "minimum": 0.0, "description": "Number of departments defined in the template", "default": 0 }, "autonomy_level": { "$ref": "#/components/schemas/AutonomyLevel" }, "workflow": { "type": "string", "minLength": 1, "description": "Workflow type (agile_kanban, kanban, etc.)", "default": "agile_kanban" } }, "type": "object", "required": [ "description", "display_name", "name", "source" ], "title": "TemplateInfoResponse" }, "TemplateVariableResponse": { "properties": { "name": { "type": "string", "minLength": 1 }, "description": { "type": "string", "default": "" }, "var_type": { "type": "string", "enum": [ "str", "int", "float", "bool" ], "default": "str" }, "default": { "type": [ "string", "integer", "number", "boolean", "null" ] }, "required": { "type": "boolean", "default": false } }, "type": "object", "required": [ "name" ], "title": "TemplateVariableResponse" }, "TestConnectionRequest": { "properties": { "model": { "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [], "title": "TestConnectionRequest" }, "TestConnectionResponse": { "properties": { "success": { "type": "boolean" }, "latency_ms": { "type": [ "number", "null" ] }, "error": { "minLength": 1, "type": [ "string", "null" ] }, "model_tested": { "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [ "success" ], "title": "TestConnectionResponse" }, "TestSinkConfigRequest": { "properties": { "sink_overrides": { "type": "string", "maxLength": 65536, "description": "JSON object of per-sink overrides", "default": "{}" }, "custom_sinks": { "type": "string", "maxLength": 65536, "description": "JSON array of custom sink definitions", "default": "[]" } }, "type": "object", "required": [], "title": "TestSinkConfigRequest" }, "TestSinkConfigResponse": { "properties": { "valid": { "type": "boolean" }, "error": { "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [ "valid" ], "title": "TestSinkConfigResponse" }, "TokenResponse": { "properties": { "token": { "type": "string", "minLength": 1 }, "expires_in": { "type": "integer", "exclusiveMinimum": 0.0 }, "must_change_password": { "type": "boolean" } }, "type": "object", "required": [ "expires_in", "must_change_password", "token" ], "title": "TokenResponse" }, "TransitionTaskRequest": { "properties": { "target_status": { "$ref": "#/components/schemas/TaskStatus" }, "assigned_to": { "minLength": 1, "type": [ "string", "null" ] }, "expected_version": { "minimum": 1, "description": "Optimistic concurrency version guard", "type": [ "integer", "null" ] } }, "type": "object", "required": [ "target_status" ], "title": "TransitionTaskRequest" }, "TrendDataPoint": { "properties": { "timestamp": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" }, "value": { "type": "number", "description": "Metric value for this bucket" } }, "type": "object", "required": [ "timestamp", "value" ], "title": "TrendDataPoint" }, "TrendDirection": { "type": "string", "enum": [ "improving", "stable", "declining", "insufficient_data" ], "title": "TrendDirection", "description": "Primary trend direction" }, "TrendMetric": { "type": "string", "enum": [ "tasks_completed", "spend", "active_agents", "success_rate" ], "title": "TrendMetric", "description": "Metric to trend", "default": "spend" }, "TrendPeriod": { "type": "string", "enum": [ "7d", "30d", "90d" ], "title": "TrendPeriod", "description": "Lookback period", "default": "7d" }, "TrendResult": { "properties": { "metric_name": { "type": "string", "minLength": 1, "description": "Metric being trended" }, "window_size": { "type": "string", "minLength": 1, "description": "Time window label" }, "direction": { "$ref": "#/components/schemas/TrendDirection" }, "slope": { "type": "number", "description": "Slope of the trend line" }, "data_point_count": { "type": "integer", "minimum": 0.0, "description": "Number of data points used" } }, "type": "object", "required": [ "data_point_count", "direction", "metric_name", "slope", "window_size" ], "title": "TrendResult" }, "TrendsResponse": { "properties": { "period": { "$ref": "#/components/schemas/TrendPeriod" }, "metric": { "$ref": "#/components/schemas/TrendMetric" }, "bucket_size": { "$ref": "#/components/schemas/BucketSize" }, "data_points": { "items": { "$ref": "#/components/schemas/TrendDataPoint" }, "type": "array", "description": "Bucketed time-series data points" } }, "type": "object", "required": [ "bucket_size", "data_points", "metric", "period" ], "title": "TrendsResponse" }, "TriggerMeetingRequest": { "properties": { "event_name": { "type": "string", "minLength": 1, "description": "Event trigger name" }, "context": { "additionalProperties": { "oneOf": [ { "type": "string" }, { "items": { "type": "string" }, "type": "array" } ] }, "type": "object", "description": "Event context for participant resolution and agenda" } }, "type": "object", "required": [ "event_name" ], "title": "TriggerMeetingRequest" }, "UpdateAgentModelRequest": { "properties": { "model_provider": { "type": "string", "maxLength": 100, "minLength": 1 }, "model_id": { "type": "string", "maxLength": 200, "minLength": 1 } }, "type": "object", "required": [ "model_id", "model_provider" ], "title": "UpdateAgentModelRequest" }, "UpdateAgentNameRequest": { "properties": { "name": { "type": "string", "maxLength": 200, "minLength": 1 } }, "type": "object", "required": [ "name" ], "title": "UpdateAgentNameRequest" }, "UpdateAgentPersonalityRequest": { "properties": { "personality_preset": { "type": "string", "maxLength": 100, "minLength": 1 } }, "type": "object", "required": [ "personality_preset" ], "title": "UpdateAgentPersonalityRequest" }, "UpdateModelConfigRequest": { "properties": { "local_params": { "$ref": "#/components/schemas/LocalModelParams" } }, "type": "object", "required": [ "local_params" ], "title": "UpdateModelConfigRequest" }, "UpdatePresetRequest": { "properties": { "traits": { "items": { "type": "string", "minLength": 1 }, "type": "array", "maxItems": 50, "default": [] }, "communication_style": { "type": "string", "maxLength": 100, "minLength": 1, "default": "neutral" }, "risk_tolerance": { "$ref": "#/components/schemas/RiskTolerance" }, "creativity": { "$ref": "#/components/schemas/CreativityLevel" }, "description": { "type": "string", "maxLength": 500, "default": "" }, "openness": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.5 }, "conscientiousness": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.5 }, "extraversion": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.5 }, "agreeableness": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.5 }, "stress_response": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.5 }, "decision_making": { "$ref": "#/components/schemas/DecisionMakingStyle" }, "collaboration": { "$ref": "#/components/schemas/CollaborationPreference" }, "verbosity": { "$ref": "#/components/schemas/CommunicationVerbosity" }, "conflict_approach": { "$ref": "#/components/schemas/ConflictApproach" } }, "type": "object", "required": [], "title": "UpdatePresetRequest" }, "UpdateProviderRequest": { "properties": { "driver": { "minLength": 1, "type": [ "string", "null" ] }, "litellm_provider": { "minLength": 1, "type": [ "string", "null" ] }, "auth_type": { "type": [ "string", "null" ], "enum": [ "api_key", "oauth", "custom_header", "subscription", "none", null ], "default": "api_key" }, "api_key": { "minLength": 1, "type": [ "string", "null" ] }, "clear_api_key": { "type": "boolean", "default": false }, "subscription_token": { "minLength": 1, "type": [ "string", "null" ] }, "clear_subscription_token": { "type": "boolean", "default": false }, "tos_accepted": { "type": [ "boolean", "null" ] }, "base_url": { "minLength": 1, "type": [ "string", "null" ] }, "oauth_token_url": { "minLength": 1, "type": [ "string", "null" ] }, "oauth_client_id": { "minLength": 1, "type": [ "string", "null" ] }, "oauth_client_secret": { "minLength": 1, "type": [ "string", "null" ] }, "oauth_scope": { "minLength": 1, "type": [ "string", "null" ] }, "custom_header_name": { "minLength": 1, "type": [ "string", "null" ] }, "custom_header_value": { "minLength": 1, "type": [ "string", "null" ] }, "models": { "items": { "$ref": "#/components/schemas/ProviderModelConfig" }, "type": [ "array", "null" ] } }, "type": "object", "required": [], "title": "UpdateProviderRequest" }, "UpdateSettingRequest": { "properties": { "value": { "type": "string", "maxLength": 65536, "description": "New value as string" } }, "type": "object", "required": [ "value" ], "title": "UpdateSettingRequest" }, "UpdateTaskRequest": { "properties": { "title": { "maxLength": 256, "minLength": 1, "type": [ "string", "null" ] }, "description": { "maxLength": 4096, "minLength": 1, "type": [ "string", "null" ] }, "priority": { "type": [ "string", "null" ], "enum": [ "critical", "high", "medium", "low", null ], "default": "medium" }, "assigned_to": { "minLength": 1, "type": [ "string", "null" ] }, "budget_limit": { "type": [ "number", "null" ] }, "expected_version": { "minimum": 1, "description": "Optimistic concurrency version guard", "type": [ "integer", "null" ] } }, "type": "object", "required": [], "title": "UpdateTaskRequest" }, "UpdateUserRoleRequest": { "properties": { "role": { "$ref": "#/components/schemas/HumanRole" } }, "type": "object", "required": [ "role" ], "title": "UpdateUserRoleRequest" }, "UpdateWorkflowDefinitionRequest": { "properties": { "name": { "maxLength": 256, "minLength": 1, "type": [ "string", "null" ] }, "description": { "maxLength": 4096, "type": [ "string", "null" ] }, "workflow_type": { "type": [ "string", "null" ], "enum": [ "sequential_pipeline", "parallel_execution", "kanban", "agile_kanban", null ], "default": "sequential_pipeline" }, "nodes": { "maxLength": 500, "items": { "additionalProperties": {}, "type": "object" }, "type": [ "array", "null" ] }, "edges": { "maxLength": 1000, "items": { "additionalProperties": {}, "type": "object" }, "type": [ "array", "null" ] }, "expected_version": { "minimum": 1, "description": "Optimistic concurrency guard", "type": [ "integer", "null" ] } }, "type": "object", "required": [], "title": "UpdateWorkflowDefinitionRequest" }, "UrgencyLevel": { "type": "string", "enum": [ "critical", "high", "normal", "no_expiry" ], "title": "UrgencyLevel", "description": "Urgency classification based on remaining time" }, "UserInfoResponse": { "properties": { "id": { "type": "string", "minLength": 1 }, "username": { "type": "string", "minLength": 1 }, "role": { "$ref": "#/components/schemas/HumanRole" }, "must_change_password": { "type": "boolean" } }, "type": "object", "required": [ "id", "must_change_password", "role", "username" ], "title": "UserInfoResponse" }, "UserResponse": { "properties": { "id": { "type": "string", "minLength": 1 }, "username": { "type": "string", "minLength": 1 }, "role": { "$ref": "#/components/schemas/HumanRole" }, "must_change_password": { "type": "boolean" }, "created_at": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" }, "updated_at": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" } }, "type": "object", "required": [ "created_at", "id", "must_change_password", "role", "updated_at", "username" ], "title": "UserResponse" }, "ValidationErrorCode": { "type": "string", "enum": [ "unreachable_node", "end_not_reachable", "conditional_missing_true", "conditional_missing_false", "conditional_extra_outgoing", "split_too_few_branches", "task_missing_title", "cycle_detected" ], "title": "ValidationErrorCode", "description": "Error code" }, "WindowMetrics": { "properties": { "window_size": { "type": "string", "minLength": 1, "description": "Time window label" }, "data_point_count": { "type": "integer", "minimum": 0.0, "description": "Records in the window" }, "tasks_completed": { "type": "integer", "minimum": 0.0, "description": "Number of successful tasks" }, "tasks_failed": { "type": "integer", "minimum": 0.0, "description": "Number of failed tasks" }, "avg_quality_score": { "maximum": 10.0, "description": "Average quality score", "type": [ "number", "null" ] }, "avg_cost_per_task": { "description": "Average cost per task in USD (base currency)", "type": [ "number", "null" ] }, "avg_completion_time_seconds": { "description": "Average completion time", "type": [ "number", "null" ] }, "avg_tokens_per_task": { "description": "Average tokens per task", "type": [ "number", "null" ] }, "success_rate": { "maximum": 1.0, "description": "Task success rate", "type": [ "number", "null" ] }, "collaboration_score": { "maximum": 10.0, "description": "Collaboration score", "type": [ "number", "null" ] } }, "type": "object", "required": [ "data_point_count", "tasks_completed", "tasks_failed", "window_size" ], "title": "WindowMetrics" }, "WorkflowDefinition": { "properties": { "id": { "type": "string", "minLength": 1, "description": "Unique workflow definition ID" }, "name": { "type": "string", "minLength": 1, "description": "Workflow name" }, "description": { "type": "string", "description": "Detailed description", "default": "" }, "workflow_type": { "$ref": "#/components/schemas/WorkflowType" }, "nodes": { "items": { "$ref": "#/components/schemas/WorkflowNode" }, "type": "array", "description": "Nodes in the workflow graph", "default": [] }, "edges": { "items": { "$ref": "#/components/schemas/WorkflowEdge" }, "type": "array", "description": "Edges connecting nodes", "default": [] }, "created_by": { "type": "string", "minLength": 1, "description": "Creator identity" }, "created_at": { "type": "string", "format": "date-time", "description": "Creation timestamp (UTC)" }, "updated_at": { "type": "string", "format": "date-time", "description": "Last update timestamp (UTC)" }, "version": { "type": "integer", "minimum": 1.0, "description": "Optimistic concurrency version", "default": 1 } }, "type": "object", "required": [ "created_by", "id", "name" ], "title": "WorkflowDefinition" }, "WorkflowDefinitionVersion": { "properties": { "definition_id": { "type": "string", "minLength": 1, "description": "Parent definition ID" }, "version": { "type": "integer", "minimum": 1.0, "description": "Version number" }, "name": { "type": "string", "minLength": 1, "description": "Workflow name at this version" }, "description": { "type": "string", "description": "Description at this version", "default": "" }, "workflow_type": { "$ref": "#/components/schemas/WorkflowType" }, "nodes": { "items": { "$ref": "#/components/schemas/WorkflowNode" }, "type": "array", "description": "Node graph snapshot", "default": [] }, "edges": { "items": { "$ref": "#/components/schemas/WorkflowEdge" }, "type": "array", "description": "Edge graph snapshot", "default": [] }, "created_by": { "type": "string", "minLength": 1, "description": "Original definition creator" }, "saved_by": { "type": "string", "minLength": 1, "description": "User who performed this save" }, "saved_at": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" } }, "type": "object", "required": [ "created_by", "definition_id", "name", "saved_at", "saved_by", "version", "workflow_type" ], "title": "WorkflowDefinitionVersion" }, "WorkflowDiff": { "properties": { "definition_id": { "type": "string", "minLength": 1 }, "from_version": { "type": "integer", "minimum": 1.0 }, "to_version": { "type": "integer", "minimum": 1.0 }, "node_changes": { "items": { "$ref": "#/components/schemas/NodeChange" }, "type": "array", "default": [] }, "edge_changes": { "items": { "$ref": "#/components/schemas/EdgeChange" }, "type": "array", "default": [] }, "metadata_changes": { "items": { "$ref": "#/components/schemas/MetadataChange" }, "type": "array", "default": [] }, "summary": { "type": "string", "default": "" } }, "type": "object", "required": [ "definition_id", "from_version", "to_version" ], "title": "WorkflowDiff" }, "WorkflowEdge": { "properties": { "id": { "type": "string", "minLength": 1, "description": "Unique edge identifier" }, "source_node_id": { "type": "string", "minLength": 1, "description": "Source node ID" }, "target_node_id": { "type": "string", "minLength": 1, "description": "Target node ID" }, "type": { "$ref": "#/components/schemas/WorkflowEdgeType" }, "label": { "description": "Optional display label", "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [ "id", "source_node_id", "target_node_id" ], "title": "WorkflowEdge" }, "WorkflowEdgeType": { "type": "string", "enum": [ "sequential", "conditional_true", "conditional_false", "parallel_branch" ], "title": "WorkflowEdgeType", "description": "Edge type", "default": "sequential" }, "WorkflowExecution": { "properties": { "id": { "type": "string", "minLength": 1, "description": "Unique execution ID" }, "definition_id": { "type": "string", "minLength": 1, "description": "Source definition ID" }, "definition_version": { "type": "integer", "minimum": 1.0, "description": "Definition version at activation time" }, "status": { "$ref": "#/components/schemas/WorkflowExecutionStatus" }, "node_executions": { "items": { "$ref": "#/components/schemas/WorkflowNodeExecution" }, "type": "array", "description": "Per-node execution state", "default": [] }, "activated_by": { "type": "string", "minLength": 1, "description": "User who triggered activation" }, "project": { "type": "string", "minLength": 1, "description": "Project ID for created tasks" }, "created_at": { "type": "string", "format": "date-time", "description": "Creation timestamp (UTC)" }, "updated_at": { "type": "string", "format": "date-time", "description": "Last update timestamp (UTC)" }, "completed_at": { "description": "Completion timestamp", "format": "date-time", "type": [ "string", "null" ] }, "error": { "description": "Error message when FAILED", "minLength": 1, "type": [ "string", "null" ] }, "version": { "type": "integer", "minimum": 1.0, "description": "Optimistic concurrency version", "default": 1 } }, "type": "object", "required": [ "activated_by", "definition_id", "definition_version", "id", "project" ], "title": "WorkflowExecution" }, "WorkflowExecutionStatus": { "type": "string", "enum": [ "pending", "running", "completed", "failed", "cancelled" ], "title": "WorkflowExecutionStatus", "description": "Overall execution status", "default": "pending" }, "WorkflowNode": { "properties": { "id": { "type": "string", "minLength": 1, "description": "Unique node identifier" }, "type": { "$ref": "#/components/schemas/WorkflowNodeType" }, "label": { "type": "string", "minLength": 1, "description": "Display label" }, "position_x": { "type": "number", "description": "Canvas X position", "default": 0.0 }, "position_y": { "type": "number", "description": "Canvas Y position", "default": 0.0 }, "config": { "additionalProperties": {}, "type": "object", "description": "Type-specific configuration" } }, "type": "object", "required": [ "id", "label", "type" ], "title": "WorkflowNode" }, "WorkflowNodeExecution": { "properties": { "node_id": { "type": "string", "minLength": 1, "description": "Source node ID" }, "node_type": { "$ref": "#/components/schemas/WorkflowNodeType" }, "status": { "$ref": "#/components/schemas/WorkflowNodeExecutionStatus" }, "task_id": { "description": "Concrete task ID (TASK nodes only)", "minLength": 1, "type": [ "string", "null" ] }, "skipped_reason": { "description": "Reason when status is SKIPPED", "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [ "node_id", "node_type" ], "title": "WorkflowNodeExecution" }, "WorkflowNodeExecutionStatus": { "type": "string", "enum": [ "pending", "skipped", "task_created", "task_completed", "task_failed", "completed" ], "title": "WorkflowNodeExecutionStatus", "description": "Processing status", "default": "pending" }, "WorkflowNodeType": { "type": "string", "enum": [ "start", "end", "task", "agent_assignment", "conditional", "parallel_split", "parallel_join" ], "title": "WorkflowNodeType", "description": "Node type" }, "WorkflowType": { "type": "string", "enum": [ "sequential_pipeline", "parallel_execution", "kanban", "agile_kanban" ], "title": "WorkflowType", "description": "Target execution topology", "default": "sequential_pipeline" }, "WorkflowValidationError": { "properties": { "code": { "$ref": "#/components/schemas/ValidationErrorCode" }, "message": { "type": "string", "minLength": 1, "description": "Human-readable message" }, "node_id": { "description": "Related node ID", "minLength": 1, "type": [ "string", "null" ] }, "edge_id": { "description": "Related edge ID", "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [ "code", "message" ], "title": "WorkflowValidationError" }, "WorkflowValidationResult": { "properties": { "errors": { "items": { "$ref": "#/components/schemas/WorkflowValidationError" }, "type": "array", "description": "Validation errors", "default": [] }, "valid": { "type": "boolean", "description": "Whether validation passed (no errors).", "readOnly": true } }, "type": "object", "required": [ "valid" ], "title": "WorkflowValidationResult" }, "WsTicketResponse": { "properties": { "ticket": { "type": "string", "minLength": 1 }, "expires_in": { "type": "integer", "exclusiveMinimum": 0.0 } }, "type": "object", "required": [ "expires_in", "ticket" ], "title": "WsTicketResponse" }, "ProblemDetail": { "description": "Bare RFC 9457 ``application/problem+json`` response body.\n\nReturned when the client sends ``Accept: application/problem+json``.\n\nAttributes:\n type: Documentation URI for the error category.\n title: Static per-category title.\n status: HTTP status code.\n detail: Human-readable occurrence-specific explanation.\n instance: Request correlation ID for log tracing.\n error_code: Machine-readable 4-digit error code.\n error_category: High-level error category.\n retryable: Whether the client should retry the request.\n retry_after: Seconds to wait before retrying (``None``\n when not applicable).", "properties": { "type": { "minLength": 1, "title": "Type", "type": "string" }, "title": { "minLength": 1, "title": "Title", "type": "string" }, "status": { "maximum": 599, "minimum": 400, "title": "Status", "type": "integer" }, "detail": { "minLength": 1, "title": "Detail", "type": "string" }, "instance": { "minLength": 1, "title": "Instance", "type": "string" }, "error_code": { "$ref": "#/components/schemas/ErrorCode" }, "error_category": { "$ref": "#/components/schemas/ErrorCategory" }, "retryable": { "default": false, "title": "Retryable", "type": "boolean" }, "retry_after": { "default": null, "title": "Retry After", "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "type", "title", "status", "detail", "instance", "error_code", "error_category" ], "title": "ProblemDetail", "type": "object" } }, "responses": { "BadRequest": { "description": "Validation error -- request body or parameters are invalid.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_NoneType_" }, "example": { "data": null, "error": "Validation error", "error_detail": { "detail": "Validation error", "error_code": 2001, "error_category": "validation", "retryable": false, "retry_after": null, "instance": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "title": "Validation Error", "type": "https://synthorg.io/docs/errors#validation" }, "success": false } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetail" }, "example": { "type": "https://synthorg.io/docs/errors#validation", "title": "Validation Error", "status": 400, "detail": "Validation error", "instance": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "error_code": 2001, "error_category": "validation", "retryable": false, "retry_after": null } } } }, "Unauthorized": { "description": "Authentication required -- missing or invalid credentials.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_NoneType_" }, "example": { "data": null, "error": "Authentication required", "error_detail": { "detail": "Authentication required", "error_code": 1000, "error_category": "auth", "retryable": false, "retry_after": null, "instance": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "title": "Authentication Error", "type": "https://synthorg.io/docs/errors#auth" }, "success": false } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetail" }, "example": { "type": "https://synthorg.io/docs/errors#auth", "title": "Authentication Error", "status": 401, "detail": "Authentication required", "instance": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "error_code": 1000, "error_category": "auth", "retryable": false, "retry_after": null } } } }, "Forbidden": { "description": "Insufficient permissions for this operation.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_NoneType_" }, "example": { "data": null, "error": "Forbidden", "error_detail": { "detail": "Forbidden", "error_code": 1001, "error_category": "auth", "retryable": false, "retry_after": null, "instance": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "title": "Authentication Error", "type": "https://synthorg.io/docs/errors#auth" }, "success": false } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetail" }, "example": { "type": "https://synthorg.io/docs/errors#auth", "title": "Authentication Error", "status": 403, "detail": "Forbidden", "instance": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "error_code": 1001, "error_category": "auth", "retryable": false, "retry_after": null } } } }, "NotFound": { "description": "Requested resource does not exist.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_NoneType_" }, "example": { "data": null, "error": "Resource not found", "error_detail": { "detail": "Resource not found", "error_code": 3001, "error_category": "not_found", "retryable": false, "retry_after": null, "instance": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "title": "Resource Not Found", "type": "https://synthorg.io/docs/errors#not_found" }, "success": false } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetail" }, "example": { "type": "https://synthorg.io/docs/errors#not_found", "title": "Resource Not Found", "status": 404, "detail": "Resource not found", "instance": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "error_code": 3001, "error_category": "not_found", "retryable": false, "retry_after": null } } } }, "Conflict": { "description": "Resource conflict -- duplicate or invalid state transition.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_NoneType_" }, "example": { "data": null, "error": "Resource conflict", "error_detail": { "detail": "Resource conflict", "error_code": 4000, "error_category": "conflict", "retryable": false, "retry_after": null, "instance": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "title": "Resource Conflict", "type": "https://synthorg.io/docs/errors#conflict" }, "success": false } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetail" }, "example": { "type": "https://synthorg.io/docs/errors#conflict", "title": "Resource Conflict", "status": 409, "detail": "Resource conflict", "instance": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "error_code": 4000, "error_category": "conflict", "retryable": false, "retry_after": null } } } }, "TooManyRequests": { "description": "Rate limit exceeded -- back off and retry.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_NoneType_" }, "example": { "data": null, "error": "Rate limit exceeded", "error_detail": { "detail": "Rate limit exceeded", "error_code": 5000, "error_category": "rate_limit", "retryable": true, "retry_after": null, "instance": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "title": "Rate Limit Exceeded", "type": "https://synthorg.io/docs/errors#rate_limit" }, "success": false } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetail" }, "example": { "type": "https://synthorg.io/docs/errors#rate_limit", "title": "Rate Limit Exceeded", "status": 429, "detail": "Rate limit exceeded", "instance": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "error_code": 5000, "error_category": "rate_limit", "retryable": true, "retry_after": null } } } }, "InternalError": { "description": "Internal server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_NoneType_" }, "example": { "data": null, "error": "Internal server error", "error_detail": { "detail": "Internal server error", "error_code": 8000, "error_category": "internal", "retryable": false, "retry_after": null, "instance": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "title": "Internal Server Error", "type": "https://synthorg.io/docs/errors#internal" }, "success": false } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetail" }, "example": { "type": "https://synthorg.io/docs/errors#internal", "title": "Internal Server Error", "status": 500, "detail": "Internal server error", "instance": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "error_code": 8000, "error_category": "internal", "retryable": false, "retry_after": null } } } }, "ServiceUnavailable": { "description": "Required service is temporarily unavailable.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_NoneType_" }, "example": { "data": null, "error": "Service unavailable", "error_detail": { "detail": "Service unavailable", "error_code": 8001, "error_category": "internal", "retryable": true, "retry_after": null, "instance": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "title": "Internal Server Error", "type": "https://synthorg.io/docs/errors#internal" }, "success": false } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetail" }, "example": { "type": "https://synthorg.io/docs/errors#internal", "title": "Internal Server Error", "status": 503, "detail": "Service unavailable", "instance": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "error_code": 8001, "error_category": "internal", "retryable": true, "retry_after": null } } } } } } }