{ "info": { "title": "SynthOrg API", "version": "0.8.9", "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/healthz": { "get": { "tags": [ "health" ], "summary": "Liveness", "operationId": "ApiV1HealthzLiveness", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_LivenessStatus_" } } } }, "500": { "$ref": "#/components/responses/InternalError" } }, "deprecated": false } }, "/api/v1/readyz": { "get": { "tags": [ "health" ], "summary": "Readiness", "operationId": "ApiV1ReadyzReadiness", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_ReadinessStatus_" } } } }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/metrics": { "get": { "tags": [ "metrics" ], "summary": "Metrics", "operationId": "ApiV1MetricsMetrics", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "type": "string" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/capabilities": { "get": { "summary": "Report which optional subsystems are wired", "description": "Returns one boolean per optional subsystem. The dashboard uses this to gate polling on the surfaces actually wired in this deployment, avoiding 503-spam against optional services that are intentionally not configured.", "operationId": "ApiV1CapabilitiesGetCapabilities", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_CapabilitiesResponse_" } } } }, "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": { "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 }, "patch": { "tags": [ "company" ], "summary": "UpdateCompany", "operationId": "ApiV1CompanyUpdateCompany", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateCompanyRequest" } } }, "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" }, "409": { "$ref": "#/components/responses/Conflict" }, "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/company/reorder-departments": { "post": { "tags": [ "company" ], "summary": "ReorderDepartments", "operationId": "ApiV1CompanyReorderDepartmentsReorderDepartments", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReorderDepartmentsRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_tuple_Department_..._" } } } }, "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": { "get": { "tags": [ "agents" ], "summary": "ListAgents", "operationId": "ApiV1AgentsListAgents", "parameters": [ { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "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 }, "post": { "tags": [ "agents" ], "summary": "CreateAgent", "operationId": "ApiV1AgentsCreateAgent", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateAgentOrgRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_AgentConfig_" } } } }, "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_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 }, "delete": { "tags": [ "agents" ], "summary": "DeleteAgent", "operationId": "ApiV1AgentsAgentNameDeleteAgent", "parameters": [ { "name": "agent_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 }, "patch": { "tags": [ "agents" ], "summary": "UpdateAgent", "operationId": "ApiV1AgentsAgentNameUpdateAgent", "parameters": [ { "name": "agent_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/UpdateAgentOrgRequest" } } }, "required": true }, "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" }, "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_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": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "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}/health": { "get": { "tags": [ "agents" ], "summary": "GetAgentHealth", "operationId": "ApiV1AgentsAgentNameHealthGetAgentHealth", "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_AgentHealthResponse_" } } } }, "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/{agent_id}/versions/diff": { "get": { "tags": [ "agents" ], "summary": "GetDiff", "operationId": "ApiV1AgentsAgentIdVersionsDiffGetDiff", "parameters": [ { "name": "agent_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_AgentIdentityDiff_" } } } }, "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}/versions/{version_num}": { "get": { "tags": [ "agents" ], "summary": "GetVersion", "operationId": "ApiV1AgentsAgentIdVersionsVersionNumGetVersion", "parameters": [ { "name": "agent_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, "description": "Agent identity version (one-based; 1 = first revision)." }, "description": "Agent identity version (one-based; 1 = first revision).", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_VersionSnapshot_AgentIdentity_" } } } }, "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}/versions": { "get": { "tags": [ "agents" ], "summary": "ListVersions", "operationId": "ApiV1AgentsAgentIdVersionsListVersions", "parameters": [ { "name": "agent_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false }, { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 20 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_VersionSnapshot_AgentIdentity_" } } } }, "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}/versions/rollback": { "post": { "tags": [ "agents" ], "summary": "RollbackIdentity", "operationId": "ApiV1AgentsAgentIdVersionsRollbackRollbackIdentity", "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/RollbackAgentIdentityRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_AgentIdentity_" } } } }, "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/activities": { "get": { "tags": [ "activities" ], "summary": "ListActivities", "operationId": "ApiV1ActivitiesListActivities", "parameters": [ { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "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": { "get": { "tags": [ "departments" ], "summary": "ListDepartments", "operationId": "ApiV1DepartmentsListDepartments", "parameters": [ { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "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 }, "post": { "tags": [ "departments" ], "summary": "CreateDepartment", "operationId": "ApiV1DepartmentsCreateDepartment", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateDepartmentRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_Department_" } } } }, "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/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 }, "delete": { "tags": [ "departments" ], "summary": "DeleteDepartment", "operationId": "ApiV1DepartmentsNameDeleteDepartment", "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 }, "patch": { "tags": [ "departments" ], "summary": "UpdateDepartment", "operationId": "ApiV1DepartmentsNameUpdateDepartment", "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/UpdateDepartmentRequest" } } }, "required": true }, "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" }, "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/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}/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" }, "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}/reorder-agents": { "post": { "tags": [ "departments" ], "summary": "ReorderAgents", "operationId": "ApiV1DepartmentsNameReorderAgentsReorderAgents", "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/ReorderAgentsRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_tuple_AgentConfig_..._" } } } }, "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/projects": { "get": { "tags": [ "projects" ], "summary": "ListProjects", "operationId": "ApiV1ProjectsListProjects", "parameters": [ { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "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 }, "delete": { "tags": [ "projects" ], "summary": "DeleteProject", "operationId": "ApiV1ProjectsProjectIdDeleteProject", "parameters": [ { "name": "project_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/projects/{project_id}/docs/{slug}": { "get": { "tags": [ "project_docs" ], "summary": "GetDoc", "operationId": "ApiV1ProjectsProjectIdDocsSlugGetDoc", "parameters": [ { "name": "project_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false }, { "name": "slug", "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_LivingDocument_" } } } }, "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/projects/{project_id}/docs/{slug}/history": { "get": { "tags": [ "project_docs" ], "summary": "GetHistory", "operationId": "ApiV1ProjectsProjectIdDocsSlugHistoryGetHistory", "parameters": [ { "name": "project_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false }, { "name": "slug", "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_tuple_DocVersion_..._" } } } }, "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/projects/{project_id}/docs": { "get": { "tags": [ "project_docs" ], "summary": "ListDocs", "operationId": "ApiV1ProjectsProjectIdDocsListDocs", "parameters": [ { "name": "project_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false }, { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "doc_type", "in": "query", "schema": { "maxLength": 128, "description": "Filter by doc_type (status_report / deliverable / knowledge_note)", "minLength": 1, "type": [ "string", "null" ] }, "description": "Filter by doc_type (status_report / deliverable / knowledge_note)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "tag", "in": "query", "schema": { "maxLength": 128, "description": "Filter by tag (exact match)", "minLength": 1, "type": [ "string", "null" ] }, "description": "Filter by tag (exact match)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_DocSummary_" } } } }, "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/projects/{project_id}/docs/search": { "get": { "tags": [ "project_docs" ], "summary": "SearchDocs", "operationId": "ApiV1ProjectsProjectIdDocsSearchSearchDocs", "parameters": [ { "name": "project_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false }, { "name": "q", "in": "query", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Search query text" }, "description": "Search query text", "required": true, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "limit", "in": "query", "schema": { "type": "integer", "maximum": 64.0, "minimum": 1.0, "description": "Maximum hits to return", "default": 8 }, "description": "Maximum hits to return", "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_DocSearchHit_..._" } } } }, "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/projects/{project_id}/knowledge/{source_id}": { "get": { "tags": [ "project_knowledge" ], "summary": "GetSource", "operationId": "ApiV1ProjectsProjectIdKnowledgeSourceIdGetSource", "parameters": [ { "name": "project_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false }, { "name": "source_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_KnowledgeSource_" } } } }, "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/projects/{project_id}/knowledge": { "get": { "tags": [ "project_knowledge" ], "summary": "ListSources", "operationId": "ApiV1ProjectsProjectIdKnowledgeListSources", "parameters": [ { "name": "project_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false }, { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "include_global", "in": "query", "schema": { "type": "boolean", "description": "Include global (project-unscoped) sources in the listing", "default": true }, "description": "Include global (project-unscoped) sources in the listing", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "stale_only", "in": "query", "schema": { "type": "boolean", "description": "Only sources needing a refresh", "default": false }, "description": "Only sources needing a refresh", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_KnowledgeSource_" } } } }, "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/projects/{project_id}/knowledge/search": { "get": { "tags": [ "project_knowledge" ], "summary": "Search", "operationId": "ApiV1ProjectsProjectIdKnowledgeSearchSearch", "parameters": [ { "name": "project_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false }, { "name": "q", "in": "query", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Search text" }, "description": "Search text", "required": true, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "limit", "in": "query", "schema": { "type": "integer", "maximum": 64.0, "minimum": 1.0, "description": "Maximum cited hits to return", "default": 8 }, "description": "Maximum cited hits to return", "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_KnowledgeHit_..._" } } } }, "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/knowledge": { "get": { "tags": [ "knowledge" ], "summary": "ListGlobalSources", "operationId": "ApiV1KnowledgeListGlobalSources", "parameters": [ { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "stale_only", "in": "query", "schema": { "type": "boolean", "description": "Only sources needing a refresh", "default": false }, "description": "Only sources needing a refresh", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_KnowledgeSource_" } } } }, "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}/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": { "description": "Filter to tasks in this status.", "type": [ "string", "null" ], "enum": [ "created", "assigned", "in_progress", "in_review", "completed", "blocked", "failed", "interrupted", "suspended", "cancelled", "rejected", "auth_required", null ] }, "description": "Filter to tasks in this status.", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "assigned_to", "in": "query", "schema": { "maxLength": 256, "description": "Filter to tasks assigned to this agent.", "type": [ "string", "null" ] }, "description": "Filter to tasks assigned to this agent.", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "project", "in": "query", "schema": { "maxLength": 256, "description": "Filter to tasks scoped to this project.", "type": [ "string", "null" ] }, "description": "Filter to tasks scoped to this project.", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "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": { "202": { "description": "Request accepted, processing continues off-line", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_TaskBoardSubmissionResponse_" } } } }, "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}/execute": { "post": { "tags": [ "tasks" ], "summary": "ExecuteTask", "operationId": "ApiV1TasksTaskIdExecuteExecuteTask", "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/ExecuteTaskRequest" } } }, "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/experiments/{experiment}/assign": { "post": { "tags": [ "experiments" ], "summary": "Assign", "operationId": "ApiV1ExperimentsAssignAssign", "parameters": [ { "name": "experiment", "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/AssignExperimentRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_ExperimentAssignment_" } } } }, "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/experiments/{experiment}/assignments": { "get": { "tags": [ "experiments" ], "summary": "ListAssignments", "operationId": "ApiV1ExperimentsAssignmentsListAssignments", "parameters": [ { "name": "experiment", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false }, { "name": "limit", "in": "query", "schema": { "type": "integer", "maximum": 200.0, "minimum": 1.0, "description": "Page size (default 50, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_ExperimentAssignment_" } } } }, "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/experiments/{experiment}/variants": { "get": { "tags": [ "experiments" ], "summary": "ListVariants", "operationId": "ApiV1ExperimentsVariantsListVariants", "parameters": [ { "name": "experiment", "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_tuple_ExperimentVariant_..._" } } } }, "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": [ "experiments" ], "summary": "RegisterVariant", "operationId": "ApiV1ExperimentsVariantsRegisterVariant", "parameters": [ { "name": "experiment", "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/RegisterExperimentVariantRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_ExperimentVariant_" } } } }, "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/{message_id}": { "delete": { "tags": [ "messages" ], "summary": "DeleteMessage", "operationId": "ApiV1MessagesMessageIdDeleteMessage", "parameters": [ { "name": "message_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/messages/channels": { "get": { "tags": [ "messages" ], "summary": "ListChannels", "operationId": "ApiV1MessagesChannelsListChannels", "parameters": [ { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_Channel_" } } } }, "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/messages": { "get": { "tags": [ "messages" ], "summary": "ListMessages", "operationId": "ApiV1MessagesListMessages", "parameters": [ { "name": "channel", "in": "query", "schema": { "description": "Filter to messages on this channel.", "type": [ "string", "null" ] }, "description": "Filter to messages on this channel.", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "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 }, "delete": { "tags": [ "meetings" ], "summary": "DeleteMeeting", "operationId": "ApiV1MeetingsMeetingIdDeleteMeeting", "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_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/meetings": { "get": { "tags": [ "meetings" ], "summary": "ListMeetings", "operationId": "ApiV1MeetingsListMeetings", "parameters": [ { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "status", "in": "query", "schema": { "description": "Filter to meetings in this status.", "type": [ "string", "null" ], "enum": [ "scheduled", "in_progress", "completed", "failed", "cancelled", "budget_exhausted", null ] }, "description": "Filter to meetings in this status.", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "meeting_type", "in": "query", "schema": { "maxLength": 128, "description": "Filter by meeting type (STAND_UP, RETRO, etc.).", "type": [ "string", "null" ] }, "description": "Filter by meeting type (STAND_UP, RETRO, etc.).", "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": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "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/meta/charters/{charter_id}/approve": { "post": { "tags": [ "charter" ], "summary": "ApproveCharter", "operationId": "ApiV1MetaChartersCharterIdApproveApproveCharter", "parameters": [ { "name": "charter_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/_DecisionRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_CharterApprovalResult_" } } } }, "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/meta/charters/{charter_id}/cancel": { "post": { "tags": [ "charter" ], "summary": "CancelCharter", "operationId": "ApiV1MetaChartersCharterIdCancelCancelCharter", "parameters": [ { "name": "charter_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/_DecisionRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_ProjectCharter_" } } } }, "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/meta/charters/{charter_id}": { "get": { "tags": [ "charter" ], "summary": "GetCharter", "operationId": "ApiV1MetaChartersCharterIdGetCharter", "parameters": [ { "name": "charter_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_ProjectCharter_" } } } }, "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 }, "patch": { "tags": [ "charter" ], "summary": "EditCharter", "operationId": "ApiV1MetaChartersCharterIdEditCharter", "parameters": [ { "name": "charter_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/CharterEditRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_ProjectCharter_" } } } }, "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/meta/charters/interview": { "post": { "tags": [ "charter" ], "summary": "Interview", "operationId": "ApiV1MetaChartersInterviewInterview", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InterviewTurnRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_InterviewTurnResult_" } } } }, "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/meta/charters": { "get": { "tags": [ "charter" ], "summary": "ListCharters", "operationId": "ApiV1MetaChartersListCharters", "parameters": [ { "name": "status", "in": "query", "schema": { "type": [ "string", "null" ], "enum": [ "drafted", "approved", "cancelled", null ] }, "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "project_id", "in": "query", "schema": { "type": [ "string", "null" ] }, "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_ProjectCharter_" } } } }, "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/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, "description": "Filter to cost records emitted by this agent.", "type": [ "string", "null" ] }, "description": "Filter to cost records emitted by this agent.", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "task_id", "in": "query", "schema": { "maxLength": 128, "description": "Filter to cost records emitted under this task.", "type": [ "string", "null" ] }, "description": "Filter to cost records emitted under this task.", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "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/budget/forecasts/{forecast_id}/approve": { "post": { "tags": [ "budget", "forecast" ], "summary": "ApproveForecast", "operationId": "ApiV1BudgetForecastsForecastIdApproveApproveForecast", "parameters": [ { "name": "forecast_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/ForecastApproveRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Forecast" } } } }, "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/forecast": { "post": { "tags": [ "budget", "forecast" ], "summary": "CreateForecast", "operationId": "ApiV1BudgetForecastCreateForecast", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ForecastRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Forecast" } } } }, "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/budget/forecasts/{forecast_id}": { "get": { "tags": [ "budget", "forecast" ], "summary": "GetForecast", "operationId": "ApiV1BudgetForecastsForecastIdGetForecast", "parameters": [ { "name": "forecast_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/Forecast" } } } }, "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/pareto": { "get": { "tags": [ "budget", "forecast" ], "summary": "GetPareto", "operationId": "ApiV1BudgetParetoGetPareto", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ParetoFrontier" } } } }, "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/forecasts/{forecast_id}/raise_ceiling": { "post": { "tags": [ "budget", "forecast" ], "summary": "RaiseCeiling", "operationId": "ApiV1BudgetForecastsForecastIdRaiseCeilingRaiseCeiling", "parameters": [ { "name": "forecast_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/RaiseCeilingRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Forecast" } } } }, "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/forecasts/{forecast_id}/reject": { "post": { "tags": [ "budget", "forecast" ], "summary": "RejectForecast", "operationId": "ApiV1BudgetForecastsForecastIdRejectRejectForecast", "parameters": [ { "name": "forecast_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/ForecastRejectRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Forecast" } } } }, "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/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/{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 }, { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_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 }, "post": { "tags": [ "providers" ], "summary": "AddModel", "operationId": "ApiV1ProvidersNameModelsAddModel", "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/AddModelRequest" } } }, "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" }, "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/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", "parameters": [ { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_ProviderResponse_" } } } }, "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": [ "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, "description": "Local provider model id (may contain colons)." }, "description": "Local provider model id (may contain colons).", "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/presets/{preset_name}/override": { "get": { "tags": [ "providers" ], "summary": "GetPresetOverride", "operationId": "ApiV1ProvidersPresetsPresetNameOverrideGetPresetOverride", "parameters": [ { "name": "preset_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_PresetOverride_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 }, "delete": { "tags": [ "providers" ], "summary": "DeletePresetOverride", "operationId": "ApiV1ProvidersPresetsPresetNameOverrideDeletePresetOverride", "parameters": [ { "name": "preset_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 }, "patch": { "tags": [ "providers" ], "summary": "UpdatePresetOverride", "operationId": "ApiV1ProvidersPresetsPresetNameOverrideUpdatePresetOverride", "parameters": [ { "name": "preset_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/PresetOverrideUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_PresetOverride_" } } } }, "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}": { "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, "description": "Canonical preset hint (e.g. \"example-provider\", \"test-provider\").", "type": [ "string", "null" ] }, "description": "Canonical preset hint (e.g. \"example-provider\", \"test-provider\").", "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_Annotated_Union_CloudPreset_LocalPreset_FieldInfo_annotation_NoneType_required_True_discriminator_kind_..._" } } } }, "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" }, "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/{name}/rate-limits": { "get": { "tags": [ "providers" ], "summary": "GetRateLimits", "operationId": "ApiV1ProvidersNameRateLimitsGetRateLimits", "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_RateLimitsResponse_" } } } }, "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 }, "patch": { "tags": [ "providers" ], "summary": "UpdateRateLimits", "operationId": "ApiV1ProvidersNameRateLimitsUpdateRateLimits", "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/RateLimitsUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_RateLimitsResponse_" } } } }, "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}/audit": { "get": { "tags": [ "providers" ], "summary": "ListAudit", "operationId": "ApiV1ProvidersNameAuditListAudit", "parameters": [ { "name": "name", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource name" }, "description": "Resource name", "required": true, "deprecated": false }, { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_ProviderAuditEvent_" } } } }, "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-local": { "post": { "tags": [ "providers" ], "summary": "ProbeLocal", "operationId": "ApiV1ProvidersProbeLocalProbeLocal", "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_ProbeLocalResponse_" } } } }, "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}/credentials/rotate": { "post": { "tags": [ "providers" ], "summary": "RotateCredentials", "operationId": "ApiV1ProvidersNameCredentialsRotateRotateCredentials", "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": { "oneOf": [ { "$ref": "#/components/schemas/_ApiKeyRotation" }, { "$ref": "#/components/schemas/_SubscriptionRotation" }, { "$ref": "#/components/schemas/_CustomHeaderRotation" }, { "$ref": "#/components/schemas/_OAuthRotation" } ] } } }, "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" }, "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/sync": { "post": { "tags": [ "providers" ], "summary": "SyncModels", "operationId": "ApiV1ProvidersNameModelsSyncSyncModels", "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/SyncModelsRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_SyncModelsResponse_" } } } }, "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}/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, "description": "Local provider model whose launch parameters to update." }, "description": "Local provider model whose launch parameters to update.", "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": { "description": "Filter to approvals in this status.", "type": [ "string", "null" ], "enum": [ "pending", "approved", "rejected", "expired", null ] }, "description": "Filter to approvals in this status.", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "risk_level", "in": "query", "schema": { "description": "Filter to approvals at this risk level.", "type": [ "string", "null" ], "enum": [ "low", "medium", "high", "critical", null ] }, "description": "Filter to approvals at this risk level.", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "action_type", "in": "query", "schema": { "maxLength": 128, "description": "Filter to approvals raised for this action type.", "type": [ "string", "null" ] }, "description": "Filter to approvals raised for this action type.", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "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/conflicts/escalations/{escalation_id}/cancel": { "post": { "tags": [ "conflict-escalations" ], "summary": "CancelEscalation", "operationId": "ApiV1ConflictsEscalationsEscalationIdCancelCancelEscalation", "parameters": [ { "name": "escalation_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/CancelEscalationRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_EscalationResponse_" } } } }, "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/conflicts/escalations/{escalation_id}": { "get": { "tags": [ "conflict-escalations" ], "summary": "GetEscalation", "operationId": "ApiV1ConflictsEscalationsEscalationIdGetEscalation", "parameters": [ { "name": "escalation_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_EscalationResponse_" } } } }, "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/conflicts/escalations": { "get": { "tags": [ "conflict-escalations" ], "summary": "ListEscalations", "operationId": "ApiV1ConflictsEscalationsListEscalations", "parameters": [ { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "status", "in": "query", "schema": { "$ref": "#/components/schemas/EscalationStatus" }, "description": "Lifecycle state of an escalation row.\n\nMembers:\n PENDING: Awaiting a human decision.\n DECIDED: A decision has been applied.\n EXPIRED: Timed out without a decision.\n CANCELLED: Operator explicitly abandoned the escalation.\n", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_EscalationResponse_" } } } }, "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/conflicts/escalations/{escalation_id}/decision": { "post": { "tags": [ "conflict-escalations" ], "summary": "SubmitDecision", "operationId": "ApiV1ConflictsEscalationsEscalationIdDecisionSubmitDecision", "parameters": [ { "name": "escalation_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/SubmitDecisionRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_EscalationResponse_" } } } }, "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_CookieSessionResponse_" } } } }, "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": {}, "content": { "application/json": { "schema": { "type": "null" } } } }, "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/refresh": { "post": { "tags": [ "auth" ], "summary": "Rotate the refresh token", "operationId": "ApiV1AuthRefreshRefresh", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_CookieSessionResponse_" } } } }, "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/{session_id}": { "delete": { "tags": [ "auth" ], "summary": "Revoke a session", "operationId": "ApiV1AuthSessionsSessionIdRevokeSession", "parameters": [ { "name": "session_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/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_CookieSessionResponse_" } } } }, "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, "description": "Department to resolve against; omit for project policy.", "minLength": 1, "type": [ "string", "null" ] }, "description": "Department to resolve against; omit for project policy.", "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/events/resume/{interrupt_id}": { "post": { "tags": [ "events" ], "summary": "ResumeInterrupt", "operationId": "ApiV1EventsResumeInterruptIdResumeInterrupt", "parameters": [ { "name": "interrupt_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/ResumeInterruptRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_dict_str_str_" } } } }, "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/events/stream": { "get": { "tags": [ "events" ], "summary": "Stream", "operationId": "ApiV1EventsStreamStream", "parameters": [ { "name": "session_id", "in": "query", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "pattern": "^[a-zA-Z0-9_-]{1,128}$", "description": "Session ID whose AG-UI stream to subscribe to." }, "description": "Session ID whose AG-UI stream to subscribe to.", "required": true, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "text/event-stream": { "schema": {} } } }, "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/interrupts": { "get": { "tags": [ "interrupts" ], "summary": "ListInterrupts", "operationId": "ApiV1InterruptsListInterrupts", "parameters": [ { "name": "session_id", "in": "query", "schema": { "maxLength": 128, "pattern": "^[a-zA-Z0-9_-]{1,128}$", "description": "Filter to interrupts for this session; omit to list all.", "minLength": 1, "type": [ "string", "null" ] }, "description": "Filter to interrupts for this session; omit to list all.", "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_InterruptResponse_..._" } } } }, "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/interrupts/{interrupt_id}/resume": { "post": { "tags": [ "interrupts" ], "summary": "Resume", "operationId": "ApiV1InterruptsInterruptIdResumeResume", "parameters": [ { "name": "interrupt_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/ResumeInterruptRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_dict_str_str_" } } } }, "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/security/audit": { "get": { "tags": [ "security" ], "summary": "ListAuditEntries", "operationId": "ApiV1SecurityAuditListAuditEntries", "parameters": [ { "name": "agent_id", "in": "query", "schema": { "maxLength": 128, "description": "Filter to audit entries emitted for this agent.", "type": [ "string", "null" ] }, "description": "Filter to audit entries emitted for this agent.", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "tool_name", "in": "query", "schema": { "maxLength": 128, "description": "Filter to audit entries emitted for this tool.", "type": [ "string", "null" ] }, "description": "Filter to audit entries emitted for this tool.", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "action_type", "in": "query", "schema": { "maxLength": 128, "description": "Filter to audit entries with this action type.", "type": [ "string", "null" ] }, "description": "Filter to audit entries with this action type.", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "verdict", "in": "query", "schema": { "maxLength": 50, "description": "Filter by verdict (APPROVED / DENIED).", "type": [ "string", "null" ] }, "description": "Filter by verdict (APPROVED / DENIED).", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "since", "in": "query", "schema": { "description": "Filter to entries emitted at or after this ISO timestamp.", "format": "date-time", "type": [ "string", "null" ] }, "description": "Filter to entries emitted at or after this ISO timestamp.", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "until", "in": "query", "schema": { "description": "Filter to entries emitted at or before this ISO timestamp.", "format": "date-time", "type": [ "string", "null" ] }, "description": "Filter to entries emitted at or before this ISO timestamp.", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "jsonb_contains", "in": "query", "schema": { "maxLength": 2048, "description": "JSONB containment filter (Postgres @>); JSON-encoded.", "type": [ "string", "null" ] }, "description": "JSONB containment filter (Postgres @>); JSON-encoded.", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "jsonb_key_exists", "in": "query", "schema": { "maxLength": 256, "description": "Filter to entries whose payload has this top-level key.", "type": [ "string", "null" ] }, "description": "Filter to entries whose payload has this top-level key.", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_AuditEntry_" } } } }, "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/coordination/metrics": { "get": { "tags": [ "coordination" ], "summary": "ListCoordinationMetrics", "operationId": "ApiV1CoordinationMetricsListCoordinationMetrics", "parameters": [ { "name": "task_id", "in": "query", "schema": { "maxLength": 128, "description": "Filter to coordination metrics emitted under this task.", "type": [ "string", "null" ] }, "description": "Filter to coordination metrics emitted under this task.", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "agent_id", "in": "query", "schema": { "maxLength": 128, "description": "Filter to coordination metrics emitted by this agent.", "type": [ "string", "null" ] }, "description": "Filter to coordination metrics emitted by this agent.", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "since", "in": "query", "schema": { "description": "Filter to metrics emitted at or after this ISO timestamp.", "format": "date-time", "type": [ "string", "null" ] }, "description": "Filter to metrics emitted at or after this ISO timestamp.", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "until", "in": "query", "schema": { "description": "Filter to metrics emitted at or before this ISO timestamp.", "format": "date-time", "type": [ "string", "null" ] }, "description": "Filter to metrics emitted at or before this ISO timestamp.", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_CoordinationMetricsRecord_" } } } }, "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/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/security/export": { "get": { "tags": [ "settings" ], "summary": "ExportSecurityConfig", "operationId": "ApiV1SettingsSecurityExportExportSecurityConfig", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_SecurityConfigExportResponse_" } } } }, "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": { "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/security/import": { "post": { "tags": [ "settings" ], "summary": "ImportSecurityConfig", "operationId": "ApiV1SettingsSecurityImportImportSecurityConfig", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecurityConfigImportRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_SecurityConfigExportResponse_" } } } }, "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/settings": { "get": { "tags": [ "settings" ], "summary": "ListAllSettings", "operationId": "ApiV1SettingsListAllSettings", "parameters": [ { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_SettingEntry_" } } } }, "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/settings/observability/sinks": { "get": { "tags": [ "settings" ], "summary": "ListSinks", "operationId": "ApiV1SettingsObservabilitySinksListSinks", "parameters": [ { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_SinkInfoResponse_" } } } }, "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/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", "parameters": [ { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_SetupAgentSummary_" } } } }, "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/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", "parameters": [ { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_PersonalityPresetInfoResponse_" } } } }, "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/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": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "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", "parameters": [ { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_BackupInfo_" } } } }, "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": [ "admin", "backup" ], "summary": "CreateBackup", "operationId": "ApiV1AdminBackupsCreateBackup", "parameters": [ { "name": "Idempotency-Key", "in": "header", "schema": { "type": "string", "maxLength": 255, "minLength": 1, "description": "RFC-style retry-safe key. Required: identical keys within 24h return the cached manifest instead of starting a second backup. Without a key a 5xx-driven client retry could launch concurrent backups, violating the at-most-one-running invariant." }, "description": "RFC-style retry-safe key. Required: identical keys within 24h return the cached manifest instead of starting a second backup. Without a key a 5xx-driven client retry could launch concurrent backups, violating the at-most-one-running invariant.", "required": true, "deprecated": false } ], "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", "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/admin/memory/agents/{agent_id}/memories/{memory_id}": { "delete": { "tags": [ "admin", "memory" ], "summary": "DeleteMemoryEntry", "operationId": "ApiV1AdminMemoryAgentsAgentIdMemoriesMemoryIdDeleteMemoryEntry", "parameters": [ { "name": "agent_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false }, { "name": "memory_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/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", "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_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": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_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": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_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", "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_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", "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_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/departments/{dept_name}/teams": { "post": { "tags": [ "departments" ], "summary": "CreateTeam", "operationId": "ApiV1DepartmentsDeptNameTeamsCreateTeam", "parameters": [ { "name": "dept_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/CreateTeamRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_TeamResponse_" } } } }, "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/departments/{dept_name}/teams/{team_name}": { "delete": { "tags": [ "departments" ], "summary": "DeleteTeam", "operationId": "ApiV1DepartmentsDeptNameTeamsTeamNameDeleteTeam", "parameters": [ { "name": "dept_name", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource name" }, "description": "Resource name", "required": true, "deprecated": false }, { "name": "team_name", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource name" }, "description": "Resource name", "required": true, "deprecated": false }, { "name": "reassign_to", "in": "query", "schema": { "minLength": 1, "type": [ "string", "null" ] }, "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": 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": [ "departments" ], "summary": "UpdateTeam", "operationId": "ApiV1DepartmentsDeptNameTeamsTeamNameUpdateTeam", "parameters": [ { "name": "dept_name", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource name" }, "description": "Resource name", "required": true, "deprecated": false }, { "name": "team_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/UpdateTeamRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_TeamResponse_" } } } }, "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/departments/{dept_name}/teams/reorder": { "patch": { "tags": [ "departments" ], "summary": "ReorderTeams", "operationId": "ApiV1DepartmentsDeptNameTeamsReorderReorderTeams", "parameters": [ { "name": "dept_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/ReorderTeamsRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_tuple_TeamResponse_..._" } } } }, "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/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", "parameters": [ { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_UserResponse_" } } } }, "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": [ "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/users/{user_id}/org-roles": { "post": { "tags": [ "users" ], "summary": "GrantOrgRole", "operationId": "ApiV1UsersUserIdOrgRolesGrantOrgRole", "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/GrantOrgRoleRequest" } } }, "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" }, "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/users/{user_id}/org-roles/{role}": { "delete": { "tags": [ "users" ], "summary": "RevokeOrgRole", "operationId": "ApiV1UsersUserIdOrgRolesRevokeOrgRole", "parameters": [ { "name": "user_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false }, { "name": "role", "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/subworkflows": { "get": { "tags": [ "subworkflows" ], "summary": "ListSubworkflows", "operationId": "ApiV1SubworkflowsListSubworkflows", "parameters": [ { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_SubworkflowSummary_" } } } }, "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": [ "subworkflows" ], "summary": "CreateSubworkflow", "operationId": "ApiV1SubworkflowsCreateSubworkflow", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSubworkflowRequest" } } }, "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/subworkflows/{subworkflow_id}/versions/{version}": { "get": { "tags": [ "subworkflows" ], "summary": "GetVersion", "operationId": "ApiV1SubworkflowsSubworkflowIdVersionsGetVersion", "parameters": [ { "name": "subworkflow_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false }, { "name": "version", "in": "path", "schema": { "type": "string", "maxLength": 64, "minLength": 1, "description": "Subworkflow version to fetch (semver-like, e.g. 1.0.0)." }, "description": "Subworkflow version to fetch (semver-like, e.g. 1.0.0).", "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": [ "subworkflows" ], "summary": "DeleteVersion", "operationId": "ApiV1SubworkflowsSubworkflowIdVersionsDeleteVersion", "parameters": [ { "name": "subworkflow_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false }, { "name": "version", "in": "path", "schema": { "type": "string", "maxLength": 64, "minLength": 1, "description": "Subworkflow version to delete (parents block)." }, "description": "Subworkflow version to delete (parents block).", "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/subworkflows/{subworkflow_id}/versions/{version}/parents": { "get": { "tags": [ "subworkflows" ], "summary": "ListParents", "operationId": "ApiV1SubworkflowsSubworkflowIdVersionsParentsListParents", "parameters": [ { "name": "subworkflow_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false }, { "name": "version", "in": "path", "schema": { "type": "string", "maxLength": 64, "minLength": 1, "description": "Subworkflow version pinned by the parent workflows." }, "description": "Subworkflow version pinned by the parent workflows.", "required": true, "deprecated": false }, { "name": "limit", "in": "query", "schema": { "type": "integer", "maximum": 200.0, "minimum": 1.0, "description": "Page size (default 50, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_ParentReference_" } } } }, "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/subworkflows/{subworkflow_id}/versions": { "get": { "tags": [ "subworkflows" ], "summary": "ListVersions", "operationId": "ApiV1SubworkflowsSubworkflowIdVersionsListVersions", "parameters": [ { "name": "subworkflow_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false }, { "name": "limit", "in": "query", "schema": { "type": "integer", "maximum": 200.0, "minimum": 1.0, "description": "Page size (default 50, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_str_" } } } }, "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/subworkflows/search": { "get": { "tags": [ "subworkflows" ], "summary": "SearchSubworkflows", "operationId": "ApiV1SubworkflowsSearchSearchSubworkflows", "parameters": [ { "name": "q", "in": "query", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Search substring" }, "description": "Search substring", "required": true, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "limit", "in": "query", "schema": { "type": "integer", "maximum": 200.0, "minimum": 1.0, "description": "Page size (default 50, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_SubworkflowSummary_" } } } }, "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/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": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "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": { "type": "string" } } } }, "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, "description": "Workflow version (one-based; 1 = first revision)." }, "description": "Workflow version (one-based; 1 = first revision).", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_VersionSnapshot_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 } }, "/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": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 20 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_VersionSnapshot_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 } }, "/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/budget/config/versions/{version_num}": { "get": { "tags": [ "budget" ], "summary": "GetVersion", "operationId": "ApiV1BudgetConfigVersionsVersionNumGetVersion", "parameters": [ { "name": "version_num", "in": "path", "schema": { "type": "integer", "minimum": 1.0, "description": "Budget config version (one-based; 1 = first revision)." }, "description": "Budget config version (one-based; 1 = first revision).", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_VersionSnapshot_BudgetConfig_" } } } }, "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/versions": { "get": { "tags": [ "budget" ], "summary": "ListVersions", "operationId": "ApiV1BudgetConfigVersionsListVersions", "parameters": [ { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 20 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_VersionSnapshot_BudgetConfig_" } } } }, "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/company/versions/{version_num}": { "get": { "tags": [ "company" ], "summary": "GetVersion", "operationId": "ApiV1CompanyVersionsVersionNumGetVersion", "parameters": [ { "name": "version_num", "in": "path", "schema": { "type": "integer", "minimum": 1.0, "description": "Company version (one-based; 1 = first revision)." }, "description": "Company version (one-based; 1 = first revision).", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_VersionSnapshot_Company_" } } } }, "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/company/versions": { "get": { "tags": [ "company" ], "summary": "ListVersions", "operationId": "ApiV1CompanyVersionsListVersions", "parameters": [ { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 20 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_VersionSnapshot_Company_" } } } }, "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/evaluation/config/versions/{version_num}": { "get": { "tags": [ "evaluation" ], "summary": "GetVersion", "operationId": "ApiV1EvaluationConfigVersionsVersionNumGetVersion", "parameters": [ { "name": "version_num", "in": "path", "schema": { "type": "integer", "minimum": 1.0, "description": "Evaluation config version (one-based)." }, "description": "Evaluation config version (one-based).", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_VersionSnapshot_EvaluationConfig_" } } } }, "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/evaluation/config/versions": { "get": { "tags": [ "evaluation" ], "summary": "ListVersions", "operationId": "ApiV1EvaluationConfigVersionsListVersions", "parameters": [ { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 20 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_VersionSnapshot_EvaluationConfig_" } } } }, "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/roles/{role_name}/versions/{version_num}": { "get": { "tags": [ "roles" ], "summary": "GetVersion", "operationId": "ApiV1RolesRoleNameVersionsVersionNumGetVersion", "parameters": [ { "name": "role_name", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource name" }, "description": "Resource name", "required": true, "deprecated": false }, { "name": "version_num", "in": "path", "schema": { "type": "integer", "minimum": 1.0, "description": "Role version (one-based; 1 = first revision)." }, "description": "Role version (one-based; 1 = first revision).", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_VersionSnapshot_Role_" } } } }, "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/roles/{role_name}/versions": { "get": { "tags": [ "roles" ], "summary": "ListVersions", "operationId": "ApiV1RolesRoleNameVersionsListVersions", "parameters": [ { "name": "role_name", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource name" }, "description": "Resource name", "required": true, "deprecated": false }, { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 20 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_VersionSnapshot_Role_" } } } }, "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}/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 (paginated).", "operationId": "ApiV1ReportsPeriodsListPeriods", "parameters": [ { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_str_" } } } }, "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/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 }, { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/PaginatedResponse_WorkflowExecution_" }, { "$ref": "#/components/schemas/ApiResponse_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 } }, "/api/v1/ontology/admin/derive": { "post": { "tags": [ "ontology" ], "summary": "AdminDerive", "operationId": "ApiV1OntologyAdminDeriveAdminDerive", "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_dict_str_int_" } } } }, "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/ontology/admin/sync-org-memory": { "post": { "tags": [ "ontology" ], "summary": "AdminSyncOrgMemory", "operationId": "ApiV1OntologyAdminSyncOrgMemoryAdminSyncOrgMemory", "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_dict_str_Union_int_str_" } } } }, "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/ontology/entities": { "get": { "tags": [ "ontology" ], "summary": "ListEntities", "operationId": "ApiV1OntologyEntitiesListEntities", "parameters": [ { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "tier", "in": "query", "schema": { "description": "Filter to entity definitions in this tier.", "type": [ "string", "null" ] }, "description": "Filter to entity definitions in this tier.", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_EntityResponse_" } } } }, "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": [ "ontology" ], "summary": "CreateEntity", "operationId": "ApiV1OntologyEntitiesCreateEntity", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateEntityRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_EntityResponse_" } } } }, "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/ontology/entities/{name}": { "get": { "tags": [ "ontology" ], "summary": "GetEntity", "operationId": "ApiV1OntologyEntitiesNameGetEntity", "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_EntityResponse_" } } } }, "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": [ "ontology" ], "summary": "UpdateEntity", "operationId": "ApiV1OntologyEntitiesNameUpdateEntity", "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/UpdateEntityRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_EntityResponse_" } } } }, "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": [ "ontology" ], "summary": "DeleteEntity", "operationId": "ApiV1OntologyEntitiesNameDeleteEntity", "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/ontology/drift/{entity_name}": { "get": { "tags": [ "ontology" ], "summary": "GetDriftReport", "operationId": "ApiV1OntologyDriftEntityNameGetDriftReport", "parameters": [ { "name": "entity_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_DriftReportResponse_..._" } } } }, "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/ontology/entities/{name}/versions/{version}": { "get": { "tags": [ "ontology" ], "summary": "GetEntityVersion", "operationId": "ApiV1OntologyEntitiesNameVersionsGetEntityVersion", "parameters": [ { "name": "name", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource name" }, "description": "Resource name", "required": true, "deprecated": false }, { "name": "version", "in": "path", "schema": { "type": "integer", "description": "Entity definition version to fetch." }, "description": "Entity definition version to fetch.", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_EntityVersionResponse_" } } } }, "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/ontology/manifest": { "get": { "tags": [ "ontology" ], "summary": "GetVersionManifest", "operationId": "ApiV1OntologyManifestGetVersionManifest", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_dict_str_int_" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/ontology/drift": { "get": { "tags": [ "ontology" ], "summary": "ListDriftReports", "operationId": "ApiV1OntologyDriftListDriftReports", "parameters": [ { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_DriftReportResponse_" } } } }, "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/ontology/entities/{name}/versions": { "get": { "tags": [ "ontology" ], "summary": "ListEntityVersions", "operationId": "ApiV1OntologyEntitiesNameVersionsListEntityVersions", "parameters": [ { "name": "name", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource name" }, "description": "Resource name", "required": true, "deprecated": false }, { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_EntityVersionResponse_" } } } }, "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/ontology/drift/check": { "post": { "tags": [ "ontology" ], "summary": "TriggerDriftCheck", "operationId": "ApiV1OntologyDriftCheckTriggerDriftCheck", "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_dict_str_str_" } } } }, "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/clients": { "get": { "tags": [ "clients" ], "summary": "ListClients", "operationId": "ApiV1ClientsListClients", "parameters": [ { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_ClientProfile_" } } } }, "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": [ "clients" ], "summary": "CreateClient", "operationId": "ApiV1ClientsCreateClient", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateClientRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_ClientProfile_" } } } }, "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/clients/{client_id}": { "get": { "tags": [ "clients" ], "summary": "GetClient", "operationId": "ApiV1ClientsClientIdGetClient", "parameters": [ { "name": "client_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_ClientProfile_" } } } }, "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": [ "clients" ], "summary": "DeactivateClient", "operationId": "ApiV1ClientsClientIdDeactivateClient", "parameters": [ { "name": "client_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": [ "clients" ], "summary": "UpdateClient", "operationId": "ApiV1ClientsClientIdUpdateClient", "parameters": [ { "name": "client_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/UpdateClientRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_ClientProfile_" } } } }, "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/clients/{client_id}/satisfaction": { "get": { "tags": [ "clients" ], "summary": "GetSatisfaction", "operationId": "ApiV1ClientsClientIdSatisfactionGetSatisfaction", "parameters": [ { "name": "client_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_SatisfactionHistory_" } } } }, "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/reviews/{task_id}/stages/{stage_name}/decide": { "post": { "tags": [ "reviews" ], "summary": "DecideStage", "operationId": "ApiV1ReviewsTaskIdStagesStageNameDecideDecideStage", "parameters": [ { "name": "task_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false }, { "name": "stage_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/StageDecisionPayload" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_StageDecisionResult_" } } } }, "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/reviews/{task_id}/pipeline": { "get": { "tags": [ "reviews" ], "summary": "GetPipeline", "operationId": "ApiV1ReviewsTaskIdPipelineGetPipeline", "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_PipelineResult_" } } } }, "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/scaling/decisions": { "get": { "tags": [ "scaling" ], "summary": "ListDecisions", "operationId": "ApiV1ScalingDecisionsListDecisions", "parameters": [ { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_ScalingDecisionResponse_" } } } }, "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/scaling/signals": { "get": { "tags": [ "scaling" ], "summary": "ListSignals", "operationId": "ApiV1ScalingSignalsListSignals", "parameters": [ { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_ScalingSignalResponse_" } } } }, "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/scaling/strategies": { "get": { "tags": [ "scaling" ], "summary": "ListStrategies", "operationId": "ApiV1ScalingStrategiesListStrategies", "parameters": [ { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_ScalingStrategyResponse_" } } } }, "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/scaling/evaluate": { "post": { "tags": [ "scaling" ], "summary": "TriggerEvaluation", "operationId": "ApiV1ScalingEvaluateTriggerEvaluation", "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_tuple_ScalingDecisionResponse_..._" } } } }, "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/scaling/priority": { "put": { "tags": [ "scaling" ], "summary": "UpdatePriority", "operationId": "ApiV1ScalingPriorityUpdatePriority", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PriorityUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_tuple_str_..._" } } } }, "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/scaling/strategies/{strategy_name}": { "put": { "tags": [ "scaling" ], "summary": "UpdateStrategy", "operationId": "ApiV1ScalingStrategiesStrategyNameUpdateStrategy", "parameters": [ { "name": "strategy_name", "in": "path", "schema": { "type": "string" }, "required": true, "deprecated": false } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StrategyUpdateRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_ScalingStrategyResponse_" } } } }, "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_name}/training/plan": { "get": { "summary": "GetLatestPlan", "operationId": "ApiV1AgentsAgentNameTrainingPlanGetLatestPlan", "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_TrainingPlanResponse_" } } } }, "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": { "summary": "CreatePlan", "operationId": "ApiV1AgentsAgentNameTrainingPlanCreatePlan", "parameters": [ { "name": "agent_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/CreateTrainingPlanRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_TrainingPlanResponse_" } } } }, "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_name}/training/execute": { "post": { "summary": "ExecutePlan", "operationId": "ApiV1AgentsAgentNameTrainingExecuteExecutePlan", "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_TrainingResultResponse_" } } } }, "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_name}/training/result": { "get": { "summary": "GetResult", "operationId": "ApiV1AgentsAgentNameTrainingResultGetResult", "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_TrainingResultResponse_" } } } }, "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}/training/preview": { "post": { "summary": "PreviewPlan", "operationId": "ApiV1AgentsAgentNameTrainingPreviewPreviewPlan", "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_TrainingResultResponse_" } } } }, "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_name}/training/plan/{plan_id}/overrides": { "put": { "summary": "UpdateOverrides", "operationId": "ApiV1AgentsAgentNameTrainingPlanPlanIdOverridesUpdateOverrides", "parameters": [ { "name": "agent_name", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource name" }, "description": "Resource name", "required": true, "deprecated": false }, { "name": "plan_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/UpdateTrainingOverridesRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_TrainingPlanResponse_" } } } }, "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/meta/chat": { "post": { "tags": [ "meta" ], "summary": "Chat", "operationId": "ApiV1MetaChatChat", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChatRequest" } } }, "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" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/meta/chat/propose": { "post": { "tags": [ "meta" ], "summary": "ChatPropose", "operationId": "ApiV1MetaChatProposeChatPropose", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConversationalProposeRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_ProposeResult_" } } } }, "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/meta/ab-tests/{proposal_id}": { "get": { "tags": [ "meta" ], "summary": "GetAbTestDetail", "operationId": "ApiV1MetaAbTestsProposalIdGetAbTestDetail", "parameters": [ { "name": "proposal_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_dict_str_Any_" } } } }, "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/meta/config": { "get": { "tags": [ "meta" ], "summary": "GetConfig", "operationId": "ApiV1MetaConfigGetConfig", "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/meta/mcp/server": { "get": { "tags": [ "meta" ], "summary": "GetMcpServerConfig", "operationId": "ApiV1MetaMcpServerGetMcpServerConfig", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_dict_str_object_" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/meta/signals": { "get": { "tags": [ "meta" ], "summary": "GetSignals", "operationId": "ApiV1MetaSignalsGetSignals", "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/meta/ab-tests": { "get": { "tags": [ "meta" ], "summary": "ListAbTests", "operationId": "ApiV1MetaAbTestsListAbTests", "parameters": [ { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_dict_str_Any_" } } } }, "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/meta/mcp/tools": { "get": { "tags": [ "meta" ], "summary": "ListMcpTools", "operationId": "ApiV1MetaMcpToolsListMcpTools", "parameters": [ { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_dict_str_str_" } } } }, "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/meta/proposals": { "get": { "tags": [ "meta" ], "summary": "ListProposals", "operationId": "ApiV1MetaProposalsListProposals", "parameters": [ { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_dict_str_Any_" } } } }, "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/meta/rules": { "get": { "tags": [ "meta" ], "summary": "ListRules", "operationId": "ApiV1MetaRulesListRules", "parameters": [ { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_dict_str_Any_" } } } }, "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/meta/cycle": { "post": { "tags": [ "meta" ], "summary": "TriggerCycle", "operationId": "ApiV1MetaCycleTriggerCycle", "responses": { "201": { "description": "Document created, URL 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" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/meta/analytics/patterns": { "get": { "tags": [ "meta-analytics" ], "summary": "GetPatterns", "operationId": "ApiV1MetaAnalyticsPatternsGetPatterns", "parameters": [ { "name": "min_deployments", "in": "query", "schema": { "type": "integer", "maximum": 100.0, "minimum": 1.0, "description": "Minimum deployment count for a pattern to be returned.", "default": 3 }, "description": "Minimum deployment count for a pattern to be returned.", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_AggregatedPattern_" } } } }, "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/meta/analytics/recommendations": { "get": { "tags": [ "meta-analytics" ], "summary": "GetRecommendations", "operationId": "ApiV1MetaAnalyticsRecommendationsGetRecommendations", "parameters": [ { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_ThresholdRecommendation_" } } } }, "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/meta/analytics/events": { "post": { "tags": [ "meta-analytics" ], "summary": "IngestEvents", "operationId": "ApiV1MetaAnalyticsEventsIngestEvents", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EventBatch" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_dict_str_int_" } } } }, "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/meta/custom-rules": { "get": { "tags": [ "meta" ], "summary": "ListRules", "operationId": "ApiV1MetaCustomRulesListRules", "parameters": [ { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_dict_str_Any_" } } } }, "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": [ "meta" ], "summary": "CreateRule", "operationId": "ApiV1MetaCustomRulesCreateRule", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateCustomRuleRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL 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" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/meta/custom-rules/{rule_id}": { "get": { "tags": [ "meta" ], "summary": "GetRule", "operationId": "ApiV1MetaCustomRulesRuleIdGetRule", "parameters": [ { "name": "rule_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_dict_str_Any_" } } } }, "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": [ "meta" ], "summary": "DeleteRule", "operationId": "ApiV1MetaCustomRulesRuleIdDeleteRule", "parameters": [ { "name": "rule_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": [ "meta" ], "summary": "UpdateRule", "operationId": "ApiV1MetaCustomRulesRuleIdUpdateRule", "parameters": [ { "name": "rule_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/UpdateCustomRuleRequest" } } }, "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 } }, "/api/v1/meta/custom-rules/metrics": { "get": { "tags": [ "meta" ], "summary": "ListMetrics", "operationId": "ApiV1MetaCustomRulesMetricsListMetrics", "parameters": [ { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_dict_str_Any_" } } } }, "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/meta/custom-rules/preview": { "post": { "tags": [ "meta" ], "summary": "PreviewRule", "operationId": "ApiV1MetaCustomRulesPreviewPreviewRule", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PreviewRuleRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL 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" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/meta/custom-rules/{rule_id}/toggle": { "post": { "tags": [ "meta" ], "summary": "ToggleRule", "operationId": "ApiV1MetaCustomRulesRuleIdToggleToggleRule", "parameters": [ { "name": "rule_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_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 } }, "/api/v1/cockpit/flight-recorder/{execution_id}/frames": { "get": { "tags": [ "cockpit" ], "summary": "GetFrames", "operationId": "ApiV1CockpitFlightRecorderExecutionIdFramesGetFrames", "parameters": [ { "name": "execution_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false }, { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_FlightRecorderFrame_" } } } }, "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/cockpit/snapshot": { "get": { "tags": [ "cockpit" ], "summary": "GetSnapshot", "operationId": "ApiV1CockpitSnapshotGetSnapshot", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_LiveActivitySnapshot_" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/cockpit/interventions/hint": { "post": { "tags": [ "cockpit" ], "summary": "Hint", "operationId": "ApiV1CockpitInterventionsHintHint", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SteerInterventionRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_SteeringOutcome_" } } } }, "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/cockpit/interventions/kill": { "post": { "tags": [ "cockpit" ], "summary": "Kill", "operationId": "ApiV1CockpitInterventionsKillKill", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/KillInterventionRequest" } } }, "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/cockpit/interventions/pause": { "post": { "tags": [ "cockpit" ], "summary": "Pause", "operationId": "ApiV1CockpitInterventionsPausePause", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PauseInterventionRequest" } } }, "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/cockpit/interventions/redirect": { "post": { "tags": [ "cockpit" ], "summary": "Redirect", "operationId": "ApiV1CockpitInterventionsRedirectRedirect", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SteerInterventionRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_SteeringOutcome_" } } } }, "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/cockpit/flight-recorder/{execution_id}/seek/{turn_index}": { "get": { "tags": [ "cockpit" ], "summary": "SeekFrame", "operationId": "ApiV1CockpitFlightRecorderExecutionIdSeekTurnIndexSeekFrame", "parameters": [ { "name": "execution_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false }, { "name": "turn_index", "in": "path", "schema": { "type": "integer", "minimum": 1.0, "description": "Target turn index (1-based)" }, "description": "Target turn index (1-based)", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_ReplaySeekView_" } } } }, "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/connections/{name}/health": { "get": { "tags": [ "Integrations" ], "summary": "Check connection health", "operationId": "ApiV1ConnectionsNameHealthCheckHealth", "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_HealthReport_" } } } }, "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/connections": { "get": { "tags": [ "Integrations" ], "summary": "List all connections", "operationId": "ApiV1ConnectionsListConnections", "parameters": [ { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_Connection_" } } } }, "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": [ "Integrations" ], "summary": "Create a connection", "operationId": "ApiV1ConnectionsCreateConnection", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateConnectionRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_Connection_" } } } }, "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/connections/{name}": { "get": { "tags": [ "Integrations" ], "summary": "Get a connection by name", "operationId": "ApiV1ConnectionsNameGetConnection", "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_Connection_" } } } }, "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": [ "Integrations" ], "summary": "Delete a connection", "operationId": "ApiV1ConnectionsNameDeleteConnection", "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 }, "patch": { "tags": [ "Integrations" ], "summary": "Update a connection", "operationId": "ApiV1ConnectionsNameUpdateConnection", "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/UpdateConnectionRequest" } } }, "required": true }, "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_Connection_" } } } }, "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/connections/{name}/secrets/{field}": { "get": { "tags": [ "Integrations" ], "summary": "Reveal a single credential field", "operationId": "ApiV1ConnectionsNameSecretsFieldRevealSecret", "parameters": [ { "name": "name", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource name" }, "description": "Resource name", "required": true, "deprecated": false }, { "name": "field", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Credential field name" }, "description": "Credential field name", "required": true, "deprecated": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_dict_str_str_" } } } }, "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/integrations/health": { "get": { "tags": [ "Integrations" ], "summary": "Aggregate health report across all connections", "operationId": "ApiV1IntegrationsHealthAggregateHealth", "parameters": [ { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_HealthReport_" } } } }, "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/integrations/health/{connection_name}": { "get": { "tags": [ "Integrations" ], "summary": "Health report for a single connection", "operationId": "ApiV1IntegrationsHealthConnectionNameSingleHealth", "parameters": [ { "name": "connection_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_HealthReport_" } } } }, "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/oauth/callback": { "get": { "tags": [ "Integrations" ], "summary": "OAuth callback", "operationId": "ApiV1OauthCallbackCallback", "parameters": [ { "name": "code", "in": "query", "schema": { "type": "string", "maxLength": 2048, "description": "Authorization code" }, "description": "Authorization code", "required": true, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "state", "in": "query", "schema": { "type": "string", "maxLength": 512, "description": "OAuth state token" }, "description": "OAuth state token", "required": true, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "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" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/oauth/initiate": { "post": { "tags": [ "Integrations" ], "summary": "Start an OAuth flow", "operationId": "ApiV1OauthInitiateInitiateFlow", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InitiateOAuthFlowRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_dict_str_str_" } } } }, "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/oauth/status/{connection_name}": { "get": { "tags": [ "Integrations" ], "summary": "Check OAuth token status", "operationId": "ApiV1OauthStatusConnectionNameTokenStatus", "parameters": [ { "name": "connection_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_dict_str_Any_" } } } }, "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/webhooks/{connection_name}/activity": { "get": { "tags": [ "Integrations" ], "summary": "List webhook activity for a connection", "operationId": "ApiV1WebhooksConnectionNameActivityListActivity", "parameters": [ { "name": "connection_name", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource name" }, "description": "Resource name", "required": true, "deprecated": false }, { "name": "limit", "in": "query", "schema": { "type": "integer", "maximum": 500.0, "minimum": 1.0, "description": "Max results", "default": 100 }, "description": "Max results", "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_WebhookReceipt_..._" } } } }, "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/webhooks/{connection_name}/{event_type}": { "post": { "tags": [ "Integrations" ], "summary": "Receive a webhook event", "operationId": "ApiV1WebhooksConnectionNameEventTypeReceiveWebhook", "parameters": [ { "name": "connection_name", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource name" }, "description": "Resource name", "required": true, "deprecated": false }, { "name": "event_type", "in": "path", "schema": { "type": "string", "maxLength": 64, "minLength": 1, "description": "Webhook event type" }, "description": "Webhook event type", "required": true, "deprecated": false } ], "responses": { "202": { "description": "Request accepted, processing continues off-line", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_dict_str_object_" } } } }, "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/webhooks/receipts/{receipt_id}/retry": { "post": { "tags": [ "Integrations" ], "summary": "Retry a failed webhook receipt", "operationId": "ApiV1WebhooksReceiptsReceiptIdRetryRetryReceipt", "parameters": [ { "name": "receipt_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "responses": { "202": { "description": "Request accepted, processing continues off-line", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_dict_str_object_" } } } }, "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/integrations/mcp/catalog": { "get": { "tags": [ "Integrations" ], "summary": "List all catalog entries", "operationId": "ApiV1IntegrationsMcpCatalogBrowseCatalog", "parameters": [ { "name": "limit", "in": "query", "schema": { "type": "integer", "maximum": 200.0, "minimum": 1.0, "description": "Page size (default 50, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_CatalogEntry_" } } } }, "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/integrations/mcp/catalog/{entry_id}": { "get": { "tags": [ "Integrations" ], "summary": "Get a catalog entry", "operationId": "ApiV1IntegrationsMcpCatalogEntryIdGetEntry", "parameters": [ { "name": "entry_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_CatalogEntry_" } } } }, "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/integrations/mcp/catalog/install": { "post": { "tags": [ "Integrations" ], "summary": "Install a catalog entry", "operationId": "ApiV1IntegrationsMcpCatalogInstallInstallEntry", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InstallEntryRequest" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_InstallEntryResponse_" } } } }, "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/integrations/mcp/catalog/installed": { "get": { "tags": [ "Integrations" ], "summary": "List installed catalog entries", "operationId": "ApiV1IntegrationsMcpCatalogInstalledListInstalled", "parameters": [ { "name": "limit", "in": "query", "schema": { "type": "integer", "maximum": 200.0, "minimum": 1.0, "description": "Page size (default 50, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_InstalledEntry_" } } } }, "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/integrations/mcp/catalog/search": { "get": { "tags": [ "Integrations" ], "summary": "Search catalog entries", "operationId": "ApiV1IntegrationsMcpCatalogSearchSearchCatalog", "parameters": [ { "name": "q", "in": "query", "schema": { "type": "string", "maxLength": 512, "description": "Search query" }, "description": "Search query", "required": true, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "limit", "in": "query", "schema": { "type": "integer", "maximum": 200.0, "minimum": 1.0, "description": "Page size (default 50, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_CatalogEntry_" } } } }, "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/integrations/mcp/catalog/install/{entry_id}": { "delete": { "tags": [ "Integrations" ], "summary": "Uninstall a catalog entry", "operationId": "ApiV1IntegrationsMcpCatalogInstallEntryIdUninstallEntry", "parameters": [ { "name": "entry_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/integrations/tunnel/status": { "get": { "tags": [ "Integrations" ], "summary": "Get tunnel status", "operationId": "ApiV1IntegrationsTunnelStatusGetStatus", "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_dict_str_Union_str_bool_NoneType_" } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/integrations/tunnel/start": { "post": { "tags": [ "Integrations" ], "summary": "Start webhook tunnel", "operationId": "ApiV1IntegrationsTunnelStartStartTunnel", "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_dict_str_str_" } } } }, "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/integrations/tunnel/stop": { "post": { "tags": [ "Integrations" ], "summary": "Stop webhook tunnel", "operationId": "ApiV1IntegrationsTunnelStopStopTunnel", "responses": { "201": { "description": "Document created, URL 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" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/simulations/{simulation_id}/cancel": { "post": { "tags": [ "simulations" ], "summary": "CancelSimulation", "operationId": "ApiV1SimulationsSimulationIdCancelCancelSimulation", "parameters": [ { "name": "simulation_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_SimulationStatusResponse_" } } } }, "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/simulations/{simulation_id}/report": { "get": { "tags": [ "simulations" ], "summary": "GetReport", "operationId": "ApiV1SimulationsSimulationIdReportGetReport", "parameters": [ { "name": "simulation_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false }, { "name": "fmt", "in": "query", "schema": { "type": "string", "default": "summary" }, "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "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" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/TooManyRequests" }, "500": { "$ref": "#/components/responses/InternalError" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "deprecated": false } }, "/api/v1/simulations/{simulation_id}": { "get": { "tags": [ "simulations" ], "summary": "GetSimulation", "operationId": "ApiV1SimulationsSimulationIdGetSimulation", "parameters": [ { "name": "simulation_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_SimulationStatusResponse_" } } } }, "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/simulations": { "get": { "tags": [ "simulations" ], "summary": "ListSimulations", "operationId": "ApiV1SimulationsListSimulations", "parameters": [ { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_SimulationStatusResponse_" } } } }, "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": [ "simulations" ], "summary": "StartSimulation", "operationId": "ApiV1SimulationsStartSimulation", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StartSimulationPayload" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_SimulationStatusResponse_" } } } }, "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/requests/{request_id}/approve": { "post": { "tags": [ "requests" ], "summary": "ApproveRequest", "operationId": "ApiV1RequestsRequestIdApproveApproveRequest", "parameters": [ { "name": "request_id", "in": "path", "schema": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Resource identifier" }, "description": "Resource identifier", "required": true, "deprecated": false } ], "responses": { "202": { "description": "Request accepted, processing continues off-line", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_ClientRequest_" } } } }, "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/requests/{request_id}": { "get": { "tags": [ "requests" ], "summary": "GetRequest", "operationId": "ApiV1RequestsRequestIdGetRequest", "parameters": [ { "name": "request_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_ClientRequest_" } } } }, "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/requests": { "get": { "tags": [ "requests" ], "summary": "ListRequests", "operationId": "ApiV1RequestsListRequests", "parameters": [ { "name": "status", "in": "query", "schema": { "description": "Filter to requests in this status.", "type": [ "string", "null" ], "enum": [ "submitted", "triaging", "scoping", "approved", "task_created", "cancelled", null ] }, "description": "Filter to requests in this status.", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false }, { "name": "cursor", "in": "query", "schema": { "maxLength": 512, "description": "Opaque pagination cursor returned by the previous page", "type": [ "string", "null" ] }, "description": "Opaque pagination cursor returned by the previous page", "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, max 200)", "default": 50 }, "description": "Page size (default 50, max 200)", "required": false, "deprecated": false, "allowEmptyValue": false, "allowReserved": false } ], "responses": { "200": { "description": "Request fulfilled, document follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedResponse_ClientRequest_" } } } }, "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": [ "requests" ], "summary": "SubmitRequest", "operationId": "ApiV1RequestsSubmitRequest", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateRequestPayload" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_ClientRequest_" } } } }, "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/requests/{request_id}/reject": { "post": { "tags": [ "requests" ], "summary": "RejectRequest", "operationId": "ApiV1RequestsRequestIdRejectRejectRequest", "parameters": [ { "name": "request_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/RejectionPayload" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_ClientRequest_" } } } }, "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/requests/{request_id}/scope": { "post": { "tags": [ "requests" ], "summary": "ScopeRequest", "operationId": "ApiV1RequestsRequestIdScopeScopeRequest", "parameters": [ { "name": "request_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/ScopingPayload" } } }, "required": true }, "responses": { "201": { "description": "Document created, URL follows", "headers": {}, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiResponse_ClientRequest_" } } } }, "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 } } }, "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" }, "AddModelRequest": { "properties": { "model": { "$ref": "#/components/schemas/ProviderModelConfig" } }, "type": "object", "required": [ "model" ], "title": "AddModelRequest" }, "AgentActivity": { "properties": { "agent_id": { "type": "string", "minLength": 1, "description": "Agent working the task" }, "task_id": { "type": "string", "minLength": 1, "description": "Task being worked" }, "execution_id": { "description": "Execution id of the latest recorded turn, when any", "minLength": 1, "type": [ "string", "null" ] }, "status": { "$ref": "#/components/schemas/TaskStatus" }, "turn_count": { "type": "integer", "minimum": 0.0, "description": "Turns recorded so far" }, "cost": { "type": "number", "minimum": 0.0, "description": "Accumulated cost for the task" }, "last_active": { "description": "datetime with the constraint that the value must have timezone info", "format": "date-time", "type": [ "string", "null" ] }, "is_stuck": { "type": "boolean", "description": "Idle beyond the stuck threshold" }, "is_runaway": { "type": "boolean", "description": "Cost beyond the runaway threshold" } }, "type": "object", "required": [ "agent_id", "cost", "is_runaway", "is_stuck", "status", "task_id", "turn_count" ], "title": "AgentActivity" }, "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_preset": { "description": "Named personality preset. ``setup_agents`` writes the resolved preset name back when bootstrapping from a template, so the company-agents setting must round-trip the field rather than reject it under ``extra=forbid``.", "minLength": 1, "type": [ "string", "null" ] }, "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 ] }, "strategic_output_mode": { "description": "Per-agent strategic output mode override. None inherits the company strategy config default.", "type": [ "string", "null" ], "enum": [ "option_expander", "advisor", "decision_maker", "context_dependent", null ] }, "tier": { "type": [ "null", "string" ], "enum": [ "large", "medium", "small", null ], "description": "Resolved model tier from the setup wizard (``large`` / ``medium`` / ``small``). Round-trips so the company-agents setting survives Pydantic validation when the wizard persists tier alongside the model selection." }, "model_requirement": { "description": "Structured model requirement dict emitted by the setup wizard (tier / priority / min_context / capabilities). Stored as a raw dict because the canonical ``ModelRequirement`` model lives in ``synthorg.templates`` and importing it here would create a config -> templates cycle; the matcher rehydrates the dict at use sites.", "additionalProperties": {}, "type": [ "object", "null" ] } }, "type": "object", "required": [ "department", "name", "role" ], "title": "AgentConfig" }, "AgentHealthResponse": { "properties": { "agent_id": { "type": "string", "minLength": 1 }, "agent_name": { "type": "string", "minLength": 1 }, "lifecycle_status": { "$ref": "#/components/schemas/AgentStatus" }, "last_active_at": { "format": "date-time", "description": "datetime with the constraint that the value must have timezone info", "type": [ "string", "null" ] }, "trust": { "anyOf": [ { "$ref": "#/components/schemas/TrustSummary" }, { "type": "null" } ] }, "performance": { "anyOf": [ { "$ref": "#/components/schemas/PerformanceSummary" }, { "type": "null" } ] } }, "type": "object", "required": [ "agent_id", "agent_name", "lifecycle_status" ], "title": "AgentHealthResponse" }, "AgentIdentity": { "properties": { "id": { "type": "string", "format": "uuid", "description": "Unique agent identifier" }, "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": { "$ref": "#/components/schemas/PersonalityConfig" }, "skills": { "$ref": "#/components/schemas/SkillSet" }, "model": { "$ref": "#/components/schemas/ModelConfig" }, "memory": { "$ref": "#/components/schemas/MemoryConfig" }, "tools": { "$ref": "#/components/schemas/ToolPermissions" }, "authority": { "$ref": "#/components/schemas/Authority" }, "autonomy_level": { "description": "Per-agent autonomy level override (D6)", "type": [ "string", "null" ], "enum": [ "full", "semi", "supervised", "locked", null ] }, "strategic_output_mode": { "description": "Per-agent strategic output mode override. None inherits the company strategy config default.", "type": [ "string", "null" ], "enum": [ "option_expander", "advisor", "decision_maker", "context_dependent", null ] }, "hiring_date": { "type": "string", "format": "date", "description": "Date the agent was hired" }, "status": { "$ref": "#/components/schemas/AgentStatus" } }, "type": "object", "required": [ "department", "hiring_date", "model", "name", "role" ], "title": "AgentIdentity", "description": "Full frozen entity model at this version" }, "AgentIdentityDiff": { "properties": { "agent_id": { "type": "string", "minLength": 1 }, "from_version": { "type": "integer", "minimum": 1.0 }, "to_version": { "type": "integer", "minimum": 1.0 }, "field_changes": { "items": { "$ref": "#/components/schemas/IdentityFieldChange" }, "type": "array", "default": [] }, "summary": { "type": "string", "description": "Human-readable one-line summary of the diff.", "readOnly": true } }, "type": "object", "required": [ "agent_id", "from_version", "summary", "to_version" ], "title": "AgentIdentityDiff" }, "AgentMiddlewareConfig": { "properties": { "chain": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Agent middleware names in execution order", "default": [ "checkpoint_resume", "delegation_chain_hash", "authority_deference", "sanitize_message", "security_interceptor", "policy_gate", "approval_gate", "assumption_violation", "classification", "cost_recording" ] }, "authority_deference": { "$ref": "#/components/schemas/AuthorityDeferenceConfig" } }, "type": "object", "required": [], "title": "AgentMiddlewareConfig", "description": "Agent-level middleware configuration" }, "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": { "description": "Average cost per task in the configured display 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" }, "AgentRetentionRule": { "properties": { "category": { "$ref": "#/components/schemas/MemoryCategory" }, "retention_days": { "type": "integer", "minimum": 1.0, "description": "Number of days to retain memories" } }, "type": "object", "required": [ "category", "retention_days" ], "title": "AgentRetentionRule" }, "AgentSpending": { "properties": { "agent_id": { "type": "string", "minLength": 1, "description": "Agent identifier" }, "total_cost": { "type": "number", "minimum": 0.0, "description": "Total cost in the configured currency" }, "currency": { "type": "string", "maxLength": 3, "minLength": 3, "description": "ISO 4217 currency code", "default": "USD" } }, "type": "object", "required": [ "agent_id", "total_cost" ], "title": "AgentSpending" }, "AgentStatus": { "type": "string", "enum": [ "active", "onboarding", "on_leave", "terminated" ], "title": "AgentStatus", "description": "Lifecycle status of an agent.", "default": "active" }, "AggregatedPattern": { "properties": { "source_rule": { "type": "string", "minLength": 1 }, "altitude": { "type": "string", "minLength": 1 }, "deployment_count": { "type": "integer", "minimum": 1.0 }, "total_events": { "type": "integer", "minimum": 1.0 }, "decision_count": { "type": "integer", "minimum": 0.0 }, "approval_rate": { "type": "number", "maximum": 1.0, "minimum": 0.0 }, "success_rate": { "type": "number", "maximum": 1.0, "minimum": 0.0 }, "avg_confidence": { "type": "number", "maximum": 1.0, "minimum": 0.0 }, "avg_observation_hours": { "type": [ "number", "null" ] }, "industry_breakdown": { "items": { "prefixItems": [ { "type": "string", "minLength": 1 }, { "type": "integer", "minimum": 0.0 } ], "type": "array" }, "type": "array", "default": [] } }, "type": "object", "required": [ "altitude", "approval_rate", "avg_confidence", "decision_count", "deployment_count", "source_rule", "success_rate", "total_events" ], "title": "AggregatedPattern" }, "AmdahlCeiling": { "properties": { "parallelizable_fraction": { "type": "number", "exclusiveMaximum": 1.0, "minimum": 0.0, "description": "Parallelizable workload fraction (0.0--<1.0)" }, "max_speedup": { "type": "number", "description": "Maximum theoretical speedup", "readOnly": true }, "recommended_team_size": { "type": "integer", "description": "Team size at 90% of max speedup", "readOnly": true } }, "type": "object", "required": [ "max_speedup", "parallelizable_fraction", "recommended_team_size" ], "title": "AmdahlCeiling" }, "AnonymizedOutcomeEvent": { "properties": { "schema_version": { "type": "string", "const": "1", "default": "1" }, "deployment_id": { "type": "string", "minLength": 1 }, "event_type": { "type": "string", "enum": [ "proposal_decision", "rollout_result" ] }, "timestamp": { "type": "string", "minLength": 1 }, "altitude": { "type": "string", "minLength": 1 }, "source_rule": { "minLength": 1, "type": [ "string", "null" ] }, "decision": { "type": [ "null", "string" ], "enum": [ "approved", "rejected", null ] }, "confidence": { "maximum": 1.0, "type": [ "number", "null" ] }, "rollout_outcome": { "minLength": 1, "type": [ "string", "null" ] }, "regression_verdict": { "minLength": 1, "type": [ "string", "null" ] }, "observation_hours": { "type": [ "number", "null" ] }, "enabled_altitudes": { "items": { "type": "string", "minLength": 1 }, "type": "array", "default": [] }, "industry_tag": { "minLength": 1, "type": [ "string", "null" ] }, "sdk_version": { "type": "string", "minLength": 1 } }, "type": "object", "required": [ "altitude", "deployment_id", "event_type", "sdk_version", "timestamp" ], "title": "AnonymizedOutcomeEvent" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[AgentConfig]" }, "ApiResponse_AgentHealthResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/AgentHealthResponse" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[AgentHealthResponse]" }, "ApiResponse_AgentIdentityDiff_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/AgentIdentityDiff" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[AgentIdentityDiff]" }, "ApiResponse_AgentIdentity_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/AgentIdentity" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[AgentIdentity]" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[CalibrationSummaryResponse]" }, "ApiResponse_CapabilitiesResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/CapabilitiesResponse" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[CapabilitiesResponse]" }, "ApiResponse_CatalogEntry_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/CatalogEntry" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[CatalogEntry]" }, "ApiResponse_CharterApprovalResult_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/CharterApprovalResult" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[CharterApprovalResult]" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[CheckpointRecord]" }, "ApiResponse_ClientProfile_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/ClientProfile" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[ClientProfile]" }, "ApiResponse_ClientRequest_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/ClientRequest" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[ClientRequest]" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[CollaborationScoreResult]" }, "ApiResponse_Connection_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/Connection" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[Connection]" }, "ApiResponse_CookieSessionResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/CookieSessionResponse" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[CookieSessionResponse]" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[DiscoveryPolicyResponse]" }, "ApiResponse_EntityResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/EntityResponse" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[EntityResponse]" }, "ApiResponse_EntityVersionResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/EntityVersionResponse" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[EntityVersionResponse]" }, "ApiResponse_EscalationResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/EscalationResponse" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[EscalationResponse]" }, "ApiResponse_ExperimentAssignment_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/ExperimentAssignment" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[ExperimentAssignment]" }, "ApiResponse_ExperimentVariant_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/ExperimentVariant" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[ExperimentVariant]" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[ForecastResponse]" }, "ApiResponse_HealthReport_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/HealthReport" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[HealthReport]" }, "ApiResponse_InstallEntryResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/InstallEntryResponse" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[InstallEntryResponse]" }, "ApiResponse_InterviewTurnResult_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/InterviewTurnResult" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[InterviewTurnResult]" }, "ApiResponse_KnowledgeSource_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/KnowledgeSource" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[KnowledgeSource]" }, "ApiResponse_LiveActivitySnapshot_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/LiveActivitySnapshot" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[LiveActivitySnapshot]" }, "ApiResponse_LivenessStatus_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/LivenessStatus" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[LivenessStatus]" }, "ApiResponse_LivingDocument_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/LivingDocument" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[LivingDocument]" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[OverviewMetrics]" }, "ApiResponse_PipelineResult_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/PipelineResult" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[PipelineResult]" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[PresetDetailResponse]" }, "ApiResponse_PresetOverride_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/PresetOverride" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[PresetOverride]" }, "ApiResponse_ProbeLocalResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/ProbeLocalResponse" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[ProbeLocalResponse]" }, "ApiResponse_ProjectCharter_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/ProjectCharter" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[ProjectCharter]" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[Project]" }, "ApiResponse_ProposeResult_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/ProposeResult" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[ProposeResult]" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[QualityOverrideResponse]" }, "ApiResponse_RateLimitsResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/RateLimitsResponse" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[RateLimitsResponse]" }, "ApiResponse_ReadinessStatus_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/ReadinessStatus" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[ReadinessStatus]" }, "ApiResponse_ReplaySeekView_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/ReplaySeekView" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[ReplaySeekView]" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[RestoreResponse]" }, "ApiResponse_SatisfactionHistory_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/SatisfactionHistory" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[SatisfactionHistory]" }, "ApiResponse_ScalingStrategyResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/ScalingStrategyResponse" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[ScalingStrategyResponse]" }, "ApiResponse_SecurityConfigExportResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/SecurityConfigExportResponse" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[SecurityConfigExportResponse]" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[SetupAgentSummary]" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[SetupStatusResponse]" }, "ApiResponse_SimulationStatusResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/SimulationStatusResponse" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[SimulationStatusResponse]" }, "ApiResponse_StageDecisionResult_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/StageDecisionResult" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[StageDecisionResult]" }, "ApiResponse_SteeringOutcome_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/SteeringOutcome" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[SteeringOutcome]" }, "ApiResponse_SyncModelsResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/SyncModelsResponse" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[SyncModelsResponse]" }, "ApiResponse_TaskBoardSubmissionResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/TaskBoardSubmissionResponse" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[TaskBoardSubmissionResponse]" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[Task]" }, "ApiResponse_TeamResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/TeamResponse" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[TeamResponse]" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[TestSinkConfigResponse]" }, "ApiResponse_TrainingPlanResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/TrainingPlanResponse" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[TrainingPlanResponse]" }, "ApiResponse_TrainingResultResponse_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/TrainingResultResponse" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[TrainingResultResponse]" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[TrendsResponse]" }, "ApiResponse_Union_PresetOverride_NoneType_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/PresetOverride" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[Union[PresetOverride, NoneType]]" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[UserResponse]" }, "ApiResponse_VersionSnapshot_AgentIdentity_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/VersionSnapshot_AgentIdentity_" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[VersionSnapshot[AgentIdentity]]" }, "ApiResponse_VersionSnapshot_BudgetConfig_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/VersionSnapshot_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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[VersionSnapshot[BudgetConfig]]" }, "ApiResponse_VersionSnapshot_Company_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/VersionSnapshot_Company_" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[VersionSnapshot[Company]]" }, "ApiResponse_VersionSnapshot_EvaluationConfig_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/VersionSnapshot_EvaluationConfig_" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[VersionSnapshot[EvaluationConfig]]" }, "ApiResponse_VersionSnapshot_Role_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/VersionSnapshot_Role_" }, { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[VersionSnapshot[Role]]" }, "ApiResponse_VersionSnapshot_WorkflowDefinition_": { "properties": { "data": { "anyOf": [ { "$ref": "#/components/schemas/VersionSnapshot_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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[VersionSnapshot[WorkflowDefinition]]" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[dict[str, Any]]" }, "ApiResponse_dict_str_Union_int_str_": { "properties": { "data": { "additionalProperties": { "oneOf": [ { "type": "integer" }, { "type": "string" } ] }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[dict[str, Union[int, str]]]" }, "ApiResponse_dict_str_Union_str_bool_NoneType_": { "properties": { "data": { "additionalProperties": { "type": [ "string", "boolean", "null" ] }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[dict[str, Union[str, bool, NoneType]]]" }, "ApiResponse_dict_str_int_": { "properties": { "data": { "additionalProperties": { "type": "integer" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[dict[str, int]]" }, "ApiResponse_dict_str_object_": { "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[dict[str, object]]" }, "ApiResponse_dict_str_str_": { "properties": { "data": { "additionalProperties": { "type": "string" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[dict[str, str]]" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[list[SessionResponse]]" }, "ApiResponse_tuple_AgentConfig_..._": { "properties": { "data": { "items": { "$ref": "#/components/schemas/AgentConfig" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[tuple[AgentConfig, ...]]" }, "ApiResponse_tuple_Annotated_Union_CloudPreset_LocalPreset_FieldInfo_annotation_NoneType_required_True_discriminator_kind_..._": { "properties": { "data": { "items": { "oneOf": [ { "$ref": "#/components/schemas/CloudPreset" }, { "$ref": "#/components/schemas/LocalPreset" } ] }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[tuple[Annotated[Union[CloudPreset, LocalPreset], FieldInfo(annotation=NoneType, required=True, discriminator='kind')], ...]]" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[tuple[CareerEvent, ...]]" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[tuple[Department, ...]]" }, "ApiResponse_tuple_DocSearchHit_..._": { "properties": { "data": { "items": { "$ref": "#/components/schemas/DocSearchHit" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[tuple[DocSearchHit, ...]]" }, "ApiResponse_tuple_DocVersion_..._": { "properties": { "data": { "items": { "$ref": "#/components/schemas/DocVersion" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[tuple[DocVersion, ...]]" }, "ApiResponse_tuple_DriftReportResponse_..._": { "properties": { "data": { "items": { "$ref": "#/components/schemas/DriftReportResponse" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[tuple[DriftReportResponse, ...]]" }, "ApiResponse_tuple_ExperimentVariant_..._": { "properties": { "data": { "items": { "$ref": "#/components/schemas/ExperimentVariant" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[tuple[ExperimentVariant, ...]]" }, "ApiResponse_tuple_InterruptResponse_..._": { "properties": { "data": { "items": { "$ref": "#/components/schemas/InterruptResponse" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[tuple[InterruptResponse, ...]]" }, "ApiResponse_tuple_KnowledgeHit_..._": { "properties": { "data": { "items": { "$ref": "#/components/schemas/KnowledgeHit" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[tuple[KnowledgeHit, ...]]" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[tuple[PackInfoResponse, ...]]" }, "ApiResponse_tuple_ScalingDecisionResponse_..._": { "properties": { "data": { "items": { "$ref": "#/components/schemas/ScalingDecisionResponse" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[tuple[ScalingDecisionResponse, ...]]" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[tuple[SettingEntry, ...]]" }, "ApiResponse_tuple_TeamResponse_..._": { "properties": { "data": { "items": { "$ref": "#/components/schemas/TeamResponse" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[tuple[TeamResponse, ...]]" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[tuple[TemplateInfoResponse, ...]]" }, "ApiResponse_tuple_WebhookReceipt_..._": { "properties": { "data": { "items": { "$ref": "#/components/schemas/WebhookReceipt" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[tuple[WebhookReceipt, ...]]" }, "ApiResponse_tuple_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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "success" ], "title": "ApiResponse[tuple[str, ...]]" }, "ApplyTemplatePackRequest": { "properties": { "pack_name": { "type": "string", "minLength": 1, "description": "Pack to apply" }, "rebalance_mode": { "$ref": "#/components/schemas/RebalanceMode" } }, "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 }, "budget_before": { "type": "number", "minimum": 0.0, "description": "Sum of existing department budgets before apply" }, "budget_after": { "type": "number", "minimum": 0.0, "description": "Sum of all department budgets after apply" }, "rebalance_mode": { "$ref": "#/components/schemas/RebalanceMode" }, "scale_factor": { "description": "Scale factor applied to existing departments", "type": [ "number", "null" ] } }, "type": "object", "required": [ "agents_added", "budget_after", "budget_before", "departments_added", "pack_name", "rebalance_mode" ], "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" }, "source": { "$ref": "#/components/schemas/ApprovalSource" }, "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" ] }, "consumed_at": { "format": "date-time", "description": "datetime with the constraint that the value must have timezone info", "type": [ "string", "null" ] }, "evidence_package": { "description": "Structured evidence for HITL approval", "anyOf": [ { "$ref": "#/components/schemas/EvidencePackage" }, { "type": "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." }, "ApprovalSource": { "type": "string", "enum": [ "parked_context", "review_gate", "conversational_intake" ], "title": "ApprovalSource", "description": "Origin of an approval item, fixed at creation.\n\nRouting of a decided approval (mid-execution resume vs. review\ngate) keys off this persisted discriminator rather than a live\nparked-context probe, so the flow is deterministic even when the\nparked-context backend is momentarily unavailable.\n\nAttributes:\n PARKED_CONTEXT: Backs a parked agent execution context (SecOps\n escalation or the ``request_human_approval`` tool); the\n decision resumes the parked run.\n REVIEW_GATE: Any other approval (autonomy, hiring, promotion,\n pruning, scaling, training, signals, ...); the decision\n drives the review-gate transition. Default.\n CONVERSATIONAL_INTAKE: A work item proposed through the\n conversational interface (Chief of Staff clarify + propose);\n approval reconstructs the ``WorkItem`` and runs it through\n the work pipeline. Rejection records the proposal as\n declined and never touches the pipeline.\n", "default": "review_gate" }, "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" }, "AssignExperimentRequest": { "properties": { "subject_id": { "type": "string", "minLength": 1, "description": "Subject identifier (agent id, user id, project id, ...)" } }, "type": "object", "required": [ "subject_id" ], "title": "AssignExperimentRequest" }, "AuditEntry": { "properties": { "id": { "type": "string", "minLength": 1 }, "timestamp": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" }, "agent_id": { "minLength": 1, "type": [ "string", "null" ] }, "task_id": { "minLength": 1, "type": [ "string", "null" ] }, "tool_name": { "type": "string", "minLength": 1 }, "tool_category": { "$ref": "#/components/schemas/ToolCategory" }, "action_type": { "type": "string" }, "arguments_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "verdict": { "type": "string", "enum": [ "allow", "deny", "escalate", "output_scan" ] }, "risk_level": { "$ref": "#/components/schemas/ApprovalRiskLevel" }, "reason": { "type": "string", "minLength": 1 }, "matched_rules": { "items": { "type": "string", "minLength": 1 }, "type": "array", "default": [] }, "evaluation_duration_ms": { "type": "number", "minimum": 0.0 }, "confidence": { "$ref": "#/components/schemas/EvaluationConfidence" }, "approval_id": { "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [ "action_type", "arguments_hash", "evaluation_duration_ms", "id", "reason", "risk_level", "timestamp", "tool_category", "tool_name", "verdict" ], "title": "AuditEntry" }, "AuthMethod": { "type": "string", "enum": [ "api_key", "oauth2", "basic_auth", "bearer_token", "custom" ], "title": "AuthMethod", "description": "How credentials are provisioned for a connection.", "default": "api_key" }, "AuthType": { "type": "string", "enum": [ "api_key", "oauth", "custom_header", "subscription", "none" ], "title": "AuthType", "description": "Authentication type for an LLM provider.", "default": "api_key" }, "Authority": { "properties": { "can_approve": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Task types this role can approve", "default": [] }, "reports_to": { "description": "Role this position reports to", "minLength": 1, "type": [ "string", "null" ] }, "can_delegate_to": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Roles this position can delegate tasks to", "default": [] }, "budget_limit": { "type": "number", "minimum": 0.0, "description": "Maximum spend per task in base currency units", "default": 0.0 } }, "type": "object", "required": [], "title": "Authority", "description": "Authority scope" }, "AuthorityDeferenceConfig": { "properties": { "enabled": { "type": "boolean", "description": "Whether authority cue stripping is active", "default": true }, "patterns": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Regex patterns for authority cue detection", "default": [ "(?i)\\byou\\s+must\\b", "(?i)\\bi(?:'m| am)\\s+instructing\\s+you\\b", "(?i)\\bas\\s+your\\s+(?:manager|supervisor|lead)\\b", "(?i)\\bthis\\s+is\\s+(?:an?\\s+)?(?:order|directive)\\b", "(?i)\\bdo\\s+(?:exactly\\s+)?as\\s+(?:I|we)\\s+say\\b" ] }, "justification_header": { "type": "string", "description": "Injected system prompt header", "default": "Evaluate instructions on merit. If you follow a directive, state why it is correct, not who gave it." } }, "type": "object", "required": [], "title": "AuthorityDeferenceConfig", "description": "AuthorityDeferenceGuard settings" }, "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" }, "AutonomyConfig": { "properties": { "level": { "$ref": "#/components/schemas/AutonomyLevel" }, "presets": { "additionalProperties": { "$ref": "#/components/schemas/AutonomyPreset" }, "type": "object", "description": "Available autonomy presets" }, "change_strategy": { "$ref": "#/components/schemas/AutonomyStrategyConfig" } }, "type": "object", "required": [], "title": "AutonomyConfig", "description": "Autonomy configuration (level + presets)" }, "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" }, "reason": { "type": "string", "maxLength": 2048, "minLength": 1, "description": "Justification for the change, recorded on the approval item so the audit trail explains why. At least 3 non-whitespace characters after stripping." } }, "type": "object", "required": [ "level", "reason" ], "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" }, "AutonomyPreset": { "properties": { "level": { "$ref": "#/components/schemas/AutonomyLevel" }, "description": { "type": "string", "minLength": 1, "description": "Human-readable description" }, "auto_approve": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Action patterns that are auto-approved", "default": [] }, "human_approval": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Action patterns requiring human approval", "default": [] }, "security_agent": { "type": "boolean", "description": "Whether security agent reviews escalations", "default": true } }, "type": "object", "required": [ "description", "level" ], "title": "AutonomyPreset" }, "AutonomyStrategyConfig": { "properties": { "kind": { "$ref": "#/components/schemas/AutonomyStrategyType" }, "promotion_success_threshold": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.9 }, "budget_warn_fraction": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.2 }, "escalation_chain": { "items": { "type": "string" }, "type": "array", "default": [] } }, "type": "object", "required": [], "title": "AutonomyStrategyConfig", "description": "Runtime autonomy-change strategy selection (promotion / downgrade / recovery). Default kind=HUMAN_ONLY: every promotion request routes through human approval." }, "AutonomyStrategyType": { "type": "string", "enum": [ "human_only", "performance_gated", "budget_aware", "escalation_chain" ], "title": "AutonomyStrategyType", "description": "Discriminator selecting the autonomy change strategy.\n\n- ``HUMAN_ONLY`` -- promotions + recovery always require human\n approval; byte-identical to a bare ``HumanOnlyPromotionStrategy()``.\n- ``PERFORMANCE_GATED`` -- grants promotion when the agent's\n rolling success rate clears a threshold; downgrade/recovery\n delegate to the base (HumanOnly) strategy.\n- ``BUDGET_AWARE`` -- denies promotion while risk-budget headroom\n is below the warn fraction; otherwise delegates to the base.\n- ``ESCALATION_CHAIN`` -- promotion is routed through a configured\n role chain; returns ``False`` (pending) until the chain approves.\n", "default": "human_only" }, "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, "pattern": "^[A-Z]{3}$", "description": "ISO 4217 currency code stamped onto every new cost record and used for display formatting. SynthOrg does not convert provider costs -- provider token prices are reported in the provider-native currency (see ``DEFAULT_CURRENCY``) and changing this setting relabels the code stamped onto subsequent records without translating any numeric values. Historical rows retain the code that was active when they were written.", "default": "USD" }, "risk_budget": { "$ref": "#/components/schemas/RiskBudgetConfig" }, "pte_tracking_enabled": { "type": "boolean", "description": "Enable Prefill Token Equivalents tracking (observability-only)", "default": false }, "forecast_required": { "type": "boolean", "description": "Require operator approval of a pre-flight cost forecast", "default": true }, "forecast_default_ceiling_multiplier": { "type": "number", "minimum": 1.0, "description": "Multiplier applied to the forecast upper bound when suggesting a per-run hard ceiling at approval time", "default": 1.5 }, "run_hard_ceiling": { "type": "number", "minimum": 0.0, "description": "Absolute hard real-money ceiling applied when Task.hard_ceiling is unset (zero disables the global fallback)", "default": 0.0 }, "forecast_static_prior_per_turn_large": { "type": "number", "minimum": 0.0, "description": "Static prior cost per turn for the `large` model tier", "default": 0.1 }, "forecast_static_prior_per_turn_medium": { "type": "number", "minimum": 0.0, "description": "Static prior cost per turn for the `medium` model tier", "default": 0.03 }, "forecast_static_prior_per_turn_small": { "type": "number", "minimum": 0.0, "description": "Static prior cost per turn for the `small` model tier", "default": 0.005 }, "forecast_static_prior_per_turn_local_small": { "type": "number", "minimum": 0.0, "description": "Static prior cost per turn for the `local-small` model tier", "default": 0.0 }, "forecast_shrinkage_prior_weight": { "type": "number", "minimum": 0.0, "description": "Prior pseudo-count for the Bayesian shrinkage blend", "default": 5.0 } }, "type": "object", "required": [], "title": "BudgetConfig" }, "BudgetEnvelope": { "properties": { "amount": { "type": "number", "exclusiveMinimum": 0.0, "description": "Budget ceiling in `currency`" }, "currency": { "type": "string", "maxLength": 3, "minLength": 3, "pattern": "^[A-Z]{3}$", "description": "ISO 4217 currency code" }, "deadline": { "format": "date-time", "description": "datetime with the constraint that the value must have timezone info", "type": [ "string", "null" ] }, "time_horizon": { "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [ "amount", "currency" ], "title": "BudgetEnvelope" }, "BulletListBlock": { "properties": { "block_kind": { "type": "string", "const": "bullet_list", "description": "Discriminator value for the DocBlock union", "default": "bullet_list" }, "block_id": { "type": "string", "minLength": 1 }, "items": { "items": { "type": "string", "maxLength": 1024, "minLength": 1 }, "type": "array", "minItems": 1, "description": "Non-empty tuple of bullet entries" } }, "type": "object", "required": [ "items" ], "title": "BulletListBlock" }, "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" }, "CancelEscalationRequest": { "properties": { "reason": { "type": "string", "maxLength": 4096, "minLength": 1, "description": "Why the operator is abandoning this escalation" } }, "type": "object", "required": [ "reason" ], "title": "CancelEscalationRequest" }, "CancelTaskRequest": { "properties": { "reason": { "type": "string", "maxLength": 4096, "minLength": 1, "description": "Reason for cancellation" } }, "type": "object", "required": [ "reason" ], "title": "CancelTaskRequest" }, "CapabilitiesResponse": { "properties": { "simulations": { "type": "boolean" }, "requests": { "type": "boolean" }, "ontology": { "type": "boolean" }, "tunnel": { "type": "boolean" }, "webhooks": { "type": "boolean" }, "a2a": { "type": "boolean" }, "telemetry": { "type": "boolean" }, "integrations": { "type": "boolean" } }, "type": "object", "required": [ "a2a", "integrations", "ontology", "requests", "simulations", "telemetry", "tunnel", "webhooks" ], "title": "CapabilitiesResponse" }, "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" }, "CatalogEntry": { "properties": { "id": { "type": "string", "minLength": 1 }, "name": { "type": "string", "minLength": 1 }, "description": { "type": "string", "default": "" }, "npm_package": { "minLength": 1, "type": [ "string", "null" ] }, "required_connection_type": { "type": [ "string", "null" ], "enum": [ "github", "gitlab", "gitea", "forgejo", "slack", "smtp", "database", "generic_http", "oauth_app", "a2a_peer", null ] }, "transport": { "type": "string", "enum": [ "stdio", "streamable_http" ], "default": "stdio" }, "capabilities": { "items": { "type": "string" }, "type": "array", "default": [] }, "tags": { "items": { "type": "string" }, "type": "array", "default": [] } }, "type": "object", "required": [ "id", "name" ], "title": "CatalogEntry" }, "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" }, "CharterApprovalResult": { "properties": { "charter": { "$ref": "#/components/schemas/ProjectCharter" }, "project_id": { "type": "string", "minLength": 1 }, "task_id": { "type": "string", "minLength": 1 }, "is_success": { "type": "boolean" } }, "type": "object", "required": [ "charter", "is_success", "project_id", "task_id" ], "title": "CharterApprovalResult" }, "CharterEditRequest": { "properties": { "title": { "minLength": 1, "type": [ "string", "null" ] }, "brief": { "minLength": 1, "type": [ "string", "null" ] }, "goals": { "items": { "type": "string", "minLength": 1 }, "type": [ "array", "null" ] }, "constraints": { "items": { "type": "string", "minLength": 1 }, "type": [ "array", "null" ] }, "success_criteria": { "items": { "type": "string", "minLength": 1 }, "type": [ "array", "null" ] }, "scope": { "anyOf": [ { "$ref": "#/components/schemas/ScopeBoundaries" }, { "type": "null" } ] }, "envelope": { "anyOf": [ { "$ref": "#/components/schemas/BudgetEnvelope" }, { "type": "null" } ] } }, "type": "object", "required": [], "title": "CharterEditRequest" }, "CharterStatus": { "type": "string", "enum": [ "drafted", "approved", "cancelled" ], "title": "CharterStatus", "description": "Lifecycle state of a project charter produced by a deep interview.\n\nAttributes:\n DRAFTED: The interview produced a charter draft; the user may\n review and edit it in place. The only non-terminal state.\n APPROVED: The charter was approved and dispatched into the work\n pipeline spine as a real project run. Terminal.\n CANCELLED: The charter was discarded before approval. Terminal.\n", "default": "drafted" }, "ChatRequest": { "properties": { "question": { "type": "string", "maxLength": 2000, "minLength": 1 }, "proposal_id": { "format": "uuid", "type": [ "string", "null" ] }, "alert_id": { "format": "uuid", "type": [ "string", "null" ] } }, "type": "object", "required": [ "question" ], "title": "ChatRequest" }, "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" }, "Citation": { "properties": { "source_id": { "type": "string", "minLength": 1, "description": "Owning source identifier" }, "chunk_id": { "type": "string", "minLength": 1, "description": "Resolved chunk identifier" }, "source_type": { "$ref": "#/components/schemas/SourceType" }, "title": { "type": "string", "maxLength": 1024, "minLength": 1, "description": "Source title" }, "uri": { "type": "string", "minLength": 1, "description": "Source URI" }, "locator": { "oneOf": [ { "$ref": "#/components/schemas/PdfLocator" }, { "$ref": "#/components/schemas/WebLocator" }, { "$ref": "#/components/schemas/CodeLocator" }, { "$ref": "#/components/schemas/TicketLocator" } ], "description": "Exact source region" }, "content_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$", "description": "Chunk content hash at index time" } }, "type": "object", "required": [ "chunk_id", "content_hash", "locator", "source_id", "source_type", "title", "uri" ], "title": "Citation", "description": "Resolvable provenance handle" }, "ClarificationGateConfig": { "properties": { "enabled": { "type": "boolean", "description": "Whether the clarification gate is active", "default": true }, "min_criterion_length": { "type": "integer", "minimum": 1.0, "description": "Minimum character length per criterion", "default": 10 }, "generic_patterns": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Patterns for overly generic criteria text", "default": [ "done", "complete", "works", "finished" ] } }, "type": "object", "required": [], "title": "ClarificationGateConfig", "description": "ClarificationGate settings" }, "ClientProfile": { "properties": { "client_id": { "type": "string", "minLength": 1, "description": "Unique client identifier" }, "name": { "type": "string", "minLength": 1, "description": "Human-readable client name" }, "persona": { "type": "string", "minLength": 1, "description": "Description of the client's persona" }, "expertise_domains": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Domains the client is knowledgeable about", "default": [] }, "strictness_level": { "type": "number", "maximum": 1.0, "minimum": 0.0, "description": "Review strictness (0.0=lenient, 1.0=strict)", "default": 0.5 } }, "type": "object", "required": [ "client_id", "name", "persona" ], "title": "ClientProfile" }, "ClientRequest": { "properties": { "request_id": { "type": "string", "minLength": 1, "description": "Unique request identifier" }, "client_id": { "type": "string", "minLength": 1, "description": "ID of the submitting client" }, "requirement": { "$ref": "#/components/schemas/TaskRequirement" }, "status": { "$ref": "#/components/schemas/RequestStatus" }, "created_at": { "type": "string", "format": "date-time", "description": "Timestamp of request creation" }, "metadata": { "additionalProperties": {}, "type": "object", "description": "Additional request metadata" } }, "type": "object", "required": [ "client_id", "requirement" ], "title": "ClientRequest" }, "CloudPreset": { "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" }, "default_base_url": { "minLength": 1, "type": [ "string", "null" ] }, "requires_base_url": { "type": "boolean", "default": false }, "is_featured": { "type": "boolean", "default": true }, "kind": { "type": "string", "const": "cloud", "default": "cloud" }, "supported_auth_types": { "items": { "$ref": "#/components/schemas/AuthType" }, "type": "array", "minItems": 1, "default": [ "api_key" ] }, "default_models": { "items": { "$ref": "#/components/schemas/ProviderModelConfig" }, "type": "array", "default": [] } }, "type": "object", "required": [ "auth_type", "description", "display_name", "driver", "litellm_provider", "name" ], "title": "CloudPreset" }, "CodeBlock": { "properties": { "block_kind": { "type": "string", "const": "code", "description": "Discriminator value for the DocBlock union", "default": "code" }, "block_id": { "type": "string", "minLength": 1 }, "language": { "description": "Renderer language hint", "minLength": 1, "type": [ "string", "null" ] }, "code": { "type": "string", "maxLength": 16384, "description": "Code body" } }, "type": "object", "required": [ "code" ], "title": "CodeBlock" }, "CodeExecutionIsolation": { "type": "string", "enum": [ "containerized", "process" ], "title": "CodeExecutionIsolation", "description": "Code execution isolation level", "default": "containerized" }, "CodeLocator": { "properties": { "locator_kind": { "type": "string", "const": "code", "default": "code" }, "path": { "type": "string", "minLength": 1, "description": "Repo-relative file path" }, "line_start": { "type": "integer", "minimum": 1.0, "description": "1-indexed first line" }, "line_end": { "type": "integer", "minimum": 1.0, "description": "1-indexed last line (inclusive)" }, "symbol": { "description": "Enclosing symbol name (function / class / method)", "minLength": 1, "type": [ "string", "null" ] }, "ast_path": { "description": "Dotted AST node path, e.g. module.ClassName.method", "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [ "line_end", "line_start", "path" ], "title": "CodeLocator" }, "CollaborationPreference": { "type": "string", "enum": [ "independent", "pair", "team" ], "title": "CollaborationPreference", "description": "Preferred collaboration mode", "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", "default": "balanced" }, "Company": { "properties": { "id": { "type": "string", "format": "uuid", "description": "Company identifier" }, "name": { "type": "string", "minLength": 1, "description": "Company name" }, "type": { "$ref": "#/components/schemas/CompanyType" }, "departments": { "items": { "$ref": "#/components/schemas/Department" }, "type": "array", "description": "Company departments", "default": [] }, "config": { "$ref": "#/components/schemas/CompanyConfig" }, "hr_registry": { "$ref": "#/components/schemas/HRRegistry" }, "workflow_handoffs": { "items": { "$ref": "#/components/schemas/WorkflowHandoff" }, "type": "array", "description": "Cross-department workflow handoffs", "default": [] }, "escalation_paths": { "items": { "$ref": "#/components/schemas/EscalationPath" }, "type": "array", "description": "Cross-department escalation paths", "default": [] } }, "type": "object", "required": [ "name" ], "title": "Company", "description": "Full frozen entity model at this version" }, "CompanyConfig": { "properties": { "autonomy": { "$ref": "#/components/schemas/AutonomyConfig" }, "approval_timeout": { "oneOf": [ { "$ref": "#/components/schemas/WaitForeverConfig" }, { "$ref": "#/components/schemas/DenyOnTimeoutConfig" }, { "$ref": "#/components/schemas/TieredTimeoutConfig" }, { "$ref": "#/components/schemas/EscalationChainConfig" } ], "description": "Timeout policy for pending approval items" }, "budget_monthly": { "type": "number", "minimum": 0.0, "description": "Monthly budget in the configured currency", "default": 100.0 }, "communication_pattern": { "type": "string", "minLength": 1, "description": "Default communication pattern", "default": "hybrid" }, "tool_access_default": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Default tool access for all agents", "default": [] }, "middleware": { "$ref": "#/components/schemas/MiddlewareConfig" }, "session_replay_on_start": { "type": "boolean", "description": "Replay session from event log on agent start", "default": false } }, "type": "object", "required": [], "title": "CompanyConfig", "description": "Company-wide configuration" }, "CompanyType": { "type": "string", "enum": [ "solo_founder", "startup", "dev_shop", "product_team", "agency", "full_company", "research_lab", "consultancy", "data_team", "custom" ], "title": "CompanyType", "description": "Company template type", "default": "custom" }, "Comparator": { "type": "string", "enum": [ "lt", "le", "gt", "ge", "eq", "ne" ], "title": "Comparator", "description": "Comparison operator (gt, gte, lt, lte, eq, ne)." }, "Complexity": { "type": "string", "enum": [ "simple", "medium", "complex", "epic" ], "title": "Complexity", "description": "Task complexity estimate", "default": "medium" }, "Conflict": { "properties": { "id": { "type": "string", "minLength": 1, "description": "Unique conflict identifier" }, "type": { "$ref": "#/components/schemas/ConflictType" }, "task_id": { "description": "Related task ID", "minLength": 1, "type": [ "string", "null" ] }, "subject": { "type": "string", "minLength": 1, "description": "Brief dispute description" }, "positions": { "items": { "$ref": "#/components/schemas/ConflictPosition" }, "type": "array", "description": "Agent positions (min 2)" }, "detected_at": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" }, "is_cross_department": { "type": "boolean", "description": "Whether the conflict spans multiple departments.", "readOnly": true } }, "type": "object", "required": [ "detected_at", "id", "is_cross_department", "positions", "subject", "type" ], "title": "Conflict" }, "ConflictApproach": { "type": "string", "enum": [ "avoid", "accommodate", "compete", "compromise", "collaborate" ], "title": "ConflictApproach", "description": "Conflict resolution approach", "default": "collaborate" }, "ConflictPosition": { "properties": { "agent_id": { "type": "string", "minLength": 1, "description": "Agent taking the position" }, "agent_department": { "type": "string", "minLength": 1, "description": "Agent's department" }, "agent_level": { "$ref": "#/components/schemas/SeniorityLevel" }, "position": { "type": "string", "minLength": 1, "description": "Summary of the stance" }, "reasoning": { "type": "string", "minLength": 1, "description": "Justification for the position" }, "timestamp": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" } }, "type": "object", "required": [ "agent_department", "agent_id", "agent_level", "position", "reasoning", "timestamp" ], "title": "ConflictPosition" }, "ConflictType": { "type": "string", "enum": [ "architecture", "implementation", "priority", "resource", "process", "other" ], "title": "ConflictType", "description": "Conflict category" }, "Connection": { "properties": { "id": { "type": "string", "minLength": 1 }, "name": { "type": "string", "minLength": 1 }, "connection_type": { "$ref": "#/components/schemas/ConnectionType" }, "auth_method": { "$ref": "#/components/schemas/AuthMethod" }, "base_url": { "minLength": 1, "type": [ "string", "null" ] }, "secret_refs": { "items": { "$ref": "#/components/schemas/SecretRef" }, "type": "array", "default": [] }, "rate_limiter": { "anyOf": [ { "$ref": "#/components/schemas/RateLimiterConfig" }, { "type": "null" } ] }, "health_check_enabled": { "type": "boolean", "default": true }, "health_status": { "$ref": "#/components/schemas/ConnectionStatus" }, "last_health_check_at": { "format": "date-time", "description": "datetime with the constraint that the value must have timezone info", "type": [ "string", "null" ] }, "sensitive": { "type": "boolean", "default": false }, "metadata": { "additionalProperties": { "type": "string" }, "type": "object" }, "webhook_receipt_retention_days": { "description": "Per-connection override for webhook-receipt retention (days). None = use the global default; 0 = never sweep this connection's receipts.", "type": [ "integer", "null" ] }, "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": [ "auth_method", "connection_type", "name" ], "title": "Connection" }, "ConnectionStatus": { "type": "string", "enum": [ "healthy", "degraded", "unhealthy", "unknown" ], "title": "ConnectionStatus", "description": "Last-known health status of a connection.", "default": "unknown" }, "ConnectionType": { "type": "string", "enum": [ "github", "gitlab", "gitea", "forgejo", "slack", "smtp", "database", "generic_http", "oauth_app", "a2a_peer" ], "title": "ConnectionType", "description": "Supported external service connection types." }, "ContentType": { "type": "string", "enum": [ "procedural", "semantic", "tool_patterns" ], "title": "ContentType", "description": "Content types available for training extraction." }, "ConversationalProposeRequest": { "properties": { "message": { "type": "string", "maxLength": 2000, "minLength": 1 }, "conversation_id": { "minLength": 1, "type": [ "string", "null" ] }, "project": { "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [ "message" ], "title": "ConversationalProposeRequest" }, "CookieSessionResponse": { "properties": { "expires_in": { "type": "integer", "exclusiveMinimum": 0.0 }, "must_change_password": { "type": "boolean" } }, "type": "object", "required": [ "expires_in", "must_change_password" ], "title": "CookieSessionResponse" }, "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" }, "CoordinationEfficiency": { "properties": { "success_rate": { "type": "number", "maximum": 1.0, "minimum": 0.0, "description": "Multi-agent success rate" }, "turns_mas": { "type": "number", "exclusiveMinimum": 0.0, "description": "Avg turns (multi-agent)" }, "turns_sas": { "type": "number", "exclusiveMinimum": 0.0, "description": "Avg turns (single-agent)" }, "value": { "type": "number", "description": "Coordination efficiency", "readOnly": true } }, "type": "object", "required": [ "success_rate", "turns_mas", "turns_sas", "value" ], "title": "CoordinationEfficiency" }, "CoordinationMetrics": { "properties": { "efficiency": { "description": "Coordination efficiency", "anyOf": [ { "$ref": "#/components/schemas/CoordinationEfficiency" }, { "type": "null" } ] }, "overhead": { "description": "Coordination overhead", "anyOf": [ { "$ref": "#/components/schemas/CoordinationOverhead" }, { "type": "null" } ] }, "error_amplification": { "description": "Error amplification", "anyOf": [ { "$ref": "#/components/schemas/ErrorAmplification" }, { "type": "null" } ] }, "message_density": { "description": "Message density", "anyOf": [ { "$ref": "#/components/schemas/MessageDensity" }, { "type": "null" } ] }, "redundancy_rate": { "description": "Redundancy rate", "anyOf": [ { "$ref": "#/components/schemas/RedundancyRate" }, { "type": "null" } ] }, "amdahl_ceiling": { "description": "Amdahl's Law speedup ceiling", "anyOf": [ { "$ref": "#/components/schemas/AmdahlCeiling" }, { "type": "null" } ] }, "straggler_gap": { "description": "Slowest-agent gap metric", "anyOf": [ { "$ref": "#/components/schemas/StragglerGap" }, { "type": "null" } ] }, "token_speedup_ratio": { "description": "Token cost vs speedup ratio", "anyOf": [ { "$ref": "#/components/schemas/TokenSpeedupRatio" }, { "type": "null" } ] }, "message_overhead": { "description": "O(n^2) message overhead detection", "anyOf": [ { "$ref": "#/components/schemas/MessageOverhead" }, { "type": "null" } ] } }, "type": "object", "required": [], "title": "CoordinationMetrics", "description": "All nine Kim et al. coordination metrics" }, "CoordinationMetricsRecord": { "properties": { "task_id": { "type": "string", "minLength": 1, "description": "Associated task" }, "agent_id": { "description": "Lead agent (None for system-level runs)", "minLength": 1, "type": [ "string", "null" ] }, "computed_at": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" }, "team_size": { "type": "integer", "exclusiveMinimum": 0.0, "description": "Coordinating agents" }, "metrics": { "$ref": "#/components/schemas/CoordinationMetrics" } }, "type": "object", "required": [ "computed_at", "metrics", "task_id", "team_size" ], "title": "CoordinationMetricsRecord" }, "CoordinationMiddlewareConfig": { "properties": { "chain": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Coordination middleware names in execution order", "default": [ "clarification_gate", "task_ledger", "plan_review_gate", "progress_ledger", "coordination_replan", "authority_deference_coordination" ] }, "clarification_gate": { "$ref": "#/components/schemas/ClarificationGateConfig" } }, "type": "object", "required": [], "title": "CoordinationMiddlewareConfig", "description": "Coordination-level middleware configuration" }, "CoordinationOverhead": { "properties": { "turns_mas": { "type": "number", "exclusiveMinimum": 0.0, "description": "Avg turns (multi-agent)" }, "turns_sas": { "type": "number", "exclusiveMinimum": 0.0, "description": "Avg turns (single-agent)" }, "value_percent": { "type": "number", "description": "Overhead percentage", "readOnly": true } }, "type": "object", "required": [ "turns_mas", "turns_sas", "value_percent" ], "title": "CoordinationOverhead" }, "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": { "type": "number", "minimum": 0.0 }, "currency": { "type": "string", "maxLength": 3, "minLength": 3, "description": "ISO 4217 currency code", "default": "USD" }, "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", "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" }, "project_id": { "description": "Project this cost belongs to", "minLength": 1, "type": [ "string", "null" ] }, "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": { "type": "number", "minimum": 0.0, "description": "Numeric cost of the call, denominated in ``currency``" }, "currency": { "type": "string", "maxLength": 3, "minLength": 3, "pattern": "^[A-Z]{3}$", "description": "ISO 4217 currency code for ``cost``" }, "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, embedding)", "type": [ "string", "null" ], "enum": [ "productive", "coordination", "system", "embedding", null ] }, "accuracy_effort_ratio": { "description": "Accuracy-effort ratio for the task this call belongs to (populated at task completion when quality signals are available)", "type": [ "number", "null" ] }, "latency_ms": { "description": "Round-trip latency in milliseconds", "type": [ "number", "null" ] }, "cache_hit": { "description": "Whether the provider served this call from cache", "type": [ "boolean", "null" ] }, "retry_count": { "description": "Number of retry attempts before success", "type": [ "integer", "null" ] }, "retry_reason": { "description": "Exception type name of the last retried error", "type": [ "string", "null" ] }, "finish_reason": { "description": "LLM finish reason for this call", "type": [ "string", "null" ], "enum": [ "stop", "max_tokens", "tool_use", "content_filter", "error", null ] }, "success": { "description": "Whether the call completed without error or content filter", "type": [ "boolean", "null" ] }, "claim_id": { "type": "string", "minLength": 1, "description": "Idempotency key for this billing event. Generated once at construction (UUID4 by default) so retries / JetStream redelivery / in-process tracker double-submission cannot double-bill: ``CostTracker.record`` keeps a bounded LRU of seen ``claim_id`` values and treats repeats as no-ops." } }, "type": "object", "required": [ "agent_id", "cost", "currency", "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": "USD" }, "success": { "type": "boolean", "description": "Whether the request succeeded (derived from ``error``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "period_summary", "success" ], "title": "CostRecordListResponse" }, "CreateAgentOrgRequest": { "properties": { "name": { "type": "string", "maxLength": 128, "minLength": 1 }, "role": { "type": "string", "maxLength": 128, "minLength": 1 }, "department": { "type": "string", "maxLength": 128, "minLength": 1 }, "level": { "$ref": "#/components/schemas/SeniorityLevel" }, "model_provider": { "minLength": 1, "type": [ "string", "null" ] }, "model_id": { "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [ "department", "name", "role" ], "title": "CreateAgentOrgRequest" }, "CreateApprovalRequest": { "properties": { "action_type": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Kind of action requiring approval in `category:action` format." }, "title": { "type": "string", "maxLength": 256, "minLength": 1, "description": "Short human-readable summary of the approval." }, "description": { "type": "string", "maxLength": 4096, "minLength": 1, "description": "Detailed explanation of the action and why it requires approval." }, "risk_level": { "$ref": "#/components/schemas/ApprovalRiskLevel" }, "ttl_seconds": { "maximum": 604800, "minimum": 60, "description": "Optional time-to-live in seconds before the approval auto-expires (minimum 60, maximum 604800 = 7 days).", "type": [ "integer", "null" ] }, "task_id": { "maxLength": 128, "description": "Optional associated task identifier.", "minLength": 1, "type": [ "string", "null" ] }, "metadata": { "items": { "oneOf": [ { "type": "string" }, { "type": "string" } ] }, "type": "array", "maxLength": 20, "description": "Optional key-value metadata for the approval (max 20 keys, 256-char keys and values)." } }, "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, "description": "File path or artifact identifier within the workspace." }, "task_id": { "type": "string", "minLength": 1, "description": "Originating task identifier." }, "created_by": { "type": "string", "minLength": 1, "description": "Agent identifier of the artifact creator." }, "description": { "type": "string", "maxLength": 4096, "description": "Human-readable artifact description.", "default": "" }, "content_type": { "type": "string", "maxLength": 256, "description": "MIME type of the artifact content (empty when no content is stored).", "default": "" }, "project_id": { "description": "Optional project identifier to link the artifact to.", "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [ "created_by", "path", "task_id", "type" ], "title": "CreateArtifactRequest" }, "CreateClientRequest": { "properties": { "client_id": { "type": "string", "minLength": 1, "description": "Unique client identifier" }, "name": { "type": "string", "minLength": 1, "description": "Human-readable name" }, "persona": { "type": "string", "minLength": 1, "description": "Persona description" }, "expertise_domains": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Domains of expertise for the simulated client.", "default": [] }, "strictness_level": { "type": "number", "maximum": 1.0, "minimum": 0.0, "description": "Scoring strictness multiplier (0.0-1.0).", "default": 0.5 } }, "type": "object", "required": [ "client_id", "name", "persona" ], "title": "CreateClientRequest" }, "CreateConnectionRequest": { "properties": { "name": { "type": "string", "maxLength": 128, "minLength": 1 }, "connection_type": { "$ref": "#/components/schemas/ConnectionType" }, "auth_method": { "$ref": "#/components/schemas/AuthMethod" }, "credentials": { "additionalProperties": { "type": "string" }, "type": "object" }, "base_url": { "minLength": 1, "type": [ "string", "null" ] }, "metadata": { "additionalProperties": { "type": "string" }, "type": [ "object", "null" ] }, "health_check_enabled": { "type": "boolean", "default": true }, "webhook_receipt_retention_days": { "type": [ "integer", "null" ] }, "sensitive": { "type": "boolean", "default": false } }, "type": "object", "required": [ "connection_type", "name" ], "title": "CreateConnectionRequest" }, "CreateCustomRuleRequest": { "properties": { "name": { "type": "string", "minLength": 1, "description": "Human-readable rule name (unique per organization)." }, "description": { "type": "string", "minLength": 1, "description": "What pattern this rule detects and why it matters." }, "metric_path": { "type": "string", "minLength": 1, "description": "Dot-notation path into `OrgSignalSnapshot` identifying the metric to evaluate (e.g. `budget.used_percent`)." }, "comparator": { "$ref": "#/components/schemas/Comparator" }, "threshold": { "type": "number", "description": "Threshold value compared against the resolved metric." }, "severity": { "$ref": "#/components/schemas/RuleSeverity" }, "target_altitudes": { "items": { "$ref": "#/components/schemas/ProposalAltitude" }, "type": "array", "minItems": 1, "description": "Strategies to trigger when the rule matches." } }, "type": "object", "required": [ "comparator", "description", "metric_path", "name", "severity", "target_altitudes", "threshold" ], "title": "CreateCustomRuleRequest" }, "CreateDepartmentRequest": { "properties": { "name": { "type": "string", "maxLength": 128, "minLength": 1 }, "head": { "minLength": 1, "type": [ "string", "null" ] }, "budget_percent": { "type": "number", "maximum": 100.0, "minimum": 0.0, "default": 0.0 }, "autonomy_level": { "type": [ "string", "null" ], "enum": [ "full", "semi", "supervised", "locked", null ] } }, "type": "object", "required": [ "name" ], "title": "CreateDepartmentRequest" }, "CreateEntityRequest": { "properties": { "name": { "type": "string", "maxLength": 256, "minLength": 1, "description": "Entity name" }, "definition": { "type": "string", "maxLength": 4096, "description": "Free-text entity description", "default": "" }, "fields": { "items": { "$ref": "#/components/schemas/EntityFieldInput" }, "type": "array", "description": "Field definitions", "default": [] }, "constraints": { "items": { "type": "string" }, "type": "array", "description": "Business rule descriptions", "default": [] }, "disambiguation": { "type": "string", "maxLength": 2048, "description": "What this entity is NOT", "default": "" }, "relationships": { "items": { "$ref": "#/components/schemas/EntityRelationInput" }, "type": "array", "description": "Entity relationships", "default": [] } }, "type": "object", "required": [ "name" ], "title": "CreateEntityRequest" }, "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 ] }, "api_key": { "minLength": 8, "type": [ "string", "null" ] }, "subscription_token": { "minLength": 8, "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": 8, "type": [ "string", "null" ] }, "subscription_token": { "minLength": 8, "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": 8, "type": [ "string", "null" ] }, "oauth_scope": { "minLength": 1, "type": [ "string", "null" ] }, "custom_header_name": { "minLength": 1, "type": [ "string", "null" ] }, "custom_header_value": { "minLength": 8, "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" }, "CreateRequestPayload": { "properties": { "client_id": { "type": "string", "minLength": 1, "description": "Requesting client id" }, "requirement": { "$ref": "#/components/schemas/TaskRequirement" } }, "type": "object", "required": [ "client_id", "requirement" ], "title": "CreateRequestPayload" }, "CreateSubworkflowRequest": { "properties": { "subworkflow_id": { "maxLength": 128, "description": "Stable identifier (generated when omitted)", "minLength": 1, "type": [ "string", "null" ] }, "version": { "type": "string", "maxLength": 64, "minLength": 1, "description": "Semver version", "default": "1.0.0" }, "name": { "type": "string", "maxLength": 256, "minLength": 1, "description": "Display name" }, "description": { "type": "string", "maxLength": 4096, "default": "" }, "workflow_type": { "$ref": "#/components/schemas/WorkflowType" }, "inputs": { "items": { "additionalProperties": {}, "type": "object" }, "type": "array", "maxItems": 64, "default": [] }, "outputs": { "items": { "additionalProperties": {}, "type": "object" }, "type": "array", "maxItems": 64, "default": [] }, "nodes": { "items": { "additionalProperties": {}, "type": "object" }, "type": "array", "maxItems": 500 }, "edges": { "items": { "additionalProperties": {}, "type": "object" }, "type": "array", "maxItems": 1000 } }, "type": "object", "required": [ "edges", "name", "nodes" ], "title": "CreateSubworkflowRequest" }, "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" }, "CreateTeamRequest": { "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": "CreateTeamRequest" }, "CreateTrainingPlanRequest": { "properties": { "override_sources": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Explicit source agent IDs", "default": [] }, "content_types": { "description": "Enable specific content types", "items": { "$ref": "#/components/schemas/ContentType" }, "type": [ "array", "null" ] }, "custom_caps": { "description": "Per-content-type cap overrides (positive integers)", "additionalProperties": { "type": "integer", "exclusiveMinimum": 0.0 }, "type": [ "object", "null" ] }, "skip_training": { "type": "boolean", "description": "Skip training entirely", "default": false }, "require_review": { "type": "boolean", "description": "Require human review", "default": true } }, "type": "object", "required": [], "title": "CreateTrainingPlanRequest" }, "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" }, "version": { "type": "string", "maxLength": 64, "description": "Semver version string", "default": "1.0.0" }, "inputs": { "items": { "$ref": "#/components/schemas/WorkflowIODeclarationRequest" }, "type": "array", "maxItems": 100, "description": "Typed input declarations", "default": [] }, "outputs": { "items": { "$ref": "#/components/schemas/WorkflowIODeclarationRequest" }, "type": "array", "maxItems": 100, "description": "Typed output declarations", "default": [] }, "is_subworkflow": { "type": "boolean", "description": "Whether this definition is a reusable subworkflow", "default": false }, "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", "default": "medium" }, "DailySummary": { "properties": { "date": { "type": "string", "minLength": 1, "description": "ISO date (YYYY-MM-DD)" }, "total_cost": { "type": "number", "minimum": 0.0, "description": "Total cost in the configured currency" }, "currency": { "type": "string", "maxLength": 3, "minLength": 3, "description": "ISO 4217 currency code", "default": "USD" }, "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", "total_input_tokens", "total_output_tokens" ], "title": "DailySummary" }, "DataPart": { "properties": { "type": { "type": "string", "const": "data", "description": "Part type discriminator", "default": "data" }, "data": { "additionalProperties": {}, "type": "object", "description": "Structured JSON content (read-only)" } }, "type": "object", "required": [ "data" ], "title": "DataPart" }, "DecisionBlock": { "properties": { "block_kind": { "type": "string", "const": "decision", "description": "Discriminator value for the DocBlock union", "default": "decision" }, "block_id": { "type": "string", "minLength": 1 }, "decision": { "type": "string", "maxLength": 4096, "minLength": 1, "description": "What was decided" }, "rationale": { "type": "string", "maxLength": 4096, "minLength": 1, "description": "Why this decision" } }, "type": "object", "required": [ "decision", "rationale" ], "title": "DecisionBlock" }, "DecisionMakingStyle": { "type": "string", "enum": [ "analytical", "intuitive", "consultative", "directive" ], "title": "DecisionMakingStyle", "description": "Decision-making approach", "default": "consultative" }, "DenyOnTimeoutConfig": { "properties": { "policy": { "type": "string", "const": "deny", "default": "deny" }, "timeout_minutes": { "type": "number", "exclusiveMinimum": 0.0, "description": "Minutes before auto-deny", "default": 240.0 } }, "type": "object", "required": [], "title": "DenyOnTimeoutConfig" }, "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 ] }, "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, "pattern": "^[A-Z]{3}$", "description": "ISO 4217 currency code", "default": "USD" }, "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.\n\nReturns:\n Resulting numeric value.", "readOnly": true } }, "type": "object", "required": [ "active_agent_count", "agent_count", "cost_trend", "department_cost_7d", "department_name", "utilization_percent" ], "title": "DepartmentHealth" }, "DepartmentName": { "type": "string", "enum": [ "executive", "product", "design", "engineering", "quality_assurance", "data_analytics", "operations", "creative_marketing", "security" ], "title": "DepartmentName", "description": "Department this role belongs to" }, "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.\n\nReturns:\n Resulting integer.", "readOnly": true } }, "type": "object", "required": [ "entry_count" ], "title": "DiscoveryPolicyResponse" }, "DocSearchHit": { "properties": { "project_id": { "type": "string", "minLength": 1, "description": "Owning project" }, "doc_slug": { "type": "string", "minLength": 1, "description": "Matched doc slug" }, "doc_type": { "$ref": "#/components/schemas/DocType" }, "chunk_text": { "type": "string", "minLength": 1, "description": "Matching chunk content" }, "relevance_score": { "type": "number", "maximum": 1.0, "minimum": 0.0, "description": "Backend-assigned relevance" } }, "type": "object", "required": [ "chunk_text", "doc_slug", "doc_type", "project_id", "relevance_score" ], "title": "DocSearchHit" }, "DocSummary": { "properties": { "project_id": { "type": "string", "minLength": 1, "description": "Owning project" }, "slug": { "type": "string", "minLength": 1, "description": "Doc slug" }, "title": { "type": "string", "minLength": 1, "description": "Display title" }, "doc_type": { "$ref": "#/components/schemas/DocType" }, "tags": { "items": { "type": "string", "minLength": 1 }, "type": "array", "default": [] }, "updated_at": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" } }, "type": "object", "required": [ "doc_type", "project_id", "slug", "title", "updated_at" ], "title": "DocSummary" }, "DocType": { "type": "string", "enum": [ "status_report", "deliverable", "knowledge_note", "codebase_analysis" ], "title": "DocType", "description": "Doc taxonomy bucket" }, "DocVersion": { "properties": { "commit_sha": { "type": "string", "minLength": 1, "description": "Commit identifier" }, "author_agent_id": { "type": "string", "minLength": 1, "description": "Agent that authored the write" }, "committed_at": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" }, "summary": { "type": "string", "minLength": 1, "description": "Commit subject line" } }, "type": "object", "required": [ "author_agent_id", "commit_sha", "committed_at", "summary" ], "title": "DocVersion" }, "DriftAction": { "type": "string", "enum": [ "no_action", "notify", "retrain", "escalate" ], "title": "DriftAction", "description": "Recommended action for addressing entity drift.\n\nAttributes:\n NO_ACTION: Drift is within acceptable bounds.\n NOTIFY: Alert operators about emerging drift.\n RETRAIN: Retrain divergent agents on canonical definitions.\n ESCALATE: Escalate to human review.\n" }, "DriftAgentResponse": { "properties": { "agent_id": { "type": "string", "minLength": 1 }, "divergence_score": { "type": "number", "maximum": 1.0, "minimum": 0.0 }, "details": { "type": "string", "default": "" } }, "type": "object", "required": [ "agent_id", "divergence_score" ], "title": "DriftAgentResponse" }, "DriftReportResponse": { "properties": { "entity_name": { "type": "string", "minLength": 1 }, "divergence_score": { "type": "number", "maximum": 1.0, "minimum": 0.0 }, "divergent_agents": { "items": { "$ref": "#/components/schemas/DriftAgentResponse" }, "type": "array", "default": [] }, "canonical_version": { "type": "integer", "minimum": 1.0 }, "recommendation": { "$ref": "#/components/schemas/DriftAction" } }, "type": "object", "required": [ "canonical_version", "divergence_score", "entity_name", "recommendation" ], "title": "DriftReportResponse" }, "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" }, "EfficiencyConfig": { "properties": { "enabled": { "type": "boolean", "default": true }, "weight": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.2 }, "cost_enabled": { "type": "boolean", "default": true }, "time_enabled": { "type": "boolean", "default": true }, "tokens_enabled": { "type": "boolean", "default": true }, "cost_weight": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.4 }, "time_weight": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.3 }, "tokens_weight": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.3 }, "reference_cost": { "type": "number", "exclusiveMinimum": 0.0, "default": 10.0 }, "reference_time_seconds": { "type": "number", "exclusiveMinimum": 0.0, "default": 300.0 }, "reference_tokens": { "type": "integer", "exclusiveMinimum": 0.0, "default": 5000 } }, "type": "object", "required": [], "title": "EfficiencyConfig" }, "EntityFieldInput": { "properties": { "name": { "type": "string", "minLength": 1, "description": "Field name" }, "type_hint": { "type": "string", "minLength": 1, "description": "Type annotation" }, "description": { "type": "string", "description": "Field description", "default": "" } }, "type": "object", "required": [ "name", "type_hint" ], "title": "EntityFieldInput" }, "EntityFieldResponse": { "properties": { "name": { "type": "string", "minLength": 1 }, "type_hint": { "type": "string", "minLength": 1 }, "description": { "type": "string", "default": "" } }, "type": "object", "required": [ "name", "type_hint" ], "title": "EntityFieldResponse" }, "EntityRelationInput": { "properties": { "target": { "type": "string", "minLength": 1, "description": "Related entity name" }, "relation": { "type": "string", "minLength": 1, "description": "Relationship type" }, "description": { "type": "string", "description": "Relationship description", "default": "" } }, "type": "object", "required": [ "relation", "target" ], "title": "EntityRelationInput" }, "EntityRelationResponse": { "properties": { "target": { "type": "string", "minLength": 1 }, "relation": { "type": "string", "minLength": 1 }, "description": { "type": "string", "default": "" } }, "type": "object", "required": [ "relation", "target" ], "title": "EntityRelationResponse" }, "EntityResponse": { "properties": { "name": { "type": "string", "minLength": 1 }, "tier": { "$ref": "#/components/schemas/EntityTier" }, "source": { "$ref": "#/components/schemas/EntitySource" }, "definition": { "type": "string", "default": "" }, "fields": { "items": { "$ref": "#/components/schemas/EntityFieldResponse" }, "type": "array", "default": [] }, "constraints": { "items": { "type": "string" }, "type": "array", "default": [] }, "disambiguation": { "type": "string", "default": "" }, "relationships": { "items": { "$ref": "#/components/schemas/EntityRelationResponse" }, "type": "array", "default": [] }, "created_by": { "type": "string", "minLength": 1 }, "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", "created_by", "name", "source", "tier", "updated_at" ], "title": "EntityResponse" }, "EntitySource": { "type": "string", "enum": [ "auto", "config", "api" ], "title": "EntitySource", "description": "Origin of an entity definition.\n\nAttributes:\n AUTO: Derived from ``@ontology_entity`` decorator.\n CONFIG: Loaded from YAML configuration.\n API: Created via REST API.\n" }, "EntityTier": { "type": "string", "enum": [ "core", "user" ], "title": "EntityTier", "description": "Protection tier for entity definitions.\n\nAttributes:\n CORE: Framework-provided, protected from user modification.\n USER: Domain-specific, editable by users.\n" }, "EntityVersionResponse": { "properties": { "entity_id": { "type": "string", "minLength": 1 }, "version": { "type": "integer", "minimum": 1.0 }, "content_hash": { "type": "string", "minLength": 1 }, "snapshot": { "$ref": "#/components/schemas/EntityResponse" }, "saved_by": { "type": "string", "minLength": 1 }, "saved_at": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" } }, "type": "object", "required": [ "content_hash", "entity_id", "saved_at", "saved_by", "snapshot", "version" ], "title": "EntityVersionResponse" }, "ErrorAmplification": { "properties": { "error_rate_mas": { "type": "number", "minimum": 0.0, "description": "Multi-agent error rate" }, "error_rate_sas": { "type": "number", "exclusiveMinimum": 0.0, "description": "Single-agent error rate" }, "value": { "type": "number", "description": "Error amplification factor", "readOnly": true } }, "type": "object", "required": [ "error_rate_mas", "error_rate_sas", "value" ], "title": "ErrorAmplification" }, "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, 1003, 1004, 1005, 1006, 1007, 1008, 1009, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 3000, 3001, 3002, 3003, 3004, 3005, 3006, 3007, 3008, 3009, 3010, 3011, 3012, 3013, 3014, 3015, 3016, 3017, 3018, 3019, 3020, 3021, 4000, 4001, 4002, 4003, 4004, 4005, 4006, 4007, 4008, 4009, 4010, 4011, 4012, 4013, 4014, 4015, 4016, 4017, 4018, 4019, 4020, 5000, 5001, 5002, 6000, 6001, 6002, 6003, 6004, 6005, 6006, 6007, 6008, 7000, 7001, 7002, 7003, 7004, 7005, 7006, 7007, 7008, 7009, 7010, 7011, 8000, 8001, 8002, 8003, 8004, 8005, 8006, 8007, 8008, 8009, 8010, 8011, 8012, 8013, 8014, 8015, 8016, 8017, 8018, 8019, 8020, 8021, 8022, 8023, 8024, 8025, 8026, 8027, 8028, 8029 ], "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": { "description": "Seconds to wait before retrying (null when not applicable).", "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" }, "Escalation": { "properties": { "id": { "type": "string", "minLength": 1 }, "conflict": { "$ref": "#/components/schemas/Conflict" }, "status": { "$ref": "#/components/schemas/EscalationStatus" }, "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": { "anyOf": [ { "$ref": "#/components/schemas/WinnerDecision" }, { "$ref": "#/components/schemas/RejectDecision" }, { "type": "null" } ] } }, "type": "object", "required": [ "conflict", "created_at", "id" ], "title": "Escalation" }, "EscalationChainConfig": { "properties": { "policy": { "type": "string", "const": "escalation", "default": "escalation" }, "chain": { "items": { "$ref": "#/components/schemas/EscalationStep" }, "type": "array", "description": "Ordered escalation steps", "default": [] }, "on_chain_exhausted": { "$ref": "#/components/schemas/TimeoutActionType" } }, "type": "object", "required": [], "title": "EscalationChainConfig" }, "EscalationPath": { "properties": { "from_department": { "type": "string", "minLength": 1, "description": "Source department" }, "to_department": { "type": "string", "minLength": 1, "description": "Target department" }, "condition": { "type": "string", "minLength": 1, "description": "Escalation condition" }, "priority_boost": { "type": "integer", "maximum": 3.0, "minimum": 0.0, "description": "Priority boost on escalation (0-3)", "default": 1 } }, "type": "object", "required": [ "condition", "from_department", "to_department" ], "title": "EscalationPath" }, "EscalationResponse": { "properties": { "escalation": { "$ref": "#/components/schemas/Escalation" }, "conflict_id": { "type": "string", "minLength": 1 }, "status": { "$ref": "#/components/schemas/EscalationStatus" } }, "type": "object", "required": [ "conflict_id", "escalation", "status" ], "title": "EscalationResponse" }, "EscalationStatus": { "type": "string", "enum": [ "pending", "decided", "expired", "cancelled" ], "title": "EscalationStatus", "description": "Lifecycle state of an escalation row.\n\nMembers:\n PENDING: Awaiting a human decision.\n DECIDED: A decision has been applied.\n EXPIRED: Timed out without a decision.\n CANCELLED: Operator explicitly abandoned the escalation.\n", "default": "pending" }, "EscalationStep": { "properties": { "role": { "type": "string", "minLength": 1, "description": "Escalation target role" }, "timeout_minutes": { "type": "number", "exclusiveMinimum": 0.0, "description": "Minutes to wait at this escalation step" } }, "type": "object", "required": [ "role", "timeout_minutes" ], "title": "EscalationStep" }, "EvalLoopConfig": { "properties": { "enabled": { "type": "boolean", "description": "Whether evaluation cycles are active", "default": true }, "pattern_identifier_enabled": { "type": "boolean", "description": "Enable pillar-weakness pattern identification", "default": true }, "benchmark_on_cycle": { "type": "boolean", "description": "Run external benchmarks each cycle", "default": false }, "max_concurrent_benchmarks": { "type": "integer", "maximum": 10.0, "minimum": 1.0, "description": "Limit parallel benchmark execution", "default": 2 }, "pattern_weakness_threshold": { "type": "number", "maximum": 10.0, "minimum": 0.0, "description": "Pillar score below which the pillar is weak for an agent", "default": 5.0 }, "pattern_min_agents": { "type": "integer", "minimum": 1.0, "description": "Minimum weak-agent count before a pillar becomes a pattern", "default": 3 }, "pattern_action_map": { "description": "Operator override for pillar-to-action mapping. Values are validated as ``NotBlankStr`` so blank or whitespace-only action identifiers are rejected at config load.", "additionalProperties": { "type": "string", "minLength": 1 }, "type": [ "object", "null" ] } }, "type": "object", "required": [], "title": "EvalLoopConfig", "description": "Closed-loop evaluation coordinator configuration" }, "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" }, "EvaluationConfidence": { "type": "string", "enum": [ "high", "low" ], "title": "EvaluationConfidence", "description": "Confidence level of a security evaluation.\n\nIndicates whether the verdict came from a matched rule (high\nconfidence) or the fallback risk classifier (low confidence).\nLow-confidence verdicts may trigger LLM-based re-evaluation.\n\nAttributes:\n HIGH: A specific security rule matched and produced the verdict.\n LOW: No rule matched; verdict came from fallback risk\n classification.\n", "default": "high" }, "EvaluationConfig": { "properties": { "intelligence": { "$ref": "#/components/schemas/IntelligenceConfig" }, "efficiency": { "$ref": "#/components/schemas/EfficiencyConfig" }, "resilience": { "$ref": "#/components/schemas/ResilienceConfig" }, "governance": { "$ref": "#/components/schemas/GovernanceConfig" }, "experience": { "$ref": "#/components/schemas/ExperienceConfig" }, "calibration_drift_threshold": { "type": "number", "maximum": 10.0, "minimum": 0.0, "description": "LLM calibration drift threshold for confidence reduction", "default": 2.0 }, "eval_loop": { "$ref": "#/components/schemas/EvalLoopConfig" } }, "type": "object", "required": [], "title": "EvaluationConfig", "description": "Full frozen entity model at this version" }, "EventBatch": { "properties": { "events": { "items": { "$ref": "#/components/schemas/AnonymizedOutcomeEvent" }, "type": "array", "maxItems": 1000 } }, "type": "object", "required": [ "events" ], "title": "EventBatch" }, "EvidencePackage": { "properties": { "created_at": { "type": "string", "format": "date-time", "description": "Artifact creation timestamp" }, "id": { "type": "string", "minLength": 1, "description": "Stable evidence package UUID" }, "title": { "type": "string", "minLength": 1, "description": "Short human-readable summary" }, "narrative": { "type": "string", "minLength": 1, "description": "Plain-English explanation of the approval context" }, "reasoning_trace": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Compressed reasoning steps", "default": [] }, "recommended_actions": { "items": { "$ref": "#/components/schemas/RecommendedAction" }, "type": "array", "maxItems": 3, "minItems": 1, "description": "Action options for the approver (1-3)" }, "source_agent_id": { "type": "string", "minLength": 1, "description": "Producing agent identifier" }, "task_id": { "description": "Related task identifier", "minLength": 1, "type": [ "string", "null" ] }, "risk_level": { "$ref": "#/components/schemas/ApprovalRiskLevel" }, "metadata": { "additionalProperties": {}, "type": "object", "description": "Additional key-value metadata" }, "signature_threshold": { "type": "integer", "maximum": 10.0, "minimum": 1.0, "description": "Minimum signatures required before action executes", "default": 1 }, "signatures": { "items": { "$ref": "#/components/schemas/EvidencePackageSignature" }, "type": "array", "description": "Collected approver signatures", "default": [] }, "is_fully_signed": { "type": "boolean", "description": "Whether the required signature threshold has been met.\n\nCounts distinct approvers so a single approver cannot be\ncounted multiple times.", "readOnly": true } }, "type": "object", "required": [ "created_at", "id", "is_fully_signed", "narrative", "recommended_actions", "risk_level", "source_agent_id", "title" ], "title": "EvidencePackage" }, "EvidencePackageSignature": { "properties": { "approver_id": { "type": "string", "minLength": 1, "description": "Approver identity" }, "algorithm": { "type": "string", "enum": [ "ml-dsa-65", "ed25519" ], "description": "Signature algorithm" }, "signature_bytes": { "type": "string", "description": "Raw signature bytes" }, "signed_at": { "type": "string", "format": "date-time", "description": "Signature timestamp" }, "chain_position": { "type": "integer", "minimum": 0.0, "description": "Position in the append-only audit chain" } }, "type": "object", "required": [ "algorithm", "approver_id", "chain_position", "signature_bytes", "signed_at" ], "title": "EvidencePackageSignature" }, "ExecuteTaskRequest": { "properties": { "previous_status": { "description": "Task status before the triggering transition", "minLength": 1, "type": [ "string", "null" ] }, "new_status": { "type": "string", "minLength": 1, "description": "Task status that triggered the dispatch (typically 'assigned' or 'ready')" }, "idempotency_key": { "type": "string", "minLength": 1, "description": "Per-dispatch idempotency key; backend dedups duplicate executions" } }, "type": "object", "required": [ "idempotency_key", "new_status" ], "title": "ExecuteTaskRequest" }, "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" }, "ExperienceConfig": { "properties": { "enabled": { "type": "boolean", "default": true }, "weight": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.2 }, "clarity_enabled": { "type": "boolean", "default": true }, "tone_enabled": { "type": "boolean", "default": true }, "helpfulness_enabled": { "type": "boolean", "default": true }, "trust_enabled": { "type": "boolean", "default": true }, "satisfaction_enabled": { "type": "boolean", "default": true }, "clarity_weight": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.25 }, "tone_weight": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.15 }, "helpfulness_weight": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.25 }, "trust_weight": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.2 }, "satisfaction_weight": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.15 }, "min_feedback_count": { "type": "integer", "minimum": 1.0, "default": 3 } }, "type": "object", "required": [], "title": "ExperienceConfig" }, "ExperimentAssignment": { "properties": { "experiment": { "type": "string", "minLength": 1, "description": "Experiment key" }, "subject_id": { "type": "string", "minLength": 1, "description": "Subject identifier" }, "variant": { "type": "string", "minLength": 1, "description": "Variant the subject was assigned to" }, "assigned_at": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" } }, "type": "object", "required": [ "assigned_at", "experiment", "subject_id", "variant" ], "title": "ExperimentAssignment" }, "ExperimentVariant": { "properties": { "experiment": { "type": "string", "minLength": 1, "description": "Experiment key (kebab-case)" }, "variant": { "type": "string", "minLength": 1, "description": "Variant name within the experiment" }, "weight": { "type": "integer", "maximum": 1000.0, "minimum": 1.0, "description": "Relative selection weight" }, "description": { "type": "string", "description": "Operator notes", "default": "" }, "created_at": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" } }, "type": "object", "required": [ "created_at", "experiment", "variant", "weight" ], "title": "ExperimentVariant" }, "FilePart": { "properties": { "type": { "type": "string", "const": "file", "description": "Part type discriminator", "default": "file" }, "uri": { "type": "string", "minLength": 1, "description": "File URI or path" }, "mime_type": { "description": "Optional MIME type", "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [ "uri" ], "title": "FilePart" }, "FileSystemScope": { "type": "string", "enum": [ "workspace_only", "project_directory", "full" ], "title": "FileSystemScope", "description": "File system access scope", "default": "project_directory" }, "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" }, "FinishReason": { "type": "string", "enum": [ "stop", "max_tokens", "tool_use", "content_filter", "error" ], "title": "FinishReason", "description": "Reason the model stopped generating tokens." }, "FlightRecorderFrame": { "properties": { "id": { "type": "string", "minLength": 1, "description": "Unique frame identifier" }, "execution_id": { "type": "string", "minLength": 1, "description": "Execution run identifier" }, "task_id": { "description": "Task the agent was working on, when known", "minLength": 1, "type": [ "string", "null" ] }, "agent_id": { "type": "string", "minLength": 1, "description": "Agent that produced the turn" }, "turn_index": { "type": "integer", "minimum": 1.0, "description": "1-based turn index within the run" }, "timestamp": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" }, "prompt_summary": { "description": "Redacted, length-bounded prompt summary", "type": [ "string", "null" ] }, "response_summary": { "description": "Redacted, length-bounded model response summary", "type": [ "string", "null" ] }, "decision": { "description": "Classified turn outcome (e.g. tool_call, completed)", "type": [ "string", "null" ] }, "tool_calls": { "items": { "type": "string" }, "type": "array", "description": "Tool names invoked during the turn", "default": [] }, "input_tokens": { "type": "integer", "minimum": 0.0, "description": "Prompt tokens", "default": 0 }, "output_tokens": { "type": "integer", "minimum": 0.0, "description": "Completion tokens", "default": 0 }, "cost": { "type": "number", "minimum": 0.0, "description": "Turn cost", "default": 0.0 }, "status": { "$ref": "#/components/schemas/TaskStatus" }, "intervention_kind": { "description": "Operator intervention recorded on this turn, if any", "type": [ "string", "null" ], "enum": [ "pause", "kill", "hint", "redirect", null ] } }, "type": "object", "required": [ "agent_id", "execution_id", "status", "turn_index" ], "title": "FlightRecorderFrame" }, "Forecast": { "properties": { "forecast_id": { "type": "string", "format": "uuid", "description": "Stable UUID primary key" }, "brief_hash": { "type": "string", "minLength": 1, "description": "SHA-256 hex digest of canonical brief JSON" }, "estimated_cost": { "type": "number", "minimum": 0.0, "description": "Mid-point cost estimate in `currency`" }, "lower_bound": { "type": "number", "minimum": 0.0, "description": "Lower bound of the cost estimate" }, "upper_bound": { "type": "number", "minimum": 0.0, "description": "Upper bound of the cost estimate" }, "currency": { "type": "string", "maxLength": 3, "minLength": 3, "pattern": "^[A-Z]{3}$", "description": "ISO 4217 currency code stamped on the estimate" }, "decision": { "$ref": "#/components/schemas/ForecastDecision" }, "decided_at": { "description": "When the operator decided (None while pending)", "format": "date-time", "type": [ "string", "null" ] }, "decided_by": { "description": "Identifier of the deciding operator", "minLength": 1, "type": [ "string", "null" ] }, "ceiling_amount": { "description": "Per-run hard ceiling the operator approved", "type": [ "number", "null" ] }, "halt_context": { "description": "Hard-ceiling halt context; set when the run is parked on a ceiling crossing, cleared when the operator raises the ceiling", "anyOf": [ { "$ref": "#/components/schemas/HaltContext" }, { "type": "null" } ] }, "created_at": { "type": "string", "format": "date-time", "description": "Row creation timestamp" }, "updated_at": { "type": "string", "format": "date-time", "description": "Last decision-state mutation timestamp" } }, "type": "object", "required": [ "brief_hash", "created_at", "currency", "estimated_cost", "forecast_id", "lower_bound", "updated_at", "upper_bound" ], "title": "Forecast" }, "ForecastApproveRequest": { "properties": { "decided_by": { "type": "string", "minLength": 1, "description": "Operator identifier" }, "ceiling_amount": { "description": "Approved per-run hard ceiling (None to inherit setting)", "type": [ "number", "null" ] } }, "type": "object", "required": [ "decided_by" ], "title": "ForecastApproveRequest" }, "ForecastDecision": { "type": "string", "enum": [ "pending", "approved", "rejected", "superseded" ], "title": "ForecastDecision", "description": "Operator decision state", "default": "pending" }, "ForecastPoint": { "properties": { "day": { "type": "string", "format": "date", "description": "Calendar date" }, "projected_spend": { "type": "number", "minimum": 0.0, "description": "Projected cumulative spend in the configured currency" } }, "type": "object", "required": [ "day", "projected_spend" ], "title": "ForecastPoint" }, "ForecastRejectRequest": { "properties": { "decided_by": { "type": "string", "minLength": 1, "description": "Operator identifier" } }, "type": "object", "required": [ "decided_by" ], "title": "ForecastRejectRequest" }, "ForecastRequest": { "properties": { "brief_text": { "type": "string", "minLength": 1, "description": "Brief body to estimate" }, "role_skeleton": { "items": { "type": "string", "minLength": 1 }, "type": "array", "minItems": 1, "description": "Ordered role ids participating in the run (non-empty)" }, "model_assignments": { "additionalProperties": { "type": "string", "minLength": 1 }, "type": "object", "description": "Optional per-role model id (canonical alias)" }, "estimated_turns_per_role": { "description": "Optional per-role turn estimate", "type": [ "number", "null" ] } }, "type": "object", "required": [ "brief_text", "role_skeleton" ], "title": "ForecastRequest" }, "ForecastResponse": { "properties": { "horizon_days": { "type": "integer", "minimum": 1.0, "description": "Projection horizon" }, "projected_total": { "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": { "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": "USD" } }, "type": "object", "required": [ "avg_daily_spend", "confidence", "daily_projections", "horizon_days", "projected_total" ], "title": "ForecastResponse" }, "GenerateReportRequest": { "properties": { "period": { "$ref": "#/components/schemas/ReportPeriod" } }, "type": "object", "required": [ "period" ], "title": "GenerateReportRequest" }, "GitAccess": { "type": "string", "enum": [ "local_only", "read_and_branch", "full" ], "title": "GitAccess", "description": "Git access level", "default": "full" }, "GovernanceConfig": { "properties": { "enabled": { "type": "boolean", "default": true }, "weight": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.2 }, "audit_compliance_enabled": { "type": "boolean", "default": true }, "trust_level_enabled": { "type": "boolean", "default": true }, "autonomy_compliance_enabled": { "type": "boolean", "default": true }, "audit_compliance_weight": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.5 }, "trust_level_weight": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.3 }, "autonomy_compliance_weight": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.2 } }, "type": "object", "required": [], "title": "GovernanceConfig" }, "GrantOrgRoleRequest": { "properties": { "role": { "$ref": "#/components/schemas/OrgRole" }, "scoped_departments": { "items": { "type": "string", "minLength": 1 }, "type": "array", "default": [] } }, "type": "object", "required": [ "role" ], "title": "GrantOrgRoleRequest" }, "HRRegistry": { "properties": { "active_agents": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Currently active agent names", "default": [] }, "available_roles": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Roles available for hiring", "default": [] }, "hiring_queue": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Roles in the hiring pipeline", "default": [] } }, "type": "object", "required": [], "title": "HRRegistry", "description": "HR registry" }, "HaltContext": { "properties": { "accumulated_cost": { "type": "number", "minimum": 0.0, "description": "Cost accrued when the ceiling was crossed" }, "ceiling_amount": { "type": "number", "minimum": 0.0, "description": "The hard ceiling that was crossed" }, "currency": { "type": "string", "maxLength": 3, "minLength": 3, "pattern": "^[A-Z]{3}$", "description": "ISO 4217 code stamped on both amounts" }, "halted_at": { "type": "string", "format": "date-time", "description": "When the halt was recorded" } }, "type": "object", "required": [ "accumulated_cost", "ceiling_amount", "currency", "halted_at" ], "title": "HaltContext" }, "HeadingBlock": { "properties": { "block_kind": { "type": "string", "const": "heading", "description": "Discriminator value for the DocBlock union", "default": "heading" }, "block_id": { "type": "string", "minLength": 1, "description": "Stable identifier surviving re-orders" }, "level": { "type": "integer", "maximum": 6.0, "minimum": 1.0, "description": "Heading level (1 outer-most)" }, "text": { "type": "string", "maxLength": 512, "minLength": 1, "description": "Heading text" } }, "type": "object", "required": [ "level", "text" ], "title": "HeadingBlock" }, "HealthReport": { "properties": { "connection_name": { "type": "string", "minLength": 1 }, "status": { "$ref": "#/components/schemas/ConnectionStatus" }, "latency_ms": { "type": [ "number", "null" ] }, "error_detail": { "type": [ "string", "null" ] }, "checked_at": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" }, "consecutive_failures": { "type": "integer", "minimum": 0.0, "default": 0 } }, "type": "object", "required": [ "connection_name", "status" ], "title": "HealthReport" }, "HumanRole": { "type": "string", "enum": [ "ceo", "manager", "board_member", "pair_programmer", "observer", "system" ], "title": "HumanRole", "description": "Recognised human roles for access control." }, "IdentityFieldChange": { "properties": { "field_path": { "type": "string", "minLength": 1 }, "change_type": { "type": "string", "enum": [ "modified", "added", "removed" ] }, "old_value": { "type": [ "string", "null" ] }, "new_value": { "type": [ "string", "null" ] } }, "type": "object", "required": [ "change_type", "field_path" ], "title": "IdentityFieldChange" }, "InitiateOAuthFlowRequest": { "properties": { "connection_name": { "type": "string", "maxLength": 128, "minLength": 1 }, "scopes": { "items": { "type": "string", "minLength": 1 }, "type": "array", "default": [] } }, "type": "object", "required": [ "connection_name" ], "title": "InitiateOAuthFlowRequest" }, "InstallEntryRequest": { "properties": { "catalog_entry_id": { "type": "string", "minLength": 1, "description": "Catalog entry identifier to install" }, "connection_name": { "description": "Bound connection name; required when the entry declares a ``required_connection_type``", "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [ "catalog_entry_id" ], "title": "InstallEntryRequest" }, "InstallEntryResponse": { "properties": { "status": { "type": "string", "const": "installed", "description": "Installation status" }, "server_name": { "type": "string", "minLength": 1, "description": "Installed MCP server name" }, "catalog_entry_id": { "type": "string", "minLength": 1, "description": "Installed catalog entry id" }, "tool_count": { "type": "integer", "minimum": 0.0, "description": "Number of tools exposed by the installed server" } }, "type": "object", "required": [ "catalog_entry_id", "server_name", "status", "tool_count" ], "title": "InstallEntryResponse" }, "InstalledEntry": { "properties": { "catalog_entry_id": { "type": "string", "minLength": 1, "description": "Installed catalog entry id" }, "connection_name": { "description": "Bound connection name (when applicable)", "minLength": 1, "type": [ "string", "null" ] }, "installed_at": { "type": "string", "description": "ISO-8601 UTC timestamp of installation" } }, "type": "object", "required": [ "catalog_entry_id", "installed_at" ], "title": "InstalledEntry" }, "IntelligenceConfig": { "properties": { "enabled": { "type": "boolean", "default": true }, "weight": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.2 }, "ci_quality_enabled": { "type": "boolean", "default": true }, "llm_calibration_enabled": { "type": "boolean", "default": true }, "ci_quality_weight": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.7 }, "llm_calibration_weight": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.3 } }, "type": "object", "required": [], "title": "IntelligenceConfig" }, "InterruptResponse": { "properties": { "id": { "type": "string", "minLength": 1 }, "type": { "$ref": "#/components/schemas/InterruptType" }, "session_id": { "type": "string", "minLength": 1 }, "agent_id": { "type": "string", "minLength": 1 }, "created_at": { "type": "string" }, "timeout_seconds": { "type": "number" }, "tool_name": { "minLength": 1, "type": [ "string", "null" ] }, "tool_args": { "additionalProperties": {}, "type": [ "object", "null" ] }, "evidence_package_id": { "minLength": 1, "type": [ "string", "null" ] }, "question": { "minLength": 1, "type": [ "string", "null" ] }, "context_snippet": { "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [ "agent_id", "created_at", "id", "session_id", "timeout_seconds", "type" ], "title": "InterruptResponse" }, "InterruptType": { "type": "string", "enum": [ "tool_approval", "info_request" ], "title": "InterruptType", "description": "Type of blocking interrupt.\n\nMembers:\n TOOL_APPROVAL: Approval gate parked execution for HITL review.\n INFO_REQUEST: Agent needs clarification mid-task.\n" }, "InterventionKind": { "type": "string", "enum": [ "pause", "kill", "hint", "redirect" ], "title": "InterventionKind", "description": "Operator intervention applied from the mission-control cockpit.\n\nPAUSE and KILL reuse the task lifecycle seams (transition to\n``INTERRUPTED`` / cancel to ``CANCELLED``). HINT and REDIRECT route\nthrough the steering directive: both post an ``INFO_REQUEST``\ninterrupt the engine consumes at the next safe turn boundary, so the\noperator's text reaches the running agent without corrupting state.\n" }, "InterviewTurnRequest": { "properties": { "message": { "type": "string", "maxLength": 4000, "minLength": 1 }, "conversation_id": { "minLength": 1, "type": [ "string", "null" ] }, "project": { "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [ "message" ], "title": "InterviewTurnRequest" }, "InterviewTurnResult": { "properties": { "conversation_id": { "type": "string", "minLength": 1 }, "status": { "type": "string", "enum": [ "needs_more", "drafted" ] }, "next_question": { "minLength": 1, "type": [ "string", "null" ] }, "charter": { "anyOf": [ { "$ref": "#/components/schemas/ProjectCharter" }, { "type": "null" } ] }, "conversation_closed": { "type": "boolean", "default": false } }, "type": "object", "required": [ "conversation_id", "status" ], "title": "InterviewTurnResult" }, "KillInterventionRequest": { "properties": { "task_id": { "type": "string", "minLength": 1, "description": "Task to kill" }, "reason": { "type": "string", "minLength": 1, "description": "Operator reason for the kill" } }, "type": "object", "required": [ "reason", "task_id" ], "title": "KillInterventionRequest" }, "KnowledgeHit": { "properties": { "chunk_text": { "type": "string", "maxLength": 65536, "minLength": 1, "description": "Matching chunk content" }, "relevance_score": { "type": "number", "maximum": 1.0, "minimum": 0.0, "description": "Backend-assigned relevance" }, "citation": { "$ref": "#/components/schemas/Citation" } }, "type": "object", "required": [ "chunk_text", "citation", "relevance_score" ], "title": "KnowledgeHit" }, "KnowledgeSource": { "properties": { "source_id": { "type": "string", "minLength": 1, "description": "Primary key" }, "source_type": { "$ref": "#/components/schemas/SourceType" }, "project_id": { "description": "Owning project; None means global (cross-project)", "minLength": 1, "type": [ "string", "null" ] }, "uri": { "type": "string", "minLength": 1, "description": "Source URI (path / url / repo@ref / id)" }, "title": { "type": "string", "maxLength": 1024, "minLength": 1, "description": "Human-readable title" }, "content_hash": { "type": "string", "pattern": "^[0-9a-f]{64}$", "description": "Hash of source bytes" }, "status": { "$ref": "#/components/schemas/SourceStatus" }, "chunk_count": { "type": "integer", "minimum": 0.0, "description": "Indexed chunk count", "default": 0 }, "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" }, "last_indexed_at": { "description": "datetime with the constraint that the value must have timezone info", "format": "date-time", "type": [ "string", "null" ] }, "last_error": { "description": "Safe error description on the last failure", "minLength": 1, "type": [ "string", "null" ] }, "is_global": { "type": "boolean", "description": "Whether the source is global (not scoped to a project).", "readOnly": true } }, "type": "object", "required": [ "content_hash", "created_at", "is_global", "source_id", "source_type", "status", "title", "updated_at", "uri" ], "title": "KnowledgeSource" }, "LLMCallCategory": { "type": "string", "enum": [ "productive", "coordination", "system", "embedding" ], "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" }, "LinkBlock": { "properties": { "block_kind": { "type": "string", "const": "link", "description": "Discriminator value for the DocBlock union", "default": "link" }, "block_id": { "type": "string", "minLength": 1 }, "label": { "type": "string", "maxLength": 512, "minLength": 1, "description": "Link display label" }, "url": { "type": "string", "maxLength": 512, "minLength": 1, "description": "Link target URL" } }, "type": "object", "required": [ "label", "url" ], "title": "LinkBlock" }, "LiveActivitySnapshot": { "properties": { "timestamp": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" }, "agents": { "items": { "$ref": "#/components/schemas/AgentActivity" }, "type": "array", "description": "Per-task activity for active work", "default": [] }, "total_cost": { "type": "number", "minimum": 0.0, "description": "Summed active cost", "default": 0.0 }, "active_count": { "type": "integer", "minimum": 0.0, "description": "Active task count", "default": 0 }, "stuck_agents": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Agent ids flagged stuck", "default": [] }, "runaway_agents": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Agent ids flagged runaway", "default": [] } }, "type": "object", "required": [ "timestamp" ], "title": "LiveActivitySnapshot" }, "LivenessStatus": { "properties": { "status": { "type": "string", "const": "ok", "description": "Always 'ok' while the process is alive", "default": "ok" }, "version": { "type": "string", "description": "Application version" }, "uptime_seconds": { "type": "number", "minimum": 0.0, "description": "Seconds since startup" } }, "type": "object", "required": [ "uptime_seconds", "version" ], "title": "LivenessStatus" }, "LivingDocument": { "properties": { "slug": { "type": "string", "minLength": 1, "description": "URL-safe identifier" }, "title": { "type": "string", "minLength": 1, "description": "Human-readable title" }, "doc_type": { "$ref": "#/components/schemas/DocType" }, "tags": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Free-form classification tags", "default": [] }, "related_task_ids": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Task IDs that produced or reference this doc", "default": [] }, "author_agent_id": { "type": "string", "minLength": 1, "description": "Agent that performed the last write" }, "body": { "items": { "oneOf": [ { "$ref": "#/components/schemas/HeadingBlock" }, { "$ref": "#/components/schemas/ProseBlock" }, { "$ref": "#/components/schemas/BulletListBlock" }, { "$ref": "#/components/schemas/CodeBlock" }, { "$ref": "#/components/schemas/DecisionBlock" }, { "$ref": "#/components/schemas/MetricBlock" }, { "$ref": "#/components/schemas/LinkBlock" } ] }, "type": "array", "description": "Ordered typed-block body", "default": [] }, "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": [ "author_agent_id", "created_at", "doc_type", "slug", "title", "updated_at" ], "title": "LivingDocument" }, "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": { "type": "number", "minimum": 0.0, "description": "Numeric cost of the LLM call, denominated in ``currency``" }, "currency": { "type": "string", "maxLength": 3, "minLength": 3, "pattern": "^[A-Z]{3}$", "description": "ISO 4217 currency code for ``cost``" }, "drift": { "type": "number", "description": "Absolute difference between LLM and behavioral scores", "readOnly": true } }, "type": "object", "required": [ "agent_id", "behavioral_score", "cost", "currency", "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" }, "LocalPreset": { "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" }, "default_base_url": { "minLength": 1, "type": [ "string", "null" ] }, "requires_base_url": { "type": "boolean", "default": false }, "is_featured": { "type": "boolean", "default": true }, "kind": { "type": "string", "const": "local", "default": "local" }, "candidate_urls": { "items": { "type": "string", "minLength": 1 }, "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": "LocalPreset" }, "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", "premortem", "devil_advocate" ], "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" }, "MemoryCategory": { "type": "string", "enum": [ "working", "episodic", "semantic", "procedural", "social", "project_doc", "knowledge" ], "title": "MemoryCategory", "description": "Memory category this override applies to" }, "MemoryConfig": { "properties": { "type": { "$ref": "#/components/schemas/MemoryLevel" }, "retention_days": { "minimum": 1, "description": "Days to retain memories (None = forever)", "type": [ "integer", "null" ] }, "retention_overrides": { "items": { "$ref": "#/components/schemas/AgentRetentionRule" }, "type": "array", "description": "Per-category retention overrides for this agent", "default": [] } }, "type": "object", "required": [], "title": "MemoryConfig", "description": "Memory configuration" }, "MemoryLevel": { "type": "string", "enum": [ "persistent", "project", "session", "none" ], "title": "MemoryLevel", "description": "Memory persistence type", "default": "session" }, "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" }, "parts": { "items": { "oneOf": [ { "$ref": "#/components/schemas/TextPart" }, { "$ref": "#/components/schemas/DataPart" }, { "$ref": "#/components/schemas/FilePart" }, { "$ref": "#/components/schemas/UriPart" } ] }, "type": "array", "minItems": 1, "description": "Ordered content parts (text, data, files, URIs)" }, "attachments": { "items": { "oneOf": [ { "$ref": "#/components/schemas/TextPart" }, { "$ref": "#/components/schemas/DataPart" }, { "$ref": "#/components/schemas/FilePart" }, { "$ref": "#/components/schemas/UriPart" } ] }, "type": "array", "description": "Out-of-band parts attached to the message (files, data blobs, URIs) that are not part of the primary content flow. Persisted alongside the message and round-tripped by both backends.", "default": [] }, "metadata": { "$ref": "#/components/schemas/MessageMetadata" }, "text": { "type": "string", "description": "Extract the first ``TextPart`` text, or empty string.\n\nConvenience accessor for consumers that only need the primary\ntext content of a message.", "readOnly": true } }, "type": "object", "required": [ "channel", "parts", "sender", "text", "timestamp", "to", "type" ], "title": "Message" }, "MessageDensity": { "properties": { "inter_agent_messages": { "type": "integer", "minimum": 0.0, "description": "Inter-agent message count" }, "reasoning_turns": { "type": "integer", "exclusiveMinimum": 0.0, "description": "Reasoning turn count" }, "value": { "type": "number", "description": "Messages per reasoning turn", "readOnly": true } }, "type": "object", "required": [ "inter_agent_messages", "reasoning_turns", "value" ], "title": "MessageDensity" }, "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": { "description": "Estimated cost in the configured 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" }, "MessageOverhead": { "properties": { "team_size": { "type": "integer", "exclusiveMinimum": 0.0, "description": "Number of coordinating agents" }, "message_count": { "type": "integer", "minimum": 0.0, "description": "Actual inter-agent message count" }, "quadratic_threshold": { "type": "number", "maximum": 1.0, "exclusiveMinimum": 0.0, "description": "Fraction of n^2 that triggers alert", "default": 0.5 }, "is_quadratic": { "type": "boolean", "description": "Whether message growth is quadratic", "readOnly": true } }, "type": "object", "required": [ "is_quadratic", "message_count", "team_size" ], "title": "MessageOverhead" }, "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", "dissent", "context_injection" ], "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" }, "MetricBlock": { "properties": { "block_kind": { "type": "string", "const": "metric", "description": "Discriminator value for the DocBlock union", "default": "metric" }, "block_id": { "type": "string", "minLength": 1 }, "name": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Metric label" }, "value": { "type": "string", "minLength": 1, "description": "Metric value (as string)" }, "unit": { "description": "Optional unit suffix", "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [ "name", "value" ], "title": "MetricBlock" }, "MiddlewareConfig": { "properties": { "agent": { "$ref": "#/components/schemas/AgentMiddlewareConfig" }, "coordination": { "$ref": "#/components/schemas/CoordinationMiddlewareConfig" } }, "type": "object", "required": [], "title": "MiddlewareConfig", "description": "Agent and coordination middleware configuration" }, "ModelConfig": { "properties": { "provider": { "type": "string", "minLength": 1, "description": "LLM provider name" }, "model_id": { "type": "string", "minLength": 1, "description": "Model identifier" }, "temperature": { "type": "number", "maximum": 2.0, "minimum": 0.0, "description": "Sampling temperature", "default": 0.7 }, "max_tokens": { "type": "integer", "exclusiveMinimum": 0.0, "description": "Maximum output tokens", "default": 4096 }, "fallback_model": { "description": "Fallback model identifier", "minLength": 1, "type": [ "string", "null" ] }, "model_tier": { "type": [ "null", "string" ], "enum": [ "large", "medium", "small", null ], "description": "Model capability tier (large/medium/small)" } }, "type": "object", "required": [ "model_id", "provider" ], "title": "ModelConfig", "description": "LLM model configuration" }, "NetworkMode": { "type": "string", "enum": [ "none", "allowlist_only", "open" ], "title": "NetworkMode", "description": "Network access mode", "default": "open" }, "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" }, "OrgRole": { "type": "string", "enum": [ "owner", "department_admin", "editor", "viewer" ], "title": "OrgRole", "description": "Permission-level role for org configuration access.\n\nOrthogonal to ``HumanRole`` (operational persona).\n``HumanRole`` controls who you are in the org simulation;\n``OrgRole`` controls what you can do to the org config.\n" }, "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": { "type": "number", "minimum": 0.0, "description": "Total cost in the configured currency" }, "budget_remaining": { "type": "number", "minimum": 0.0, "description": "Remaining budget in the configured currency" }, "currency": { "type": "string", "maxLength": 3, "minLength": 3, "description": "ISO 4217 currency code", "default": "USD" }, "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": "Agents currently executing an in-progress task" }, "idle_agents_count": { "type": "integer", "minimum": 0.0, "description": "Employed agents not currently executing a task" } }, "type": "object", "required": [ "active_agents_count", "budget_remaining", "budget_used_percent", "cost_7d_trend", "idle_agents_count", "tasks_by_status", "total_agents", "total_cost", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[AgentConfig]" }, "PaginatedResponse_AggregatedPattern_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/AggregatedPattern" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[AggregatedPattern]" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[Artifact]" }, "PaginatedResponse_AuditEntry_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/AuditEntry" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[AuditEntry]" }, "PaginatedResponse_BackupInfo_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/BackupInfo" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[BackupInfo]" }, "PaginatedResponse_CatalogEntry_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/CatalogEntry" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[CatalogEntry]" }, "PaginatedResponse_Channel_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/Channel" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[Channel]" }, "PaginatedResponse_CheckpointRecord_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/CheckpointRecord" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[CheckpointRecord]" }, "PaginatedResponse_ClientProfile_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/ClientProfile" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[ClientProfile]" }, "PaginatedResponse_ClientRequest_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/ClientRequest" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[ClientRequest]" }, "PaginatedResponse_Connection_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/Connection" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[Connection]" }, "PaginatedResponse_CoordinationMetricsRecord_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/CoordinationMetricsRecord" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[CoordinationMetricsRecord]" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[Department]" }, "PaginatedResponse_DocSummary_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/DocSummary" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[DocSummary]" }, "PaginatedResponse_DriftReportResponse_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/DriftReportResponse" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[DriftReportResponse]" }, "PaginatedResponse_EntityResponse_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/EntityResponse" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[EntityResponse]" }, "PaginatedResponse_EntityVersionResponse_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/EntityVersionResponse" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[EntityVersionResponse]" }, "PaginatedResponse_EscalationResponse_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/EscalationResponse" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[EscalationResponse]" }, "PaginatedResponse_ExperimentAssignment_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/ExperimentAssignment" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[ExperimentAssignment]" }, "PaginatedResponse_FineTuneRun_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/FineTuneRun" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[FineTuneRun]" }, "PaginatedResponse_FlightRecorderFrame_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/FlightRecorderFrame" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[FlightRecorderFrame]" }, "PaginatedResponse_HealthReport_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/HealthReport" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[HealthReport]" }, "PaginatedResponse_InstalledEntry_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/InstalledEntry" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[InstalledEntry]" }, "PaginatedResponse_KnowledgeSource_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/KnowledgeSource" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[KnowledgeSource]" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[Message]" }, "PaginatedResponse_ParentReference_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/ParentReference" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[ParentReference]" }, "PaginatedResponse_PersonalityPresetInfoResponse_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/PersonalityPresetInfoResponse" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[PersonalityPresetInfoResponse]" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[PresetSummaryResponse]" }, "PaginatedResponse_ProjectCharter_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/ProjectCharter" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[ProjectCharter]" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[Project]" }, "PaginatedResponse_ProviderAuditEvent_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/ProviderAuditEvent" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[ProviderAuditEvent]" }, "PaginatedResponse_ProviderModelResponse_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/ProviderModelResponse" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[ProviderModelResponse]" }, "PaginatedResponse_ProviderResponse_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/ProviderResponse" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[ProviderResponse]" }, "PaginatedResponse_ScalingDecisionResponse_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/ScalingDecisionResponse" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[ScalingDecisionResponse]" }, "PaginatedResponse_ScalingSignalResponse_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/ScalingSignalResponse" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[ScalingSignalResponse]" }, "PaginatedResponse_ScalingStrategyResponse_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/ScalingStrategyResponse" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[ScalingStrategyResponse]" }, "PaginatedResponse_SettingEntry_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/SettingEntry" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[SettingEntry]" }, "PaginatedResponse_SetupAgentSummary_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/SetupAgentSummary" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[SetupAgentSummary]" }, "PaginatedResponse_SimulationStatusResponse_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/SimulationStatusResponse" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[SimulationStatusResponse]" }, "PaginatedResponse_SinkInfoResponse_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/SinkInfoResponse" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[SinkInfoResponse]" }, "PaginatedResponse_SubworkflowSummary_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/SubworkflowSummary" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[SubworkflowSummary]" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[Task]" }, "PaginatedResponse_ThresholdRecommendation_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/ThresholdRecommendation" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[ThresholdRecommendation]" }, "PaginatedResponse_UserResponse_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/UserResponse" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[UserResponse]" }, "PaginatedResponse_VersionSnapshot_AgentIdentity_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/VersionSnapshot_AgentIdentity_" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[VersionSnapshot[AgentIdentity]]" }, "PaginatedResponse_VersionSnapshot_BudgetConfig_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/VersionSnapshot_BudgetConfig_" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[VersionSnapshot[BudgetConfig]]" }, "PaginatedResponse_VersionSnapshot_Company_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/VersionSnapshot_Company_" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[VersionSnapshot[Company]]" }, "PaginatedResponse_VersionSnapshot_EvaluationConfig_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/VersionSnapshot_EvaluationConfig_" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[VersionSnapshot[EvaluationConfig]]" }, "PaginatedResponse_VersionSnapshot_Role_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/VersionSnapshot_Role_" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[VersionSnapshot[Role]]" }, "PaginatedResponse_VersionSnapshot_WorkflowDefinition_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/VersionSnapshot_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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[VersionSnapshot[WorkflowDefinition]]" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[WorkflowDefinition]" }, "PaginatedResponse_WorkflowExecution_": { "properties": { "data": { "items": { "$ref": "#/components/schemas/WorkflowExecution" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[WorkflowExecution]" }, "PaginatedResponse_dict_str_Any_": { "properties": { "data": { "items": { "additionalProperties": {}, "type": "object" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[dict[str, Any]]" }, "PaginatedResponse_dict_str_str_": { "properties": { "data": { "items": { "additionalProperties": { "type": "string" }, "type": "object" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[dict[str, str]]" }, "PaginatedResponse_str_": { "properties": { "data": { "items": { "type": "string" }, "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``).\n\nReturns:\n ``True`` or ``False`` reflecting the condition.", "readOnly": true } }, "type": "object", "required": [ "pagination", "success" ], "title": "PaginatedResponse[str]" }, "PaginationMeta": { "properties": { "limit": { "type": "integer", "minimum": 1.0, "description": "Maximum items per page" }, "next_cursor": { "description": "Opaque cursor for the next page (null on final page)", "type": [ "string", "null" ] }, "has_more": { "type": "boolean", "description": "Whether more items follow the current page", "default": false } }, "type": "object", "required": [ "limit" ], "title": "PaginationMeta" }, "ParentReference": { "properties": { "parent_id": { "type": "string", "minLength": 1, "description": "Parent workflow ID" }, "parent_name": { "type": "string", "minLength": 1, "description": "Parent workflow name" }, "pinned_version": { "type": "string", "minLength": 1, "description": "Pinned semver" }, "node_id": { "type": "string", "minLength": 1, "description": "Referencing node ID" }, "parent_type": { "type": "string", "enum": [ "workflow_definition", "subworkflow" ], "description": "Whether the parent is a workflow definition or subworkflow" }, "parent_version": { "description": "Parent's semver when parent_type is subworkflow", "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [ "node_id", "parent_id", "parent_name", "parent_type", "pinned_version" ], "title": "ParentReference" }, "ParetoFrontier": { "properties": { "points": { "items": { "$ref": "#/components/schemas/ParetoPoint" }, "type": "array", "description": "Frontier points sorted by cost_saving_pct descending", "default": [] }, "generated_at": { "type": "string", "format": "date-time", "description": "When the analyzer ran" }, "baseline_window_size": { "type": "integer", "minimum": 1.0, "description": "Historical records consulted" }, "source": { "type": "string", "minLength": 1, "description": "Aggregate provenance identifier" } }, "type": "object", "required": [ "baseline_window_size", "generated_at", "source" ], "title": "ParetoFrontier" }, "ParetoPoint": { "properties": { "role_id": { "type": "string", "minLength": 1, "description": "Identifier of the role" }, "role_label": { "type": "string", "minLength": 1, "description": "Human-readable role label" }, "current_model": { "type": "string", "minLength": 1, "description": "Canonical model id in use" }, "candidate_model": { "type": "string", "minLength": 1, "description": "Canonical model id of downgrade" }, "quality_delta_pct": { "type": "number", "maximum": 100.0, "minimum": 0.0, "description": "Percent of quality lost (0 to 100)" }, "cost_saving_pct": { "type": "number", "maximum": 100.0, "minimum": 0.0, "description": "Percent of cost saved (0 to 100)" }, "source": { "type": "string", "minLength": 1, "description": "Benchmark-score provenance identifier" } }, "type": "object", "required": [ "candidate_model", "cost_saving_pct", "current_model", "quality_delta_pct", "role_id", "role_label", "source" ], "title": "ParetoPoint" }, "PauseInterventionRequest": { "properties": { "task_id": { "type": "string", "minLength": 1, "description": "Task to pause" }, "reason": { "type": "string", "minLength": 1, "description": "Operator reason for the pause" } }, "type": "object", "required": [ "reason", "task_id" ], "title": "PauseInterventionRequest" }, "PdfLocator": { "properties": { "locator_kind": { "type": "string", "const": "pdf", "default": "pdf" }, "page": { "type": "integer", "minimum": 1.0, "description": "1-indexed page number" }, "bbox": { "description": "Optional (x0, top, x1, bottom) region in PDF points", "prefixItems": [ { "type": "number" }, { "type": "number" }, { "type": "number" }, { "type": "number" } ], "type": [ "array", "null" ] }, "char_start": { "type": "integer", "minimum": 0.0, "description": "Start offset within the page text" }, "char_end": { "type": "integer", "minimum": 0.0, "description": "End offset within the page text" } }, "type": "object", "required": [ "char_end", "char_start", "page" ], "title": "PdfLocator" }, "PerformanceSummary": { "properties": { "quality_score": { "maximum": 10.0, "type": [ "number", "null" ] }, "collaboration_score": { "maximum": 10.0, "type": [ "number", "null" ] }, "trend": { "type": [ "string", "null" ], "enum": [ "improving", "stable", "declining", "insufficient_data", null ] } }, "type": "object", "required": [], "title": "PerformanceSummary" }, "PeriodSummary": { "properties": { "total_cost": { "type": "number", "minimum": 0.0, "description": "Total cost in the configured currency" }, "currency": { "type": "string", "maxLength": 3, "minLength": 3, "description": "ISO 4217 currency code", "default": "USD" }, "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": { "type": "number", "description": "Average cost per record", "readOnly": true } }, "type": "object", "required": [ "avg_cost", "record_count", "total_cost", "total_input_tokens", "total_output_tokens" ], "title": "PeriodSummary" }, "PersonalityConfig": { "properties": { "traits": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Personality traits", "default": [] }, "communication_style": { "type": "string", "maxLength": 100, "minLength": 1, "description": "Communication style description", "default": "neutral" }, "risk_tolerance": { "$ref": "#/components/schemas/RiskTolerance" }, "creativity": { "$ref": "#/components/schemas/CreativityLevel" }, "description": { "type": "string", "maxLength": 500, "description": "Extended personality description", "default": "" }, "openness": { "type": "number", "maximum": 1.0, "minimum": 0.0, "description": "Big Five openness (curiosity, creativity)", "default": 0.5 }, "conscientiousness": { "type": "number", "maximum": 1.0, "minimum": 0.0, "description": "Big Five conscientiousness (thoroughness, reliability)", "default": 0.5 }, "extraversion": { "type": "number", "maximum": 1.0, "minimum": 0.0, "description": "Big Five extraversion (assertiveness, sociability)", "default": 0.5 }, "agreeableness": { "type": "number", "maximum": 1.0, "minimum": 0.0, "description": "Big Five agreeableness (cooperation, empathy)", "default": 0.5 }, "stress_response": { "type": "number", "maximum": 1.0, "minimum": 0.0, "description": "Emotional stability (1.0 = very calm)", "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": "PersonalityConfig", "description": "Personality configuration" }, "PersonalityPresetInfoResponse": { "properties": { "name": { "type": "string", "minLength": 1 }, "description": { "type": "string", "default": "" } }, "type": "object", "required": [ "name" ], "title": "PersonalityPresetInfoResponse" }, "PipelineResult": { "properties": { "task_id": { "type": "string", "minLength": 1, "description": "ID of the reviewed task" }, "final_verdict": { "$ref": "#/components/schemas/ReviewVerdict" }, "stage_results": { "items": { "$ref": "#/components/schemas/ReviewStageResult" }, "type": "array", "description": "Results from each stage in execution order", "default": [] }, "total_duration_ms": { "type": "integer", "minimum": 0.0, "description": "Total pipeline duration in milliseconds", "default": 0 }, "reviewed_at": { "type": "string", "format": "date-time", "description": "Timestamp of pipeline completion" } }, "type": "object", "required": [ "final_verdict", "task_id" ], "title": "PipelineResult" }, "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" }, "PresetOverride": { "properties": { "preset_name": { "type": "string", "minLength": 1, "description": "Preset this override targets" }, "default_models": { "description": "Override for default model list", "items": { "$ref": "#/components/schemas/ProviderModelConfig" }, "type": [ "array", "null" ] }, "supported_auth_types": { "description": "Override for allowed auth types", "items": { "$ref": "#/components/schemas/AuthType" }, "type": [ "array", "null" ] }, "candidate_urls": { "description": "Override for local-preset candidate URLs", "items": { "type": "string", "minLength": 1 }, "type": [ "array", "null" ] }, "base_url": { "description": "Override for cloud-preset base URL", "minLength": 1, "type": [ "string", "null" ] }, "updated_at": { "description": "datetime with the constraint that the value must have timezone info", "format": "date-time", "type": [ "string", "null" ] }, "updated_by": { "description": "Actor id of last override writer", "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [ "preset_name" ], "title": "PresetOverride" }, "PresetOverrideUpdateRequest": { "properties": { "default_models": { "items": { "$ref": "#/components/schemas/ProviderModelConfig" }, "type": [ "array", "null" ] }, "supported_auth_types": { "items": { "$ref": "#/components/schemas/AuthType" }, "type": [ "array", "null" ] }, "candidate_urls": { "items": { "type": "string", "minLength": 1 }, "type": [ "array", "null" ] }, "base_url": { "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [], "title": "PresetOverrideUpdateRequest" }, "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" }, "PreviewRuleRequest": { "properties": { "metric_path": { "type": "string", "minLength": 1 }, "comparator": { "$ref": "#/components/schemas/Comparator" }, "threshold": { "type": "number" }, "sample_value": { "type": "number" } }, "type": "object", "required": [ "comparator", "metric_path", "sample_value", "threshold" ], "title": "PreviewRuleRequest" }, "Priority": { "type": "string", "enum": [ "critical", "high", "medium", "low" ], "title": "Priority", "description": "Task priority", "default": "medium" }, "PriorityUpdateRequest": { "properties": { "order": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Strategy names in priority order (first = highest)" } }, "type": "object", "required": [ "order" ], "title": "PriorityUpdateRequest" }, "ProbeLocalResponse": { "properties": { "results": { "additionalProperties": { "$ref": "#/components/schemas/ProbePresetResponse" }, "type": "object" }, "errors": { "additionalProperties": { "type": "string" }, "type": "object" } }, "type": "object", "required": [], "title": "ProbeLocalResponse" }, "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" }, "ProjectCharter": { "properties": { "id": { "type": "string", "minLength": 1 }, "conversation_id": { "type": "string", "minLength": 1 }, "created_by": { "type": "string", "minLength": 1 }, "version": { "type": "integer", "minimum": 1.0, "default": 1 }, "status": { "$ref": "#/components/schemas/CharterStatus" }, "title": { "type": "string", "minLength": 1 }, "brief": { "type": "string", "minLength": 1 }, "goals": { "items": { "type": "string", "minLength": 1 }, "type": "array", "default": [] }, "constraints": { "items": { "type": "string", "minLength": 1 }, "type": "array", "default": [] }, "success_criteria": { "items": { "type": "string", "minLength": 1 }, "type": "array", "default": [] }, "scope": { "$ref": "#/components/schemas/ScopeBoundaries" }, "envelope": { "$ref": "#/components/schemas/BudgetEnvelope" }, "project_id": { "minLength": 1, "type": [ "string", "null" ] }, "proposed_project_name": { "minLength": 1, "type": [ "string", "null" ] }, "proposed_project_description": { "type": "string", "default": "" }, "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" }, "approved_at": { "format": "date-time", "description": "datetime with the constraint that the value must have timezone info", "type": [ "string", "null" ] }, "approved_by": { "minLength": 1, "type": [ "string", "null" ] }, "forecast_id": { "format": "uuid", "type": [ "string", "null" ] }, "correlation_id": { "minLength": 1, "type": [ "string", "null" ] }, "task_id": { "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [ "brief", "conversation_id", "created_at", "created_by", "envelope", "id", "title", "updated_at" ], "title": "ProjectCharter" }, "ProjectStatus": { "type": "string", "enum": [ "planning", "active", "on_hold", "completed", "cancelled" ], "title": "ProjectStatus", "description": "Current project status", "default": "planning" }, "ProposalAltitude": { "type": "string", "enum": [ "config_tuning", "architecture", "prompt_tuning", "code_modification", "tool_creation" ], "title": "ProposalAltitude", "description": "Altitude of change a proposal targets." }, "ProposeResult": { "properties": { "conversation_id": { "type": "string", "minLength": 1 }, "status": { "type": "string", "enum": [ "needs_clarification", "proposed" ] }, "clarifying_question": { "minLength": 1, "type": [ "string", "null" ] }, "proposals": { "items": { "$ref": "#/components/schemas/ProposedApprovalSummary" }, "type": "array", "default": [] }, "conversation_closed": { "type": "boolean", "default": false } }, "type": "object", "required": [ "conversation_id", "status" ], "title": "ProposeResult" }, "ProposedApprovalSummary": { "properties": { "approval_id": { "type": "string", "minLength": 1 }, "proposal_id": { "type": "string", "minLength": 1 }, "title": { "type": "string", "minLength": 1 }, "task_type": { "$ref": "#/components/schemas/TaskType" }, "priority": { "$ref": "#/components/schemas/Priority" } }, "type": "object", "required": [ "approval_id", "priority", "proposal_id", "task_type", "title" ], "title": "ProposedApprovalSummary" }, "ProseBlock": { "properties": { "block_kind": { "type": "string", "const": "prose", "description": "Discriminator value for the DocBlock union", "default": "prose" }, "block_id": { "type": "string", "minLength": 1 }, "text": { "type": "string", "maxLength": 8192, "minLength": 1, "description": "Prose body" } }, "type": "object", "required": [ "text" ], "title": "ProseBlock" }, "ProviderAuditActor": { "properties": { "id": { "type": "string", "minLength": 1, "description": "Stable actor identifier" }, "label": { "type": "string", "minLength": 1, "description": "Human-readable actor label" } }, "type": "object", "required": [ "id", "label" ], "title": "ProviderAuditActor", "description": "Actor performing the mutation" }, "ProviderAuditEvent": { "properties": { "id": { "minimum": 1, "description": "Repo-assigned row id", "type": [ "integer", "null" ] }, "provider_name": { "type": "string", "minLength": 1, "description": "Provider name the mutation targets" }, "event_type": { "type": "string", "enum": [ "provider_created", "provider_updated", "provider_deleted", "provider_credentials_rotated", "provider_rate_limits_updated", "preset_override_updated", "model_added", "model_removed", "model_config_updated", "model_pulled", "models_synced" ], "description": "Mutation category" }, "actor": { "$ref": "#/components/schemas/ProviderAuditActor" }, "payload": { "additionalProperties": {}, "type": "object", "description": "Event-specific metadata; credentials must be masked. Wrapped in MappingProxyType after validation so the audit row stays append-only at the Python level too." }, "occurred_at": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" } }, "type": "object", "required": [ "actor", "event_type", "occurred_at", "provider_name" ], "title": "ProviderAuditEvent" }, "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", "description": "Model spec to add" }, "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 }, "currency": { "type": "string", "maxLength": 3, "minLength": 3, "pattern": "^[A-Z]{3}$", "description": "Currency the cost fields are expressed in. Carries the operator's configured ``budget.currency`` so aggregation sites can enforce the same-currency invariant without a second lookup.", "default": "USD" }, "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" }, "ProviderResponse": { "properties": { "name": { "minLength": 1, "type": [ "string", "null" ] }, "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" }, "RaiseCeilingRequest": { "properties": { "new_ceiling": { "type": "number", "exclusiveMinimum": 0.0, "description": "New hard ceiling (must be > accumulated cost at park)" }, "accumulated_cost": { "type": "number", "minimum": 0.0, "description": "Accumulated cost at the moment of parking, supplied by the operator UI. The endpoint rejects ceilings that would re-halt the run immediately on resume with a typed RunHardCeilingTooLowError (richer than a generic 422), so the cross-field check stays in the handler rather than a model validator that would shadow that typed error" } }, "type": "object", "required": [ "accumulated_cost", "new_ceiling" ], "title": "RaiseCeilingRequest" }, "RateLimiterConfig": { "properties": { "max_requests_per_minute": { "type": "integer", "minimum": 0.0, "description": "Maximum requests per minute (0 = unlimited)", "default": 0 }, "max_concurrent": { "type": "integer", "minimum": 0.0, "description": "Maximum concurrent in-flight requests (0 = unlimited)", "default": 0 } }, "type": "object", "required": [], "title": "RateLimiterConfig" }, "RateLimitsResponse": { "properties": { "requests_per_minute": { "type": "integer", "minimum": 0.0, "description": "Per-provider RPM cap; 0 = unlimited", "default": 0 }, "concurrent_requests": { "type": "integer", "minimum": 0.0, "description": "Max concurrent in-flight requests; 0 = unlimited", "default": 0 } }, "type": "object", "required": [], "title": "RateLimitsResponse" }, "RateLimitsUpdateRequest": { "properties": { "requests_per_minute": { "type": [ "integer", "null" ] }, "concurrent_requests": { "type": [ "integer", "null" ] } }, "type": "object", "required": [], "title": "RateLimitsUpdateRequest" }, "ReadinessOutcome": { "type": "string", "enum": [ "ok", "unavailable" ], "title": "ReadinessOutcome", "description": "Overall readiness outcome" }, "ReadinessStatus": { "properties": { "status": { "$ref": "#/components/schemas/ReadinessOutcome" }, "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" ] }, "providers": { "description": "All tracked providers reachable (None if not configured)", "type": [ "boolean", "null" ] }, "telemetry": { "$ref": "#/components/schemas/TelemetryStatus" }, "version": { "type": "string", "description": "Application version" }, "uptime_seconds": { "type": "number", "minimum": 0.0, "description": "Seconds since startup" } }, "type": "object", "required": [ "status", "telemetry", "uptime_seconds", "version" ], "title": "ReadinessStatus" }, "RebalanceMode": { "type": "string", "enum": [ "none", "scale_existing", "reject_if_over" ], "title": "RebalanceMode", "description": "Budget rebalance strategy for existing departments", "default": "scale_existing" }, "RecommendedAction": { "properties": { "action_type": { "type": "string", "minLength": 1, "description": "Semantic action key" }, "label": { "type": "string", "minLength": 1, "description": "UI button text" }, "description": { "type": "string", "minLength": 1, "description": "Action explanation" }, "confirmation_required": { "type": "boolean", "description": "Whether to show a confirmation dialog", "default": false } }, "type": "object", "required": [ "action_type", "description", "label" ], "title": "RecommendedAction" }, "RedundancyRate": { "properties": { "value": { "type": "number", "maximum": 1.0, "minimum": 0.0, "description": "Mean redundancy" }, "sample_count": { "type": "integer", "minimum": 0.0, "description": "Number of similarity samples" } }, "type": "object", "required": [ "sample_count", "value" ], "title": "RedundancyRate" }, "RegisterExperimentVariantRequest": { "properties": { "variant": { "type": "string", "minLength": 1, "description": "Variant name within the experiment" }, "weight": { "type": "integer", "maximum": 1000.0, "minimum": 1.0, "description": "Relative selection weight" }, "description": { "type": "string", "description": "Operator notes", "default": "" } }, "type": "object", "required": [ "variant", "weight" ], "title": "RegisterExperimentVariantRequest" }, "RejectDecision": { "properties": { "type": { "type": "string", "const": "reject", "default": "reject" }, "reasoning": { "type": "string", "maxLength": 4096, "minLength": 1 } }, "type": "object", "required": [ "reasoning" ], "title": "RejectDecision" }, "RejectRequest": { "properties": { "reason": { "type": "string", "maxLength": 4096, "minLength": 1 } }, "type": "object", "required": [ "reason" ], "title": "RejectRequest" }, "RejectionPayload": { "properties": { "reason": { "type": "string", "minLength": 1, "description": "Reason for rejection" } }, "type": "object", "required": [ "reason" ], "title": "RejectionPayload" }, "RemoveAllowlistEntryRequest": { "properties": { "host_port": { "type": "string", "maxLength": 256, "minLength": 1 } }, "type": "object", "required": [ "host_port" ], "title": "RemoveAllowlistEntryRequest" }, "ReorderAgentsRequest": { "properties": { "agent_names": { "items": { "type": "string", "minLength": 1 }, "type": "array", "minItems": 1 } }, "type": "object", "required": [ "agent_names" ], "title": "ReorderAgentsRequest" }, "ReorderDepartmentsRequest": { "properties": { "department_names": { "items": { "type": "string", "minLength": 1 }, "type": "array", "minItems": 1 } }, "type": "object", "required": [ "department_names" ], "title": "ReorderDepartmentsRequest" }, "ReorderTeamsRequest": { "properties": { "team_names": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Ordered team names" } }, "type": "object", "required": [ "team_names" ], "title": "ReorderTeamsRequest" }, "ReplaySeekView": { "properties": { "execution_id": { "type": "string", "minLength": 1, "description": "Execution being replayed" }, "turn_index": { "type": "integer", "minimum": 1.0, "description": "Target turn index" }, "frames": { "items": { "$ref": "#/components/schemas/FlightRecorderFrame" }, "type": "array", "description": "Frames ascending up to ``turn_index``; windowed to the most recent ``_MAX_SEEK_FRAMES`` turns when ``truncated`` is True", "default": [] }, "current_frame": { "description": "Frame at turn_index, when recorded", "anyOf": [ { "$ref": "#/components/schemas/FlightRecorderFrame" }, { "type": "null" } ] }, "cumulative_cost": { "type": "number", "minimum": 0.0, "description": "Summed cost across every turn up to and including ``turn_index``; uses an unbounded SQL aggregate so it stays accurate when ``frames`` is windowed", "default": 0.0 }, "truncated": { "type": "boolean", "description": "True when the run exceeded ``_MAX_SEEK_FRAMES`` and the returned ``frames`` are a windowed tail rather than the full prefix; callers should surface this to operators so a partial scrubber reconstruction is never silent", "default": false } }, "type": "object", "required": [ "execution_id", "turn_index" ], "title": "ReplaySeekView" }, "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" }, "RequestStatus": { "type": "string", "enum": [ "submitted", "triaging", "scoping", "approved", "task_created", "cancelled" ], "title": "RequestStatus", "description": "Current intake pipeline status", "default": "submitted" }, "ResilienceConfig": { "properties": { "enabled": { "type": "boolean", "default": true }, "weight": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.2 }, "success_rate_enabled": { "type": "boolean", "default": true }, "recovery_rate_enabled": { "type": "boolean", "default": true }, "consistency_enabled": { "type": "boolean", "default": true }, "streak_enabled": { "type": "boolean", "default": true }, "success_rate_weight": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.4 }, "recovery_rate_weight": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.25 }, "consistency_weight": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.2 }, "streak_weight": { "type": "number", "maximum": 1.0, "minimum": 0.0, "default": 0.15 }, "streak_factor": { "type": "number", "exclusiveMinimum": 0.0, "default": 1.0 }, "consistency_k": { "type": "number", "exclusiveMinimum": 0.0, "default": 2.0 } }, "type": "object", "required": [], "title": "ResilienceConfig" }, "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" }, "ResumeDecision": { "type": "string", "enum": [ "approve", "reject", "revise" ], "title": "ResumeDecision", "description": "Human decision for a tool approval interrupt.\n\nMembers:\n APPROVE: Allow the tool execution to proceed.\n REJECT: Deny the tool execution.\n REVISE: Request changes before re-attempting.\n" }, "ResumeInterruptRequest": { "properties": { "decision": { "description": "Approval decision (TOOL_APPROVAL only)", "type": [ "string", "null" ], "enum": [ "approve", "reject", "revise", null ] }, "feedback": { "description": "Feedback text (TOOL_APPROVAL only)", "minLength": 1, "type": [ "string", "null" ] }, "response": { "description": "Clarification response (INFO_REQUEST only)", "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [], "title": "ResumeInterruptRequest" }, "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" }, "ReviewStageResult": { "properties": { "stage_name": { "type": "string", "minLength": 1, "description": "Identifier of the review stage" }, "verdict": { "$ref": "#/components/schemas/ReviewVerdict" }, "reason": { "description": "Explanation for the verdict", "minLength": 1, "type": [ "string", "null" ] }, "duration_ms": { "type": "integer", "minimum": 0.0, "description": "Stage execution duration in milliseconds", "default": 0 }, "metadata": { "additionalProperties": {}, "type": "object", "description": "Additional stage-specific metadata" } }, "type": "object", "required": [ "stage_name", "verdict" ], "title": "ReviewStageResult" }, "ReviewVerdict": { "type": "string", "enum": [ "pass", "fail", "skip" ], "title": "ReviewVerdict", "description": "Overriding verdict" }, "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" }, "RiskClassifierConfig": { "properties": { "kind": { "$ref": "#/components/schemas/RiskClassifierType" }, "custom_map": { "additionalProperties": { "$ref": "#/components/schemas/ApprovalRiskLevel" }, "type": "object" }, "workload_threshold": { "type": "integer", "minimum": 1.0, "default": 10 }, "operator_map": { "additionalProperties": { "$ref": "#/components/schemas/ApprovalRiskLevel" }, "type": "object" }, "off_hours_start_hour": { "type": "integer", "maximum": 23.0, "minimum": 0.0, "default": 20 }, "off_hours_end_hour": { "type": "integer", "maximum": 23.0, "minimum": 0.0, "default": 6 }, "weekend_elevation": { "type": "boolean", "default": true } }, "type": "object", "required": [], "title": "RiskClassifierConfig", "description": "Risk-tier-classifier plugin selection. Default-constructed (kind=DEFAULT) is byte-identical with the pre-plugin static classifier." }, "RiskClassifierType": { "type": "string", "enum": [ "default", "workload_adaptive", "operator_configurable", "time_based" ], "title": "RiskClassifierType", "description": "Discriminator selecting the risk-tier-classifier composition.\n\n- ``DEFAULT`` -- the static action-type -> risk map; unknown\n types fail safe to HIGH.\n- ``WORKLOAD_ADAPTIVE`` -- wraps a base classifier and elevates one\n tier when an injected in-flight probe exceeds a threshold.\n- ``OPERATOR_CONFIGURABLE`` -- an operator-defined\n action-type -> tier map; unknown types fail safe to HIGH.\n- ``TIME_BASED`` -- elevates one tier during configured off-hours /\n weekend windows (uses the ``Clock`` seam).\n", "default": "default" }, "RiskTolerance": { "type": "string", "enum": [ "low", "medium", "high" ], "title": "RiskTolerance", "description": "Risk tolerance level", "default": "medium" }, "Role": { "properties": { "name": { "type": "string", "minLength": 1, "description": "Role name" }, "department": { "$ref": "#/components/schemas/DepartmentName" }, "required_skills": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Skills required for this role", "default": [] }, "authority_level": { "$ref": "#/components/schemas/SeniorityLevel" }, "tool_access": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Tools available to this role", "default": [] }, "system_prompt_template": { "description": "Template file for system prompt", "minLength": 1, "type": [ "string", "null" ] }, "description": { "type": "string", "description": "Human-readable description", "default": "" } }, "type": "object", "required": [ "department", "name" ], "title": "Role", "description": "Full frozen entity model at this version" }, "RollbackAgentIdentityRequest": { "properties": { "target_version": { "type": "integer", "minimum": 1.0, "description": "Snapshot version to rollback to" }, "reason": { "description": "Optional rollback justification for the audit trail", "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [ "target_version" ], "title": "RollbackAgentIdentityRequest" }, "RollbackWorkflowRequest": { "properties": { "target_version": { "type": "integer", "minimum": 1.0, "description": "Snapshot version to rollback to" }, "expected_revision": { "type": "integer", "minimum": 1.0, "description": "Optimistic concurrency guard on the definition revision" } }, "type": "object", "required": [ "expected_revision", "target_version" ], "title": "RollbackWorkflowRequest" }, "RuleSeverity": { "type": "string", "enum": [ "info", "warning", "critical" ], "title": "RuleSeverity", "description": "Severity assigned to matches for downstream routing." }, "SatisfactionHistory": { "properties": { "client_id": { "type": "string", "minLength": 1, "description": "Client identifier" }, "total_reviews": { "type": "integer", "minimum": 0.0, "description": "Total number of feedback reviews." }, "acceptance_rate": { "type": "number", "maximum": 1.0, "minimum": 0.0, "description": "Fraction of reviewed tasks accepted (0.0-1.0)." }, "average_score": { "type": "number", "maximum": 1.0, "minimum": 0.0, "description": "Mean satisfaction score across reviews (0.0-1.0)." }, "history": { "items": { "$ref": "#/components/schemas/SatisfactionPoint" }, "type": "array", "description": "Chronological satisfaction data points.", "default": [] } }, "type": "object", "required": [ "acceptance_rate", "average_score", "client_id", "total_reviews" ], "title": "SatisfactionHistory" }, "SatisfactionPoint": { "properties": { "feedback_id": { "type": "string", "minLength": 1, "description": "Feedback identifier" }, "task_id": { "type": "string", "minLength": 1, "description": "Reviewed task id" }, "accepted": { "type": "boolean", "description": "Whether the task was accepted" }, "score": { "type": "number", "maximum": 1.0, "minimum": 0.0, "description": "Derived satisfaction score (0.0-1.0)" }, "created_at": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" } }, "type": "object", "required": [ "accepted", "created_at", "feedback_id", "score", "task_id" ], "title": "SatisfactionPoint" }, "ScalingDecisionResponse": { "properties": { "id": { "type": "string", "minLength": 1, "description": "Decision identifier" }, "action_type": { "type": "string", "minLength": 1, "description": "Action type" }, "source_strategy": { "type": "string", "minLength": 1, "description": "Strategy that proposed this" }, "target_agent_id": { "description": "Agent targeted for pruning", "minLength": 1, "type": [ "string", "null" ] }, "target_role": { "description": "Role to hire for", "minLength": 1, "type": [ "string", "null" ] }, "target_skills": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Skills required for the hire target", "default": [] }, "target_department": { "description": "Department for the hire target", "minLength": 1, "type": [ "string", "null" ] }, "rationale": { "type": "string", "description": "Decision rationale" }, "confidence": { "type": "number", "description": "Strategy confidence" }, "signals": { "items": { "$ref": "#/components/schemas/ScalingSignalResponse" }, "type": "array", "description": "Signals that informed the decision", "default": [] }, "created_at": { "type": "string", "minLength": 1, "description": "ISO timestamp" } }, "type": "object", "required": [ "action_type", "confidence", "created_at", "id", "rationale", "source_strategy" ], "title": "ScalingDecisionResponse" }, "ScalingSignalResponse": { "properties": { "name": { "type": "string", "minLength": 1, "description": "Signal name" }, "value": { "type": "number", "description": "Current value" }, "source": { "type": "string", "minLength": 1, "description": "Signal source" }, "threshold": { "description": "Configured threshold for this signal", "type": [ "number", "null" ] }, "timestamp": { "type": "string", "minLength": 1, "description": "ISO timestamp when collected" } }, "type": "object", "required": [ "name", "source", "timestamp", "value" ], "title": "ScalingSignalResponse" }, "ScalingStrategyResponse": { "properties": { "name": { "type": "string", "minLength": 1, "description": "Strategy identifier" }, "enabled": { "type": "boolean", "description": "Whether this strategy is active" }, "priority": { "type": "integer", "minimum": 0.0, "description": "Priority rank" } }, "type": "object", "required": [ "enabled", "name", "priority" ], "title": "ScalingStrategyResponse" }, "ScopeBoundaries": { "properties": { "in_scope": { "items": { "type": "string", "minLength": 1 }, "type": "array", "default": [] }, "out_of_scope": { "items": { "type": "string", "minLength": 1 }, "type": "array", "default": [] } }, "type": "object", "required": [], "title": "ScopeBoundaries" }, "ScopingPayload": { "properties": { "notes": { "type": "string", "minLength": 1, "description": "Scoping notes from the reviewer" }, "refined_title": { "minLength": 1, "type": [ "string", "null" ] }, "refined_description": { "minLength": 1, "type": [ "string", "null" ] }, "refined_acceptance_criteria": { "items": { "type": "string", "minLength": 1 }, "type": [ "array", "null" ] } }, "type": "object", "required": [ "notes" ], "title": "ScopingPayload" }, "SecretRef": { "properties": { "secret_id": { "type": "string", "minLength": 1 }, "backend": { "type": "string", "minLength": 1 }, "key_version": { "type": "integer", "minimum": 1.0, "default": 1 } }, "type": "object", "required": [ "backend", "secret_id" ], "title": "SecretRef" }, "SecurityConfigExportResponse": { "properties": { "config": { "additionalProperties": {}, "type": "object" }, "exported_at": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" }, "custom_policies_warning": { "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [ "config", "exported_at" ], "title": "SecurityConfigExportResponse" }, "SecurityConfigImportRequest": { "properties": { "config": { "additionalProperties": {}, "type": "object" } }, "type": "object", "required": [ "config" ], "title": "SecurityConfigImportRequest" }, "SeniorityLevel": { "type": "string", "enum": [ "junior", "mid", "senior", "lead", "principal", "director", "vp", "c_suite" ], "title": "SeniorityLevel", "description": "Seniority level", "default": "mid" }, "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 }, "read_only_post_init": { "type": "boolean", "description": "Sourced from environment at startup; mutation via SettingsService is rejected. Implies restart_required=True.", "default": false }, "env_var_override": { "description": "Override the auto-derived ``SYNTHORG_{NAMESPACE}_{KEY}`` env var name with a custom one (e.g. ``SYNTHORG_LOG_DIR`` for ``observability.log_directory``). Used when an established operator-facing env var name predates the auto-derivation rule. When set, the resolver looks up *only* this name; the auto-derived name is not consulted.", "minLength": 1, "type": [ "string", "null" ] }, "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" ] } }, "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", "client", "company", "providers", "memory", "budget", "security", "coordination", "observability", "backup", "engine", "communication", "a2a", "integrations", "meta", "notifications", "objectives", "simulations", "tools", "settings", "hr", "workers", "telemetry", "external_api", "research", "cockpit", "charter" ], "title": "SettingNamespace", "description": "Setting namespace" }, "SettingSource": { "type": "string", "enum": [ "db", "env", "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, "examples": [ "Alice Lin", "Bob Chen" ] }, "role": { "type": "string", "maxLength": 100, "minLength": 1, "examples": [ "CEO", "Engineer", "Designer" ] }, "level": { "$ref": "#/components/schemas/SeniorityLevel" }, "personality_preset": { "type": "string", "maxLength": 100, "minLength": 1, "default": "pragmatic_builder", "examples": [ "pragmatic_builder", "visionary_leader" ] }, "model_provider": { "type": "string", "maxLength": 100, "minLength": 1, "examples": [ "example-provider" ] }, "model_id": { "type": "string", "maxLength": 200, "minLength": 1, "examples": [ "example-medium-001", "example-large-001" ] }, "department": { "type": "string", "maxLength": 100, "minLength": 1, "default": "engineering", "examples": [ "engineering", "design", "operations" ] }, "budget_limit_monthly": { "maximum": 1000000.0, "examples": [ 100.0, 500.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 ] }, "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" }, "SetupCompanyRequest": { "properties": { "company_name": { "type": "string", "maxLength": 200, "minLength": 1, "examples": [ "Hooli", "Pied Piper" ] }, "description": { "maxLength": 1000, "examples": [ "Boutique consultancy specializing in agentic ops" ], "type": [ "string", "null" ] }, "template_name": { "maxLength": 100, "examples": [ "consulting-firm", "blank" ], "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.\n\nReturns:\n Resulting integer.", "readOnly": true } }, "type": "object", "required": [ "agent_count", "company_name", "department_count" ], "title": "SetupCompanyResponse" }, "SetupCompleteResponse": { "properties": { "setup_complete": { "type": "boolean", "const": true }, "embedder_selected": { "type": "boolean", "default": true }, "embedder_failure_reason": { "type": [ "string", "null" ] } }, "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" }, "SimulationConfig": { "properties": { "simulation_id": { "type": "string", "minLength": 1, "description": "Unique simulation identifier" }, "project_id": { "type": "string", "minLength": 1, "description": "Project to simulate against" }, "rounds": { "type": "integer", "exclusiveMinimum": 0.0, "description": "Number of simulation rounds", "default": 1 }, "clients_per_round": { "type": "integer", "exclusiveMinimum": 0.0, "description": "Clients participating per round", "default": 5 }, "requirements_per_client": { "type": "integer", "exclusiveMinimum": 0.0, "description": "Requirements each client generates per round", "default": 1 } }, "type": "object", "required": [ "project_id" ], "title": "SimulationConfig" }, "SimulationMetrics": { "properties": { "total_requirements": { "type": "integer", "minimum": 0.0, "default": 0 }, "total_tasks_created": { "type": "integer", "minimum": 0.0, "default": 0 }, "tasks_accepted": { "type": "integer", "minimum": 0.0, "default": 0 }, "tasks_rejected": { "type": "integer", "minimum": 0.0, "default": 0 }, "tasks_reworked": { "type": "integer", "minimum": 0.0, "default": 0 }, "avg_review_rounds": { "type": "number", "minimum": 0.0, "default": 0.0 }, "round_metrics": { "items": { "additionalProperties": {}, "type": "object" }, "type": "array", "description": "Per-round metric snapshots", "default": [] }, "acceptance_rate": { "type": "number", "description": "Proportion of accepted tasks (0.0-1.0)", "readOnly": true }, "rework_rate": { "type": "number", "description": "Proportion of reworked tasks (0.0-1.0)", "readOnly": true } }, "type": "object", "required": [ "acceptance_rate", "rework_rate" ], "title": "SimulationMetrics" }, "SimulationStatusResponse": { "properties": { "simulation_id": { "type": "string", "minLength": 1 }, "status": { "type": "string", "minLength": 1 }, "config": { "$ref": "#/components/schemas/SimulationConfig" }, "metrics": { "$ref": "#/components/schemas/SimulationMetrics" }, "progress": { "type": "number", "maximum": 1.0, "minimum": 0.0 }, "started_at": { "format": "date-time", "description": "datetime with the constraint that the value must have timezone info", "type": [ "string", "null" ] }, "completed_at": { "format": "date-time", "description": "datetime with the constraint that the value must have timezone info", "type": [ "string", "null" ] }, "error": { "type": [ "string", "null" ] } }, "type": "object", "required": [ "config", "metrics", "progress", "simulation_id", "status" ], "title": "SimulationStatusResponse" }, "SinkInfoResponse": { "properties": { "identifier": { "type": "string", "minLength": 1 }, "sink_type": { "type": "string", "minLength": 1 }, "level": { "type": "string", "minLength": 1 }, "json_format": { "type": "boolean" }, "rotation": { "anyOf": [ { "$ref": "#/components/schemas/SinkRotationResponse" }, { "type": "null" } ] }, "is_default": { "type": "boolean" }, "enabled": { "type": "boolean" }, "routing_prefixes": { "items": { "type": "string" }, "type": "array", "default": [] } }, "type": "object", "required": [ "enabled", "identifier", "is_default", "json_format", "level", "sink_type" ], "title": "SinkInfoResponse" }, "SinkRotationResponse": { "properties": { "strategy": { "type": "string", "minLength": 1 }, "max_bytes": { "type": "integer", "minimum": 0.0 }, "backup_count": { "type": "integer", "minimum": 0.0 } }, "type": "object", "required": [ "backup_count", "max_bytes", "strategy" ], "title": "SinkRotationResponse" }, "Skill": { "properties": { "id": { "type": "string", "minLength": 1, "description": "Unique skill identifier" }, "name": { "type": "string", "minLength": 1, "description": "Human-readable display name" }, "description": { "type": "string", "description": "Capability description for semantic matching", "default": "" }, "tags": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Searchable tags for multi-faceted routing", "default": [] }, "input_modes": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "MIME types the agent accepts for this skill", "default": [ "text/plain" ] }, "output_modes": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "MIME types the agent produces for this skill", "default": [ "text/plain" ] }, "proficiency": { "type": "number", "maximum": 1.0, "minimum": 0.0, "description": "Proficiency level in [0.0, 1.0]", "default": 1.0 } }, "type": "object", "required": [ "id", "name" ], "title": "Skill" }, "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" }, "SkillSet": { "properties": { "primary": { "items": { "$ref": "#/components/schemas/Skill" }, "type": "array", "description": "Primary skills", "default": [] }, "secondary": { "items": { "$ref": "#/components/schemas/Skill" }, "type": "array", "description": "Secondary skills", "default": [] } }, "type": "object", "required": [], "title": "SkillSet", "description": "Skill set" }, "SourceStatus": { "type": "string", "enum": [ "pending", "indexed", "stale", "failed" ], "title": "SourceStatus", "description": "Ingestion lifecycle state" }, "SourceType": { "type": "string", "enum": [ "pdf", "web", "repo", "ticket", "design_doc" ], "title": "SourceType", "description": "Source origin" }, "StageDecisionPayload": { "properties": { "verdict": { "$ref": "#/components/schemas/ReviewVerdict" }, "reason": { "description": "Rationale for the decision", "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [ "verdict" ], "title": "StageDecisionPayload" }, "StageDecisionResult": { "properties": { "task_id": { "type": "string", "minLength": 1 }, "stage_name": { "type": "string", "minLength": 1 }, "stage_result": { "$ref": "#/components/schemas/ReviewStageResult" }, "pipeline_result": { "$ref": "#/components/schemas/PipelineResult" } }, "type": "object", "required": [ "pipeline_result", "stage_name", "stage_result", "task_id" ], "title": "StageDecisionResult" }, "Stakes": { "type": "string", "enum": [ "low", "normal", "high", "critical" ], "title": "Stakes", "description": "How consequential this task is, driving stakes-aware model routing (cheap model for low stakes, strong model plus red-team for high/critical stakes)", "default": "normal" }, "StartSimulationPayload": { "properties": { "config": { "$ref": "#/components/schemas/SimulationConfig" } }, "type": "object", "required": [ "config" ], "title": "StartSimulationPayload" }, "SteerInterventionRequest": { "properties": { "execution_id": { "type": "string", "minLength": 1, "description": "Execution to steer" }, "agent_id": { "type": "string", "minLength": 1, "description": "Agent to steer" }, "text": { "type": "string", "minLength": 1, "description": "Operator hint / redirect text" } }, "type": "object", "required": [ "agent_id", "execution_id", "text" ], "title": "SteerInterventionRequest" }, "SteeringOutcome": { "properties": { "kind": { "$ref": "#/components/schemas/InterventionKind" }, "applied": { "type": "boolean", "description": "Whether the directive was delivered" }, "artifact_id": { "description": "Interrupt id the directive produced, when applied", "minLength": 1, "type": [ "string", "null" ] }, "detail": { "type": "string", "description": "Human-readable outcome description" } }, "type": "object", "required": [ "applied", "detail", "kind" ], "title": "SteeringOutcome" }, "StragglerGap": { "properties": { "slowest_duration_seconds": { "type": "number", "minimum": 0.0, "description": "Slowest agent duration (seconds)" }, "mean_duration_seconds": { "type": "number", "exclusiveMinimum": 0.0, "description": "Mean agent duration (seconds)" }, "slowest_agent_id": { "type": "string", "minLength": 1, "description": "Identifier of the slowest agent" }, "gap_seconds": { "type": "number", "description": "Absolute gap (slowest - mean)", "readOnly": true }, "gap_ratio": { "type": "number", "description": "Relative gap (gap / mean)", "readOnly": true } }, "type": "object", "required": [ "gap_ratio", "gap_seconds", "mean_duration_seconds", "slowest_agent_id", "slowest_duration_seconds" ], "title": "StragglerGap" }, "StrategicOutputMode": { "type": "string", "enum": [ "option_expander", "advisor", "decision_maker", "context_dependent" ], "title": "StrategicOutputMode", "description": "Controls how strategic agents frame their recommendations.\n\nApplies to any agent with a strategic output mode set (C-suite, VP,\nDirector, or any agent with an explicit override).\n\n- ``option_expander``: Present all options with analysis through each lens.\n- ``advisor``: Recommend top 2-3 options with reasoning and caveats.\n- ``decision_maker``: Make a final recommendation with full justification.\n- ``context_dependent``: Resolves based on agent seniority -- C-suite/VP\n maps to ``decision_maker``, others to ``advisor``.\n" }, "StrategyUpdateRequest": { "properties": { "enabled": { "type": "boolean", "description": "Whether the strategy should be active" } }, "type": "object", "required": [ "enabled" ], "title": "StrategyUpdateRequest" }, "SubmitDecisionRequest": { "properties": { "decision": { "oneOf": [ { "$ref": "#/components/schemas/WinnerDecision" }, { "$ref": "#/components/schemas/RejectDecision" } ], "description": "Operator decision payload" } }, "type": "object", "required": [ "decision" ], "title": "SubmitDecisionRequest" }, "SubworkflowSummary": { "properties": { "subworkflow_id": { "type": "string", "minLength": 1, "description": "Stable identifier" }, "latest_version": { "type": "string", "minLength": 1, "description": "Latest semver" }, "name": { "type": "string", "minLength": 1, "description": "Name of the latest version" }, "description": { "type": "string", "description": "Description", "default": "" }, "input_count": { "type": "integer", "minimum": 0.0, "description": "Number of inputs" }, "output_count": { "type": "integer", "minimum": 0.0, "description": "Number of outputs" }, "version_count": { "type": "integer", "minimum": 1.0, "description": "Total versions" } }, "type": "object", "required": [ "input_count", "latest_version", "name", "output_count", "subworkflow_id", "version_count" ], "title": "SubworkflowSummary" }, "SyncModelsRequest": { "properties": { "replace_existing": { "type": "boolean", "description": "Replace persisted list (True) vs append-only merge (False)", "default": true }, "preset_hint": { "description": "Optional preset hint for discovery shape", "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [], "title": "SyncModelsRequest" }, "SyncModelsResponse": { "properties": { "added": { "items": { "type": "string", "minLength": 1 }, "type": "array" }, "removed": { "items": { "type": "string", "minLength": 1 }, "type": "array" }, "updated": { "items": { "type": "string", "minLength": 1 }, "type": "array" }, "models": { "items": { "$ref": "#/components/schemas/ProviderModelConfig" }, "type": "array" } }, "type": "object", "required": [ "added", "models", "removed", "updated" ], "title": "SyncModelsResponse" }, "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" }, "stakes": { "$ref": "#/components/schemas/Stakes" }, "budget_limit": { "type": "number", "minimum": 0.0, "description": "Maximum spend for this task in the configured 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" }, "source": { "description": "Origin of this task (internal, client, or simulation)", "type": [ "string", "null" ], "enum": [ "internal", "client", "simulation", null ] }, "middleware_override": { "description": "Per-task middleware chain override (None = use company default)", "items": { "type": "string", "minLength": 1 }, "type": [ "array", "null" ] }, "metadata": { "additionalProperties": {}, "type": "object", "description": "Arbitrary key-value metadata for pipeline tracking and labels" }, "hard_ceiling": { "description": "Per-run hard real-money ceiling in the configured currency. When the in-loop BudgetChecker observes accumulated_cost >= hard_ceiling it raises RunHardCeilingExceededError and the engine parks the context via ApprovalGate so the operator can raise the ceiling and resume. None falls back to the global budget.run_hard_ceiling setting.", "type": [ "number", "null" ] }, "forecast_id": { "description": "Identifier of the pre-flight cost Forecast row this task was dispatched against. The work-entry adapter sets this after the operator approves the forecast; the engine plumbs it onto the parked-context payload when a ceiling halt occurs so the resume UI can show the original estimate alongside the accumulated cost.", "format": "uuid", "type": [ "string", "null" ] } }, "type": "object", "required": [ "created_by", "description", "id", "project", "title", "type" ], "title": "Task" }, "TaskBoardSubmissionResponse": { "properties": { "correlation_id": { "type": "string", "minLength": 1, "description": "End-to-end trace id stamped onto the work item" }, "title": { "type": "string", "minLength": 1, "description": "Title submitted by the user" }, "project": { "type": "string", "minLength": 1, "description": "Project the task was filed into" }, "status": { "type": "string", "const": "submitted", "description": "Always 'submitted' for the 202 ack", "default": "submitted" } }, "type": "object", "required": [ "correlation_id", "project", "title" ], "title": "TaskBoardSubmissionResponse" }, "TaskRequirement": { "properties": { "title": { "type": "string", "minLength": 1, "description": "Short requirement title" }, "description": { "type": "string", "minLength": 1, "description": "Detailed requirement description" }, "task_type": { "$ref": "#/components/schemas/TaskType" }, "priority": { "$ref": "#/components/schemas/Priority" }, "estimated_complexity": { "$ref": "#/components/schemas/Complexity" }, "acceptance_criteria": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Criteria for task acceptance", "default": [] } }, "type": "object", "required": [ "description", "title" ], "title": "TaskRequirement", "description": "The task requirement being requested" }, "TaskSource": { "type": "string", "enum": [ "internal", "client", "simulation" ], "title": "TaskSource", "description": "Origin of a task within the system.\n\nDistinguishes tasks created internally by agents from those\noriginating from client simulation or external API calls.\n" }, "TaskStatus": { "type": "string", "enum": [ "created", "assigned", "in_progress", "in_review", "completed", "blocked", "failed", "interrupted", "suspended", "cancelled", "rejected", "auth_required" ], "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", "analysis" ], "title": "TaskType", "description": "Task work type", "default": "development" }, "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" }, "TeamResponse": { "properties": { "name": { "type": "string", "minLength": 1 }, "lead": { "type": "string", "minLength": 1 }, "members": { "items": { "type": "string", "minLength": 1 }, "type": "array" } }, "type": "object", "required": [ "lead", "members", "name" ], "title": "TeamResponse" }, "TelemetryStatus": { "type": "string", "enum": [ "enabled", "disabled" ], "title": "TelemetryStatus", "description": "Project telemetry delivery state" }, "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" }, "TerminalAccess": { "type": "string", "enum": [ "none", "restricted_commands", "full" ], "title": "TerminalAccess", "description": "Terminal command access level", "default": "restricted_commands" }, "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" }, "TextPart": { "properties": { "type": { "type": "string", "const": "text", "description": "Part type discriminator", "default": "text" }, "text": { "type": "string", "minLength": 1, "description": "Text content" } }, "type": "object", "required": [ "text" ], "title": "TextPart" }, "ThresholdRecommendation": { "properties": { "rule_name": { "type": "string", "minLength": 1 }, "metric_name": { "type": "string", "minLength": 1 }, "current_default": { "type": "number" }, "recommended_value": { "type": "number" }, "confidence": { "type": "number", "maximum": 1.0, "minimum": 0.0 }, "based_on_deployments": { "type": "integer", "minimum": 1.0 }, "based_on_observations": { "type": "integer", "minimum": 1.0 }, "rationale": { "type": "string", "minLength": 1 } }, "type": "object", "required": [ "based_on_deployments", "based_on_observations", "confidence", "current_default", "metric_name", "rationale", "recommended_value", "rule_name" ], "title": "ThresholdRecommendation" }, "TicketLocator": { "properties": { "locator_kind": { "type": "string", "const": "ticket", "default": "ticket" }, "ticket_id": { "type": "string", "minLength": 1, "description": "Ticket identifier" }, "comment_id": { "description": "Originating comment identifier, if any", "minLength": 1, "type": [ "string", "null" ] }, "char_start": { "type": "integer", "minimum": 0.0, "description": "Start offset within the comment text" }, "char_end": { "type": "integer", "minimum": 0.0, "description": "End offset within the comment text" } }, "type": "object", "required": [ "char_end", "char_start", "ticket_id" ], "title": "TicketLocator" }, "TierConfig": { "properties": { "timeout_minutes": { "type": "number", "exclusiveMinimum": 0.0, "description": "Minutes before the timeout action" }, "on_timeout": { "$ref": "#/components/schemas/TimeoutActionType" }, "actions": { "items": { "type": "string" }, "type": "array", "description": "Specific action types in this tier", "default": [] } }, "type": "object", "required": [ "timeout_minutes" ], "title": "TierConfig" }, "TieredTimeoutConfig": { "properties": { "policy": { "type": "string", "const": "tiered", "default": "tiered" }, "tiers": { "additionalProperties": { "$ref": "#/components/schemas/TierConfig" }, "type": "object", "description": "Tier configs keyed by risk level (low/medium/high/critical)" }, "risk_classifier": { "$ref": "#/components/schemas/RiskClassifierConfig" } }, "type": "object", "required": [], "title": "TieredTimeoutConfig" }, "TimeoutActionType": { "type": "string", "enum": [ "wait", "approve", "deny", "escalate" ], "title": "TimeoutActionType", "description": "Action when this tier times out", "default": "deny" }, "TokenSpeedupRatio": { "properties": { "token_multiplier": { "type": "number", "exclusiveMinimum": 0.0, "description": "Token cost multiplier (MAS / SAS)" }, "latency_speedup": { "type": "number", "exclusiveMinimum": 0.0, "description": "Latency speedup (SAS / MAS)" }, "ratio": { "type": "number", "description": "Token/speedup ratio", "readOnly": true }, "alert": { "type": "boolean", "description": "Alert when ratio exceeds the alert threshold", "readOnly": true } }, "type": "object", "required": [ "alert", "latency_speedup", "ratio", "token_multiplier" ], "title": "TokenSpeedupRatio" }, "ToolAccessLevel": { "type": "string", "enum": [ "sandboxed", "restricted", "standard", "elevated", "custom" ], "title": "ToolAccessLevel", "description": "Access level for tool permissions.\n\nDetermines which tool categories an agent can use.\nLevels ``SANDBOXED`` through ``ELEVATED`` form a hierarchy\nwhere each includes all categories from lower levels.\n``CUSTOM`` uses only explicit allow/deny lists, ignoring\nthe hierarchy.\n\nThe concrete category sets for each level are defined in\n``ToolPermissionChecker._LEVEL_CATEGORIES``.\n", "default": "standard" }, "ToolCategory": { "type": "string", "enum": [ "file_system", "code_execution", "version_control", "web", "database", "terminal", "design", "communication", "analytics", "deployment", "memory", "ontology", "mcp", "browser", "external_data", "desktop", "other" ], "title": "ToolCategory", "description": "Category of a tool for access-level gating." }, "ToolPermissions": { "properties": { "access_level": { "$ref": "#/components/schemas/ToolAccessLevel" }, "allowed": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Explicitly allowed tools", "default": [] }, "denied": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Explicitly denied tools", "default": [] }, "mcp_capabilities": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "MCP capability patterns (e.g. 'tasks:read', 'agents:*')", "default": [] }, "sub_constraints": { "description": "Per-agent sub-constraint overrides", "anyOf": [ { "$ref": "#/components/schemas/ToolSubConstraints" }, { "type": "null" } ] } }, "type": "object", "required": [], "title": "ToolPermissions", "description": "Tool permissions" }, "ToolSubConstraints": { "properties": { "file_system": { "$ref": "#/components/schemas/FileSystemScope" }, "network": { "$ref": "#/components/schemas/NetworkMode" }, "git": { "$ref": "#/components/schemas/GitAccess" }, "code_execution": { "$ref": "#/components/schemas/CodeExecutionIsolation" }, "terminal": { "$ref": "#/components/schemas/TerminalAccess" }, "requires_approval": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Action type prefixes requiring human approval", "default": [] }, "network_allowlist": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Allowed host:port pairs for allowlist_only network mode", "default": [] } }, "type": "object", "required": [], "title": "ToolSubConstraints" }, "TrainingPlanResponse": { "properties": { "id": { "type": "string", "minLength": 1 }, "new_agent_id": { "type": "string", "minLength": 1 }, "new_agent_role": { "type": "string", "minLength": 1 }, "source_selector_type": { "type": "string", "minLength": 1 }, "enabled_content_types": { "items": { "type": "string", "minLength": 1 }, "type": "array" }, "curation_strategy_type": { "type": "string", "minLength": 1 }, "volume_caps": { "items": { "prefixItems": [ { "type": "string", "minLength": 1 }, { "type": "integer" } ], "type": "array" }, "type": "array" }, "override_sources": { "items": { "type": "string", "minLength": 1 }, "type": "array" }, "skip_training": { "type": "boolean" }, "require_review": { "type": "boolean" }, "status": { "$ref": "#/components/schemas/TrainingPlanStatus" }, "created_at": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" }, "executed_at": { "format": "date-time", "description": "datetime with the constraint that the value must have timezone info", "type": [ "string", "null" ] } }, "type": "object", "required": [ "created_at", "curation_strategy_type", "enabled_content_types", "id", "new_agent_id", "new_agent_role", "override_sources", "require_review", "skip_training", "source_selector_type", "status", "volume_caps" ], "title": "TrainingPlanResponse" }, "TrainingPlanStatus": { "type": "string", "enum": [ "pending", "executed", "failed" ], "title": "TrainingPlanStatus", "description": "Lifecycle status of a training plan." }, "TrainingResultResponse": { "properties": { "id": { "type": "string", "minLength": 1 }, "plan_id": { "type": "string", "minLength": 1 }, "new_agent_id": { "type": "string", "minLength": 1 }, "source_agents_used": { "items": { "type": "string", "minLength": 1 }, "type": "array" }, "items_extracted": { "items": { "prefixItems": [ { "type": "string", "minLength": 1 }, { "type": "integer" } ], "type": "array" }, "type": "array" }, "items_after_curation": { "items": { "prefixItems": [ { "type": "string", "minLength": 1 }, { "type": "integer" } ], "type": "array" }, "type": "array" }, "items_after_guards": { "items": { "prefixItems": [ { "type": "string", "minLength": 1 }, { "type": "integer" } ], "type": "array" }, "type": "array" }, "items_stored": { "items": { "prefixItems": [ { "type": "string", "minLength": 1 }, { "type": "integer" } ], "type": "array" }, "type": "array" }, "approval_item_id": { "minLength": 1, "type": [ "string", "null" ] }, "pending_approvals": { "items": { "prefixItems": [ { "type": "string", "minLength": 1 }, { "type": "string", "minLength": 1 }, { "type": "integer" } ], "type": "array" }, "type": "array", "default": [] }, "review_pending": { "type": "boolean", "default": false }, "errors": { "items": { "type": "string" }, "type": "array", "default": [] }, "started_at": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" }, "completed_at": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" } }, "type": "object", "required": [ "completed_at", "id", "items_after_curation", "items_after_guards", "items_extracted", "items_stored", "new_agent_id", "plan_id", "source_agents_used", "started_at" ], "title": "TrainingResultResponse" }, "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": "Direction of a performance metric trend." }, "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" }, "TrustSummary": { "properties": { "level": { "$ref": "#/components/schemas/ToolAccessLevel" }, "score": { "maximum": 1.0, "type": [ "number", "null" ] }, "last_evaluated_at": { "format": "date-time", "description": "datetime with the constraint that the value must have timezone info", "type": [ "string", "null" ] } }, "type": "object", "required": [ "level" ], "title": "TrustSummary" }, "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" }, "UpdateAgentOrgRequest": { "properties": { "name": { "maxLength": 128, "minLength": 1, "type": [ "string", "null" ] }, "role": { "maxLength": 128, "minLength": 1, "type": [ "string", "null" ] }, "department": { "maxLength": 128, "minLength": 1, "type": [ "string", "null" ] }, "level": { "type": [ "string", "null" ], "enum": [ "junior", "mid", "senior", "lead", "principal", "director", "vp", "c_suite", null ] }, "autonomy_level": { "type": [ "string", "null" ], "enum": [ "full", "semi", "supervised", "locked", null ] }, "model_provider": { "minLength": 1, "type": [ "string", "null" ] }, "model_id": { "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [], "title": "UpdateAgentOrgRequest" }, "UpdateAgentPersonalityRequest": { "properties": { "personality_preset": { "type": "string", "maxLength": 100, "minLength": 1 } }, "type": "object", "required": [ "personality_preset" ], "title": "UpdateAgentPersonalityRequest" }, "UpdateClientRequest": { "properties": { "name": { "description": "Human-readable name.", "minLength": 1, "type": [ "string", "null" ] }, "persona": { "description": "Persona description.", "minLength": 1, "type": [ "string", "null" ] }, "expertise_domains": { "description": "Domains of expertise for the simulated client.", "items": { "type": "string", "minLength": 1 }, "type": [ "array", "null" ] }, "strictness_level": { "maximum": 1.0, "description": "Scoring strictness multiplier (0.0-1.0).", "type": [ "number", "null" ] } }, "type": "object", "required": [], "title": "UpdateClientRequest" }, "UpdateCompanyRequest": { "properties": { "company_name": { "description": "Display name of the company.", "minLength": 1, "type": [ "string", "null" ] }, "autonomy_level": { "description": "Org-wide autonomy level (full, semi, supervised, locked).", "type": [ "string", "null" ], "enum": [ "full", "semi", "supervised", "locked", null ] }, "budget_monthly": { "description": "Monthly budget cap for the company in the operator's configured currency; set to 0 to disable enforcement.", "type": [ "number", "null" ] }, "communication_pattern": { "description": "Communication strategy or pattern identifier.", "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [], "title": "UpdateCompanyRequest" }, "UpdateConnectionRequest": { "properties": { "base_url": { "minLength": 1, "type": [ "string", "null" ] }, "metadata": { "additionalProperties": { "type": "string" }, "type": [ "object", "null" ] }, "health_check_enabled": { "type": [ "boolean", "null" ] }, "webhook_receipt_retention_days": { "type": [ "integer", "null" ] }, "sensitive": { "type": [ "boolean", "null" ] } }, "type": "object", "required": [], "title": "UpdateConnectionRequest" }, "UpdateCustomRuleRequest": { "properties": { "name": { "minLength": 1, "type": [ "string", "null" ] }, "description": { "minLength": 1, "type": [ "string", "null" ] }, "metric_path": { "minLength": 1, "type": [ "string", "null" ] }, "comparator": { "type": [ "string", "null" ], "enum": [ "lt", "le", "gt", "ge", "eq", "ne", null ] }, "threshold": { "type": [ "number", "null" ] }, "severity": { "type": [ "string", "null" ], "enum": [ "info", "warning", "critical", null ] }, "target_altitudes": { "items": { "$ref": "#/components/schemas/ProposalAltitude" }, "type": [ "array", "null" ] } }, "type": "object", "required": [], "title": "UpdateCustomRuleRequest" }, "UpdateDepartmentRequest": { "properties": { "head": { "minLength": 1, "type": [ "string", "null" ] }, "budget_percent": { "maximum": 100.0, "type": [ "number", "null" ] }, "autonomy_level": { "type": [ "string", "null" ], "enum": [ "full", "semi", "supervised", "locked", null ] }, "teams": { "maxLength": 64, "items": { "$ref": "#/components/schemas/Team" }, "type": [ "array", "null" ] }, "ceremony_policy": { "additionalProperties": {}, "type": [ "object", "null" ] } }, "type": "object", "required": [], "title": "UpdateDepartmentRequest" }, "UpdateEntityRequest": { "properties": { "definition": { "maxLength": 4096, "description": "Updated description", "type": [ "string", "null" ] }, "fields": { "description": "Updated fields", "items": { "$ref": "#/components/schemas/EntityFieldInput" }, "type": [ "array", "null" ] }, "constraints": { "description": "Updated constraints", "items": { "type": "string" }, "type": [ "array", "null" ] }, "disambiguation": { "maxLength": 2048, "description": "Updated disambiguation", "type": [ "string", "null" ] }, "relationships": { "description": "Updated relationships", "items": { "$ref": "#/components/schemas/EntityRelationInput" }, "type": [ "array", "null" ] } }, "type": "object", "required": [], "title": "UpdateEntityRequest" }, "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 ] }, "api_key": { "minLength": 8, "type": [ "string", "null" ] }, "clear_api_key": { "type": "boolean", "default": false }, "subscription_token": { "minLength": 8, "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": 8, "type": [ "string", "null" ] }, "oauth_scope": { "minLength": 1, "type": [ "string", "null" ] }, "custom_header_name": { "minLength": 1, "type": [ "string", "null" ] }, "custom_header_value": { "minLength": 8, "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 ] }, "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" }, "UpdateTeamRequest": { "properties": { "name": { "description": "New team name (rename)", "minLength": 1, "type": [ "string", "null" ] }, "lead": { "description": "New team lead agent name", "minLength": 1, "type": [ "string", "null" ] }, "members": { "description": "Replacement member list", "items": { "type": "string", "minLength": 1 }, "type": [ "array", "null" ] } }, "type": "object", "required": [], "title": "UpdateTeamRequest" }, "UpdateTrainingOverridesRequest": { "properties": { "override_sources": { "description": "Updated source agent IDs", "items": { "type": "string", "minLength": 1 }, "type": [ "array", "null" ] }, "custom_caps": { "description": "Updated per-content-type caps (positive integers)", "additionalProperties": { "type": "integer", "exclusiveMinimum": 0.0 }, "type": [ "object", "null" ] }, "content_types": { "description": "Updated enabled content types", "items": { "$ref": "#/components/schemas/ContentType" }, "type": [ "array", "null" ] }, "skip_training": { "description": "Updated skip_training flag", "type": [ "boolean", "null" ] } }, "type": "object", "required": [], "title": "UpdateTrainingOverridesRequest" }, "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 ] }, "version": { "maxLength": 64, "description": "Semver string override", "minLength": 1, "type": [ "string", "null" ] }, "inputs": { "maxLength": 100, "items": { "$ref": "#/components/schemas/WorkflowIODeclarationRequest" }, "type": [ "array", "null" ] }, "outputs": { "maxLength": 100, "items": { "$ref": "#/components/schemas/WorkflowIODeclarationRequest" }, "type": [ "array", "null" ] }, "is_subworkflow": { "type": [ "boolean", "null" ] }, "nodes": { "maxLength": 500, "items": { "additionalProperties": {}, "type": "object" }, "type": [ "array", "null" ] }, "edges": { "maxLength": 1000, "items": { "additionalProperties": {}, "type": "object" }, "type": [ "array", "null" ] }, "expected_revision": { "minimum": 1, "description": "Optimistic concurrency guard (revision counter)", "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" }, "UriPart": { "properties": { "type": { "type": "string", "const": "uri", "description": "Part type discriminator", "default": "uri" }, "uri": { "type": "string", "minLength": 1, "description": "URI or URL" } }, "type": "object", "required": [ "uri" ], "title": "UriPart" }, "UserInfoResponse": { "properties": { "id": { "type": "string", "minLength": 1 }, "username": { "type": "string", "minLength": 1 }, "role": { "$ref": "#/components/schemas/HumanRole" }, "must_change_password": { "type": "boolean" }, "org_roles": { "items": { "type": "string", "minLength": 1 }, "type": "array", "default": [] }, "scoped_departments": { "items": { "type": "string", "minLength": 1 }, "type": "array", "default": [] } }, "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" }, "org_roles": { "items": { "type": "string" }, "type": "array", "default": [] }, "scoped_departments": { "items": { "type": "string" }, "type": "array", "default": [] }, "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", "subworkflow_ref_missing", "subworkflow_version_unpinned", "subworkflow_not_found", "subworkflow_input_missing", "subworkflow_input_unknown", "subworkflow_input_type_mismatch", "subworkflow_output_missing", "subworkflow_output_unknown", "subworkflow_output_type_mismatch", "subworkflow_cycle_detected", "verification_missing_pass", "verification_missing_fail", "verification_missing_refer", "verification_duplicate_edge", "verification_extra_outgoing", "verification_edge_outside", "verification_missing_config" ], "title": "ValidationErrorCode", "description": "Error code" }, "VersionSnapshot_AgentIdentity_": { "properties": { "entity_id": { "type": "string", "minLength": 1, "description": "String primary key of the entity" }, "version": { "type": "integer", "minimum": 1.0, "description": "Monotonic version counter (1-indexed)" }, "content_hash": { "type": "string", "minLength": 1, "description": "SHA-256 hex digest of canonical JSON" }, "snapshot": { "$ref": "#/components/schemas/AgentIdentity" }, "saved_by": { "type": "string", "minLength": 1, "description": "Actor that triggered the snapshot" }, "saved_at": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" } }, "type": "object", "required": [ "content_hash", "entity_id", "saved_at", "saved_by", "snapshot", "version" ], "title": "VersionSnapshot[AgentIdentity]" }, "VersionSnapshot_BudgetConfig_": { "properties": { "entity_id": { "type": "string", "minLength": 1, "description": "String primary key of the entity" }, "version": { "type": "integer", "minimum": 1.0, "description": "Monotonic version counter (1-indexed)" }, "content_hash": { "type": "string", "minLength": 1, "description": "SHA-256 hex digest of canonical JSON" }, "snapshot": { "$ref": "#/components/schemas/BudgetConfig" }, "saved_by": { "type": "string", "minLength": 1, "description": "Actor that triggered the snapshot" }, "saved_at": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" } }, "type": "object", "required": [ "content_hash", "entity_id", "saved_at", "saved_by", "snapshot", "version" ], "title": "VersionSnapshot[BudgetConfig]" }, "VersionSnapshot_Company_": { "properties": { "entity_id": { "type": "string", "minLength": 1, "description": "String primary key of the entity" }, "version": { "type": "integer", "minimum": 1.0, "description": "Monotonic version counter (1-indexed)" }, "content_hash": { "type": "string", "minLength": 1, "description": "SHA-256 hex digest of canonical JSON" }, "snapshot": { "$ref": "#/components/schemas/Company" }, "saved_by": { "type": "string", "minLength": 1, "description": "Actor that triggered the snapshot" }, "saved_at": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" } }, "type": "object", "required": [ "content_hash", "entity_id", "saved_at", "saved_by", "snapshot", "version" ], "title": "VersionSnapshot[Company]" }, "VersionSnapshot_EvaluationConfig_": { "properties": { "entity_id": { "type": "string", "minLength": 1, "description": "String primary key of the entity" }, "version": { "type": "integer", "minimum": 1.0, "description": "Monotonic version counter (1-indexed)" }, "content_hash": { "type": "string", "minLength": 1, "description": "SHA-256 hex digest of canonical JSON" }, "snapshot": { "$ref": "#/components/schemas/EvaluationConfig" }, "saved_by": { "type": "string", "minLength": 1, "description": "Actor that triggered the snapshot" }, "saved_at": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" } }, "type": "object", "required": [ "content_hash", "entity_id", "saved_at", "saved_by", "snapshot", "version" ], "title": "VersionSnapshot[EvaluationConfig]" }, "VersionSnapshot_Role_": { "properties": { "entity_id": { "type": "string", "minLength": 1, "description": "String primary key of the entity" }, "version": { "type": "integer", "minimum": 1.0, "description": "Monotonic version counter (1-indexed)" }, "content_hash": { "type": "string", "minLength": 1, "description": "SHA-256 hex digest of canonical JSON" }, "snapshot": { "$ref": "#/components/schemas/Role" }, "saved_by": { "type": "string", "minLength": 1, "description": "Actor that triggered the snapshot" }, "saved_at": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" } }, "type": "object", "required": [ "content_hash", "entity_id", "saved_at", "saved_by", "snapshot", "version" ], "title": "VersionSnapshot[Role]" }, "VersionSnapshot_WorkflowDefinition_": { "properties": { "entity_id": { "type": "string", "minLength": 1, "description": "String primary key of the entity" }, "version": { "type": "integer", "minimum": 1.0, "description": "Monotonic version counter (1-indexed)" }, "content_hash": { "type": "string", "minLength": 1, "description": "SHA-256 hex digest of canonical JSON" }, "snapshot": { "$ref": "#/components/schemas/WorkflowDefinition" }, "saved_by": { "type": "string", "minLength": 1, "description": "Actor that triggered the snapshot" }, "saved_at": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" } }, "type": "object", "required": [ "content_hash", "entity_id", "saved_at", "saved_by", "snapshot", "version" ], "title": "VersionSnapshot[WorkflowDefinition]" }, "WaitForeverConfig": { "properties": { "policy": { "type": "string", "const": "wait", "default": "wait" } }, "type": "object", "required": [], "title": "WaitForeverConfig" }, "WebLocator": { "properties": { "locator_kind": { "type": "string", "const": "web", "default": "web" }, "url": { "type": "string", "minLength": 1, "description": "Source page URL" }, "css_path": { "description": "Optional CSS path of the containing element", "minLength": 1, "type": [ "string", "null" ] }, "char_start": { "type": "integer", "minimum": 0.0, "description": "Start offset within extracted text" }, "char_end": { "type": "integer", "minimum": 0.0, "description": "End offset within extracted text" } }, "type": "object", "required": [ "char_end", "char_start", "url" ], "title": "WebLocator" }, "WebhookReceipt": { "properties": { "id": { "type": "string", "minLength": 1 }, "connection_name": { "type": "string", "minLength": 1 }, "event_type": { "type": "string", "default": "" }, "status": { "type": "string", "default": "received" }, "received_at": { "type": "string", "format": "date-time", "description": "datetime with the constraint that the value must have timezone info" }, "processed_at": { "format": "date-time", "description": "datetime with the constraint that the value must have timezone info", "type": [ "string", "null" ] }, "payload_json": { "type": "string", "default": "" }, "error": { "type": [ "string", "null" ] } }, "type": "object", "required": [ "connection_name" ], "title": "WebhookReceipt" }, "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, denominated in ``currency``", "type": [ "number", "null" ] }, "currency": { "description": "ISO 4217 currency code for ``avg_cost_per_task``; ``None`` when ``avg_cost_per_task`` is ``None``", "maxLength": 3, "minLength": 3, "type": [ "string", "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" }, "WinnerDecision": { "properties": { "type": { "type": "string", "const": "winner", "default": "winner" }, "winning_agent_id": { "type": "string", "minLength": 1 }, "reasoning": { "type": "string", "maxLength": 4096, "minLength": 1 } }, "type": "object", "required": [ "reasoning", "winning_agent_id" ], "title": "WinnerDecision" }, "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" }, "version": { "type": "string", "minLength": 1, "description": "Semver version string (MAJOR.MINOR.PATCH)", "default": "1.0.0" }, "inputs": { "items": { "$ref": "#/components/schemas/WorkflowIODeclaration" }, "type": "array", "description": "Typed input contract (subworkflow-facing)", "default": [] }, "outputs": { "items": { "$ref": "#/components/schemas/WorkflowIODeclaration" }, "type": "array", "description": "Typed output contract (subworkflow-facing)", "default": [] }, "is_subworkflow": { "type": "boolean", "description": "Whether this definition is published to the registry", "default": false }, "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)" }, "revision": { "type": "integer", "minimum": 1.0, "description": "Optimistic concurrency counter", "default": 1 } }, "type": "object", "required": [ "created_by", "id", "name" ], "title": "WorkflowDefinition" }, "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", "verification_pass", "verification_fail", "verification_refer" ], "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_revision": { "type": "integer", "minimum": 1.0, "description": "Definition revision (optimistic concurrency) 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_revision", "id", "project" ], "title": "WorkflowExecution" }, "WorkflowExecutionStatus": { "type": "string", "enum": [ "pending", "running", "completed", "failed", "cancelled" ], "title": "WorkflowExecutionStatus", "description": "Overall execution status", "default": "pending" }, "WorkflowHandoff": { "properties": { "from_department": { "type": "string", "minLength": 1, "description": "Source department" }, "to_department": { "type": "string", "minLength": 1, "description": "Target department" }, "trigger": { "type": "string", "minLength": 1, "description": "Trigger condition" }, "artifacts": { "items": { "type": "string", "minLength": 1 }, "type": "array", "description": "Artifacts passed during handoff", "default": [] } }, "type": "object", "required": [ "from_department", "to_department", "trigger" ], "title": "WorkflowHandoff" }, "WorkflowIODeclaration": { "properties": { "name": { "type": "string", "minLength": 1, "description": "Identifier" }, "type": { "$ref": "#/components/schemas/WorkflowValueType" }, "required": { "type": "boolean", "description": "Whether a value is mandatory", "default": true }, "default": { "description": "Default value when not required", "anyOf": [ {}, { "type": "null" } ] }, "description": { "type": "string", "description": "Human-readable description", "default": "" } }, "type": "object", "required": [ "name", "type" ], "title": "WorkflowIODeclaration" }, "WorkflowIODeclarationRequest": { "properties": { "name": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Declaration name" }, "type": { "$ref": "#/components/schemas/WorkflowValueType" }, "required": { "type": "boolean", "description": "Whether mandatory", "default": true }, "default": { "description": "Default value" }, "description": { "type": "string", "maxLength": 1024, "description": "Human-readable description", "default": "" } }, "type": "object", "required": [ "default", "name", "type" ], "title": "WorkflowIODeclarationRequest" }, "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", "subworkflow_completed" ], "title": "WorkflowNodeExecutionStatus", "description": "Processing status", "default": "pending" }, "WorkflowNodeType": { "type": "string", "enum": [ "start", "end", "task", "agent_assignment", "conditional", "parallel_split", "parallel_join", "subworkflow", "verification" ], "title": "WorkflowNodeType", "description": "Node type" }, "WorkflowType": { "type": "string", "enum": [ "sequential_pipeline", "parallel_execution", "kanban", "agile_kanban" ], "title": "WorkflowType", "description": "Workflow type for organizing task execution.\n\nMatches the four workflow types defined in the Engine design page\n(docs/design/engine.md, Workflow Types section).\n", "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" }, "WorkflowValueType": { "type": "string", "enum": [ "string", "integer", "float", "boolean", "datetime", "json", "task_ref", "agent_ref" ], "title": "WorkflowValueType", "description": "Typed value kind" }, "WsTicketResponse": { "properties": { "ticket": { "type": "string", "minLength": 1 }, "expires_in": { "type": "integer", "exclusiveMinimum": 0.0 } }, "type": "object", "required": [ "expires_in", "ticket" ], "title": "WsTicketResponse" }, "_ApiKeyRotation": { "properties": { "auth_type": { "type": "string", "const": "api_key" }, "api_key": { "type": "string", "minLength": 8 } }, "type": "object", "required": [ "api_key", "auth_type" ], "title": "_ApiKeyRotation" }, "_CustomHeaderRotation": { "properties": { "auth_type": { "type": "string", "const": "custom_header" }, "custom_header_name": { "type": "string", "maxLength": 200, "minLength": 1 }, "custom_header_value": { "type": "string", "minLength": 8 } }, "type": "object", "required": [ "auth_type", "custom_header_name", "custom_header_value" ], "title": "_CustomHeaderRotation" }, "_DecisionRequest": { "properties": {}, "type": "object", "required": [], "title": "_DecisionRequest" }, "_OAuthRotation": { "properties": { "auth_type": { "type": "string", "const": "oauth" }, "oauth_token_url": { "type": "string", "minLength": 1 }, "oauth_client_id": { "type": "string", "minLength": 1 }, "oauth_client_secret": { "type": "string", "minLength": 8 }, "oauth_scope": { "minLength": 1, "type": [ "string", "null" ] } }, "type": "object", "required": [ "auth_type", "oauth_client_id", "oauth_client_secret", "oauth_token_url" ], "title": "_OAuthRotation" }, "_SubscriptionRotation": { "properties": { "auth_type": { "type": "string", "const": "subscription" }, "subscription_token": { "type": "string", "minLength": 8 }, "tos_accepted": { "type": "boolean", "description": "ToS re-acceptance is required on rotate" } }, "type": "object", "required": [ "auth_type", "subscription_token", "tos_accepted" ], "title": "_SubscriptionRotation" }, "ProblemDetail": { "additionalProperties": false, "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, "description": "Seconds to wait before retrying (null when not applicable).", "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 } } } } } } }