{ "openapi": "3.1.0", "info": { "title": "HostAnAgent Public API", "version": "1.0", "description": "Reviewed public application API subset. Console, administrator and personal billing routes are excluded." }, "servers": [ { "url": "https://api.hostanagent.com" } ], "paths": { "/v1/agents": { "post": { "operationId": "agent_v1_agents_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentCreate" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentRecord" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Agent" } }, "/v1/agents/{agent_id}/executor-bindings/{binding_id}/diagnostics": { "get": { "operationId": "diagnostics_v1_agents__agent_id__executor_bindings__binding_id__diagnostics_get", "parameters": [ { "in": "path", "name": "agent_id", "required": true, "schema": { "title": "Agent Id", "type": "string" } }, { "in": "path", "name": "binding_id", "required": true, "schema": { "title": "Binding Id", "type": "string" } }, { "in": "header", "name": "X-Subject", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "X-Subject", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BindingDiagnostics" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Diagnostics" } }, "/v1/agents/{agent_id}/runtime": { "get": { "operationId": "runtime_agent_v1_agents__agent_id__runtime_get", "parameters": [ { "in": "path", "name": "agent_id", "required": true, "schema": { "title": "Agent Id", "type": "string" } }, { "in": "query", "name": "version_id", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Version Id" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RuntimeAgentMetadata" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Runtime Agent" } }, "/v1/agents/{agent_id}/versions": { "post": { "operationId": "version_v1_agents__agent_id__versions_post", "parameters": [ { "in": "path", "name": "agent_id", "required": true, "schema": { "title": "Agent Id", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentVersionPublish" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentVersionRecord" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "428": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Precondition Required" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Version" } }, "/v1/billing/model-pricing": { "get": { "operationId": "model_pricing_v1_billing_model_pricing_get", "parameters": [ { "in": "query", "name": "model", "required": true, "schema": { "maxLength": 200, "minLength": 1, "title": "Model", "type": "string" } }, { "description": "可选估价输出量；省略时使用模型渠道容量。此查询不修改运行输出额度。", "in": "query", "name": "max_output_tokens", "required": false, "schema": { "anyOf": [ { "maximum": 1000000, "minimum": 1, "type": "integer" }, { "type": "null" } ], "description": "可选估价输出量；省略时使用模型渠道容量。此查询不修改运行输出额度。", "title": "Max Output Tokens" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ModelPricing" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Model Pricing", "tags": [ "Billing" ] } }, "/v1/capabilities": { "get": { "operationId": "capabilities_v1_capabilities_get", "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "summary": "Capabilities" } }, "/v1/configuration": { "get": { "operationId": "configuration_v1_configuration_get", "parameters": [ { "in": "query", "name": "include_archived", "required": false, "schema": { "default": false, "title": "Include Archived", "type": "boolean" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Configuration" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Configuration" } }, "/v1/configuration/agents": { "get": { "operationId": "agents_v1_configuration_agents_get", "parameters": [ { "in": "query", "name": "offset", "required": false, "schema": { "default": 0, "minimum": 0, "title": "Offset", "type": "integer" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 25, "maximum": 100, "minimum": 1, "title": "Limit", "type": "integer" } }, { "in": "query", "name": "state", "required": false, "schema": { "anyOf": [ { "enum": [ "active", "paused", "archived" ], "type": "string" }, { "type": "null" } ], "title": "State" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationAgentList" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Agents" }, "post": { "operationId": "create_agent_v1_configuration_agents_post", "parameters": [ { "in": "header", "name": "authorization", "required": true, "schema": { "title": "Authorization", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationAgentCreate" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationAgentView" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Create Agent" } }, "/v1/configuration/agents/{agent_id}": { "get": { "operationId": "agent_v1_configuration_agents__agent_id__get", "parameters": [ { "in": "path", "name": "agent_id", "required": true, "schema": { "title": "Agent Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationAgentView" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Agent" }, "patch": { "operationId": "update_agent_v1_configuration_agents__agent_id__patch", "parameters": [ { "in": "path", "name": "agent_id", "required": true, "schema": { "title": "Agent Id", "type": "string" } }, { "in": "header", "name": "authorization", "required": true, "schema": { "title": "Authorization", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationAgentUpdate" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationAgentView" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Update Agent" } }, "/v1/configuration/agents/{agent_id}/compare": { "get": { "operationId": "compare_v1_configuration_agents__agent_id__compare_get", "parameters": [ { "in": "path", "name": "agent_id", "required": true, "schema": { "title": "Agent Id", "type": "string" } }, { "in": "query", "name": "from_version", "required": true, "schema": { "title": "From Version", "type": "string" } }, { "in": "query", "name": "to_version", "required": true, "schema": { "title": "To Version", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentVersionComparison" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Compare" } }, "/v1/configuration/agents/{agent_id}/copy": { "post": { "operationId": "copy_v1_configuration_agents__agent_id__copy_post", "parameters": [ { "in": "path", "name": "agent_id", "required": true, "schema": { "title": "Agent Id", "type": "string" } }, { "in": "header", "name": "authorization", "required": true, "schema": { "title": "Authorization", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentCopy" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationAgentView" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Copy" } }, "/v1/configuration/agents/{agent_id}/deletion-request": { "post": { "operationId": "deletion_v1_configuration_agents__agent_id__deletion_request_post", "parameters": [ { "in": "path", "name": "agent_id", "required": true, "schema": { "title": "Agent Id", "type": "string" } }, { "in": "header", "name": "authorization", "required": true, "schema": { "title": "Authorization", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentDeletionRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationAgentView" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Deletion" } }, "/v1/configuration/agents/{agent_id}/references": { "get": { "operationId": "references_v1_configuration_agents__agent_id__references_get", "parameters": [ { "in": "path", "name": "agent_id", "required": true, "schema": { "title": "Agent Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentReferences" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "References" } }, "/v1/configuration/agents/{agent_id}/rollback": { "post": { "operationId": "rollback_v1_configuration_agents__agent_id__rollback_post", "parameters": [ { "in": "path", "name": "agent_id", "required": true, "schema": { "title": "Agent Id", "type": "string" } }, { "in": "header", "name": "authorization", "required": true, "schema": { "title": "Authorization", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentRollback" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationAgentView" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Rollback" } }, "/v1/configuration/agents/{agent_id}/state": { "post": { "operationId": "state_v1_configuration_agents__agent_id__state_post", "parameters": [ { "in": "path", "name": "agent_id", "required": true, "schema": { "title": "Agent Id", "type": "string" } }, { "in": "header", "name": "authorization", "required": true, "schema": { "title": "Authorization", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentStateUpdate" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationAgentView" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "State" } }, "/v1/configuration/agents/{agent_id}/versions": { "get": { "operationId": "history_v1_configuration_agents__agent_id__versions_get", "parameters": [ { "in": "path", "name": "agent_id", "required": true, "schema": { "title": "Agent Id", "type": "string" } }, { "in": "query", "name": "before", "required": false, "schema": { "anyOf": [ { "minimum": 1, "type": "integer" }, { "type": "null" } ], "title": "Before" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 25, "maximum": 100, "minimum": 1, "title": "Limit", "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentVersionHistory" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "History" } }, "/v1/configuration/agents/{agent_id}/versions/{version_id}": { "get": { "operationId": "version_v1_configuration_agents__agent_id__versions__version_id__get", "parameters": [ { "in": "path", "name": "agent_id", "required": true, "schema": { "title": "Agent Id", "type": "string" } }, { "in": "path", "name": "version_id", "required": true, "schema": { "title": "Version Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentVersionRecord" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Version" } }, "/v1/configuration/bindings": { "get": { "operationId": "bindings_v1_configuration_bindings_get", "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Bindings" }, "post": { "operationId": "create_binding_v1_configuration_bindings_post", "parameters": [ { "in": "header", "name": "authorization", "required": true, "schema": { "title": "Authorization", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationBindingCreate" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Create Binding" } }, "/v1/configuration/toolsets": { "get": { "operationId": "toolsets_v1_configuration_toolsets_get", "parameters": [ { "in": "query", "name": "offset", "required": false, "schema": { "default": 0, "minimum": 0, "title": "Offset", "type": "integer" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 25, "maximum": 100, "minimum": 1, "title": "Limit", "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Toolsets" }, "post": { "operationId": "create_toolset_v1_configuration_toolsets_post", "parameters": [ { "in": "header", "name": "authorization", "required": true, "schema": { "title": "Authorization", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationToolsetCreate" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Create Toolset" } }, "/v1/configuration/toolsets/{toolset_id}": { "get": { "operationId": "toolset_v1_configuration_toolsets__toolset_id__get", "parameters": [ { "in": "path", "name": "toolset_id", "required": true, "schema": { "title": "Toolset Id", "type": "string" } }, { "in": "query", "name": "version_id", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Version Id" } } ], "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Toolset" }, "patch": { "operationId": "update_toolset_v1_configuration_toolsets__toolset_id__patch", "parameters": [ { "in": "path", "name": "toolset_id", "required": true, "schema": { "title": "Toolset Id", "type": "string" } }, { "in": "header", "name": "authorization", "required": true, "schema": { "title": "Authorization", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationToolsetUpdate" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Update Toolset" } }, "/v1/configuration/validate": { "post": { "operationId": "validate_v1_configuration_validate_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentDraft" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigurationValidation" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Validate" } }, "/v1/executor-bindings": { "post": { "operationId": "binding_v1_executor_bindings_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BindingCreate" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BindingRecord" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Binding" } }, "/v1/executors/connect": { "post": { "operationId": "connect_v1_executors_connect_post", "parameters": [ { "in": "header", "name": "X-Subject", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "X-Subject", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExecutorConnect" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExecutorRecord" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Connect" } }, "/v1/executors/{executor_id}/calls/report": { "post": { "operationId": "report_v1_executors__executor_id__calls_report_post", "parameters": [ { "in": "path", "name": "executor_id", "required": true, "schema": { "title": "Executor Id", "type": "string" } }, { "in": "header", "name": "X-Subject", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "X-Subject", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExecutorCallReport" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Report" } }, "/v1/executors/{executor_id}/disconnect": { "post": { "operationId": "disconnect_v1_executors__executor_id__disconnect_post", "parameters": [ { "in": "path", "name": "executor_id", "required": true, "schema": { "title": "Executor Id", "type": "string" } }, { "in": "header", "name": "X-Subject", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "X-Subject", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExecutorRecord" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Disconnect" } }, "/v1/executors/{executor_id}/heartbeat": { "post": { "operationId": "heartbeat_v1_executors__executor_id__heartbeat_post", "parameters": [ { "in": "path", "name": "executor_id", "required": true, "schema": { "title": "Executor Id", "type": "string" } }, { "in": "header", "name": "X-Subject", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "X-Subject", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExecutorHeartbeat" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExecutorRecord" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Heartbeat" } }, "/v1/executors/{executor_id}/pending": { "get": { "operationId": "pending_v1_executors__executor_id__pending_get", "parameters": [ { "in": "path", "name": "executor_id", "required": true, "schema": { "title": "Executor Id", "type": "string" } }, { "in": "query", "name": "cursor", "required": false, "schema": { "anyOf": [ { "maxLength": 1024, "type": "string" }, { "type": "null" } ], "title": "Cursor" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "maximum": 100, "minimum": 1, "title": "Limit", "type": "integer" } }, { "in": "header", "name": "X-Subject", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "X-Subject", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PendingToolCalls" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Pending" } }, "/v1/models": { "get": { "operationId": "models_v1_models_get", "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": { "items": { "$ref": "#/components/schemas/PlatformModel" }, "type": "array" }, "title": "Response Models V1 Models Get", "type": "object" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Models" } }, "/v1/runs": { "get": { "operationId": "runs_v1_runs_get", "parameters": [ { "in": "header", "name": "X-Subject", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "X-Subject", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Runs" }, "post": { "operationId": "create_run_v1_runs_post", "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Idempotency-Key" } }, { "in": "header", "name": "X-Subject", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "X-Subject", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunCreate" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunAccepted" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Create Run" } }, "/v1/runs/{run_id}": { "get": { "operationId": "snapshot_v1_runs__run_id__get", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } }, { "in": "header", "name": "X-Subject", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "X-Subject", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunSnapshot" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Snapshot" } }, "/v1/runs/{run_id}/approvals": { "post": { "operationId": "approve_v1_runs__run_id__approvals_post", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } }, { "in": "header", "name": "X-Subject", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "X-Subject", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApprovalCreate" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunSnapshot" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Approve" } }, "/v1/runs/{run_id}/cancel": { "post": { "operationId": "cancel_v1_runs__run_id__cancel_post", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } }, { "in": "header", "name": "X-Subject", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "X-Subject", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunSnapshot" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Cancel" } }, "/v1/runs/{run_id}/diagnostics": { "get": { "operationId": "diagnostic_v1_runs__run_id__diagnostics_get", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } }, { "in": "query", "name": "after", "required": false, "schema": { "default": 0, "minimum": 0, "title": "After", "type": "integer" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 100, "maximum": 200, "minimum": 1, "title": "Limit", "type": "integer" } }, { "in": "header", "name": "X-Subject", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "X-Subject", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunDiagnostics" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Diagnostic", "tags": [ "Diagnostics" ] } }, "/v1/runs/{run_id}/events": { "get": { "operationId": "stream_v1_runs__run_id__events_get", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } }, { "in": "query", "name": "after", "required": false, "schema": { "default": 0, "minimum": 0, "title": "After", "type": "integer" } }, { "in": "header", "name": "last-event-id", "required": false, "schema": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "title": "Last-Event-Id" } }, { "in": "header", "name": "X-Subject", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "X-Subject", "type": "string" } } ], "responses": { "200": { "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Stream" } }, "/v1/runs/{run_id}/inputs": { "post": { "operationId": "add_input_v1_runs__run_id__inputs_post", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } }, { "in": "header", "name": "Idempotency-Key", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Idempotency-Key" } }, { "in": "header", "name": "X-Subject", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "X-Subject", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InputCreate" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Add Input" } }, "/v1/runs/{run_id}/tool-calls/{call_id}/claim": { "post": { "operationId": "claim_v1_runs__run_id__tool_calls__call_id__claim_post", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } }, { "in": "path", "name": "call_id", "required": true, "schema": { "title": "Call Id", "type": "string" } }, { "in": "header", "name": "X-Subject", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "X-Subject", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClaimCreate" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClaimResult" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Claim" } }, "/v1/runs/{run_id}/tool-calls/{call_id}/receipts": { "post": { "operationId": "receipt_v1_runs__run_id__tool_calls__call_id__receipts_post", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } }, { "in": "path", "name": "call_id", "required": true, "schema": { "title": "Call Id", "type": "string" } }, { "in": "header", "name": "X-Tool-Grant", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Tool-Grant" } }, { "in": "header", "name": "X-Subject", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "X-Subject", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReceiptCreate" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Receipt" } }, "/v1/runtime/bootstrap": { "get": { "operationId": "runtime_configuration_v1_runtime_bootstrap_get", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RuntimeConfiguration" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Runtime Configuration" } }, "/v1/sessions": { "get": { "operationId": "sessions_v1_sessions_get", "parameters": [ { "in": "header", "name": "X-Subject", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "X-Subject", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": { "items": { "$ref": "#/components/schemas/SessionSnapshot" }, "type": "array" }, "title": "Response Sessions V1 Sessions Get", "type": "object" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Sessions" }, "post": { "operationId": "create_session_v1_sessions_post", "parameters": [ { "in": "header", "name": "X-Subject", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "X-Subject", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionCreate" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionSnapshot" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Create Session" } }, "/v1/sessions/{session_id}": { "delete": { "operationId": "delete_session_v1_sessions__session_id__delete", "parameters": [ { "in": "path", "name": "session_id", "required": true, "schema": { "title": "Session Id", "type": "string" } }, { "in": "header", "name": "X-Subject", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "X-Subject", "type": "string" } } ], "responses": { "204": { "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Delete Session" }, "get": { "operationId": "session_v1_sessions__session_id__get", "parameters": [ { "in": "path", "name": "session_id", "required": true, "schema": { "title": "Session Id", "type": "string" } }, { "in": "header", "name": "X-Subject", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "X-Subject", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionSnapshot" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Session" } }, "/v1/sessions/{session_id}/messages": { "get": { "operationId": "messages_v1_sessions__session_id__messages_get", "parameters": [ { "in": "path", "name": "session_id", "required": true, "schema": { "title": "Session Id", "type": "string" } }, { "in": "query", "name": "before", "required": false, "schema": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "title": "Before" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "maximum": 200, "minimum": 1, "title": "Limit", "type": "integer" } }, { "in": "header", "name": "X-Subject", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "X-Subject", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Messages" } }, "/v1/tools/dry-run": { "post": { "operationId": "dry_run_v1_tools_dry_run_post", "parameters": [ { "in": "header", "name": "X-Subject", "required": true, "schema": { "maxLength": 160, "minLength": 1, "title": "X-Subject", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolDryRun" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolDryRunResult" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Dry Run" } }, "/v1/toolsets/{toolset_id}/versions": { "post": { "operationId": "toolset_v1_toolsets__toolset_id__versions_post", "parameters": [ { "in": "path", "name": "toolset_id", "required": true, "schema": { "title": "Toolset Id", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolsetCreate" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolsetRecord" } } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Toolset" } }, "/v1/usage": { "get": { "operationId": "usage_v1_usage_get", "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Bad Request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not Found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "413": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Request Entity Too Large" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Too Many Requests" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } }, "security": [ { "HTTPBearer": [] } ], "summary": "Usage" } } }, "components": { "schemas": { "AgentConfigPatch": { "additionalProperties": false, "properties": { "limits": { "additionalProperties": false, "description": "只修改提供的输入 Token 窗口；运行按钱包余额扣费，无累计 Token、步骤、时长或费用预算；输出容量由模型渠道决定。", "properties": { "max_context_tokens": { "description": "单次请求的输入上下文预算；运行时按完整请求估算及真实 usage 校准，并受模型渠道容量限制。", "maximum": 1000000, "minimum": 1024, "title": "Max Context Tokens", "type": "integer" } }, "title": "Limits", "type": "object" }, "model": { "anyOf": [ { "maxLength": 200, "pattern": "^[a-zA-Z0-9_-]+:.+$", "type": "string" }, { "type": "null" } ], "title": "Model" }, "output_schema": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Output Schema" }, "platform_tools": { "$ref": "#/components/schemas/PlatformToolsConfig" }, "reasoning_effort": { "anyOf": [ { "enum": [ "low", "medium", "high", "xhigh", "max" ], "type": "string" }, { "type": "null" } ], "title": "Reasoning Effort" }, "system_prompt": { "anyOf": [ { "maxLength": 32000, "type": "string" }, { "type": "null" } ], "title": "System Prompt" }, "toolset_version": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Toolset Version" } }, "title": "AgentConfigPatch", "type": "object" }, "AgentCopy": { "additionalProperties": false, "properties": { "expected_revision": { "minimum": 0, "title": "Expected Revision", "type": "integer" }, "name": { "maxLength": 100, "minLength": 1, "title": "Name", "type": "string" }, "request_id": { "maxLength": 160, "minLength": 1, "title": "Request Id", "type": "string" }, "source_version_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "省略时复制当前草稿或最新版本；固定工具集引用复用，不复制凭证和历史。", "title": "Source Version Id" } }, "required": [ "request_id", "expected_revision", "name" ], "title": "AgentCopy", "type": "object" }, "AgentCreate": { "additionalProperties": false, "properties": { "description": { "default": "", "maxLength": 1000, "title": "Description", "type": "string" }, "name": { "maxLength": 100, "minLength": 1, "title": "Name", "type": "string" } }, "required": [ "name" ], "title": "AgentCreate", "type": "object" }, "AgentDeletionRequest": { "additionalProperties": false, "properties": { "expected_revision": { "minimum": 0, "title": "Expected Revision", "type": "integer" }, "request_id": { "maxLength": 160, "minLength": 1, "title": "Request Id", "type": "string" }, "requested": { "default": true, "description": "申请时归档；撤回申请仍保持归档。实际正文清理由保留策略执行。", "title": "Requested", "type": "boolean" } }, "required": [ "request_id", "expected_revision" ], "title": "AgentDeletionRequest", "type": "object" }, "AgentDraft": { "additionalProperties": false, "properties": { "limits": { "$ref": "#/components/schemas/Limits" }, "model": { "anyOf": [ { "maxLength": 200, "pattern": "^[a-zA-Z0-9_-]+:.+$", "type": "string" }, { "type": "null" } ], "title": "Model" }, "output_schema": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Output Schema" }, "platform_tools": { "$ref": "#/components/schemas/PlatformToolsConfig" }, "reasoning_effort": { "anyOf": [ { "enum": [ "low", "medium", "high", "xhigh", "max" ], "type": "string" }, { "type": "null" } ], "title": "Reasoning Effort" }, "system_prompt": { "default": "", "maxLength": 32000, "title": "System Prompt", "type": "string" }, "toolset_version": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Toolset Version" } }, "title": "AgentDraft", "type": "object" }, "AgentRecord": { "additionalProperties": false, "properties": { "copied_from_agent_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Copied From Agent Id" }, "copied_from_revision": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Copied From Revision" }, "copied_from_version_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Copied From Version Id" }, "created_at": { "title": "Created At", "type": "number" }, "deletion_requested_at": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Deletion Requested At" }, "description": { "default": "", "maxLength": 1000, "title": "Description", "type": "string" }, "draft": { "anyOf": [ { "$ref": "#/components/schemas/AgentDraft" }, { "type": "null" } ] }, "id": { "title": "Id", "type": "string" }, "latest_version": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Latest Version" }, "name": { "maxLength": 100, "minLength": 1, "title": "Name", "type": "string" }, "revision": { "default": 0, "title": "Revision", "type": "integer" }, "state": { "default": "active", "enum": [ "active", "paused", "archived" ], "title": "State", "type": "string" } }, "required": [ "name", "id", "created_at", "latest_version" ], "title": "AgentRecord", "type": "object" }, "AgentReferences": { "additionalProperties": false, "properties": { "agent_id": { "title": "Agent Id", "type": "string" }, "deletion_requested_at": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Deletion Requested At" }, "physical_deletion_available": { "const": false, "default": false, "title": "Physical Deletion Available", "type": "boolean" }, "runs": { "title": "Runs", "type": "integer" }, "sessions": { "title": "Sessions", "type": "integer" }, "toolset_versions": { "items": { "type": "string" }, "title": "Toolset Versions", "type": "array" }, "versions": { "title": "Versions", "type": "integer" } }, "required": [ "agent_id", "versions", "runs", "sessions", "toolset_versions", "deletion_requested_at" ], "title": "AgentReferences", "type": "object" }, "AgentRollback": { "additionalProperties": false, "properties": { "change_note": { "default": "", "maxLength": 1000, "title": "Change Note", "type": "string" }, "expected_revision": { "minimum": 0, "title": "Expected Revision", "type": "integer" }, "request_id": { "maxLength": 160, "minLength": 1, "title": "Request Id", "type": "string" }, "source_version_id": { "title": "Source Version Id", "type": "string" } }, "required": [ "request_id", "expected_revision", "source_version_id" ], "title": "AgentRollback", "type": "object" }, "AgentStateUpdate": { "additionalProperties": false, "properties": { "expected_revision": { "minimum": 0, "title": "Expected Revision", "type": "integer" }, "request_id": { "maxLength": 160, "minLength": 1, "title": "Request Id", "type": "string" }, "state": { "enum": [ "active", "paused", "archived" ], "title": "State", "type": "string" } }, "required": [ "request_id", "expected_revision", "state" ], "title": "AgentStateUpdate", "type": "object" }, "AgentVersionComparison": { "additionalProperties": false, "properties": { "agent_id": { "title": "Agent Id", "type": "string" }, "changes": { "items": { "$ref": "#/components/schemas/ConfigurationDifference" }, "title": "Changes", "type": "array" }, "from_version": { "title": "From Version", "type": "string" }, "to_version": { "title": "To Version", "type": "string" }, "tool_changes": { "items": { "$ref": "#/components/schemas/ConfigurationDifference" }, "title": "Tool Changes", "type": "array" } }, "required": [ "agent_id", "from_version", "to_version", "changes", "tool_changes" ], "title": "AgentVersionComparison", "type": "object" }, "AgentVersionHistory": { "additionalProperties": false, "properties": { "items": { "items": { "$ref": "#/components/schemas/AgentVersionSummary" }, "title": "Items", "type": "array" }, "next_before": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Next Before" } }, "required": [ "items", "next_before" ], "title": "AgentVersionHistory", "type": "object" }, "AgentVersionPublish": { "additionalProperties": false, "properties": { "expected_revision": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "description": "已有配置的后续发布必须提供；首次发布允许省略。", "title": "Expected Revision" }, "limits": { "$ref": "#/components/schemas/Limits" }, "model": { "maxLength": 200, "pattern": "^[a-zA-Z0-9_-]+:.+$", "title": "Model", "type": "string" }, "output_schema": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Output Schema" }, "platform_tools": { "$ref": "#/components/schemas/PlatformToolsConfig" }, "reasoning_effort": { "anyOf": [ { "enum": [ "low", "medium", "high", "xhigh", "max" ], "type": "string" }, { "type": "null" } ], "title": "Reasoning Effort" }, "request_id": { "anyOf": [ { "maxLength": 160, "minLength": 1, "type": "string" }, { "type": "null" } ], "description": "重试时复用；旧调用未提供时按完整请求摘要幂等。", "title": "Request Id" }, "system_prompt": { "maxLength": 32000, "minLength": 1, "title": "System Prompt", "type": "string" }, "toolset_version": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Toolset Version" } }, "required": [ "system_prompt", "model" ], "title": "AgentVersionPublish", "type": "object" }, "AgentVersionRecord": { "additionalProperties": false, "properties": { "agent_id": { "title": "Agent Id", "type": "string" }, "change_note": { "default": "", "title": "Change Note", "type": "string" }, "change_summary": { "items": { "type": "string" }, "title": "Change Summary", "type": "array" }, "created_at": { "title": "Created At", "type": "number" }, "id": { "title": "Id", "type": "string" }, "limits": { "$ref": "#/components/schemas/Limits" }, "model": { "maxLength": 200, "pattern": "^[a-zA-Z0-9_-]+:.+$", "title": "Model", "type": "string" }, "output_schema": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Output Schema" }, "parent_version_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Parent Version Id" }, "platform_tools": { "$ref": "#/components/schemas/PlatformToolsConfig" }, "publication_kind": { "default": "legacy", "enum": [ "publish", "rollback", "legacy" ], "title": "Publication Kind", "type": "string" }, "reasoning_effort": { "anyOf": [ { "enum": [ "low", "medium", "high", "xhigh", "max" ], "type": "string" }, { "type": "null" } ], "title": "Reasoning Effort" }, "source_version_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source Version Id" }, "system_prompt": { "maxLength": 32000, "minLength": 1, "title": "System Prompt", "type": "string" }, "toolset_version": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Toolset Version" } }, "required": [ "system_prompt", "model", "id", "agent_id", "created_at" ], "title": "AgentVersionRecord", "type": "object" }, "AgentVersionSummary": { "additionalProperties": false, "properties": { "agent_id": { "title": "Agent Id", "type": "string" }, "change_note": { "title": "Change Note", "type": "string" }, "change_summary": { "items": { "type": "string" }, "title": "Change Summary", "type": "array" }, "created_at": { "title": "Created At", "type": "number" }, "id": { "title": "Id", "type": "string" }, "is_current": { "title": "Is Current", "type": "boolean" }, "parent_version_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Parent Version Id" }, "publication_kind": { "enum": [ "publish", "rollback", "legacy" ], "title": "Publication Kind", "type": "string" }, "source_version_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source Version Id" } }, "required": [ "id", "agent_id", "created_at", "publication_kind", "source_version_id", "parent_version_id", "change_summary", "change_note", "is_current" ], "title": "AgentVersionSummary", "type": "object" }, "ApprovalCreate": { "additionalProperties": false, "properties": { "approval_id": { "title": "Approval Id", "type": "string" }, "arguments_digest": { "title": "Arguments Digest", "type": "string" }, "decision": { "enum": [ "approve", "deny" ], "title": "Decision", "type": "string" }, "tool_call_id": { "title": "Tool Call Id", "type": "string" } }, "required": [ "approval_id", "tool_call_id", "arguments_digest", "decision" ], "title": "ApprovalCreate", "type": "object" }, "BillingPrice": { "additionalProperties": false, "properties": { "bands": { "items": { "$ref": "#/components/schemas/BillingPriceBand" }, "title": "Bands", "type": "array" }, "currency": { "const": "USD", "default": "USD", "title": "Currency", "type": "string" }, "effective_from": { "title": "Effective From", "type": "number" }, "effective_until": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Effective Until" }, "id": { "title": "Id", "type": "string" }, "model": { "title": "Model", "type": "string" }, "rates": { "additionalProperties": { "type": "string" }, "title": "Rates", "type": "object" }, "side": { "const": "sale", "default": "sale", "title": "Side", "type": "string" }, "timezone": { "title": "Timezone", "type": "string" }, "unit": { "const": "million_tokens", "default": "million_tokens", "title": "Unit", "type": "string" } }, "required": [ "id", "model", "effective_from", "timezone", "rates", "bands" ], "title": "BillingPrice", "type": "object" }, "BillingPriceBand": { "additionalProperties": false, "properties": { "end_hour": { "title": "End Hour", "type": "integer" }, "excluded_dates": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Excluded Dates" }, "max_input": { "title": "Max Input", "type": "integer" }, "min_input": { "title": "Min Input", "type": "integer" }, "rates": { "additionalProperties": { "type": "string" }, "title": "Rates", "type": "object" }, "start_hour": { "title": "Start Hour", "type": "integer" }, "weekdays": { "anyOf": [ { "items": { "type": "integer" }, "type": "array" }, { "type": "null" } ], "title": "Weekdays" } }, "required": [ "min_input", "max_input", "start_hour", "end_hour", "rates" ], "title": "BillingPriceBand", "type": "object" }, "BindingCreate": { "additionalProperties": false, "properties": { "name": { "maxLength": 100, "minLength": 1, "title": "Name", "type": "string" }, "target": { "default": "backend", "enum": [ "browser", "desktop", "backend" ], "title": "Target", "type": "string" } }, "required": [ "name" ], "title": "BindingCreate", "type": "object" }, "BindingDiagnostics": { "additionalProperties": false, "properties": { "agent_id": { "title": "Agent Id", "type": "string" }, "binding_id": { "title": "Binding Id", "type": "string" }, "connection_status": { "enum": [ "unconnected", "connected", "offline", "incompatible" ], "title": "Connection Status", "type": "string" }, "counts_truncated": { "default": false, "title": "Counts Truncated", "type": "boolean" }, "executors": { "items": { "$ref": "#/components/schemas/ExecutorRecord" }, "title": "Executors", "type": "array" }, "missing_handlers": { "items": { "$ref": "#/components/schemas/ExecutorCapability" }, "title": "Missing Handlers", "type": "array" }, "processing_count": { "title": "Processing Count", "type": "integer" }, "receipt_pending_count": { "title": "Receipt Pending Count", "type": "integer" }, "reconciliation_count": { "title": "Reconciliation Count", "type": "integer" }, "waiting_count": { "title": "Waiting Count", "type": "integer" } }, "required": [ "binding_id", "agent_id", "connection_status", "executors", "missing_handlers", "waiting_count", "processing_count", "reconciliation_count", "receipt_pending_count" ], "title": "BindingDiagnostics", "type": "object" }, "BindingRecord": { "additionalProperties": false, "properties": { "created_at": { "title": "Created At", "type": "number" }, "id": { "title": "Id", "type": "string" }, "name": { "maxLength": 100, "minLength": 1, "title": "Name", "type": "string" }, "target": { "default": "backend", "enum": [ "browser", "desktop", "backend" ], "title": "Target", "type": "string" } }, "required": [ "name", "id", "created_at" ], "title": "BindingRecord", "type": "object" }, "ClaimCreate": { "additionalProperties": false, "properties": { "executor_id": { "maxLength": 160, "minLength": 1, "title": "Executor Id", "type": "string" } }, "required": [ "executor_id" ], "title": "ClaimCreate", "type": "object" }, "ClaimResult": { "additionalProperties": false, "properties": { "grant": { "title": "Grant", "type": "string" }, "replayed": { "title": "Replayed", "type": "boolean" }, "tool_call": { "$ref": "#/components/schemas/PublicToolCall" } }, "required": [ "tool_call", "grant", "replayed" ], "title": "ClaimResult", "type": "object" }, "Configuration": { "additionalProperties": false, "properties": { "agents": { "items": { "$ref": "#/components/schemas/AgentRecord" }, "title": "Agents", "type": "array" }, "bindings": { "items": { "$ref": "#/components/schemas/BindingRecord" }, "title": "Bindings", "type": "array" }, "toolsets": { "items": { "$ref": "#/components/schemas/ToolsetRecord" }, "title": "Toolsets", "type": "array" }, "versions": { "items": { "$ref": "#/components/schemas/AgentVersionRecord" }, "title": "Versions", "type": "array" } }, "required": [ "agents", "versions", "bindings", "toolsets" ], "title": "Configuration", "type": "object" }, "ConfigurationAgentCreate": { "additionalProperties": false, "properties": { "change_note": { "default": "", "maxLength": 1000, "title": "Change Note", "type": "string" }, "config": { "$ref": "#/components/schemas/AgentDraft" }, "description": { "default": "", "maxLength": 1000, "title": "Description", "type": "string" }, "name": { "maxLength": 100, "minLength": 1, "title": "Name", "type": "string" }, "publish": { "default": false, "title": "Publish", "type": "boolean" }, "request_id": { "maxLength": 160, "minLength": 1, "title": "Request Id", "type": "string" } }, "required": [ "name", "request_id" ], "title": "ConfigurationAgentCreate", "type": "object" }, "ConfigurationAgentList": { "additionalProperties": false, "properties": { "items": { "items": { "$ref": "#/components/schemas/ConfigurationAgentSummary" }, "title": "Items", "type": "array" }, "next_offset": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Next Offset" } }, "required": [ "items", "next_offset" ], "title": "ConfigurationAgentList", "type": "object" }, "ConfigurationAgentSummary": { "additionalProperties": false, "properties": { "created_at": { "title": "Created At", "type": "number" }, "deletion_requested_at": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Deletion Requested At" }, "description": { "default": "", "maxLength": 1000, "title": "Description", "type": "string" }, "has_draft": { "title": "Has Draft", "type": "boolean" }, "id": { "title": "Id", "type": "string" }, "latest_version": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Latest Version" }, "name": { "maxLength": 100, "minLength": 1, "title": "Name", "type": "string" }, "revision": { "title": "Revision", "type": "integer" }, "state": { "enum": [ "active", "paused", "archived" ], "title": "State", "type": "string" } }, "required": [ "name", "id", "latest_version", "revision", "created_at", "state", "has_draft", "deletion_requested_at" ], "title": "ConfigurationAgentSummary", "type": "object" }, "ConfigurationAgentUpdate": { "additionalProperties": false, "properties": { "change_note": { "default": "", "maxLength": 1000, "title": "Change Note", "type": "string" }, "config": { "$ref": "#/components/schemas/AgentConfigPatch" }, "description": { "anyOf": [ { "maxLength": 1000, "type": "string" }, { "type": "null" } ], "title": "Description" }, "expected_revision": { "minimum": 0, "title": "Expected Revision", "type": "integer" }, "name": { "anyOf": [ { "maxLength": 100, "minLength": 1, "type": "string" }, { "type": "null" } ], "title": "Name" }, "publish": { "default": false, "title": "Publish", "type": "boolean" }, "request_id": { "maxLength": 160, "minLength": 1, "title": "Request Id", "type": "string" } }, "required": [ "request_id", "expected_revision" ], "title": "ConfigurationAgentUpdate", "type": "object" }, "ConfigurationAgentView": { "additionalProperties": false, "properties": { "agent": { "$ref": "#/components/schemas/AgentRecord" }, "validation": { "$ref": "#/components/schemas/ConfigurationValidation" }, "version": { "anyOf": [ { "$ref": "#/components/schemas/AgentVersionRecord" }, { "type": "null" } ] } }, "required": [ "agent", "version", "validation" ], "title": "ConfigurationAgentView", "type": "object" }, "ConfigurationBindingCreate": { "additionalProperties": false, "properties": { "name": { "maxLength": 100, "minLength": 1, "title": "Name", "type": "string" }, "request_id": { "maxLength": 160, "minLength": 1, "title": "Request Id", "type": "string" }, "target": { "default": "backend", "enum": [ "browser", "desktop", "backend" ], "title": "Target", "type": "string" } }, "required": [ "name", "request_id" ], "title": "ConfigurationBindingCreate", "type": "object" }, "ConfigurationDifference": { "additionalProperties": false, "properties": { "after": { "title": "After", "tsType": "unknown" }, "before": { "title": "Before", "tsType": "unknown" }, "field": { "title": "Field", "type": "string" }, "label": { "title": "Label", "type": "string" } }, "required": [ "field", "label", "before", "after" ], "title": "ConfigurationDifference", "type": "object" }, "ConfigurationIssue": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "field": { "title": "Field", "type": "string" }, "message": { "title": "Message", "type": "string" } }, "required": [ "field", "code", "message" ], "title": "ConfigurationIssue", "type": "object" }, "ConfigurationToolsetCreate": { "additionalProperties": false, "properties": { "request_id": { "maxLength": 160, "minLength": 1, "title": "Request Id", "type": "string" }, "tools": { "items": { "$ref": "#/components/schemas/ToolDefinition" }, "maxItems": 64, "title": "Tools", "type": "array" }, "toolset_id": { "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_.-]{0,63}$", "title": "Toolset Id", "type": "string" } }, "required": [ "tools", "request_id", "toolset_id" ], "title": "ConfigurationToolsetCreate", "type": "object" }, "ConfigurationToolsetUpdate": { "additionalProperties": false, "properties": { "base_version": { "maxLength": 64, "minLength": 1, "title": "Base Version", "type": "string" }, "remove_tools": { "items": { "type": "string" }, "maxItems": 64, "title": "Remove Tools", "type": "array" }, "request_id": { "maxLength": 160, "minLength": 1, "title": "Request Id", "type": "string" }, "upsert_tools": { "items": { "$ref": "#/components/schemas/ToolDefinition" }, "maxItems": 64, "title": "Upsert Tools", "type": "array" } }, "required": [ "request_id", "base_version" ], "title": "ConfigurationToolsetUpdate", "type": "object" }, "ConfigurationValidation": { "additionalProperties": false, "properties": { "issues": { "items": { "$ref": "#/components/schemas/ConfigurationIssue" }, "title": "Issues", "type": "array" }, "pricing": { "anyOf": [ { "$ref": "#/components/schemas/ModelPricing" }, { "type": "null" } ] }, "ready": { "title": "Ready", "type": "boolean" }, "valid": { "title": "Valid", "type": "boolean" }, "warnings": { "description": "条件性提示，不阻止发布；ready 不保证余额或每次请求可执行。", "items": { "$ref": "#/components/schemas/ConfigurationIssue" }, "title": "Warnings", "type": "array" } }, "required": [ "valid", "ready", "issues" ], "title": "ConfigurationValidation", "type": "object" }, "ContextRef": { "additionalProperties": false, "properties": { "id": { "maxLength": 200, "title": "Id", "type": "string" }, "revision": { "anyOf": [ { "type": "string" }, { "type": "integer" }, { "type": "null" } ], "title": "Revision" }, "type": { "maxLength": 100, "title": "Type", "type": "string" } }, "required": [ "type", "id" ], "title": "ContextRef", "type": "object" }, "DiagnosticEvent": { "additionalProperties": false, "properties": { "attempt_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Attempt Id" }, "duration_seconds": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Duration Seconds" }, "error_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Error Code" }, "event": { "title": "Event", "type": "string" }, "outcome": { "title": "Outcome", "type": "string" }, "phase": { "enum": [ "queued", "model", "approval", "tool", "billing", "ended" ], "title": "Phase", "type": "string" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Request Id" }, "run_id": { "title": "Run Id", "type": "string" }, "sequence": { "title": "Sequence", "type": "integer" }, "timestamp": { "title": "Timestamp", "type": "number" }, "tool_call_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Tool Call Id" }, "values": { "additionalProperties": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] }, "title": "Values", "type": "object" } }, "required": [ "run_id", "sequence", "event", "phase", "timestamp", "outcome" ], "title": "DiagnosticEvent", "type": "object" }, "DiagnosticTool": { "additionalProperties": false, "properties": { "deadline": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "description": "工具分派后的期限；尚未分派或持久计时等待时为 null。", "title": "Deadline" }, "execution_owner": { "default": "application", "enum": [ "application", "platform" ], "title": "Execution Owner", "type": "string" }, "executor_connection_status": { "enum": [ "unconnected", "connected", "offline", "disconnected", "incompatible" ], "title": "Executor Connection Status", "type": "string" }, "executor_state": { "anyOf": [ { "enum": [ "reconciliation_required", "receipt_pending" ], "type": "string" }, { "type": "null" } ], "title": "Executor State" }, "status": { "title": "Status", "type": "string" }, "tool_call_id": { "title": "Tool Call Id", "type": "string" } }, "required": [ "tool_call_id", "status", "executor_connection_status", "deadline" ], "title": "DiagnosticTool", "type": "object" }, "DisplayMessage": { "additionalProperties": false, "properties": { "content": { "title": "Content", "type": "string" }, "created_at": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Created At" }, "id": { "title": "Id", "type": "string" }, "reasoning": { "default": "", "title": "Reasoning", "type": "string" }, "reasoning_kind": { "anyOf": [ { "enum": [ "reasoning", "summary" ], "type": "string" }, { "type": "null" } ], "title": "Reasoning Kind" }, "role": { "enum": [ "user", "assistant", "tool" ], "title": "Role", "type": "string" }, "run_id": { "title": "Run Id", "type": "string" }, "status": { "default": "committed", "enum": [ "committed", "streaming", "interrupted" ], "title": "Status", "type": "string" }, "tool_call_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Tool Call Id" } }, "required": [ "id", "role", "content", "run_id" ], "title": "DisplayMessage", "type": "object" }, "ErrorResponse": { "additionalProperties": false, "properties": { "code": { "title": "Code", "type": "string" }, "details": { "additionalProperties": true, "title": "Details", "type": "object" }, "message": { "title": "Message", "type": "string" }, "request_id": { "title": "Request Id", "type": "string" }, "retryable": { "default": false, "title": "Retryable", "type": "boolean" } }, "required": [ "code", "message", "request_id" ], "title": "ErrorResponse", "type": "object" }, "ExecutorCallReport": { "additionalProperties": false, "properties": { "run_id": { "maxLength": 160, "minLength": 1, "title": "Run Id", "type": "string" }, "state": { "enum": [ "reconciliation_required", "receipt_pending" ], "title": "State", "type": "string" }, "tool_call_id": { "maxLength": 160, "minLength": 1, "title": "Tool Call Id", "type": "string" } }, "required": [ "run_id", "tool_call_id", "state" ], "title": "ExecutorCallReport", "type": "object" }, "ExecutorCapability": { "additionalProperties": false, "properties": { "name": { "pattern": "^[a-zA-Z][a-zA-Z0-9_.-]{0,63}$", "title": "Name", "type": "string" }, "version": { "default": "1", "maxLength": 40, "minLength": 1, "title": "Version", "type": "string" } }, "required": [ "name" ], "title": "ExecutorCapability", "type": "object" }, "ExecutorConnect": { "additionalProperties": false, "properties": { "agent_id": { "maxLength": 160, "minLength": 1, "title": "Agent Id", "type": "string" }, "binding_id": { "maxLength": 160, "minLength": 1, "title": "Binding Id", "type": "string" }, "capabilities": { "items": { "$ref": "#/components/schemas/ExecutorCapability" }, "maxItems": 64, "title": "Capabilities", "type": "array" }, "executor_id": { "pattern": "^[a-zA-Z0-9_.-]{1,160}$", "title": "Executor Id", "type": "string" }, "protocol_version": { "default": "1.0", "maxLength": 40, "minLength": 1, "title": "Protocol Version", "type": "string" }, "target": { "enum": [ "browser", "desktop", "backend" ], "title": "Target", "type": "string" } }, "required": [ "executor_id", "binding_id", "agent_id", "target" ], "title": "ExecutorConnect", "type": "object" }, "ExecutorHeartbeat": { "additionalProperties": false, "properties": { "last_error_code": { "anyOf": [ { "enum": [ "RECONCILIATION_REQUIRED", "RECEIPT_DELIVERY_FAILED", "HANDLER_UNAVAILABLE", "AUTHORIZATION_FAILED" ], "type": "string" }, { "type": "null" } ], "title": "Last Error Code" } }, "title": "ExecutorHeartbeat", "type": "object" }, "ExecutorRecord": { "additionalProperties": false, "properties": { "agent_id": { "maxLength": 160, "minLength": 1, "title": "Agent Id", "type": "string" }, "binding_id": { "maxLength": 160, "minLength": 1, "title": "Binding Id", "type": "string" }, "capabilities": { "items": { "$ref": "#/components/schemas/ExecutorCapability" }, "maxItems": 64, "title": "Capabilities", "type": "array" }, "connected_at": { "title": "Connected At", "type": "number" }, "connection_status": { "enum": [ "connected", "offline", "disconnected", "incompatible" ], "title": "Connection Status", "type": "string" }, "disconnected_at": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Disconnected At" }, "executor_id": { "pattern": "^[a-zA-Z0-9_.-]{1,160}$", "title": "Executor Id", "type": "string" }, "heartbeat_interval_seconds": { "default": 30, "title": "Heartbeat Interval Seconds", "type": "integer" }, "last_error_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Last Error Code" }, "last_seen_at": { "title": "Last Seen At", "type": "number" }, "offline_after_seconds": { "default": 90, "title": "Offline After Seconds", "type": "integer" }, "protocol_version": { "default": "1.0", "maxLength": 40, "minLength": 1, "title": "Protocol Version", "type": "string" }, "target": { "enum": [ "browser", "desktop", "backend" ], "title": "Target", "type": "string" } }, "required": [ "executor_id", "binding_id", "agent_id", "target", "connected_at", "last_seen_at", "connection_status" ], "title": "ExecutorRecord", "type": "object" }, "InputCreate": { "additionalProperties": false, "properties": { "content": { "maxLength": 32000, "minLength": 1, "title": "Content", "type": "string" } }, "required": [ "content" ], "title": "InputCreate", "type": "object" }, "Limits": { "additionalProperties": false, "properties": { "max_context_tokens": { "default": 256000, "description": "单次请求的输入上下文预算；运行时按完整请求估算及真实 usage 校准，并受模型渠道容量限制。", "maximum": 1000000, "minimum": 1024, "title": "Max Context Tokens", "type": "integer" } }, "title": "Limits", "type": "object" }, "MessageInput": { "additionalProperties": false, "properties": { "content": { "maxLength": 32000, "minLength": 1, "title": "Content", "type": "string" }, "type": { "const": "message", "default": "message", "title": "Type", "type": "string" } }, "required": [ "content" ], "title": "MessageInput", "type": "object" }, "ModelPricing": { "additionalProperties": false, "properties": { "currency": { "const": "USD", "default": "USD", "title": "Currency", "type": "string" }, "max_allowed_output_tokens": { "description": "平台与渠道共同允许的最大输出 Token 上限。", "title": "Max Allowed Output Tokens", "type": "integer" }, "max_input_tokens": { "description": "当前保守预留使用的渠道最大输入 Token 数，不是本次提示词的 Token 估算。", "title": "Max Input Tokens", "type": "integer" }, "max_output_tokens": { "description": "本次查询采用的输出 Token 上限。", "title": "Max Output Tokens", "type": "integer" }, "model": { "title": "Model", "type": "string" }, "price": { "$ref": "#/components/schemas/BillingPrice" }, "request_reservation_supported": { "default": false, "description": "存在匹配模型的可信计数能力；具体输入仍需通过覆盖范围、请求摘要与发送前校验，否则回退最大上下文预留。本查询没有具体输入，不是本次请求报价。", "title": "Request Reservation Supported", "type": "boolean" }, "reservation_basis": { "const": "maximum_context", "default": "maximum_context", "title": "Reservation Basis", "type": "string" }, "reservation_usd": { "description": "一次模型请求所需的保守预留金额（USD 字符串），不是实际扣款或账户余额；查询不会冻结资金。", "pattern": "^(0|[1-9][0-9]{0,14})(\\.[0-9]{1,12})?$", "title": "Reservation Usd", "type": "string" } }, "required": [ "model", "price", "max_input_tokens", "max_output_tokens", "max_allowed_output_tokens", "reservation_usd" ], "title": "ModelPricing", "type": "object" }, "PendingToolCall": { "additionalProperties": false, "description": "Discovery only. Arguments and grants are returned by an authorized claim.", "properties": { "binding_id": { "title": "Binding Id", "type": "string" }, "deadline": { "title": "Deadline", "type": "number" }, "id": { "title": "Id", "type": "string" }, "name": { "title": "Name", "type": "string" }, "run_id": { "title": "Run Id", "type": "string" }, "status": { "title": "Status", "type": "string" }, "version": { "title": "Version", "type": "string" } }, "required": [ "id", "run_id", "binding_id", "name", "version", "status", "deadline" ], "title": "PendingToolCall", "type": "object" }, "PendingToolCalls": { "additionalProperties": false, "properties": { "items": { "items": { "$ref": "#/components/schemas/PendingToolCall" }, "title": "Items", "type": "array" }, "next_cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Next Cursor" } }, "required": [ "items" ], "title": "PendingToolCalls", "type": "object" }, "PlatformModel": { "additionalProperties": false, "properties": { "available": { "title": "Available", "type": "boolean" }, "default_reasoning_effort": { "anyOf": [ { "enum": [ "low", "medium", "high", "xhigh", "max" ], "type": "string" }, { "type": "null" } ], "title": "Default Reasoning Effort" }, "id": { "title": "Id", "type": "string" }, "provider": { "title": "Provider", "type": "string" }, "reasoning_options": { "items": { "$ref": "#/components/schemas/ReasoningOption" }, "title": "Reasoning Options", "type": "array" } }, "required": [ "id", "provider", "available" ], "title": "PlatformModel", "type": "object" }, "PlatformToolsConfig": { "additionalProperties": false, "properties": { "allowed_agent_ids": { "items": { "maxLength": 160, "minLength": 1, "type": "string" }, "maxItems": 100, "title": "Allowed Agent Ids", "type": "array" }, "allowed_session_ids": { "items": { "maxLength": 160, "minLength": 1, "type": "string" }, "maxItems": 100, "title": "Allowed Session Ids", "type": "array" }, "enabled": { "items": { "enum": [ "wait", "list_chat_sessions", "search_chat_history", "read_chat_history" ], "type": "string" }, "maxItems": 4, "title": "Enabled", "type": "array" }, "history_scope": { "default": "current_session", "enum": [ "current_session", "authorized_sessions" ], "title": "History Scope", "type": "string" }, "registry_version": { "const": "1", "default": "1", "title": "Registry Version", "type": "string" } }, "title": "PlatformToolsConfig", "type": "object" }, "PublicToolCall": { "additionalProperties": false, "properties": { "approval_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Approval Id" }, "arguments": { "additionalProperties": true, "title": "Arguments", "type": "object" }, "arguments_digest": { "title": "Arguments Digest", "type": "string" }, "binding_id": { "title": "Binding Id", "type": "string" }, "cancel_requested": { "default": false, "title": "Cancel Requested", "type": "boolean" }, "deadline": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "description": "工具分派后的期限；尚未分派或持久计时等待时为 null，不表示 Run 总期限。", "title": "Deadline" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Error" }, "execution_owner": { "default": "application", "enum": [ "application", "platform" ], "title": "Execution Owner", "type": "string" }, "execution_ref": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Execution Ref" }, "id": { "title": "Id", "type": "string" }, "message_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Message Id" }, "name": { "title": "Name", "type": "string" }, "not_before": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Not Before" }, "progress": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Progress" }, "result": { "title": "Result", "tsType": "unknown" }, "result_semantics": { "enum": [ "completion", "submission" ], "title": "Result Semantics", "type": "string" }, "run_id": { "title": "Run Id", "type": "string" }, "status": { "title": "Status", "type": "string" }, "version": { "title": "Version", "type": "string" } }, "required": [ "id", "run_id", "name", "version", "binding_id", "arguments", "arguments_digest", "status", "result_semantics", "deadline" ], "title": "PublicToolCall", "type": "object" }, "ReasoningOption": { "additionalProperties": false, "properties": { "effective_effort": { "title": "Effective Effort", "type": "string" }, "id": { "enum": [ "low", "medium", "high", "xhigh", "max" ], "title": "Id", "type": "string" }, "label": { "title": "Label", "type": "string" } }, "required": [ "id", "label", "effective_effort" ], "title": "ReasoningOption", "type": "object" }, "ReceiptCreate": { "additionalProperties": false, "properties": { "error": { "anyOf": [ { "maxLength": 4000, "type": "string" }, { "type": "null" } ], "title": "Error" }, "execution_ref": { "anyOf": [ { "$ref": "#/components/schemas/ContextRef" }, { "type": "null" } ] }, "kind": { "enum": [ "accepted", "progress", "completed", "failed", "cancelled" ], "title": "Kind", "type": "string" }, "progress": { "anyOf": [ { "maxLength": 2000, "type": "string" }, { "type": "null" } ], "title": "Progress" }, "progress_sequence": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "type": "null" } ], "title": "Progress Sequence" }, "receipt_id": { "maxLength": 160, "minLength": 1, "title": "Receipt Id", "type": "string" }, "result": { "title": "Result", "tsType": "unknown" } }, "required": [ "receipt_id", "kind" ], "title": "ReceiptCreate", "type": "object" }, "RunAccepted": { "additionalProperties": false, "properties": { "events_url": { "title": "Events Url", "type": "string" }, "run_id": { "title": "Run Id", "type": "string" }, "session_id": { "title": "Session Id", "type": "string" }, "status": { "enum": [ "queued", "running", "waiting_tool", "waiting_approval", "completed", "failed", "cancelled", "expired", "waiting_subscription" ], "title": "Status", "type": "string" } }, "required": [ "run_id", "session_id", "status", "events_url" ], "title": "RunAccepted", "type": "object" }, "RunBilling": { "additionalProperties": false, "properties": { "charged": { "title": "Charged", "type": "string" }, "currency": { "const": "USD", "default": "USD", "title": "Currency", "type": "string" }, "held": { "title": "Held", "type": "string" }, "pending_attempts": { "title": "Pending Attempts", "type": "integer" } }, "required": [ "charged", "held", "pending_attempts" ], "title": "RunBilling", "type": "object" }, "RunCreate": { "additionalProperties": false, "properties": { "agent_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "与 agent_version 二选一；新会话首次接受 Run 时固定最新版本，已有会话继续使用原版本。", "title": "Agent Id" }, "agent_version": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agent Version" }, "context_refs": { "items": { "$ref": "#/components/schemas/ContextRef" }, "maxItems": 32, "title": "Context Refs", "type": "array" }, "execution_mode": { "default": "propose", "enum": [ "propose", "execute" ], "title": "Execution Mode", "type": "string" }, "input": { "$ref": "#/components/schemas/MessageInput" }, "limits": { "anyOf": [ { "$ref": "#/components/schemas/Limits" }, { "type": "null" } ] }, "reasoning_effort": { "anyOf": [ { "enum": [ "low", "medium", "high", "xhigh", "max" ], "type": "string" }, { "type": "null" } ], "title": "Reasoning Effort" }, "session_id": { "title": "Session Id", "type": "string" } }, "required": [ "session_id", "input" ], "title": "RunCreate", "type": "object" }, "RunDiagnostics": { "additionalProperties": false, "properties": { "actions": { "items": { "enum": [ "refresh", "open_conversation", "cancel", "review_billing", "check_executor", "reconcile_business" ], "type": "string" }, "title": "Actions", "type": "array" }, "available_from": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Available From" }, "billing": { "$ref": "#/components/schemas/RunBilling" }, "billing_state": { "enum": [ "none", "held", "settled", "released", "reconciliation_required" ], "title": "Billing State", "type": "string" }, "created_at": { "title": "Created At", "type": "number" }, "elapsed_seconds": { "title": "Elapsed Seconds", "type": "number" }, "error_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Error Code" }, "events": { "items": { "$ref": "#/components/schemas/DiagnosticEvent" }, "title": "Events", "type": "array" }, "next_after": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Next After" }, "observed_at": { "title": "Observed At", "type": "number" }, "phase": { "enum": [ "queued", "model", "approval", "tool", "billing", "ended" ], "title": "Phase", "type": "string" }, "request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Request Id" }, "run_id": { "title": "Run Id", "type": "string" }, "status": { "enum": [ "queued", "running", "waiting_tool", "waiting_approval", "completed", "failed", "cancelled", "expired", "waiting_subscription" ], "title": "Status", "type": "string" }, "tools": { "items": { "$ref": "#/components/schemas/DiagnosticTool" }, "title": "Tools", "type": "array" } }, "required": [ "run_id", "status", "phase", "created_at", "observed_at", "elapsed_seconds", "billing", "billing_state", "tools", "events", "actions" ], "title": "RunDiagnostics", "type": "object" }, "RunSnapshot": { "additionalProperties": false, "properties": { "agent_version": { "title": "Agent Version", "type": "string" }, "billing": { "anyOf": [ { "$ref": "#/components/schemas/RunBilling" }, { "type": "null" } ] }, "completion_reason": { "anyOf": [ { "enum": [ "final_answer", "needs_user_input" ], "type": "string" }, { "type": "null" } ], "description": "completed 的结束分类；needs_user_input 表示本轮已停止，用户可在同一会话发起后续 Run。", "title": "Completion Reason" }, "created_at": { "title": "Created At", "type": "number" }, "effective_reasoning_effort": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Effective Reasoning Effort" }, "error": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Error" }, "id": { "title": "Id", "type": "string" }, "messages": { "items": { "$ref": "#/components/schemas/DisplayMessage" }, "title": "Messages", "type": "array" }, "protocol_version": { "const": "1.0", "default": "1.0", "title": "Protocol Version", "type": "string" }, "queued_inputs": { "default": 0, "title": "Queued Inputs", "type": "integer" }, "reasoning_effort": { "anyOf": [ { "enum": [ "low", "medium", "high", "xhigh", "max" ], "type": "string" }, { "type": "null" } ], "title": "Reasoning Effort" }, "result": { "title": "Result", "tsType": "unknown" }, "resume_cursor": { "title": "Resume Cursor", "type": "integer" }, "session_id": { "title": "Session Id", "type": "string" }, "snapshot_sequence": { "title": "Snapshot Sequence", "type": "integer" }, "status": { "enum": [ "queued", "running", "waiting_tool", "waiting_approval", "completed", "failed", "cancelled", "expired", "waiting_subscription" ], "title": "Status", "type": "string" }, "steps": { "title": "Steps", "type": "integer" }, "tool_calls": { "items": { "$ref": "#/components/schemas/PublicToolCall" }, "title": "Tool Calls", "type": "array" }, "updated_at": { "title": "Updated At", "type": "number" }, "usage": { "additionalProperties": { "type": "integer" }, "title": "Usage", "type": "object" } }, "required": [ "id", "session_id", "status", "agent_version", "created_at", "updated_at", "snapshot_sequence", "resume_cursor", "messages", "tool_calls", "steps", "usage" ], "title": "RunSnapshot", "type": "object" }, "RuntimeAgent": { "additionalProperties": false, "properties": { "created_at": { "title": "Created At", "type": "number" }, "description": { "title": "Description", "type": "string" }, "id": { "title": "Id", "type": "string" }, "latest_version": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Latest Version" }, "name": { "title": "Name", "type": "string" }, "state": { "default": "active", "enum": [ "active", "paused", "archived" ], "title": "State", "type": "string" }, "status": { "default": "active", "description": "兼容字段，与 state 相同。", "enum": [ "active", "paused", "archived" ], "title": "Status", "type": "string" } }, "required": [ "id", "name", "description", "latest_version", "created_at" ], "title": "RuntimeAgent", "type": "object" }, "RuntimeAgentMetadata": { "additionalProperties": false, "properties": { "agent_id": { "title": "Agent Id", "type": "string" }, "can_start": { "description": "仅配置与服务状态；每次创建 Run 仍检查身份、余额和会话约束。", "title": "Can Start", "type": "boolean" }, "latest_version": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Latest Version" }, "model": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Model" }, "name": { "title": "Name", "type": "string" }, "reasoning_effort": { "anyOf": [ { "enum": [ "low", "medium", "high", "xhigh", "max" ], "type": "string" }, { "type": "null" } ], "title": "Reasoning Effort" }, "state": { "enum": [ "active", "paused", "archived" ], "title": "State", "type": "string" }, "toolset_version": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Toolset Version" }, "unavailable_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Unavailable Code" }, "unavailable_reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Unavailable Reason" }, "version_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Version Id" } }, "required": [ "agent_id", "name", "state", "latest_version", "version_id", "model", "reasoning_effort", "toolset_version", "can_start", "unavailable_code", "unavailable_reason" ], "title": "RuntimeAgentMetadata", "type": "object" }, "RuntimeAgentVersion": { "additionalProperties": false, "properties": { "agent_id": { "title": "Agent Id", "type": "string" }, "binding_ids": { "items": { "type": "string" }, "title": "Binding Ids", "type": "array" }, "created_at": { "title": "Created At", "type": "number" }, "id": { "title": "Id", "type": "string" }, "model": { "title": "Model", "type": "string" }, "reasoning_effort": { "anyOf": [ { "enum": [ "low", "medium", "high", "xhigh", "max" ], "type": "string" }, { "type": "null" } ], "title": "Reasoning Effort" } }, "required": [ "id", "agent_id", "model", "reasoning_effort", "created_at" ], "title": "RuntimeAgentVersion", "type": "object" }, "RuntimeConfiguration": { "additionalProperties": false, "properties": { "agents": { "items": { "$ref": "#/components/schemas/RuntimeAgent" }, "title": "Agents", "type": "array" }, "bindings": { "items": { "$ref": "#/components/schemas/BindingRecord" }, "title": "Bindings", "type": "array" }, "toolsets": { "items": { "$ref": "#/components/schemas/ToolsetRecord" }, "maxItems": 0, "title": "Toolsets", "type": "array" }, "versions": { "items": { "$ref": "#/components/schemas/RuntimeAgentVersion" }, "title": "Versions", "type": "array" } }, "required": [ "agents", "versions", "bindings" ], "title": "RuntimeConfiguration", "type": "object" }, "SessionCreate": { "additionalProperties": false, "properties": { "history_mode": { "default": "managed", "enum": [ "managed", "external" ], "title": "History Mode", "type": "string" }, "runtime_mode": { "default": "durable", "enum": [ "durable", "ephemeral" ], "title": "Runtime Mode", "type": "string" }, "title": { "default": "新会话", "maxLength": 160, "title": "Title", "type": "string" } }, "title": "SessionCreate", "type": "object" }, "SessionSnapshot": { "additionalProperties": false, "properties": { "active_run": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Active Run" }, "agent_version": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agent Version" }, "created_at": { "title": "Created At", "type": "number" }, "history_mode": { "enum": [ "managed", "external" ], "title": "History Mode", "type": "string" }, "id": { "title": "Id", "type": "string" }, "latest_run": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Latest Run" }, "runtime_mode": { "enum": [ "durable", "ephemeral" ], "title": "Runtime Mode", "type": "string" }, "title": { "title": "Title", "type": "string" } }, "required": [ "id", "history_mode", "runtime_mode", "title", "created_at" ], "title": "SessionSnapshot", "type": "object" }, "ToolDefinition": { "additionalProperties": false, "properties": { "binding_id": { "title": "Binding Id", "type": "string" }, "confirmation": { "default": "never", "enum": [ "always", "never" ], "title": "Confirmation", "type": "string" }, "description": { "maxLength": 4000, "title": "Description", "type": "string" }, "effect": { "default": "read", "enum": [ "read", "write" ], "title": "Effect", "type": "string" }, "idempotent": { "default": false, "title": "Idempotent", "type": "boolean" }, "input_schema": { "additionalProperties": true, "title": "Input Schema", "type": "object" }, "max_result_context_bytes": { "default": 16384, "description": "单个工具结果进入执行上下文的 UTF-8 字节预算；按 result 的紧凑 JSON（含转义、投影元数据）计量，默认 16384（16 KiB），范围 1024–32768（1–32 KiB）。超限保留头尾，完整回执仍保存；多模态非文本块及不可改写回执受保护。大结果应分页、筛选字段或按需读取。", "maximum": 32768, "minimum": 1024, "title": "Max Result Context Bytes", "type": "integer" }, "name": { "pattern": "^[a-zA-Z][a-zA-Z0-9_.-]{0,63}$", "title": "Name", "type": "string" }, "output_schema": { "additionalProperties": true, "title": "Output Schema", "type": "object" }, "result_semantics": { "default": "completion", "enum": [ "completion", "submission" ], "title": "Result Semantics", "type": "string" }, "scopes": { "items": { "type": "string" }, "maxItems": 32, "title": "Scopes", "type": "array" }, "supports_cancel": { "default": false, "title": "Supports Cancel", "type": "boolean" }, "timeout_seconds": { "default": 300, "maximum": 86400, "minimum": 5, "title": "Timeout Seconds", "type": "integer" }, "version": { "default": "1", "maxLength": 40, "title": "Version", "type": "string" } }, "required": [ "name", "description", "binding_id", "input_schema" ], "title": "ToolDefinition", "type": "object" }, "ToolDryRun": { "additionalProperties": false, "properties": { "agent_version": { "maxLength": 160, "minLength": 1, "title": "Agent Version", "type": "string" }, "arguments": { "additionalProperties": true, "title": "Arguments", "type": "object" }, "mock_receipts": { "items": { "$ref": "#/components/schemas/ReceiptCreate" }, "maxItems": 32, "title": "Mock Receipts", "type": "array" }, "tool_name": { "maxLength": 64, "minLength": 1, "title": "Tool Name", "type": "string" } }, "required": [ "agent_version", "tool_name" ], "title": "ToolDryRun", "type": "object" }, "ToolDryRunResult": { "additionalProperties": false, "properties": { "context_preview": { "anyOf": [ { "$ref": "#/components/schemas/ToolResultPreview" }, { "type": "null" } ], "description": "completed 模拟回执首次进入模型上下文时的结果投影；与运行时使用相同规则。" }, "execution_verified": { "default": false, "title": "Execution Verified", "type": "boolean" }, "final_kind": { "anyOf": [ { "enum": [ "completed", "failed", "cancelled" ], "type": "string" }, { "type": "null" } ], "title": "Final Kind" }, "handler_status": { "enum": [ "declared", "missing", "unconnected" ], "title": "Handler Status", "type": "string" }, "input_valid": { "default": true, "title": "Input Valid", "type": "boolean" }, "mode": { "const": "dry_run", "default": "dry_run", "title": "Mode", "type": "string" }, "receipts_valid": { "default": true, "title": "Receipts Valid", "type": "boolean" } }, "required": [ "handler_status" ], "title": "ToolDryRunResult", "type": "object" }, "ToolResultPreview": { "additionalProperties": false, "properties": { "max_result_context_bytes": { "title": "Max Result Context Bytes", "type": "integer" }, "original_bytes": { "title": "Original Bytes", "type": "integer" }, "result": { "title": "Result" }, "retained_bytes": { "title": "Retained Bytes", "type": "integer" }, "truncated": { "title": "Truncated", "type": "boolean" } }, "required": [ "max_result_context_bytes", "original_bytes", "retained_bytes", "truncated", "result" ], "title": "ToolResultPreview", "type": "object" }, "ToolsetCreate": { "additionalProperties": false, "properties": { "tools": { "items": { "$ref": "#/components/schemas/ToolDefinition" }, "maxItems": 64, "title": "Tools", "type": "array" } }, "required": [ "tools" ], "title": "ToolsetCreate", "type": "object" }, "ToolsetRecord": { "additionalProperties": false, "properties": { "created_at": { "title": "Created At", "type": "number" }, "id": { "title": "Id", "type": "string" }, "tools": { "items": { "$ref": "#/components/schemas/ToolDefinition" }, "maxItems": 64, "title": "Tools", "type": "array" }, "toolset_id": { "title": "Toolset Id", "type": "string" } }, "required": [ "tools", "id", "toolset_id", "created_at" ], "title": "ToolsetRecord", "type": "object" } }, "securitySchemes": { "HTTPBearer": { "scheme": "bearer", "type": "http" } } } }