{ "openapi": "3.0.0", "info": { "title": "Semantic Router Apiserver", "description": "Router management API for configuration, plugin operations, prepared-model diagnostics, storage, and observability", "version": "v1" }, "servers": [ { "url": "/", "description": "Router Apiserver" } ], "tags": [ { "name": "system", "description": "Health, readiness, and API contract discovery." }, { "name": "routing", "description": "Preview routing behavior without generating an answer." }, { "name": "diagnostics", "description": "Inspect and invoke recipe-scoped prepared models, classifiers, embeddings, and rerankers." }, { "name": "inventory", "description": "Inspect configured and loaded model and classifier resources." }, { "name": "observability", "description": "Inspect routing replays, metrics, and management audit; submit outcome evidence." }, { "name": "storage", "description": "Manage Router-owned knowledge bases, memories, files, vector stores, cache partitions, and context recovery." }, { "name": "plugins", "description": "Discover recipe-scoped plugin bindings, dependencies, and typed behavior previews." }, { "name": "config", "description": "Validate, inspect, apply, version, and roll back Router configuration and Recipes." } ], "paths": { "/api/v1": { "get": { "summary": "Progressive API capability discovery", "description": "Progressive API capability discovery", "operationId": "get_api_v1", "tags": [ "system" ], "parameters": [ { "name": "view", "in": "query", "description": "Omit for a compact capability index or use operations to include endpoint metadata.", "schema": { "type": "string", "enum": [ "index", "operations" ] } }, { "name": "capability", "in": "query", "description": "Return one capability group.", "schema": { "type": "string" } }, { "name": "audience", "in": "query", "description": "Return operations intended for one caller type.", "schema": { "type": "string", "enum": [ "agent", "operator", "client", "internal" ] } }, { "name": "plane", "in": "query", "description": "Return operations from one API plane.", "schema": { "type": "string", "enum": [ "infrastructure", "management", "diagnostic", "data" ] } }, { "name": "visibility", "in": "query", "description": "Return primary or advanced operations.", "schema": { "type": "string", "enum": [ "primary", "advanced" ] } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "capabilities": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "description": { "type": "string" }, "discovery": { "type": "string" }, "name": { "type": "string" }, "openapi": { "type": "string" }, "operation_count": { "type": "integer" }, "primary_operations": { "type": "integer" } }, "required": [ "name", "description", "operation_count", "primary_operations", "discovery", "openapi" ] } }, "description": { "type": "string" }, "endpoints": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "audiences": { "nullable": true, "type": "array", "items": { "type": "string" } }, "capability": { "type": "string" }, "deprecated": { "type": "boolean" }, "description": { "type": "string" }, "method": { "type": "string" }, "path": { "type": "string" }, "permission": { "type": "string" }, "plane": { "type": "string" }, "plugin_operations": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "mode": { "type": "string" }, "plugin": { "type": "string" } }, "required": [ "plugin", "mode" ] } }, "sensitivity": { "type": "string" }, "stability": { "type": "string" }, "visibility": { "type": "string" } }, "required": [ "path", "method", "description", "permission", "sensitivity", "capability", "plane", "audiences", "stability", "visibility", "deprecated" ] } }, "links": { "nullable": true, "type": "object", "additionalProperties": { "type": "string" } }, "service": { "type": "string" }, "version": { "type": "string" } }, "required": [ "service", "version", "description", "capabilities", "links" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "docs.read", "x-vllm-sr-sensitivity": "public", "x-vllm-sr-plane": "infrastructure", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" } }, "/api/v1/config": { "get": { "summary": "Get the current router config as JSON (secrets redacted without secret_view)", "description": "Get the current router config as JSON (secrets redacted without secret_view)", "operationId": "get_api_v1_config", "tags": [ "config" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Canonical configuration document; field schemas are available at /api/v1/config/schema?view=full", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } }, "headers": { "ETag": { "description": "Current document version; use as If-Match for a conditional mutation or If-None-Match for a schema read.", "schema": { "type": "string" } }, "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } }, "x-vsr-config-hash": { "description": "SHA-256 of the document the serving configuration snapshot was compiled from.", "schema": { "type": "string" } }, "x-vsr-config-version": { "description": "Version of the configuration snapshot that serves; it can trail the persisted document while an update activates or after one is rejected.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "config.read", "x-vllm-sr-sensitivity": "secret_view", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" }, "patch": { "summary": "Compare-and-swap merge of a router config update (validates, backs up, writes, triggers hot-reload)", "description": "Compare-and-swap merge of a router config update (validates, backs up, writes, triggers hot-reload)", "operationId": "patch_api_v1_config", "tags": [ "config" ], "parameters": [ { "name": "If-Match", "in": "header", "description": "Required ETag returned by GET /api/v1/config or POST /api/v1/config/plan.", "required": true, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Configuration persisted; activation_status and generated_runtime_hash identify its runtime publication", "content": { "application/json": { "schema": { "type": "object", "properties": { "activation": { "nullable": true, "type": "object", "properties": { "attempt": { "type": "integer" }, "document_hash": { "type": "string" }, "error": { "type": "string" }, "finished_at": { "nullable": true, "type": "string", "format": "date-time" }, "reasons": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "path": { "type": "string" }, "stage": { "type": "string" } }, "required": [ "stage", "code", "message" ] } }, "source": { "type": "string" }, "stage": { "type": "string" }, "started_at": { "type": "string", "format": "date-time" }, "status": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "attempt", "document_hash", "source", "status", "stage", "started_at" ] }, "activation_status": { "type": "string" }, "config_version": { "type": "integer" }, "etag": { "type": "string" }, "generated_runtime_hash": { "type": "string" }, "message": { "type": "string" }, "rollback_of": { "type": "integer" }, "status": { "type": "string" }, "version": { "type": "string" } }, "required": [ "status", "version" ] } } }, "headers": { "ETag": { "description": "Current document version; use as If-Match for a conditional mutation or If-None-Match for a schema read.", "schema": { "type": "string" } }, "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "202": { "description": "Configuration persisted; activation_status and generated_runtime_hash identify its runtime publication", "content": { "application/json": { "schema": { "type": "object", "properties": { "activation": { "nullable": true, "type": "object", "properties": { "attempt": { "type": "integer" }, "document_hash": { "type": "string" }, "error": { "type": "string" }, "finished_at": { "nullable": true, "type": "string", "format": "date-time" }, "reasons": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "path": { "type": "string" }, "stage": { "type": "string" } }, "required": [ "stage", "code", "message" ] } }, "source": { "type": "string" }, "stage": { "type": "string" }, "started_at": { "type": "string", "format": "date-time" }, "status": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "attempt", "document_hash", "source", "status", "stage", "started_at" ] }, "activation_status": { "type": "string" }, "config_version": { "type": "integer" }, "etag": { "type": "string" }, "generated_runtime_hash": { "type": "string" }, "message": { "type": "string" }, "rollback_of": { "type": "integer" }, "status": { "type": "string" }, "version": { "type": "string" } }, "required": [ "status", "version" ] } } }, "headers": { "ETag": { "description": "Current document version; use as If-Match for a conditional mutation or If-None-Match for a schema read.", "schema": { "type": "string" } }, "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "409": { "description": "Conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "412": { "description": "Precondition Failed", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "ETag": { "description": "Current document version; use as If-Match for a conditional mutation or If-None-Match for a schema read.", "schema": { "type": "string" } }, "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "428": { "description": "Precondition Required", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Configuration persisted but activation failed; the active runtime remains on its previous generation", "content": { "application/json": { "schema": { "oneOf": [ { "type": "object", "properties": { "activation": { "nullable": true, "type": "object", "properties": { "attempt": { "type": "integer" }, "document_hash": { "type": "string" }, "error": { "type": "string" }, "finished_at": { "nullable": true, "type": "string", "format": "date-time" }, "reasons": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "path": { "type": "string" }, "stage": { "type": "string" } }, "required": [ "stage", "code", "message" ] } }, "source": { "type": "string" }, "stage": { "type": "string" }, "started_at": { "type": "string", "format": "date-time" }, "status": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "attempt", "document_hash", "source", "status", "stage", "started_at" ] }, "activation_status": { "type": "string" }, "config_version": { "type": "integer" }, "etag": { "type": "string" }, "generated_runtime_hash": { "type": "string" }, "message": { "type": "string" }, "rollback_of": { "type": "integer" }, "status": { "type": "string" }, "version": { "type": "string" } }, "required": [ "status", "version" ] }, { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } ] } } }, "headers": { "ETag": { "description": "Current document version; use as If-Match for a conditional mutation or If-None-Match for a schema read.", "schema": { "type": "string" } }, "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "yaml": { "type": "string" } }, "required": [ "yaml" ], "additionalProperties": false } } } }, "x-vllm-sr-permission": "config.write", "x-vllm-sr-sensitivity": "mutation", "x-vllm-sr-audit-action": "config.patch", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" }, "put": { "summary": "Compare-and-swap replacement of the router config (validates, backs up, writes, triggers hot-reload)", "description": "Compare-and-swap replacement of the router config (validates, backs up, writes, triggers hot-reload)", "operationId": "put_api_v1_config", "tags": [ "config" ], "parameters": [ { "name": "If-Match", "in": "header", "description": "Required ETag returned by GET /api/v1/config or POST /api/v1/config/plan.", "required": true, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Configuration persisted; activation_status and generated_runtime_hash identify its runtime publication", "content": { "application/json": { "schema": { "type": "object", "properties": { "activation": { "nullable": true, "type": "object", "properties": { "attempt": { "type": "integer" }, "document_hash": { "type": "string" }, "error": { "type": "string" }, "finished_at": { "nullable": true, "type": "string", "format": "date-time" }, "reasons": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "path": { "type": "string" }, "stage": { "type": "string" } }, "required": [ "stage", "code", "message" ] } }, "source": { "type": "string" }, "stage": { "type": "string" }, "started_at": { "type": "string", "format": "date-time" }, "status": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "attempt", "document_hash", "source", "status", "stage", "started_at" ] }, "activation_status": { "type": "string" }, "config_version": { "type": "integer" }, "etag": { "type": "string" }, "generated_runtime_hash": { "type": "string" }, "message": { "type": "string" }, "rollback_of": { "type": "integer" }, "status": { "type": "string" }, "version": { "type": "string" } }, "required": [ "status", "version" ] } } }, "headers": { "ETag": { "description": "Current document version; use as If-Match for a conditional mutation or If-None-Match for a schema read.", "schema": { "type": "string" } }, "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "202": { "description": "Configuration persisted; activation_status and generated_runtime_hash identify its runtime publication", "content": { "application/json": { "schema": { "type": "object", "properties": { "activation": { "nullable": true, "type": "object", "properties": { "attempt": { "type": "integer" }, "document_hash": { "type": "string" }, "error": { "type": "string" }, "finished_at": { "nullable": true, "type": "string", "format": "date-time" }, "reasons": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "path": { "type": "string" }, "stage": { "type": "string" } }, "required": [ "stage", "code", "message" ] } }, "source": { "type": "string" }, "stage": { "type": "string" }, "started_at": { "type": "string", "format": "date-time" }, "status": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "attempt", "document_hash", "source", "status", "stage", "started_at" ] }, "activation_status": { "type": "string" }, "config_version": { "type": "integer" }, "etag": { "type": "string" }, "generated_runtime_hash": { "type": "string" }, "message": { "type": "string" }, "rollback_of": { "type": "integer" }, "status": { "type": "string" }, "version": { "type": "string" } }, "required": [ "status", "version" ] } } }, "headers": { "ETag": { "description": "Current document version; use as If-Match for a conditional mutation or If-None-Match for a schema read.", "schema": { "type": "string" } }, "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "409": { "description": "Conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "412": { "description": "Precondition Failed", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "ETag": { "description": "Current document version; use as If-Match for a conditional mutation or If-None-Match for a schema read.", "schema": { "type": "string" } }, "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "428": { "description": "Precondition Required", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Configuration persisted but activation failed; the active runtime remains on its previous generation", "content": { "application/json": { "schema": { "oneOf": [ { "type": "object", "properties": { "activation": { "nullable": true, "type": "object", "properties": { "attempt": { "type": "integer" }, "document_hash": { "type": "string" }, "error": { "type": "string" }, "finished_at": { "nullable": true, "type": "string", "format": "date-time" }, "reasons": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "path": { "type": "string" }, "stage": { "type": "string" } }, "required": [ "stage", "code", "message" ] } }, "source": { "type": "string" }, "stage": { "type": "string" }, "started_at": { "type": "string", "format": "date-time" }, "status": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "attempt", "document_hash", "source", "status", "stage", "started_at" ] }, "activation_status": { "type": "string" }, "config_version": { "type": "integer" }, "etag": { "type": "string" }, "generated_runtime_hash": { "type": "string" }, "message": { "type": "string" }, "rollback_of": { "type": "integer" }, "status": { "type": "string" }, "version": { "type": "string" } }, "required": [ "status", "version" ] }, { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } ] } } }, "headers": { "ETag": { "description": "Current document version; use as If-Match for a conditional mutation or If-None-Match for a schema read.", "schema": { "type": "string" } }, "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "yaml": { "type": "string" } }, "required": [ "yaml" ], "additionalProperties": false } } } }, "x-vllm-sr-permission": "config.write", "x-vllm-sr-sensitivity": "mutation", "x-vllm-sr-audit-action": "config.put", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" } }, "/api/v1/config/hash": { "get": { "summary": "Compare persisted source, generated runtime, and active router config hashes", "description": "Compare persisted source, generated runtime, and active router config hashes", "operationId": "get_api_v1_config_hash", "tags": [ "config" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "activation": { "nullable": true, "type": "object", "properties": { "attempt": { "type": "integer" }, "document_hash": { "type": "string" }, "error": { "type": "string" }, "finished_at": { "nullable": true, "type": "string", "format": "date-time" }, "reasons": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "path": { "type": "string" }, "stage": { "type": "string" } }, "required": [ "stage", "code", "message" ] } }, "source": { "type": "string" }, "stage": { "type": "string" }, "started_at": { "type": "string", "format": "date-time" }, "status": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "attempt", "document_hash", "source", "status", "stage", "started_at" ] }, "activation_status": { "type": "string" }, "active_runtime_hash": { "type": "string" }, "active_version": { "type": "integer" }, "generated_runtime_hash": { "type": "string" }, "last_rejection": { "nullable": true, "type": "object", "properties": { "attempt": { "type": "integer" }, "document_hash": { "type": "string" }, "error": { "type": "string" }, "finished_at": { "nullable": true, "type": "string", "format": "date-time" }, "reasons": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "path": { "type": "string" }, "stage": { "type": "string" } }, "required": [ "stage", "code", "message" ] } }, "source": { "type": "string" }, "stage": { "type": "string" }, "started_at": { "type": "string", "format": "date-time" }, "status": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "attempt", "document_hash", "source", "status", "stage", "started_at" ] }, "source_config_hash": { "type": "string" } }, "required": [ "source_config_hash", "generated_runtime_hash", "activation_status" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "config.read", "x-vllm-sr-sensitivity": "config", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" } }, "/api/v1/config/plan": { "post": { "summary": "Plan an exact merge or replace mutation, including hot-reload compatibility, without writing it", "description": "Plan an exact merge or replace mutation, including hot-reload compatibility, without writing it", "operationId": "post_api_v1_config_plan", "tags": [ "config" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "candidate_etag": { "type": "string" }, "changed": { "type": "boolean" }, "current_etag": { "type": "string" }, "mode": { "type": "string" }, "valid": { "type": "boolean" } }, "required": [ "valid", "mode", "changed", "candidate_etag" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "409": { "description": "Conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "mode": { "type": "string" }, "yaml": { "type": "string" } }, "required": [ "yaml", "mode" ], "additionalProperties": false } } } }, "x-vllm-sr-permission": "config.read", "x-vllm-sr-sensitivity": "config", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" } }, "/api/v1/config/recipes": { "get": { "summary": "List the default and named routing recipes with their entrypoints", "description": "List the default and named routing recipes with their entrypoints", "operationId": "get_api_v1_config_recipes", "tags": [ "config" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "etag": { "type": "string" }, "recipes": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "deletable": { "type": "boolean" }, "description": { "type": "string" }, "entrypoint_source": { "type": "string" }, "entrypoints": { "nullable": true, "type": "array", "items": { "type": "string" } }, "name": { "type": "string" }, "routing": { "nullable": true, "type": "object", "additionalProperties": true }, "source": { "type": "string" } }, "required": [ "entrypoint_source", "name", "routing", "entrypoints", "source", "deletable" ] } } }, "required": [ "etag", "recipes" ] } } }, "headers": { "ETag": { "description": "Current document version; use as If-Match for a conditional mutation or If-None-Match for a schema read.", "schema": { "type": "string" } }, "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "config.read", "x-vllm-sr-sensitivity": "secret_view", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" } }, "/api/v1/config/recipes/validate": { "post": { "summary": "Validate a recipe mutation without writing or reloading config", "description": "Validate a recipe mutation without writing or reloading config", "operationId": "post_api_v1_config_recipes_validate", "tags": [ "config" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "action": { "type": "string" }, "name": { "type": "string" }, "valid": { "type": "boolean" } }, "required": [ "valid", "name", "action" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "description": { "nullable": true, "type": "string" }, "entrypoints": { "nullable": true, "type": "array", "items": { "type": "string" } }, "name": { "type": "string" }, "routing": { "nullable": true, "type": "object", "additionalProperties": true } }, "required": [ "routing" ], "additionalProperties": false } } } }, "x-vllm-sr-permission": "config.read", "x-vllm-sr-sensitivity": "config", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" } }, "/api/v1/config/recipes/{name}": { "get": { "summary": "Read one routing recipe and its entrypoints", "description": "Read one routing recipe and its entrypoints", "operationId": "get_api_v1_config_recipes_name", "tags": [ "config" ], "parameters": [ { "name": "name", "in": "path", "description": "name path parameter", "required": true, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "deletable": { "type": "boolean" }, "description": { "type": "string" }, "entrypoint_source": { "type": "string" }, "entrypoints": { "nullable": true, "type": "array", "items": { "type": "string" } }, "name": { "type": "string" }, "routing": { "nullable": true, "type": "object", "additionalProperties": true }, "source": { "type": "string" } }, "required": [ "entrypoint_source", "name", "routing", "entrypoints", "source", "deletable" ] } } }, "headers": { "ETag": { "description": "Current document version; use as If-Match for a conditional mutation or If-None-Match for a schema read.", "schema": { "type": "string" } }, "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "config.read", "x-vllm-sr-sensitivity": "secret_view", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" }, "put": { "summary": "Atomically create or replace one routing recipe; requires If-Match", "description": "Atomically create or replace one routing recipe; requires If-Match", "operationId": "put_api_v1_config_recipes_name", "tags": [ "config" ], "parameters": [ { "name": "name", "in": "path", "description": "name path parameter", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "description": "ETag returned by the current recipe or recipe collection.", "required": true, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Configuration persisted; activation_status and generated_runtime_hash identify its runtime publication", "content": { "application/json": { "schema": { "type": "object", "properties": { "activation": { "nullable": true, "type": "object", "properties": { "attempt": { "type": "integer" }, "document_hash": { "type": "string" }, "error": { "type": "string" }, "finished_at": { "nullable": true, "type": "string", "format": "date-time" }, "reasons": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "path": { "type": "string" }, "stage": { "type": "string" } }, "required": [ "stage", "code", "message" ] } }, "source": { "type": "string" }, "stage": { "type": "string" }, "started_at": { "type": "string", "format": "date-time" }, "status": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "attempt", "document_hash", "source", "status", "stage", "started_at" ] }, "activation_status": { "type": "string" }, "config_version": { "type": "integer" }, "etag": { "type": "string" }, "generated_runtime_hash": { "type": "string" }, "message": { "type": "string" }, "rollback_of": { "type": "integer" }, "status": { "type": "string" }, "version": { "type": "string" } }, "required": [ "status", "version" ] } } }, "headers": { "ETag": { "description": "Current document version; use as If-Match for a conditional mutation or If-None-Match for a schema read.", "schema": { "type": "string" } }, "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "201": { "description": "Recipe created", "content": { "application/json": { "schema": { "type": "object", "properties": { "activation": { "nullable": true, "type": "object", "properties": { "attempt": { "type": "integer" }, "document_hash": { "type": "string" }, "error": { "type": "string" }, "finished_at": { "nullable": true, "type": "string", "format": "date-time" }, "reasons": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "path": { "type": "string" }, "stage": { "type": "string" } }, "required": [ "stage", "code", "message" ] } }, "source": { "type": "string" }, "stage": { "type": "string" }, "started_at": { "type": "string", "format": "date-time" }, "status": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "attempt", "document_hash", "source", "status", "stage", "started_at" ] }, "activation_status": { "type": "string" }, "config_version": { "type": "integer" }, "etag": { "type": "string" }, "generated_runtime_hash": { "type": "string" }, "message": { "type": "string" }, "rollback_of": { "type": "integer" }, "status": { "type": "string" }, "version": { "type": "string" } }, "required": [ "status", "version" ] } } }, "headers": { "ETag": { "description": "Current document version; use as If-Match for a conditional mutation or If-None-Match for a schema read.", "schema": { "type": "string" } }, "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "202": { "description": "Configuration persisted; activation_status and generated_runtime_hash identify its runtime publication", "content": { "application/json": { "schema": { "type": "object", "properties": { "activation": { "nullable": true, "type": "object", "properties": { "attempt": { "type": "integer" }, "document_hash": { "type": "string" }, "error": { "type": "string" }, "finished_at": { "nullable": true, "type": "string", "format": "date-time" }, "reasons": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "path": { "type": "string" }, "stage": { "type": "string" } }, "required": [ "stage", "code", "message" ] } }, "source": { "type": "string" }, "stage": { "type": "string" }, "started_at": { "type": "string", "format": "date-time" }, "status": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "attempt", "document_hash", "source", "status", "stage", "started_at" ] }, "activation_status": { "type": "string" }, "config_version": { "type": "integer" }, "etag": { "type": "string" }, "generated_runtime_hash": { "type": "string" }, "message": { "type": "string" }, "rollback_of": { "type": "integer" }, "status": { "type": "string" }, "version": { "type": "string" } }, "required": [ "status", "version" ] } } }, "headers": { "ETag": { "description": "Current document version; use as If-Match for a conditional mutation or If-None-Match for a schema read.", "schema": { "type": "string" } }, "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "409": { "description": "Conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "412": { "description": "Precondition Failed", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "ETag": { "description": "Current document version; use as If-Match for a conditional mutation or If-None-Match for a schema read.", "schema": { "type": "string" } }, "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "428": { "description": "Precondition Required", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Configuration persisted but activation failed; the active runtime remains on its previous generation", "content": { "application/json": { "schema": { "oneOf": [ { "type": "object", "properties": { "activation": { "nullable": true, "type": "object", "properties": { "attempt": { "type": "integer" }, "document_hash": { "type": "string" }, "error": { "type": "string" }, "finished_at": { "nullable": true, "type": "string", "format": "date-time" }, "reasons": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "path": { "type": "string" }, "stage": { "type": "string" } }, "required": [ "stage", "code", "message" ] } }, "source": { "type": "string" }, "stage": { "type": "string" }, "started_at": { "type": "string", "format": "date-time" }, "status": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "attempt", "document_hash", "source", "status", "stage", "started_at" ] }, "activation_status": { "type": "string" }, "config_version": { "type": "integer" }, "etag": { "type": "string" }, "generated_runtime_hash": { "type": "string" }, "message": { "type": "string" }, "rollback_of": { "type": "integer" }, "status": { "type": "string" }, "version": { "type": "string" } }, "required": [ "status", "version" ] }, { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } ] } } }, "headers": { "ETag": { "description": "Current document version; use as If-Match for a conditional mutation or If-None-Match for a schema read.", "schema": { "type": "string" } }, "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "description": { "nullable": true, "type": "string" }, "entrypoints": { "nullable": true, "type": "array", "items": { "type": "string" } }, "name": { "type": "string" }, "routing": { "nullable": true, "type": "object", "additionalProperties": true } }, "required": [ "routing" ], "additionalProperties": false } } } }, "x-vllm-sr-permission": "config.write", "x-vllm-sr-sensitivity": "mutation", "x-vllm-sr-audit-action": "recipe.save", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" }, "delete": { "summary": "Delete an unreferenced named routing recipe; requires If-Match", "description": "Delete an unreferenced named routing recipe; requires If-Match", "operationId": "delete_api_v1_config_recipes_name", "tags": [ "config" ], "parameters": [ { "name": "name", "in": "path", "description": "name path parameter", "required": true, "schema": { "type": "string" } }, { "name": "If-Match", "in": "header", "description": "ETag returned by the current recipe or recipe collection.", "required": true, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Configuration persisted; activation_status and generated_runtime_hash identify its runtime publication", "content": { "application/json": { "schema": { "type": "object", "properties": { "activation": { "nullable": true, "type": "object", "properties": { "attempt": { "type": "integer" }, "document_hash": { "type": "string" }, "error": { "type": "string" }, "finished_at": { "nullable": true, "type": "string", "format": "date-time" }, "reasons": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "path": { "type": "string" }, "stage": { "type": "string" } }, "required": [ "stage", "code", "message" ] } }, "source": { "type": "string" }, "stage": { "type": "string" }, "started_at": { "type": "string", "format": "date-time" }, "status": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "attempt", "document_hash", "source", "status", "stage", "started_at" ] }, "activation_status": { "type": "string" }, "config_version": { "type": "integer" }, "etag": { "type": "string" }, "generated_runtime_hash": { "type": "string" }, "message": { "type": "string" }, "rollback_of": { "type": "integer" }, "status": { "type": "string" }, "version": { "type": "string" } }, "required": [ "status", "version" ] } } }, "headers": { "ETag": { "description": "Current document version; use as If-Match for a conditional mutation or If-None-Match for a schema read.", "schema": { "type": "string" } }, "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "202": { "description": "Configuration persisted; activation_status and generated_runtime_hash identify its runtime publication", "content": { "application/json": { "schema": { "type": "object", "properties": { "activation": { "nullable": true, "type": "object", "properties": { "attempt": { "type": "integer" }, "document_hash": { "type": "string" }, "error": { "type": "string" }, "finished_at": { "nullable": true, "type": "string", "format": "date-time" }, "reasons": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "path": { "type": "string" }, "stage": { "type": "string" } }, "required": [ "stage", "code", "message" ] } }, "source": { "type": "string" }, "stage": { "type": "string" }, "started_at": { "type": "string", "format": "date-time" }, "status": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "attempt", "document_hash", "source", "status", "stage", "started_at" ] }, "activation_status": { "type": "string" }, "config_version": { "type": "integer" }, "etag": { "type": "string" }, "generated_runtime_hash": { "type": "string" }, "message": { "type": "string" }, "rollback_of": { "type": "integer" }, "status": { "type": "string" }, "version": { "type": "string" } }, "required": [ "status", "version" ] } } }, "headers": { "ETag": { "description": "Current document version; use as If-Match for a conditional mutation or If-None-Match for a schema read.", "schema": { "type": "string" } }, "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "409": { "description": "Conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "412": { "description": "Precondition Failed", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "ETag": { "description": "Current document version; use as If-Match for a conditional mutation or If-None-Match for a schema read.", "schema": { "type": "string" } }, "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "428": { "description": "Precondition Required", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Configuration persisted but activation failed; the active runtime remains on its previous generation", "content": { "application/json": { "schema": { "oneOf": [ { "type": "object", "properties": { "activation": { "nullable": true, "type": "object", "properties": { "attempt": { "type": "integer" }, "document_hash": { "type": "string" }, "error": { "type": "string" }, "finished_at": { "nullable": true, "type": "string", "format": "date-time" }, "reasons": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "path": { "type": "string" }, "stage": { "type": "string" } }, "required": [ "stage", "code", "message" ] } }, "source": { "type": "string" }, "stage": { "type": "string" }, "started_at": { "type": "string", "format": "date-time" }, "status": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "attempt", "document_hash", "source", "status", "stage", "started_at" ] }, "activation_status": { "type": "string" }, "config_version": { "type": "integer" }, "etag": { "type": "string" }, "generated_runtime_hash": { "type": "string" }, "message": { "type": "string" }, "rollback_of": { "type": "integer" }, "status": { "type": "string" }, "version": { "type": "string" } }, "required": [ "status", "version" ] }, { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } ] } } }, "headers": { "ETag": { "description": "Current document version; use as If-Match for a conditional mutation or If-None-Match for a schema read.", "schema": { "type": "string" } }, "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "config.write", "x-vllm-sr-sensitivity": "mutation", "x-vllm-sr-audit-action": "recipe.delete", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" } }, "/api/v1/config/rollback": { "post": { "summary": "Compare-and-swap rollback to a previous router config version", "description": "Compare-and-swap rollback to a previous router config version", "operationId": "post_api_v1_config_rollback", "tags": [ "config" ], "parameters": [ { "name": "If-Match", "in": "header", "description": "Required ETag returned by GET /api/v1/config.", "required": true, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Configuration persisted; activation_status and generated_runtime_hash identify its runtime publication", "content": { "application/json": { "schema": { "type": "object", "properties": { "activation": { "nullable": true, "type": "object", "properties": { "attempt": { "type": "integer" }, "document_hash": { "type": "string" }, "error": { "type": "string" }, "finished_at": { "nullable": true, "type": "string", "format": "date-time" }, "reasons": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "path": { "type": "string" }, "stage": { "type": "string" } }, "required": [ "stage", "code", "message" ] } }, "source": { "type": "string" }, "stage": { "type": "string" }, "started_at": { "type": "string", "format": "date-time" }, "status": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "attempt", "document_hash", "source", "status", "stage", "started_at" ] }, "activation_status": { "type": "string" }, "config_version": { "type": "integer" }, "etag": { "type": "string" }, "generated_runtime_hash": { "type": "string" }, "message": { "type": "string" }, "rollback_of": { "type": "integer" }, "status": { "type": "string" }, "version": { "type": "string" } }, "required": [ "status", "version" ] } } }, "headers": { "ETag": { "description": "Current document version; use as If-Match for a conditional mutation or If-None-Match for a schema read.", "schema": { "type": "string" } }, "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "202": { "description": "Configuration persisted; activation_status and generated_runtime_hash identify its runtime publication", "content": { "application/json": { "schema": { "type": "object", "properties": { "activation": { "nullable": true, "type": "object", "properties": { "attempt": { "type": "integer" }, "document_hash": { "type": "string" }, "error": { "type": "string" }, "finished_at": { "nullable": true, "type": "string", "format": "date-time" }, "reasons": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "path": { "type": "string" }, "stage": { "type": "string" } }, "required": [ "stage", "code", "message" ] } }, "source": { "type": "string" }, "stage": { "type": "string" }, "started_at": { "type": "string", "format": "date-time" }, "status": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "attempt", "document_hash", "source", "status", "stage", "started_at" ] }, "activation_status": { "type": "string" }, "config_version": { "type": "integer" }, "etag": { "type": "string" }, "generated_runtime_hash": { "type": "string" }, "message": { "type": "string" }, "rollback_of": { "type": "integer" }, "status": { "type": "string" }, "version": { "type": "string" } }, "required": [ "status", "version" ] } } }, "headers": { "ETag": { "description": "Current document version; use as If-Match for a conditional mutation or If-None-Match for a schema read.", "schema": { "type": "string" } }, "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "409": { "description": "Conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "412": { "description": "Precondition Failed", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "ETag": { "description": "Current document version; use as If-Match for a conditional mutation or If-None-Match for a schema read.", "schema": { "type": "string" } }, "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "428": { "description": "Precondition Required", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Configuration persisted but activation failed; the active runtime remains on its previous generation", "content": { "application/json": { "schema": { "oneOf": [ { "type": "object", "properties": { "activation": { "nullable": true, "type": "object", "properties": { "attempt": { "type": "integer" }, "document_hash": { "type": "string" }, "error": { "type": "string" }, "finished_at": { "nullable": true, "type": "string", "format": "date-time" }, "reasons": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "path": { "type": "string" }, "stage": { "type": "string" } }, "required": [ "stage", "code", "message" ] } }, "source": { "type": "string" }, "stage": { "type": "string" }, "started_at": { "type": "string", "format": "date-time" }, "status": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "attempt", "document_hash", "source", "status", "stage", "started_at" ] }, "activation_status": { "type": "string" }, "config_version": { "type": "integer" }, "etag": { "type": "string" }, "generated_runtime_hash": { "type": "string" }, "message": { "type": "string" }, "rollback_of": { "type": "integer" }, "status": { "type": "string" }, "version": { "type": "string" } }, "required": [ "status", "version" ] }, { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } ] } } }, "headers": { "ETag": { "description": "Current document version; use as If-Match for a conditional mutation or If-None-Match for a schema read.", "schema": { "type": "string" } }, "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "config_version": { "type": "integer" }, "version": { "type": "string" } }, "additionalProperties": false } } } }, "x-vllm-sr-permission": "config.write", "x-vllm-sr-sensitivity": "mutation", "x-vllm-sr-audit-action": "config.rollback", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" } }, "/api/v1/config/schema": { "get": { "summary": "Discover the canonical Router configuration contract progressively or return the complete JSON Schema", "description": "Discover the canonical Router configuration contract progressively or return the complete JSON Schema", "operationId": "get_api_v1_config_schema", "tags": [ "config" ], "parameters": [ { "name": "view", "in": "query", "description": "Representation to return. Omit for the compact index; use full for the complete schema.", "schema": { "type": "string", "enum": [ "full", "index", "section", "surface" ] } }, { "name": "path", "in": "query", "description": "Dot- or slash-delimited config path required by view=section.", "schema": { "type": "string" } }, { "name": "If-None-Match", "in": "header", "description": "Return 304 when the selected schema representation has this ETag.", "schema": { "type": "string" } }, { "name": "expanded", "in": "query", "description": "Return a self-contained JSON Schema for view=section instead of its compact field directory.", "schema": { "type": "boolean" } }, { "name": "kind", "in": "query", "description": "Surface kind required by view=surface.", "schema": { "type": "string", "enum": [ "signal", "algorithm", "plugin", "projection" ] } }, { "name": "name", "in": "query", "description": "Registered surface name required by view=surface.", "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Complete or selected JSON Schema document", "content": { "application/json": { "schema": { "oneOf": [ { "type": "object", "properties": { "config_version": { "type": "string" }, "contract_version": { "type": "string" }, "default_view": { "type": "string" }, "schema_etag": { "type": "string" }, "schema_id": { "type": "string" }, "sections": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "description": { "type": "string" }, "href": { "type": "string" }, "path": { "type": "string" }, "required": { "type": "boolean" }, "title": { "type": "string" } }, "required": [ "path", "title", "required", "href" ] } }, "surfaces": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "count": { "type": "integer" }, "href_template": { "type": "string" }, "names": { "nullable": true, "type": "array", "items": { "type": "string" } } }, "required": [ "count", "names", "href_template" ] } }, "views": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "description": { "type": "string" }, "href": { "type": "string" }, "name": { "type": "string" } }, "required": [ "name", "description", "href" ] } } }, "required": [ "contract_version", "config_version", "schema_id", "schema_etag", "default_view", "views", "sections", "surfaces" ] }, { "type": "object", "properties": { "const": {}, "default": {}, "description": { "type": "string" }, "enum": {}, "expanded_href": { "type": "string" }, "fields": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "const": {}, "default": {}, "description": { "type": "string" }, "enum": {}, "href": { "type": "string" }, "maximum": {}, "minimum": {}, "name": { "type": "string" }, "path": { "type": "string" }, "required": { "type": "boolean" }, "type": { "type": "string" } }, "required": [ "name", "path", "type", "required", "href" ] } }, "maximum": {}, "minimum": {}, "shape": { "type": "string" }, "title": { "type": "string" }, "x-vllm-sr-view": { "nullable": true, "type": "object", "additionalProperties": true } }, "required": [ "x-vllm-sr-view", "shape", "title", "fields", "expanded_href" ] } ] } }, "application/schema+json": { "schema": { "type": "object", "additionalProperties": true } } }, "headers": { "ETag": { "description": "Current document version; use as If-Match for a conditional mutation or If-None-Match for a schema read.", "schema": { "type": "string" } }, "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "304": { "description": "Schema matches If-None-Match", "headers": { "ETag": { "description": "Current document version; use as If-Match for a conditional mutation or If-None-Match for a schema read.", "schema": { "type": "string" } }, "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "docs.read", "x-vllm-sr-sensitivity": "public", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" } }, "/api/v1/config/validate": { "post": { "summary": "Validate and normalize a router config without writing it", "description": "Validate and normalize a router config without writing it", "operationId": "post_api_v1_config_validate", "tags": [ "config" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "normalized_yaml": { "type": "string" }, "valid": { "type": "boolean" }, "warnings": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "field": { "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "field", "message" ] } } }, "required": [ "valid", "normalized_yaml", "warnings" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "yaml": { "type": "string" } }, "required": [ "yaml" ], "additionalProperties": false } } } }, "x-vllm-sr-permission": "config.read", "x-vllm-sr-sensitivity": "config", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" } }, "/api/v1/config/versions": { "get": { "summary": "List available router config backup versions", "description": "List available router config backup versions", "operationId": "get_api_v1_config_versions", "tags": [ "config" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "active": { "type": "boolean" }, "config_version": { "type": "integer" }, "filename": { "type": "string" }, "hash": { "type": "string" }, "rollback_of": { "type": "integer" }, "source": { "type": "string" }, "timestamp": { "type": "string" }, "version": { "type": "string" } }, "required": [ "version", "timestamp", "source", "filename" ] } } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "config.read", "x-vllm-sr-sensitivity": "config", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" } }, "/api/v1/diagnostics/classify/batch": { "post": { "summary": "Batch classification with configurable task_type parameter", "description": "Batch classification with configurable task_type parameter", "operationId": "post_api_v1_diagnostics_classify_batch", "tags": [ "diagnostics" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "processing_time_ms": { "type": "integer" }, "recipe": { "type": "string" }, "results": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "category": { "type": "string" }, "confidence": { "type": "number" }, "pii": { "nullable": true, "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "has_pii": { "type": "boolean" }, "pii_types": { "nullable": true, "type": "array", "items": { "type": "string" } }, "scores_available": { "nullable": true, "type": "boolean" } }, "required": [ "has_pii", "confidence" ] }, "probabilities": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "processing_time_ms": { "type": "integer" }, "security": { "nullable": true, "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "decision": { "nullable": true, "type": "object", "properties": { "categories": { "nullable": true, "type": "array", "items": { "type": "string" } }, "label": { "type": "string" }, "score": { "nullable": true, "type": "object", "properties": { "Value": { "type": "number" } }, "required": [ "Value" ] }, "score_semantics": { "nullable": true, "type": "object", "properties": { "Calibrated": { "type": "boolean" }, "Direction": { "type": "string" }, "Maximum": { "nullable": true, "type": "number" }, "Minimum": { "nullable": true, "type": "number" }, "Unit": { "type": "string" } }, "required": [ "Unit", "Direction", "Minimum", "Maximum", "Calibrated" ] }, "source_label": { "type": "string" } }, "required": [ "label" ] }, "is_jailbreak": { "type": "boolean" }, "scores_available": { "nullable": true, "type": "boolean" }, "threat_type": { "type": "string" } }, "required": [ "is_jailbreak", "threat_type", "confidence" ] } }, "required": [ "category", "confidence", "processing_time_ms" ] } }, "statistics": { "type": "object", "properties": { "avg_confidence": { "type": "number" }, "category_distribution": { "nullable": true, "type": "object", "additionalProperties": { "type": "integer" } }, "low_confidence_count": { "type": "integer" } }, "required": [ "category_distribution", "avg_confidence", "low_confidence_count" ] }, "total_count": { "type": "integer" } }, "required": [ "results", "total_count", "processing_time_ms", "statistics" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "options": { "nullable": true, "type": "object", "properties": { "confidence_threshold": { "type": "number" }, "include_explanation": { "type": "boolean" }, "return_probabilities": { "type": "boolean" } } }, "recipe": { "type": "string" }, "task_type": { "type": "string" }, "texts": { "nullable": true, "type": "array", "items": { "type": "string" } } }, "required": [ "texts" ] } } } }, "x-vllm-sr-permission": "classify.invoke", "x-vllm-sr-sensitivity": "operational", "x-vllm-sr-plane": "diagnostic", "x-vllm-sr-audiences": [ "operator", "internal" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "advanced" } }, "/api/v1/diagnostics/classify/combined": { "post": { "summary": "Perform combined classification (intent, PII, and security)", "description": "Perform combined classification (intent, PII, and security)", "operationId": "post_api_v1_diagnostics_classify_combined", "tags": [ "diagnostics" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "intent": { "nullable": true, "type": "object", "properties": { "applied_unknown_policies": { "nullable": true, "type": "object", "additionalProperties": { "type": "string" } }, "classification": { "type": "object", "properties": { "category": { "type": "string" }, "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "processing_time_ms": { "type": "integer" } }, "required": [ "category", "confidence", "processing_time_ms" ] }, "decision_result": { "nullable": true, "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "decision_name": { "type": "string" }, "matched_rules": { "nullable": true, "type": "array", "items": { "type": "string" } } }, "required": [ "decision_name", "confidence", "matched_rules" ] }, "matched_signals": { "nullable": true, "type": "object", "properties": { "action": { "nullable": true, "type": "array", "items": { "type": "string" } }, "authz": { "nullable": true, "type": "array", "items": { "type": "string" } }, "classifier": { "nullable": true, "type": "array", "items": { "type": "string" } }, "complexity": { "nullable": true, "type": "array", "items": { "type": "string" } }, "context": { "nullable": true, "type": "array", "items": { "type": "string" } }, "conversation": { "nullable": true, "type": "array", "items": { "type": "string" } }, "decision": { "nullable": true, "type": "array", "items": { "type": "string" } }, "domains": { "nullable": true, "type": "array", "items": { "type": "string" } }, "embeddings": { "nullable": true, "type": "array", "items": { "type": "string" } }, "event": { "nullable": true, "type": "array", "items": { "type": "string" } }, "fact_check": { "nullable": true, "type": "array", "items": { "type": "string" } }, "input_modality": { "nullable": true, "type": "array", "items": { "type": "string" } }, "jailbreak": { "nullable": true, "type": "array", "items": { "type": "string" } }, "kb": { "nullable": true, "type": "array", "items": { "type": "string" } }, "keywords": { "nullable": true, "type": "array", "items": { "type": "string" } }, "language": { "nullable": true, "type": "array", "items": { "type": "string" } }, "metadata": { "nullable": true, "type": "array", "items": { "type": "string" } }, "modality": { "nullable": true, "type": "array", "items": { "type": "string" } }, "pii": { "nullable": true, "type": "array", "items": { "type": "string" } }, "preferences": { "nullable": true, "type": "array", "items": { "type": "string" } }, "projection": { "nullable": true, "type": "array", "items": { "type": "string" } }, "reask": { "nullable": true, "type": "array", "items": { "type": "string" } }, "safety": { "nullable": true, "type": "array", "items": { "type": "string" } }, "structure": { "nullable": true, "type": "array", "items": { "type": "string" } }, "user_feedback": { "nullable": true, "type": "array", "items": { "type": "string" } } } }, "probabilities": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "probabilities_available": { "type": "boolean" }, "recommended_model": { "type": "string" }, "routing_decision": { "type": "string" }, "signal_error_matches": { "nullable": true, "type": "object", "additionalProperties": { "type": "boolean" } }, "signal_errors": { "nullable": true, "type": "object", "additionalProperties": { "type": "string" } } }, "required": [ "probabilities_available", "classification" ] }, "pii": { "nullable": true, "type": "object", "properties": { "entities": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "confidence": { "type": "number" }, "end_position": { "nullable": true, "type": "integer" }, "masked_value": { "type": "string" }, "start_position": { "nullable": true, "type": "integer" }, "type": { "type": "string" }, "value": { "type": "string" } }, "required": [ "type", "value", "confidence" ] } }, "has_pii": { "type": "boolean" }, "masked_text": { "type": "string" }, "processing_time_ms": { "type": "integer" }, "recipe": { "type": "string" }, "scan_incomplete": { "type": "boolean" }, "security_recommendation": { "type": "string" } }, "required": [ "has_pii", "entities", "security_recommendation", "processing_time_ms" ] }, "processing_time_ms": { "type": "integer" }, "recipe": { "type": "string" }, "security": { "nullable": true, "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "decision": { "nullable": true, "type": "object", "properties": { "categories": { "nullable": true, "type": "array", "items": { "type": "string" } }, "label": { "type": "string" }, "score": { "nullable": true, "type": "object", "properties": { "Value": { "type": "number" } }, "required": [ "Value" ] }, "score_semantics": { "nullable": true, "type": "object", "properties": { "Calibrated": { "type": "boolean" }, "Direction": { "type": "string" }, "Maximum": { "nullable": true, "type": "number" }, "Minimum": { "nullable": true, "type": "number" }, "Unit": { "type": "string" } }, "required": [ "Unit", "Direction", "Minimum", "Maximum", "Calibrated" ] }, "source_label": { "type": "string" } }, "required": [ "label" ] }, "detection_types": { "nullable": true, "type": "array", "items": { "type": "string" } }, "is_jailbreak": { "type": "boolean" }, "patterns_detected": { "nullable": true, "type": "array", "items": { "type": "string" } }, "processing_time_ms": { "type": "integer" }, "reasoning": { "type": "string" }, "recipe": { "type": "string" }, "recommendation": { "type": "string" }, "risk_score": { "nullable": true, "type": "number" }, "scores_available": { "type": "boolean" } }, "required": [ "is_jailbreak", "risk_score", "detection_types", "confidence", "scores_available", "recommendation", "patterns_detected", "processing_time_ms" ] } }, "required": [ "intent", "pii", "security", "processing_time_ms" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "intent_options": { "nullable": true, "type": "object", "properties": { "confidence_threshold": { "type": "number" }, "include_explanation": { "type": "boolean" }, "return_probabilities": { "type": "boolean" }, "trace": { "type": "boolean" } } }, "pii_options": { "nullable": true, "type": "object", "properties": { "confidence_threshold": { "type": "number" }, "entity_types": { "nullable": true, "type": "array", "items": { "type": "string" } }, "mask_entities": { "type": "boolean" }, "return_positions": { "type": "boolean" }, "reveal_entity_text": { "type": "boolean" } } }, "recipe": { "type": "string" }, "security_options": { "nullable": true, "type": "object", "properties": { "detection_types": { "nullable": true, "type": "array", "items": { "type": "string" } }, "include_reasoning": { "type": "boolean" }, "sensitivity": { "type": "string" } } }, "text": { "type": "string" } }, "required": [ "text" ] } } } }, "x-vllm-sr-permission": "classify.invoke", "x-vllm-sr-sensitivity": "operational", "x-vllm-sr-plane": "diagnostic", "x-vllm-sr-audiences": [ "operator", "internal" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "advanced" } }, "/api/v1/diagnostics/classify/fact-check": { "post": { "summary": "Classify if text needs fact-checking", "description": "Classify if text needs fact-checking", "operationId": "post_api_v1_diagnostics_classify_fact_check", "tags": [ "diagnostics" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "type": "boolean" }, "label": { "type": "string" }, "needs_fact_check": { "type": "boolean" }, "policy_default": { "type": "string" }, "processing_time_ms": { "type": "integer" }, "recipe": { "type": "string" } }, "required": [ "needs_fact_check", "label", "confidence", "confidence_available", "processing_time_ms" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "options": { "nullable": true, "type": "object", "properties": { "confidence_threshold": { "type": "number" } } }, "recipe": { "type": "string" }, "text": { "type": "string" } }, "required": [ "text" ] } } } }, "x-vllm-sr-permission": "classify.invoke", "x-vllm-sr-sensitivity": "operational", "x-vllm-sr-plane": "diagnostic", "x-vllm-sr-audiences": [ "operator", "internal" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "advanced" } }, "/api/v1/diagnostics/classify/intent": { "post": { "summary": "Classify user queries into routing categories", "description": "Classify user queries into routing categories", "operationId": "post_api_v1_diagnostics_classify_intent", "tags": [ "diagnostics" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "applied_unknown_policies": { "nullable": true, "type": "object", "additionalProperties": { "type": "string" } }, "classification": { "type": "object", "properties": { "category": { "type": "string" }, "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "processing_time_ms": { "type": "integer" } }, "required": [ "category", "confidence", "processing_time_ms" ] }, "decision_result": { "nullable": true, "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "decision_name": { "type": "string" }, "matched_rules": { "nullable": true, "type": "array", "items": { "type": "string" } } }, "required": [ "decision_name", "confidence", "matched_rules" ] }, "matched_signals": { "nullable": true, "type": "object", "properties": { "action": { "nullable": true, "type": "array", "items": { "type": "string" } }, "authz": { "nullable": true, "type": "array", "items": { "type": "string" } }, "classifier": { "nullable": true, "type": "array", "items": { "type": "string" } }, "complexity": { "nullable": true, "type": "array", "items": { "type": "string" } }, "context": { "nullable": true, "type": "array", "items": { "type": "string" } }, "conversation": { "nullable": true, "type": "array", "items": { "type": "string" } }, "decision": { "nullable": true, "type": "array", "items": { "type": "string" } }, "domains": { "nullable": true, "type": "array", "items": { "type": "string" } }, "embeddings": { "nullable": true, "type": "array", "items": { "type": "string" } }, "event": { "nullable": true, "type": "array", "items": { "type": "string" } }, "fact_check": { "nullable": true, "type": "array", "items": { "type": "string" } }, "input_modality": { "nullable": true, "type": "array", "items": { "type": "string" } }, "jailbreak": { "nullable": true, "type": "array", "items": { "type": "string" } }, "kb": { "nullable": true, "type": "array", "items": { "type": "string" } }, "keywords": { "nullable": true, "type": "array", "items": { "type": "string" } }, "language": { "nullable": true, "type": "array", "items": { "type": "string" } }, "metadata": { "nullable": true, "type": "array", "items": { "type": "string" } }, "modality": { "nullable": true, "type": "array", "items": { "type": "string" } }, "pii": { "nullable": true, "type": "array", "items": { "type": "string" } }, "preferences": { "nullable": true, "type": "array", "items": { "type": "string" } }, "projection": { "nullable": true, "type": "array", "items": { "type": "string" } }, "reask": { "nullable": true, "type": "array", "items": { "type": "string" } }, "safety": { "nullable": true, "type": "array", "items": { "type": "string" } }, "structure": { "nullable": true, "type": "array", "items": { "type": "string" } }, "user_feedback": { "nullable": true, "type": "array", "items": { "type": "string" } } } }, "probabilities": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "probabilities_available": { "type": "boolean" }, "recommended_model": { "type": "string" }, "routing_decision": { "type": "string" }, "signal_error_matches": { "nullable": true, "type": "object", "additionalProperties": { "type": "boolean" } }, "signal_errors": { "nullable": true, "type": "object", "additionalProperties": { "type": "string" } } }, "required": [ "probabilities_available", "classification" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "function_call": {}, "functions": { "nullable": true, "type": "array", "items": {} }, "max_completion_tokens": {}, "max_tokens": {}, "messages": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "content": {}, "function_call": {}, "name": { "type": "string" }, "reasoning_content": {}, "refusal": {}, "role": { "type": "string" }, "tool_call_id": { "type": "string" }, "tool_calls": { "nullable": true, "type": "array", "items": {} } }, "required": [ "role", "content" ] } }, "metadata": { "nullable": true, "type": "object", "additionalProperties": { "type": "string" } }, "model": { "type": "string" }, "options": { "nullable": true, "type": "object", "properties": { "confidence_threshold": { "type": "number" }, "include_explanation": { "type": "boolean" }, "return_probabilities": { "type": "boolean" }, "trace": { "type": "boolean" } } }, "preview_context": { "nullable": true, "type": "object", "properties": { "conversation_id": { "type": "string" }, "sampling_seed": { "nullable": true, "type": "integer" }, "session_id": { "type": "string" } } }, "response_format": {}, "text": { "type": "string" }, "tool_choice": {}, "tools": { "nullable": true, "type": "array", "items": {} } } } } } }, "x-vllm-sr-permission": "classify.invoke", "x-vllm-sr-sensitivity": "operational", "x-vllm-sr-plane": "diagnostic", "x-vllm-sr-audiences": [ "operator", "internal" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "advanced" } }, "/api/v1/diagnostics/classify/pii": { "post": { "summary": "Detect personally identifiable information in text", "description": "Detect personally identifiable information in text", "operationId": "post_api_v1_diagnostics_classify_pii", "tags": [ "diagnostics" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "entities": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "confidence": { "type": "number" }, "end_position": { "nullable": true, "type": "integer" }, "masked_value": { "type": "string" }, "start_position": { "nullable": true, "type": "integer" }, "type": { "type": "string" }, "value": { "type": "string" } }, "required": [ "type", "value", "confidence" ] } }, "has_pii": { "type": "boolean" }, "masked_text": { "type": "string" }, "processing_time_ms": { "type": "integer" }, "recipe": { "type": "string" }, "scan_incomplete": { "type": "boolean" }, "security_recommendation": { "type": "string" } }, "required": [ "has_pii", "entities", "security_recommendation", "processing_time_ms" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "options": { "nullable": true, "type": "object", "properties": { "confidence_threshold": { "type": "number" }, "entity_types": { "nullable": true, "type": "array", "items": { "type": "string" } }, "mask_entities": { "type": "boolean" }, "return_positions": { "type": "boolean" }, "reveal_entity_text": { "type": "boolean" } } }, "recipe": { "type": "string" }, "text": { "type": "string" } }, "required": [ "text" ] } } } }, "x-vllm-sr-permission": "classify.invoke", "x-vllm-sr-sensitivity": "operational", "x-vllm-sr-plane": "diagnostic", "x-vllm-sr-audiences": [ "operator", "internal" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "advanced" } }, "/api/v1/diagnostics/classify/security": { "post": { "summary": "Detect jailbreak attempts and security threats", "description": "Detect jailbreak attempts and security threats", "operationId": "post_api_v1_diagnostics_classify_security", "tags": [ "diagnostics" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "decision": { "nullable": true, "type": "object", "properties": { "categories": { "nullable": true, "type": "array", "items": { "type": "string" } }, "label": { "type": "string" }, "score": { "nullable": true, "type": "object", "properties": { "Value": { "type": "number" } }, "required": [ "Value" ] }, "score_semantics": { "nullable": true, "type": "object", "properties": { "Calibrated": { "type": "boolean" }, "Direction": { "type": "string" }, "Maximum": { "nullable": true, "type": "number" }, "Minimum": { "nullable": true, "type": "number" }, "Unit": { "type": "string" } }, "required": [ "Unit", "Direction", "Minimum", "Maximum", "Calibrated" ] }, "source_label": { "type": "string" } }, "required": [ "label" ] }, "detection_types": { "nullable": true, "type": "array", "items": { "type": "string" } }, "is_jailbreak": { "type": "boolean" }, "patterns_detected": { "nullable": true, "type": "array", "items": { "type": "string" } }, "processing_time_ms": { "type": "integer" }, "reasoning": { "type": "string" }, "recipe": { "type": "string" }, "recommendation": { "type": "string" }, "risk_score": { "nullable": true, "type": "number" }, "scores_available": { "type": "boolean" } }, "required": [ "is_jailbreak", "risk_score", "detection_types", "confidence", "scores_available", "recommendation", "patterns_detected", "processing_time_ms" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "options": { "nullable": true, "type": "object", "properties": { "detection_types": { "nullable": true, "type": "array", "items": { "type": "string" } }, "include_reasoning": { "type": "boolean" }, "sensitivity": { "type": "string" } } }, "recipe": { "type": "string" }, "text": { "type": "string" } }, "required": [ "text" ] } } } }, "x-vllm-sr-permission": "classify.invoke", "x-vllm-sr-sensitivity": "operational", "x-vllm-sr-plane": "diagnostic", "x-vllm-sr-audiences": [ "operator", "internal" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "advanced" } }, "/api/v1/diagnostics/classify/user-feedback": { "post": { "summary": "Classify user feedback type (satisfied, need_clarification, wrong_answer, want_different)", "description": "Classify user feedback type (satisfied, need_clarification, wrong_answer, want_different)", "operationId": "post_api_v1_diagnostics_classify_user_feedback", "tags": [ "diagnostics" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "abstained": { "type": "boolean" }, "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "type": "boolean" }, "feedback_type": { "type": "string" }, "label": { "type": "string" }, "policy_default": { "type": "string" }, "processing_time_ms": { "type": "integer" }, "recipe": { "type": "string" } }, "required": [ "feedback_type", "label", "confidence", "confidence_available", "processing_time_ms" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "options": { "nullable": true, "type": "object", "properties": { "confidence_threshold": { "type": "number" } } }, "recipe": { "type": "string" }, "text": { "type": "string" } }, "required": [ "text" ] } } } }, "x-vllm-sr-permission": "classify.invoke", "x-vllm-sr-sensitivity": "operational", "x-vllm-sr-plane": "diagnostic", "x-vllm-sr-audiences": [ "operator", "internal" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "advanced" } }, "/api/v1/diagnostics/embeddings": { "post": { "summary": "Generate text, image, and audio embeddings", "description": "Generate text, image, and audio embeddings", "operationId": "post_api_v1_diagnostics_embeddings", "tags": [ "diagnostics" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "avg_processing_time_ms": { "type": "number" }, "embeddings": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "dimension": { "type": "integer" }, "embedding": { "nullable": true, "type": "array", "items": { "type": "number" } }, "modality": { "type": "string" }, "model_used": { "type": "string" }, "processing_time_ms": { "type": "integer" }, "text": { "type": "string" } }, "required": [ "text", "embedding", "dimension", "model_used", "processing_time_ms" ] } }, "recipe": { "type": "string" }, "total_count": { "type": "integer" }, "total_processing_time_ms": { "type": "integer" } }, "required": [ "embeddings", "total_count", "total_processing_time_ms", "avg_processing_time_ms" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "audios": { "nullable": true, "type": "array", "items": { "type": "string" } }, "dimension": { "type": "integer" }, "images": { "nullable": true, "type": "array", "items": { "type": "string" } }, "latency_priority": { "type": "number" }, "model": { "type": "string" }, "quality_priority": { "type": "number" }, "recipe": { "type": "string" }, "sequence_length": { "type": "integer" }, "target_layer": { "type": "integer" }, "texts": { "nullable": true, "type": "array", "items": { "type": "string" } } } } } } }, "x-vllm-sr-permission": "classify.invoke", "x-vllm-sr-sensitivity": "operational", "x-vllm-sr-plane": "diagnostic", "x-vllm-sr-audiences": [ "operator", "internal" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "advanced" } }, "/api/v1/diagnostics/models": { "get": { "summary": "List prepared model bindings in an explicitly selected recipe", "description": "List prepared model bindings in an explicitly selected recipe", "operationId": "get_api_v1_diagnostics_models", "tags": [ "diagnostics" ], "parameters": [ { "name": "recipe", "in": "query", "description": "Configured recipe name", "required": true, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Prepared binding inventory", "content": { "application/json": { "schema": { "type": "object", "properties": { "bindings": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "adapter": { "type": "string" }, "artifact": { "type": "string" }, "contract": { "type": "string" }, "deployment": { "type": "string" }, "device": { "type": "string" }, "embedding": { "nullable": true, "type": "object", "properties": { "audio": { "nullable": true, "type": "object", "properties": { "layout": { "type": "string" }, "max_channels": { "type": "integer" }, "max_sample_rate": { "type": "integer" }, "max_seconds": { "type": "integer" }, "sample_rates": { "nullable": true, "type": "array", "items": { "type": "integer" } } }, "required": [ "max_sample_rate", "max_seconds", "max_channels", "layout" ] }, "dimension": { "type": "integer" }, "dimensions": { "nullable": true, "type": "array", "items": { "type": "integer" } }, "layer": { "type": "integer" }, "modalities": { "nullable": true, "type": "array", "items": { "type": "string" } }, "normalization": { "type": "string" }, "pooling": { "type": "string" } }, "required": [ "dimension", "layer", "pooling", "normalization", "modalities" ] }, "head": { "type": "string" }, "labels": { "nullable": true, "type": "array", "items": { "type": "string" } }, "max_tokens": { "type": "integer" }, "name": { "type": "string" }, "overflow": { "type": "string" }, "precision": { "type": "string" }, "provider": { "type": "string" }, "recipe": { "type": "string" }, "revision": { "type": "string" }, "window": { "nullable": true, "type": "object", "properties": { "overlap": { "type": "integer" }, "size": { "type": "integer" } }, "required": [ "size", "overlap" ] } }, "required": [ "recipe", "name", "deployment", "contract", "adapter", "provider", "device", "precision", "max_tokens", "overflow" ] } }, "recipe": { "type": "string" } }, "required": [ "recipe", "bindings" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "config.read", "x-vllm-sr-sensitivity": "config", "x-vllm-sr-plane": "diagnostic", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "advanced" } }, "/api/v1/diagnostics/models/embeddings": { "post": { "summary": "Run the explicitly selected prepared embedding binding at its published representation", "description": "Run the explicitly selected prepared embedding binding at its published representation", "operationId": "post_api_v1_diagnostics_models_embeddings", "tags": [ "diagnostics" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Embedding vector and actual binding identity", "content": { "application/json": { "schema": { "type": "object", "properties": { "binding": { "type": "object", "properties": { "adapter": { "type": "string" }, "artifact": { "type": "string" }, "contract": { "type": "string" }, "deployment": { "type": "string" }, "device": { "type": "string" }, "embedding": { "nullable": true, "type": "object", "properties": { "audio": { "nullable": true, "type": "object", "properties": { "layout": { "type": "string" }, "max_channels": { "type": "integer" }, "max_sample_rate": { "type": "integer" }, "max_seconds": { "type": "integer" }, "sample_rates": { "nullable": true, "type": "array", "items": { "type": "integer" } } }, "required": [ "max_sample_rate", "max_seconds", "max_channels", "layout" ] }, "dimension": { "type": "integer" }, "dimensions": { "nullable": true, "type": "array", "items": { "type": "integer" } }, "layer": { "type": "integer" }, "modalities": { "nullable": true, "type": "array", "items": { "type": "string" } }, "normalization": { "type": "string" }, "pooling": { "type": "string" } }, "required": [ "dimension", "layer", "pooling", "normalization", "modalities" ] }, "head": { "type": "string" }, "labels": { "nullable": true, "type": "array", "items": { "type": "string" } }, "max_tokens": { "type": "integer" }, "name": { "type": "string" }, "overflow": { "type": "string" }, "precision": { "type": "string" }, "provider": { "type": "string" }, "recipe": { "type": "string" }, "revision": { "type": "string" }, "window": { "nullable": true, "type": "object", "properties": { "overlap": { "type": "integer" }, "size": { "type": "integer" } }, "required": [ "size", "overlap" ] } }, "required": [ "recipe", "name", "deployment", "contract", "adapter", "provider", "device", "precision", "max_tokens", "overflow" ] }, "result": { "type": "object", "properties": { "embedding": { "nullable": true, "type": "array", "items": { "type": "number" } }, "input": { "nullable": true, "type": "object", "properties": { "original_tokens": { "type": "integer" }, "processed_tokens": { "type": "integer" }, "truncated": { "type": "boolean" } }, "required": [ "original_tokens", "processed_tokens", "truncated" ] } }, "required": [ "embedding" ] } }, "required": [ "binding", "result" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "409": { "description": "Conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "binding": { "type": "string" }, "recipe": { "type": "string" }, "text": { "type": "string" } }, "required": [ "recipe", "binding", "text" ], "additionalProperties": false } } } }, "x-vllm-sr-permission": "classify.invoke", "x-vllm-sr-sensitivity": "operational", "x-vllm-sr-plane": "diagnostic", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "advanced" } }, "/api/v1/diagnostics/models/label-scores": { "post": { "summary": "Inspect independent label scores using the prepared operating point when configured", "description": "Inspect independent label scores using the prepared operating point when configured", "operationId": "post_api_v1_diagnostics_models_label_scores", "tags": [ "diagnostics" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Independent scores, operating policy and actual binding identity", "content": { "application/json": { "schema": { "type": "object", "properties": { "binding": { "type": "object", "properties": { "adapter": { "type": "string" }, "artifact": { "type": "string" }, "contract": { "type": "string" }, "deployment": { "type": "string" }, "device": { "type": "string" }, "embedding": { "nullable": true, "type": "object", "properties": { "audio": { "nullable": true, "type": "object", "properties": { "layout": { "type": "string" }, "max_channels": { "type": "integer" }, "max_sample_rate": { "type": "integer" }, "max_seconds": { "type": "integer" }, "sample_rates": { "nullable": true, "type": "array", "items": { "type": "integer" } } }, "required": [ "max_sample_rate", "max_seconds", "max_channels", "layout" ] }, "dimension": { "type": "integer" }, "dimensions": { "nullable": true, "type": "array", "items": { "type": "integer" } }, "layer": { "type": "integer" }, "modalities": { "nullable": true, "type": "array", "items": { "type": "string" } }, "normalization": { "type": "string" }, "pooling": { "type": "string" } }, "required": [ "dimension", "layer", "pooling", "normalization", "modalities" ] }, "head": { "type": "string" }, "labels": { "nullable": true, "type": "array", "items": { "type": "string" } }, "max_tokens": { "type": "integer" }, "name": { "type": "string" }, "overflow": { "type": "string" }, "precision": { "type": "string" }, "provider": { "type": "string" }, "recipe": { "type": "string" }, "revision": { "type": "string" }, "window": { "nullable": true, "type": "object", "properties": { "overlap": { "type": "integer" }, "size": { "type": "integer" } }, "required": [ "size", "overlap" ] } }, "required": [ "recipe", "name", "deployment", "contract", "adapter", "provider", "device", "precision", "max_tokens", "overflow" ] }, "result": { "type": "object", "properties": { "input": { "nullable": true, "type": "object", "properties": { "original_tokens": { "type": "integer" }, "processed_tokens": { "type": "integer" }, "truncated": { "type": "boolean" } }, "required": [ "original_tokens", "processed_tokens", "truncated" ] }, "policy_sha256": { "type": "string" }, "scores": { "nullable": true, "type": "array", "items": { "type": "number" } }, "thresholds": { "nullable": true, "type": "array", "items": { "type": "number" } }, "window_ranges": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "windows": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "end": { "type": "integer" }, "scores": { "nullable": true, "type": "array", "items": { "type": "number" } }, "start": { "type": "integer" } }, "required": [ "start", "end", "scores" ] } } } } }, "required": [ "binding", "result" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "409": { "description": "Conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "binding": { "type": "string" }, "recipe": { "type": "string" }, "text": { "type": "string" } }, "required": [ "recipe", "binding", "text" ], "additionalProperties": false } } } }, "x-vllm-sr-permission": "classify.invoke", "x-vllm-sr-sensitivity": "operational", "x-vllm-sr-plane": "diagnostic", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "advanced" } }, "/api/v1/diagnostics/models/labels": { "post": { "summary": "Inspect a prepared label distribution; windowed bindings preserve their configured scan", "description": "Inspect a prepared label distribution; windowed bindings preserve their configured scan", "operationId": "post_api_v1_diagnostics_models_labels", "tags": [ "diagnostics" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Label probabilities and actual binding identity", "content": { "application/json": { "schema": { "type": "object", "properties": { "binding": { "type": "object", "properties": { "adapter": { "type": "string" }, "artifact": { "type": "string" }, "contract": { "type": "string" }, "deployment": { "type": "string" }, "device": { "type": "string" }, "embedding": { "nullable": true, "type": "object", "properties": { "audio": { "nullable": true, "type": "object", "properties": { "layout": { "type": "string" }, "max_channels": { "type": "integer" }, "max_sample_rate": { "type": "integer" }, "max_seconds": { "type": "integer" }, "sample_rates": { "nullable": true, "type": "array", "items": { "type": "integer" } } }, "required": [ "max_sample_rate", "max_seconds", "max_channels", "layout" ] }, "dimension": { "type": "integer" }, "dimensions": { "nullable": true, "type": "array", "items": { "type": "integer" } }, "layer": { "type": "integer" }, "modalities": { "nullable": true, "type": "array", "items": { "type": "string" } }, "normalization": { "type": "string" }, "pooling": { "type": "string" } }, "required": [ "dimension", "layer", "pooling", "normalization", "modalities" ] }, "head": { "type": "string" }, "labels": { "nullable": true, "type": "array", "items": { "type": "string" } }, "max_tokens": { "type": "integer" }, "name": { "type": "string" }, "overflow": { "type": "string" }, "precision": { "type": "string" }, "provider": { "type": "string" }, "recipe": { "type": "string" }, "revision": { "type": "string" }, "window": { "nullable": true, "type": "object", "properties": { "overlap": { "type": "integer" }, "size": { "type": "integer" } }, "required": [ "size", "overlap" ] } }, "required": [ "recipe", "name", "deployment", "contract", "adapter", "provider", "device", "precision", "max_tokens", "overflow" ] }, "result": { "type": "object", "properties": { "content_tokens": { "type": "integer" }, "input": { "nullable": true, "type": "object", "properties": { "original_tokens": { "type": "integer" }, "processed_tokens": { "type": "integer" }, "truncated": { "type": "boolean" } }, "required": [ "original_tokens", "processed_tokens", "truncated" ] }, "probabilities": { "nullable": true, "type": "array", "items": { "type": "number" } }, "windows": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "end": { "type": "integer" }, "probabilities": { "nullable": true, "type": "array", "items": { "type": "number" } }, "start": { "type": "integer" } }, "required": [ "start", "end", "probabilities" ] } } } } }, "required": [ "binding", "result" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "409": { "description": "Conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "binding": { "type": "string" }, "recipe": { "type": "string" }, "text": { "type": "string" } }, "required": [ "recipe", "binding", "text" ], "additionalProperties": false } } } }, "x-vllm-sr-permission": "classify.invoke", "x-vllm-sr-sensitivity": "operational", "x-vllm-sr-plane": "diagnostic", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "advanced" } }, "/api/v1/diagnostics/models/rerank": { "post": { "summary": "Score query-document pairs using the selected prepared relevance binding without running a RAG request; max_batch_size applies (default 100 pairs)", "description": "Score query-document pairs using the selected prepared relevance binding without running a RAG request; max_batch_size applies (default 100 pairs)", "operationId": "post_api_v1_diagnostics_models_rerank", "tags": [ "diagnostics" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Relevance logits in input order and actual binding identity", "content": { "application/json": { "schema": { "type": "object", "properties": { "binding": { "type": "object", "properties": { "adapter": { "type": "string" }, "artifact": { "type": "string" }, "contract": { "type": "string" }, "deployment": { "type": "string" }, "device": { "type": "string" }, "embedding": { "nullable": true, "type": "object", "properties": { "audio": { "nullable": true, "type": "object", "properties": { "layout": { "type": "string" }, "max_channels": { "type": "integer" }, "max_sample_rate": { "type": "integer" }, "max_seconds": { "type": "integer" }, "sample_rates": { "nullable": true, "type": "array", "items": { "type": "integer" } } }, "required": [ "max_sample_rate", "max_seconds", "max_channels", "layout" ] }, "dimension": { "type": "integer" }, "dimensions": { "nullable": true, "type": "array", "items": { "type": "integer" } }, "layer": { "type": "integer" }, "modalities": { "nullable": true, "type": "array", "items": { "type": "string" } }, "normalization": { "type": "string" }, "pooling": { "type": "string" } }, "required": [ "dimension", "layer", "pooling", "normalization", "modalities" ] }, "head": { "type": "string" }, "labels": { "nullable": true, "type": "array", "items": { "type": "string" } }, "max_tokens": { "type": "integer" }, "name": { "type": "string" }, "overflow": { "type": "string" }, "precision": { "type": "string" }, "provider": { "type": "string" }, "recipe": { "type": "string" }, "revision": { "type": "string" }, "window": { "nullable": true, "type": "object", "properties": { "overlap": { "type": "integer" }, "size": { "type": "integer" } }, "required": [ "size", "overlap" ] } }, "required": [ "recipe", "name", "deployment", "contract", "adapter", "provider", "device", "precision", "max_tokens", "overflow" ] }, "result": { "type": "object", "properties": { "inputs": { "nullable": true, "type": "array", "items": { "nullable": true, "type": "object", "properties": { "original_tokens": { "type": "integer" }, "processed_tokens": { "type": "integer" }, "truncated": { "type": "boolean" } }, "required": [ "original_tokens", "processed_tokens", "truncated" ] } }, "score_type": { "type": "string" }, "scores": { "nullable": true, "type": "array", "items": { "type": "number" } } }, "required": [ "scores", "score_type", "inputs" ] } }, "required": [ "binding", "result" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "409": { "description": "Conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "binding": { "type": "string" }, "pairs": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "document": { "type": "string" }, "query": { "type": "string" } }, "required": [ "query", "document" ], "additionalProperties": false } }, "recipe": { "type": "string" } }, "required": [ "recipe", "binding", "pairs" ], "additionalProperties": false } } } }, "x-vllm-sr-permission": "classify.invoke", "x-vllm-sr-sensitivity": "operational", "x-vllm-sr-plane": "diagnostic", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "advanced" } }, "/api/v1/diagnostics/models/systemone": { "get": { "summary": "List published model deployments and their native System One question capabilities", "description": "List published model deployments and their native System One question capabilities", "operationId": "get_api_v1_diagnostics_models_systemone", "tags": [ "diagnostics" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Published deployment capabilities", "content": { "application/json": { "schema": { "type": "object", "properties": { "deployments": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "artifact": { "type": "string" }, "family": { "type": "string" }, "id": { "type": "string" }, "max_input_tokens": { "type": "integer" }, "max_scan_tokens": { "type": "integer" }, "model": { "type": "string" }, "presets": { "nullable": true, "type": "array", "items": { "type": "string" } }, "question_types": { "nullable": true, "type": "array", "items": { "type": "string" } }, "ready": { "type": "boolean" }, "repo": { "type": "string" }, "surfaces": { "nullable": true, "type": "array", "items": { "type": "string" } }, "unavailable_reason": { "type": "string" } }, "required": [ "id", "model", "ready", "question_types", "surfaces" ] } } }, "required": [ "deployments" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "config.read", "x-vllm-sr-sensitivity": "config", "x-vllm-sr-plane": "diagnostic", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "advanced" }, "post": { "summary": "Test native System One questions against a published deployment; preserves choice, score, noul, set, span, usage and metadata; 48 MiB request, 4 MiB response, 30 second deadline", "description": "Test native System One questions against a published deployment; preserves choice, score, noul, set, span, usage and metadata; 48 MiB request, 4 MiB response, 30 second deadline", "operationId": "post_api_v1_diagnostics_models_systemone", "tags": [ "diagnostics" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Native System One response; per-question errors are preserved", "content": { "application/json": { "schema": { "type": "object", "properties": { "answers": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "abstain_probability": { "nullable": true, "type": "number" }, "choice": { "nullable": true, "type": "string" }, "confidence": { "nullable": true, "type": "number" }, "error": { "nullable": true, "type": "string" }, "input_coverage": { "nullable": true, "type": "string" }, "legend": { "nullable": true, "type": "object", "additionalProperties": { "type": "string" } }, "message": { "nullable": true, "type": "string" }, "noul": { "nullable": true, "type": "number" }, "probabilities": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "score": { "nullable": true, "type": "number" }, "type": { "nullable": true, "type": "string" } }, "required": [ "type" ] } }, "meta": { "nullable": true, "type": "object", "properties": { "accelerator": { "nullable": true, "type": "string" }, "compute_ms": { "nullable": true, "type": "number" }, "device": { "nullable": true, "type": "string" }, "engine": { "nullable": true, "type": "string" }, "head": { "nullable": true, "type": "string" }, "model_id": { "nullable": true, "type": "string" }, "model_sha256": { "nullable": true, "type": "string" }, "numerics": { "nullable": true, "type": "string" }, "profile": { "nullable": true, "type": "string" }, "queue_ms": { "nullable": true, "type": "number" }, "representation": { "nullable": true, "type": "object", "properties": { "dimension": { "type": "integer" }, "layer": { "type": "integer" }, "modality": { "nullable": true, "type": "string" }, "model_sha256": { "type": "string" }, "normalized": { "nullable": true, "type": "boolean" } }, "required": [ "dimension", "layer", "model_sha256" ] }, "revision": { "nullable": true, "type": "string" } }, "required": [ "revision" ] }, "model": { "type": "string" }, "sets": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "input_coverage": { "nullable": true, "type": "string" }, "probabilities": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "selected": { "nullable": true, "type": "array", "items": { "type": "string" } } }, "required": [ "probabilities", "selected" ] } }, "span_heads": { "nullable": true, "type": "object", "additionalProperties": { "type": "string" } }, "spans": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "end": { "type": "integer" }, "label": { "type": "string" }, "probability": { "type": "number" }, "start": { "type": "integer" }, "text": { "type": "string" } }, "required": [ "end", "label", "probability", "start", "text" ] } } }, "states": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "answers": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "abstain_probability": { "nullable": true, "type": "number" }, "choice": { "nullable": true, "type": "string" }, "confidence": { "nullable": true, "type": "number" }, "error": { "nullable": true, "type": "string" }, "input_coverage": { "nullable": true, "type": "string" }, "legend": { "nullable": true, "type": "object", "additionalProperties": { "type": "string" } }, "message": { "nullable": true, "type": "string" }, "noul": { "nullable": true, "type": "number" }, "probabilities": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "score": { "nullable": true, "type": "number" }, "type": { "nullable": true, "type": "string" } }, "required": [ "type" ] } }, "meta": { "nullable": true, "type": "object", "properties": { "accelerator": { "nullable": true, "type": "string" }, "compute_ms": { "nullable": true, "type": "number" }, "device": { "nullable": true, "type": "string" }, "engine": { "nullable": true, "type": "string" }, "head": { "nullable": true, "type": "string" }, "model_id": { "nullable": true, "type": "string" }, "model_sha256": { "nullable": true, "type": "string" }, "numerics": { "nullable": true, "type": "string" }, "profile": { "nullable": true, "type": "string" }, "queue_ms": { "nullable": true, "type": "number" }, "representation": { "nullable": true, "type": "object", "properties": { "dimension": { "type": "integer" }, "layer": { "type": "integer" }, "modality": { "nullable": true, "type": "string" }, "model_sha256": { "type": "string" }, "normalized": { "nullable": true, "type": "boolean" } }, "required": [ "dimension", "layer", "model_sha256" ] }, "revision": { "nullable": true, "type": "string" } }, "required": [ "revision" ] }, "model": { "type": "string" }, "sets": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "input_coverage": { "nullable": true, "type": "string" }, "probabilities": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "selected": { "nullable": true, "type": "array", "items": { "type": "string" } } }, "required": [ "probabilities", "selected" ] } }, "span_heads": { "nullable": true, "type": "object", "additionalProperties": { "type": "string" } }, "spans": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "end": { "type": "integer" }, "label": { "type": "string" }, "probability": { "type": "number" }, "start": { "type": "integer" }, "text": { "type": "string" } }, "required": [ "end", "label", "probability", "start", "text" ] } } }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "usage": { "type": "object", "properties": { "input_tokens": { "type": "integer" }, "output_tokens": { "type": "integer" } }, "required": [ "input_tokens", "output_tokens" ] } }, "required": [ "answers", "model", "usage" ] } }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "usage": { "type": "object", "properties": { "input_tokens": { "type": "integer" }, "output_tokens": { "type": "integer" } }, "required": [ "input_tokens", "output_tokens" ] } }, "required": [ "answers", "model", "usage" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "409": { "description": "Conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "502": { "description": "Bad Gateway", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "504": { "description": "Gateway Timeout", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 50339840 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "deployment": { "type": "string" }, "expected_artifact": { "type": "string" }, "request": { "type": "object", "properties": { "images": { "nullable": true, "type": "array", "items": { "type": "string" } }, "model": { "nullable": true, "type": "string" }, "options": { "nullable": true, "type": "object", "properties": { "deadline_ms": { "nullable": true, "type": "number" }, "max_tokens": { "nullable": true, "type": "integer" }, "profile": { "nullable": true, "type": "string" }, "return_meta": { "nullable": true, "type": "boolean" } }, "additionalProperties": false }, "questions": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "choices": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "description": { "nullable": true }, "key": { "type": "string" } }, "required": [ "description", "key" ], "additionalProperties": false } }, "criteria": { "nullable": true }, "head": { "nullable": true, "type": "string" }, "instructions": { "nullable": true }, "labels": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "description": { "nullable": true }, "key": { "type": "string" } }, "required": [ "description", "key" ], "additionalProperties": false } }, "levels": { "nullable": true, "type": "array", "items": {} }, "over": { "nullable": true }, "overflow": { "nullable": true, "type": "string" }, "preset": { "nullable": true, "type": "string" }, "require_full_input": { "nullable": true, "type": "boolean" }, "threshold": { "nullable": true, "type": "number" }, "type": { "nullable": true, "type": "string" } }, "additionalProperties": false } }, "state": {}, "states": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "images": { "nullable": true, "type": "array", "items": { "type": "string" } }, "questions": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "choices": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "description": { "nullable": true }, "key": { "type": "string" } }, "required": [ "description", "key" ], "additionalProperties": false } }, "criteria": { "nullable": true }, "head": { "nullable": true, "type": "string" }, "instructions": { "nullable": true }, "labels": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "description": { "nullable": true }, "key": { "type": "string" } }, "required": [ "description", "key" ], "additionalProperties": false } }, "levels": { "nullable": true, "type": "array", "items": {} }, "over": { "nullable": true }, "overflow": { "nullable": true, "type": "string" }, "preset": { "nullable": true, "type": "string" }, "require_full_input": { "nullable": true, "type": "boolean" }, "threshold": { "nullable": true, "type": "number" }, "type": { "nullable": true, "type": "string" } }, "additionalProperties": false } }, "state": {}, "videos": { "nullable": true, "type": "array", "items": { "type": "string" } } }, "required": [ "questions", "state" ], "additionalProperties": false } }, "videos": { "nullable": true, "type": "array", "items": { "type": "string" } } }, "required": [ "questions", "state" ], "additionalProperties": false } }, "required": [ "deployment", "request" ], "additionalProperties": false } } } }, "x-vllm-sr-permission": "classify.invoke", "x-vllm-sr-sensitivity": "operational", "x-vllm-sr-plane": "diagnostic", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "advanced" } }, "/api/v1/diagnostics/models/systemone/forward": { "post": { "summary": "Forward a public native inference or discovery request through one active listener grant; requires management authorization and the original listener credentials", "description": "Forward a public native inference or discovery request through one active listener grant; requires management authorization and the original listener credentials", "operationId": "post_api_v1_diagnostics_models_systemone_forward", "tags": [ "diagnostics" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Native response or listener model discovery", "content": { "application/json": { "schema": { "nullable": true, "type": "object", "additionalProperties": true } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "409": { "description": "Conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "502": { "description": "Bad Gateway", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "504": { "description": "Gateway Timeout", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 50339840 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "api_key": { "type": "string" }, "authorization": { "type": "string" }, "backend_request": { "type": "boolean" }, "listener": { "type": "string" }, "method": { "type": "string" }, "path": { "type": "string" }, "request": {} }, "required": [ "method", "path" ], "additionalProperties": false } } } }, "x-vllm-sr-permission": "classify.invoke", "x-vllm-sr-sensitivity": "operational", "x-vllm-sr-plane": "diagnostic", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "advanced" } }, "/api/v1/diagnostics/models/tasks": { "get": { "summary": "List shared judgment task templates, structural model capabilities and binding provenance", "description": "List shared judgment task templates, structural model capabilities and binding provenance", "operationId": "get_api_v1_diagnostics_models_tasks", "tags": [ "diagnostics" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Task templates, capabilities and effective bindings", "content": { "application/json": { "schema": { "type": "object", "properties": { "bindings": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "binding": { "type": "object", "properties": { "adapter": { "type": "string" }, "contract": { "type": "string" }, "deployment": { "type": "string" }, "head": { "type": "string" }, "mapping_path": { "type": "string" }, "operating_point": { "nullable": true, "type": "object", "properties": { "path": { "type": "string" }, "sha256": { "type": "string" } }, "required": [ "path", "sha256" ] }, "pair_scorer": { "nullable": true, "type": "object", "properties": { "dimension": { "type": "integer" }, "layer": { "type": "integer" } } } }, "required": [ "deployment", "contract", "adapter" ] }, "consumer": { "type": "string" }, "deployment": { "type": "string" }, "editable": { "type": "boolean" }, "model": { "type": "string" }, "path": { "nullable": true, "type": "array", "items": { "type": "string" } }, "ready": { "type": "boolean" }, "recipe": { "type": "string" }, "source": { "type": "string" }, "task_id": { "type": "string" } }, "required": [ "task_id", "consumer", "recipe", "deployment", "model", "source", "ready", "editable", "path", "binding" ] } }, "default_bindings": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "adapter": { "type": "string" }, "contract": { "type": "string" }, "deployment": { "type": "string" }, "head": { "type": "string" }, "mapping_path": { "type": "string" }, "operating_point": { "nullable": true, "type": "object", "properties": { "path": { "type": "string" }, "sha256": { "type": "string" } }, "required": [ "path", "sha256" ] }, "pair_scorer": { "nullable": true, "type": "object", "properties": { "dimension": { "type": "integer" }, "layer": { "type": "integer" } } } }, "required": [ "deployment", "contract", "adapter" ] } }, "default_deployment": { "type": "string" }, "deployments": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "deployment": { "type": "string" }, "model": { "type": "string" }, "native_question_types": { "nullable": true, "type": "array", "items": { "type": "string" } }, "ready": { "type": "boolean" }, "tasks": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "implementation": { "type": "string" }, "quality": { "type": "string" }, "reason": { "type": "string" }, "supported": { "type": "boolean" }, "task_id": { "type": "string" } }, "required": [ "task_id", "supported", "quality" ] } } }, "required": [ "model", "native_question_types", "tasks", "deployment", "ready" ] } }, "global_bindings": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "adapter": { "type": "string" }, "contract": { "type": "string" }, "deployment": { "type": "string" }, "head": { "type": "string" }, "mapping_path": { "type": "string" }, "operating_point": { "nullable": true, "type": "object", "properties": { "path": { "type": "string" }, "sha256": { "type": "string" } }, "required": [ "path", "sha256" ] }, "pair_scorer": { "nullable": true, "type": "object", "properties": { "dimension": { "type": "integer" }, "layer": { "type": "integer" } } } }, "required": [ "deployment", "contract", "adapter" ] } }, "models": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "model": { "type": "string" }, "native_question_types": { "nullable": true, "type": "array", "items": { "type": "string" } }, "tasks": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "implementation": { "type": "string" }, "quality": { "type": "string" }, "reason": { "type": "string" }, "supported": { "type": "boolean" }, "task_id": { "type": "string" } }, "required": [ "task_id", "supported", "quality" ] } } }, "required": [ "model", "native_question_types", "tasks" ] } }, "tasks": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "consumers": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "binding": { "type": "string" }, "kind": { "type": "string" }, "optional": { "type": "boolean" }, "type": { "type": "string" } }, "required": [ "kind", "type" ] } }, "description": { "type": "string" }, "full_input": { "type": "boolean" }, "id": { "type": "string" }, "input": { "type": "string" }, "output": { "type": "string" }, "stage": { "type": "string" }, "template": { "type": "object", "properties": { "questions": { "nullable": true, "type": "object", "additionalProperties": true }, "state": {} }, "required": [ "state", "questions" ] }, "title": { "type": "string" } }, "required": [ "id", "title", "description", "stage", "input", "output", "full_input", "template" ] } } }, "required": [ "default_deployment", "global_bindings", "default_bindings", "tasks", "models", "deployments", "bindings" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "config.read", "x-vllm-sr-sensitivity": "config", "x-vllm-sr-plane": "diagnostic", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "advanced" } }, "/api/v1/diagnostics/models/tokens": { "post": { "summary": "Inspect prepared token spans with original UTF-8 byte offsets and complete configured window scanning", "description": "Inspect prepared token spans with original UTF-8 byte offsets and complete configured window scanning", "operationId": "post_api_v1_diagnostics_models_tokens", "tags": [ "diagnostics" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Token spans and actual binding identity", "content": { "application/json": { "schema": { "type": "object", "properties": { "binding": { "type": "object", "properties": { "adapter": { "type": "string" }, "artifact": { "type": "string" }, "contract": { "type": "string" }, "deployment": { "type": "string" }, "device": { "type": "string" }, "embedding": { "nullable": true, "type": "object", "properties": { "audio": { "nullable": true, "type": "object", "properties": { "layout": { "type": "string" }, "max_channels": { "type": "integer" }, "max_sample_rate": { "type": "integer" }, "max_seconds": { "type": "integer" }, "sample_rates": { "nullable": true, "type": "array", "items": { "type": "integer" } } }, "required": [ "max_sample_rate", "max_seconds", "max_channels", "layout" ] }, "dimension": { "type": "integer" }, "dimensions": { "nullable": true, "type": "array", "items": { "type": "integer" } }, "layer": { "type": "integer" }, "modalities": { "nullable": true, "type": "array", "items": { "type": "string" } }, "normalization": { "type": "string" }, "pooling": { "type": "string" } }, "required": [ "dimension", "layer", "pooling", "normalization", "modalities" ] }, "head": { "type": "string" }, "labels": { "nullable": true, "type": "array", "items": { "type": "string" } }, "max_tokens": { "type": "integer" }, "name": { "type": "string" }, "overflow": { "type": "string" }, "precision": { "type": "string" }, "provider": { "type": "string" }, "recipe": { "type": "string" }, "revision": { "type": "string" }, "window": { "nullable": true, "type": "object", "properties": { "overlap": { "type": "integer" }, "size": { "type": "integer" } }, "required": [ "size", "overlap" ] } }, "required": [ "recipe", "name", "deployment", "contract", "adapter", "provider", "device", "precision", "max_tokens", "overflow" ] }, "result": { "type": "object", "properties": { "content_tokens": { "type": "integer" }, "entities": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "end": { "type": "integer" }, "start": { "type": "integer" }, "text": { "type": "string" }, "type": { "type": "string" } }, "required": [ "type", "start", "end", "text" ] } }, "input": { "nullable": true, "type": "object", "properties": { "original_tokens": { "type": "integer" }, "processed_tokens": { "type": "integer" }, "truncated": { "type": "boolean" } }, "required": [ "original_tokens", "processed_tokens", "truncated" ] }, "scan_incomplete": { "type": "boolean" }, "scores_available": { "type": "boolean" }, "truncated_at": { "nullable": true, "type": "integer" }, "windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } } }, "required": [ "entities", "scores_available", "scan_incomplete" ] } }, "required": [ "binding", "result" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "409": { "description": "Conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "binding": { "type": "string" }, "recipe": { "type": "string" }, "text": { "type": "string" } }, "required": [ "recipe", "binding", "text" ], "additionalProperties": false } } } }, "x-vllm-sr-permission": "classify.invoke", "x-vllm-sr-sensitivity": "operational", "x-vllm-sr-plane": "diagnostic", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "advanced" } }, "/api/v1/diagnostics/routes/systemone": { "get": { "summary": "List active native recipe entrypoints for operator diagnostics without probing models; availability describes the routing plan, not backend health", "description": "List active native recipe entrypoints for operator diagnostics without probing models; availability describes the routing plan, not backend health", "operationId": "get_api_v1_diagnostics_routes_systemone", "tags": [ "diagnostics" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Active native routing plans", "content": { "application/json": { "schema": { "type": "object", "properties": { "available": { "type": "boolean" }, "routes": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "algorithms": { "nullable": true, "type": "array", "items": { "type": "string" } }, "execution_timeout_ms": { "type": "integer" }, "model": { "type": "string" }, "question_types": { "nullable": true, "type": "array", "items": { "type": "string" } }, "recipe": { "type": "string" } }, "required": [ "model", "recipe", "algorithms", "question_types", "execution_timeout_ms" ] } } }, "required": [ "available", "routes" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "config.read", "x-vllm-sr-sensitivity": "config", "x-vllm-sr-plane": "diagnostic", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "advanced" }, "post": { "summary": "Run a native recipe using operator classify.invoke permission; the selected algorithm owns its execution deadline and physical call budget, while signals use their own timeouts; independent of public listener grants", "description": "Run a native recipe using operator classify.invoke permission; the selected algorithm owns its execution deadline and physical call budget, while signals use their own timeouts; independent of public listener grants", "operationId": "post_api_v1_diagnostics_routes_systemone", "tags": [ "diagnostics" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Selected native response and routing outcome", "content": { "application/json": { "schema": { "nullable": true, "type": "object", "additionalProperties": true } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "502": { "description": "Bad Gateway", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "504": { "description": "Gateway Timeout", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "model": { "type": "string" }, "request": { "type": "object", "properties": { "images": { "nullable": true, "type": "array", "items": { "type": "string" } }, "model": { "nullable": true, "type": "string" }, "options": { "nullable": true, "type": "object", "properties": { "deadline_ms": { "nullable": true, "type": "number" }, "max_tokens": { "nullable": true, "type": "integer" }, "profile": { "nullable": true, "type": "string" }, "return_meta": { "nullable": true, "type": "boolean" } }, "additionalProperties": false }, "questions": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "choices": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "description": { "nullable": true }, "key": { "type": "string" } }, "required": [ "description", "key" ], "additionalProperties": false } }, "criteria": { "nullable": true }, "head": { "nullable": true, "type": "string" }, "instructions": { "nullable": true }, "labels": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "description": { "nullable": true }, "key": { "type": "string" } }, "required": [ "description", "key" ], "additionalProperties": false } }, "levels": { "nullable": true, "type": "array", "items": {} }, "over": { "nullable": true }, "overflow": { "nullable": true, "type": "string" }, "preset": { "nullable": true, "type": "string" }, "require_full_input": { "nullable": true, "type": "boolean" }, "threshold": { "nullable": true, "type": "number" }, "type": { "nullable": true, "type": "string" } }, "additionalProperties": false } }, "state": {}, "states": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "images": { "nullable": true, "type": "array", "items": { "type": "string" } }, "questions": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "choices": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "description": { "nullable": true }, "key": { "type": "string" } }, "required": [ "description", "key" ], "additionalProperties": false } }, "criteria": { "nullable": true }, "head": { "nullable": true, "type": "string" }, "instructions": { "nullable": true }, "labels": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "description": { "nullable": true }, "key": { "type": "string" } }, "required": [ "description", "key" ], "additionalProperties": false } }, "levels": { "nullable": true, "type": "array", "items": {} }, "over": { "nullable": true }, "overflow": { "nullable": true, "type": "string" }, "preset": { "nullable": true, "type": "string" }, "require_full_input": { "nullable": true, "type": "boolean" }, "threshold": { "nullable": true, "type": "number" }, "type": { "nullable": true, "type": "string" } }, "additionalProperties": false } }, "state": {}, "videos": { "nullable": true, "type": "array", "items": { "type": "string" } } }, "required": [ "questions", "state" ], "additionalProperties": false } }, "videos": { "nullable": true, "type": "array", "items": { "type": "string" } } }, "required": [ "questions", "state" ], "additionalProperties": false } }, "required": [ "model", "request" ], "additionalProperties": false } } } }, "x-vllm-sr-permission": "classify.invoke", "x-vllm-sr-sensitivity": "operational", "x-vllm-sr-plane": "diagnostic", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "advanced" } }, "/api/v1/diagnostics/similarity": { "post": { "summary": "Calculate pairwise text similarity", "description": "Calculate pairwise text similarity", "operationId": "post_api_v1_diagnostics_similarity", "tags": [ "diagnostics" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "model_used": { "type": "string" }, "processing_time_ms": { "type": "number" }, "recipe": { "type": "string" }, "similarity": { "type": "number" } }, "required": [ "model_used", "similarity", "processing_time_ms" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "dimension": { "type": "integer" }, "latency_priority": { "type": "number" }, "model": { "type": "string" }, "quality_priority": { "type": "number" }, "recipe": { "type": "string" }, "target_layer": { "type": "integer" }, "text1": { "type": "string" }, "text2": { "type": "string" } }, "required": [ "text1", "text2" ] } } } }, "x-vllm-sr-permission": "classify.invoke", "x-vllm-sr-sensitivity": "operational", "x-vllm-sr-plane": "diagnostic", "x-vllm-sr-audiences": [ "operator", "internal" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "advanced" } }, "/api/v1/diagnostics/similarity/batch": { "post": { "summary": "Calculate batch text-similarity matches", "description": "Calculate batch text-similarity matches", "operationId": "post_api_v1_diagnostics_similarity_batch", "tags": [ "diagnostics" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "matches": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "index": { "type": "integer" }, "similarity": { "type": "number" }, "text": { "type": "string" } }, "required": [ "index", "similarity", "text" ] } }, "model_used": { "type": "string" }, "processing_time_ms": { "type": "number" }, "recipe": { "type": "string" }, "total_candidates": { "type": "integer" } }, "required": [ "matches", "total_candidates", "model_used", "processing_time_ms" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "candidates": { "nullable": true, "type": "array", "items": { "type": "string" } }, "dimension": { "type": "integer" }, "latency_priority": { "type": "number" }, "model": { "type": "string" }, "quality_priority": { "type": "number" }, "query": { "type": "string" }, "recipe": { "type": "string" }, "target_layer": { "type": "integer" }, "top_k": { "type": "integer" } }, "required": [ "query", "candidates" ] } } } }, "x-vllm-sr-permission": "classify.invoke", "x-vllm-sr-sensitivity": "operational", "x-vllm-sr-plane": "diagnostic", "x-vllm-sr-audiences": [ "operator", "internal" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "advanced" } }, "/api/v1/instance": { "get": { "summary": "Read the serving frontend capability mode and default native deployment", "description": "Read the serving frontend capability mode and default native deployment", "operationId": "get_api_v1_instance", "tags": [ "diagnostics" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Active frontend state", "content": { "application/json": { "schema": { "type": "object", "properties": { "active_deployment": { "type": "string" }, "model": { "type": "string" }, "observed_mode": { "type": "string" } }, "required": [ "observed_mode" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "config.read", "x-vllm-sr-sensitivity": "config", "x-vllm-sr-plane": "diagnostic", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "advanced" } }, "/api/v1/inventory/classifier": { "get": { "summary": "Get classifier information and status (secrets redacted without secret_view)", "description": "Get classifier information and status (secrets redacted without secret_view)", "operationId": "get_api_v1_inventory_classifier", "tags": [ "inventory" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "config": {}, "status": { "type": "string" } }, "required": [ "status", "config" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "config.read", "x-vllm-sr-sensitivity": "secret_view", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" } }, "/api/v1/inventory/embedding-models": { "get": { "summary": "Get information about loaded embedding models", "description": "Get information about loaded embedding models", "operationId": "get_api_v1_inventory_embedding_models", "tags": [ "inventory" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "count": { "type": "integer" }, "models": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "categories": { "nullable": true, "type": "array", "items": { "type": "string" } }, "load_time": { "type": "string" }, "loaded": { "type": "boolean" }, "memory_usage": { "type": "string" }, "metadata": { "nullable": true, "type": "object", "additionalProperties": { "type": "string" } }, "model_path": { "type": "string" }, "name": { "type": "string" }, "recipe": { "type": "string" }, "registry": { "nullable": true, "type": "object", "properties": { "base_model": { "type": "string" }, "base_model_max_context": { "type": "integer" }, "datasets": { "nullable": true, "type": "array", "items": { "type": "string" } }, "description": { "type": "string" }, "embedding_dim": { "type": "integer" }, "languages": { "nullable": true, "type": "array", "items": { "type": "string" } }, "license": { "type": "string" }, "local_path": { "type": "string" }, "max_context_length": { "type": "integer" }, "model_card_url": { "type": "string" }, "num_classes": { "type": "integer" }, "parameter_size": { "type": "string" }, "pipeline_tag": { "type": "string" }, "purpose": { "type": "string" }, "repo_id": { "type": "string" }, "revision": { "type": "string" }, "tags": { "nullable": true, "type": "array", "items": { "type": "string" } }, "uses_lora": { "type": "boolean" } } }, "resolved_model_path": { "type": "string" }, "state": { "type": "string" }, "type": { "type": "string" } }, "required": [ "name", "type", "loaded" ] } } }, "required": [ "models", "count" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "config.read", "x-vllm-sr-sensitivity": "config", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" } }, "/api/v1/inventory/model-runtime": { "get": { "summary": "Get the model_runtime deployments: process, readiness, restarts and served model cards", "description": "Get the model_runtime deployments: process, readiness, restarts and served model cards", "operationId": "get_api_v1_inventory_model_runtime", "tags": [ "inventory" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "count": { "type": "integer" }, "deployments": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "desired_replicas": { "type": "integer" }, "device": { "type": "string" }, "embedding": { "nullable": true, "type": "object", "properties": { "dimensions": { "nullable": true, "type": "array", "items": { "type": "integer" } }, "layers": { "nullable": true, "type": "array", "items": { "type": "integer" } }, "modalities": { "nullable": true, "type": "array", "items": { "type": "string" } } } }, "endpoint": { "type": "string" }, "engine": { "type": "string" }, "family": { "type": "string" }, "heads": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string" }, "labels": { "nullable": true, "type": "array", "items": { "type": "string" } }, "name": { "type": "string" } }, "required": [ "name", "kind" ] } }, "managed": { "type": "boolean" }, "name": { "type": "string" }, "process": { "type": "string" }, "profile": { "type": "string" }, "ready": { "type": "boolean" }, "ready_replicas": { "type": "integer" }, "reason": { "type": "string" }, "replicas": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "device": { "type": "string" }, "estimated_work": { "type": "integer" }, "id": { "type": "string" }, "inflight": { "type": "integer" }, "managed": { "type": "boolean" }, "ready": { "type": "boolean" }, "reason": { "type": "string" }, "restarts": { "type": "integer" }, "state": { "type": "string" } }, "required": [ "id", "managed", "ready", "state", "inflight", "estimated_work", "restarts" ] } }, "repo": { "type": "string" }, "rerank": { "nullable": true, "type": "object", "properties": { "default_layer": { "type": "integer" }, "layers": { "nullable": true, "type": "array", "items": { "type": "integer" } } }, "required": [ "default_layer" ] }, "restarts": { "type": "integer" }, "revision": { "type": "string" }, "served_name": { "type": "string" }, "state": { "type": "string" }, "surfaces": { "nullable": true, "type": "array", "items": { "type": "string" } } }, "required": [ "desired_replicas", "ready_replicas", "name", "managed", "process", "served_name", "ready", "state", "restarts" ] } } }, "required": [ "deployments", "count" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "config.read", "x-vllm-sr-sensitivity": "config", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" } }, "/api/v1/inventory/models": { "get": { "summary": "Get information about loaded models", "description": "Get information about loaded models", "operationId": "get_api_v1_inventory_models", "tags": [ "inventory" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "models": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "categories": { "nullable": true, "type": "array", "items": { "type": "string" } }, "load_time": { "type": "string" }, "loaded": { "type": "boolean" }, "memory_usage": { "type": "string" }, "metadata": { "nullable": true, "type": "object", "additionalProperties": { "type": "string" } }, "model_path": { "type": "string" }, "name": { "type": "string" }, "recipe": { "type": "string" }, "registry": { "nullable": true, "type": "object", "properties": { "base_model": { "type": "string" }, "base_model_max_context": { "type": "integer" }, "datasets": { "nullable": true, "type": "array", "items": { "type": "string" } }, "description": { "type": "string" }, "embedding_dim": { "type": "integer" }, "languages": { "nullable": true, "type": "array", "items": { "type": "string" } }, "license": { "type": "string" }, "local_path": { "type": "string" }, "max_context_length": { "type": "integer" }, "model_card_url": { "type": "string" }, "num_classes": { "type": "integer" }, "parameter_size": { "type": "string" }, "pipeline_tag": { "type": "string" }, "purpose": { "type": "string" }, "repo_id": { "type": "string" }, "revision": { "type": "string" }, "tags": { "nullable": true, "type": "array", "items": { "type": "string" } }, "uses_lora": { "type": "boolean" } } }, "resolved_model_path": { "type": "string" }, "state": { "type": "string" }, "type": { "type": "string" } }, "required": [ "name", "type", "loaded" ] } }, "summary": { "type": "object", "properties": { "downloading_model": { "type": "string" }, "loaded_models": { "type": "integer" }, "message": { "type": "string" }, "pending_models": { "nullable": true, "type": "array", "items": { "type": "string" } }, "phase": { "type": "string" }, "ready": { "type": "boolean" }, "total_models": { "type": "integer" }, "updated_at": { "type": "string" } }, "required": [ "ready", "loaded_models", "total_models" ] }, "system": { "type": "object", "properties": { "architecture": { "type": "string" }, "go_version": { "type": "string" }, "gpu_available": { "type": "boolean" }, "memory_usage": { "type": "string" }, "os": { "type": "string" } }, "required": [ "go_version", "architecture", "os", "memory_usage", "gpu_available" ] } }, "required": [ "models", "summary", "system" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "config.read", "x-vllm-sr-sensitivity": "config", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" } }, "/api/v1/observability/audit": { "get": { "summary": "Page through this Router process's bounded management mutation audit, configuration lifecycle outcomes included; filter by action and resume after a sequence", "description": "Page through this Router process's bounded management mutation audit, configuration lifecycle outcomes included; filter by action and resume after a sequence", "operationId": "get_api_v1_observability_audit", "tags": [ "observability" ], "parameters": [ { "name": "action", "in": "query", "description": "Exact mutation audit action to select.", "schema": { "type": "string" } }, { "name": "after_sequence", "in": "query", "description": "Exclusive sequence cursor; omitted starts at the oldest retained entry.", "schema": { "type": "integer" } }, { "name": "limit", "in": "query", "description": "Page size, from 1 to 1000; defaults to 100.", "schema": { "type": "integer" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "A bounded audit page; retention is process-local and resets on restart", "content": { "application/json": { "schema": { "type": "object", "properties": { "capacity": { "type": "integer" }, "entries": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "action": { "type": "string" }, "config": { "nullable": true, "type": "object", "properties": { "attempt": { "type": "integer" }, "codes": { "nullable": true, "type": "array", "items": { "type": "string" } }, "hash": { "type": "string" }, "result": { "type": "string" }, "rollback_of": { "type": "integer" }, "source": { "type": "string" }, "stage": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "attempt", "result", "source" ] }, "hash": { "type": "string" }, "method": { "type": "string" }, "path": { "type": "string" }, "previous_hash": { "type": "string" }, "request_id": { "type": "string" }, "role": { "type": "string" }, "sequence": { "type": "integer" }, "status": { "type": "integer" }, "timestamp": { "type": "string" } }, "required": [ "sequence", "timestamp", "action", "request_id", "role", "method", "path", "status", "hash" ] } }, "has_more": { "type": "boolean" }, "next_sequence": { "type": "integer" }, "oldest_sequence": { "type": "integer" }, "retention": { "type": "string" }, "truncated": { "type": "boolean" } }, "required": [ "entries", "next_sequence", "oldest_sequence", "has_more", "truncated", "retention", "capacity" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "audit.read", "x-vllm-sr-sensitivity": "operational", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "advanced" } }, "/api/v1/observability/classification-metrics": { "get": { "summary": "Get classification metrics and statistics", "description": "Get classification metrics and statistics", "operationId": "get_api_v1_observability_classification_metrics", "tags": [ "observability" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "decision_count": { "type": "integer" }, "fact_check_classifier": { "type": "boolean" }, "feedback_detector": { "type": "boolean" }, "hallucination_detector": { "type": "boolean" }, "projection_mapping_count": { "type": "integer" }, "projection_partition_count": { "type": "integer" }, "projection_score_count": { "type": "integer" }, "router_config_api": { "type": "boolean" }, "signal_counts": { "nullable": true, "type": "object", "additionalProperties": { "type": "integer" } }, "unified_classifier": { "type": "boolean" } }, "required": [ "unified_classifier", "fact_check_classifier", "hallucination_detector", "feedback_detector", "decision_count", "projection_partition_count", "projection_score_count", "projection_mapping_count", "signal_counts", "router_config_api" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "metrics.read", "x-vllm-sr-sensitivity": "operational", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" } }, "/api/v1/observability/outcomes": { "post": { "summary": "Submit Router Learning outcome feedback linked to a replay record", "description": "Submit Router Learning outcome feedback linked to a replay record", "operationId": "post_api_v1_observability_outcomes", "tags": [ "observability" ], "parameters": [ { "name": "Idempotency-Key", "in": "header", "description": "Stable retry key for outcome ingestion.", "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "duplicate": { "type": "boolean" }, "recorded": { "type": "boolean" }, "success": { "type": "boolean" }, "timestamp": { "type": "string" }, "updated": { "type": "integer" } }, "required": [ "success", "updated", "recorded", "timestamp" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "409": { "description": "Conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "metadata": { "nullable": true, "type": "object", "additionalProperties": { "type": "string" } }, "reason": { "type": "string" }, "record_only": { "type": "boolean" }, "replay_id": { "type": "string" }, "score": { "nullable": true, "type": "number" }, "source": { "type": "string" }, "target": { "type": "string" }, "target_ref": { "type": "string" }, "verdict": { "type": "string" } }, "required": [ "replay_id", "target", "verdict" ] } } } }, "x-vllm-sr-permission": "learning.ingest", "x-vllm-sr-sensitivity": "mutation", "x-vllm-sr-audit-action": "outcome.ingest", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" } }, "/api/v1/observability/plugins/context_compression/stats": { "get": { "summary": "Get redacted context-compression statistics", "description": "Get redacted context-compression statistics", "operationId": "get_api_v1_observability_plugins_context_compression_stats", "tags": [ "observability" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "applied": { "type": "integer" }, "estimated_cost_saved_usd": { "type": "number" }, "failures": { "type": "integer" }, "recovery_failures": { "type": "integer" }, "recovery_reads": { "type": "integer" }, "recovery_writes": { "type": "integer" }, "requests": { "type": "integer" }, "skipped": { "type": "integer" }, "tokens_after": { "type": "integer" }, "tokens_before": { "type": "integer" }, "tokens_saved": { "type": "integer" } }, "required": [ "requests", "applied", "skipped", "failures", "recovery_writes", "recovery_reads", "recovery_failures", "tokens_before", "tokens_after", "tokens_saved", "estimated_cost_saved_usd" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "compression.read", "x-vllm-sr-sensitivity": "operational", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-plugin-operations": [ { "plugin": "context_compression", "mode": "read" } ], "x-vllm-sr-visibility": "advanced" } }, "/api/v1/observability/replays": { "get": { "summary": "List Router Replay records", "description": "List Router Replay records", "operationId": "get_api_v1_observability_replays", "tags": [ "observability" ], "parameters": [ { "name": "search", "in": "query", "description": "Case-insensitive text search across replay records.", "schema": { "type": "string" } }, { "name": "recipe", "in": "query", "description": "Filter by recipe name.", "schema": { "type": "string" } }, { "name": "decision", "in": "query", "description": "Filter by decision name.", "schema": { "type": "string" } }, { "name": "model", "in": "query", "description": "Filter by selected model.", "schema": { "type": "string" } }, { "name": "session_id", "in": "query", "description": "Filter by logical session identifier.", "schema": { "type": "string" } }, { "name": "cache_status", "in": "query", "description": "Filter by response-cache outcome.", "schema": { "type": "string", "enum": [ "all", "cached", "streamed" ] } }, { "name": "limit", "in": "query", "description": "Maximum records; defaults to 20 and is capped at 100.", "schema": { "type": "integer" } }, { "name": "offset", "in": "query", "description": "Zero-based result offset.", "schema": { "type": "integer" } }, { "name": "showDetails", "in": "query", "description": "Include full replay details when the principal has replay_detail permission.", "schema": { "type": "boolean" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful replay response", "content": { "application/json": { "schema": { "type": "object", "properties": { "count": { "type": "integer" }, "data": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "actual_cost": { "nullable": true, "type": "number" }, "baseline_cost": { "nullable": true, "type": "number" }, "baseline_model": { "nullable": true, "type": "string" }, "cache_entry_age_seconds": { "type": "number" }, "cache_hit_kind": { "type": "string" }, "cache_similarity": { "type": "number" }, "cache_source": { "type": "string" }, "cache_ttl_seconds": { "type": "integer" }, "cache_write_tokens": { "nullable": true, "type": "integer" }, "cached_prompt_tokens": { "nullable": true, "type": "integer" }, "category": { "type": "string" }, "completion_tokens": { "nullable": true, "type": "integer" }, "confidence_score": { "nullable": true, "type": "number" }, "confidence_score_available": { "type": "boolean" }, "context_token_count": { "type": "integer" }, "conversation_id": { "type": "string" }, "cost_savings": { "nullable": true, "type": "number" }, "currency": { "nullable": true, "type": "string" }, "decision": { "type": "string" }, "decision_priority": { "type": "integer" }, "decision_tier": { "type": "integer" }, "duration_ms": { "type": "integer" }, "ended_at": { "nullable": true, "type": "string", "format": "date-time" }, "from_cache": { "type": "boolean" }, "guardrails_enabled": { "type": "boolean" }, "hallucination_confidence": { "type": "number" }, "hallucination_detected": { "type": "boolean" }, "hallucination_enabled": { "type": "boolean" }, "hallucination_score_available": { "type": "boolean" }, "hallucination_score_kind": { "type": "string" }, "hallucination_span_details": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "end": { "type": "integer" }, "explanation": { "type": "string" }, "hallucination_confidence": { "type": "number" }, "score_available": { "type": "boolean" }, "severity": { "type": "integer" }, "start": { "type": "integer" }, "text": { "type": "string" } }, "required": [ "text", "start", "end", "score_available", "severity", "explanation" ] } }, "hallucination_spans": { "nullable": true, "type": "array", "items": { "type": "string" } }, "id": { "type": "string" }, "jailbreak_confidence": { "nullable": true, "type": "number" }, "jailbreak_decision": { "nullable": true, "type": "object", "properties": { "categories": { "nullable": true, "type": "array", "items": { "type": "string" } }, "label": { "type": "string" }, "score": { "nullable": true, "type": "object", "properties": { "Value": { "type": "number" } }, "required": [ "Value" ] }, "score_semantics": { "nullable": true, "type": "object", "properties": { "Calibrated": { "type": "boolean" }, "Direction": { "type": "string" }, "Maximum": { "nullable": true, "type": "number" }, "Minimum": { "nullable": true, "type": "number" }, "Unit": { "type": "string" } }, "required": [ "Unit", "Direction", "Minimum", "Maximum", "Calibrated" ] }, "source_label": { "type": "string" } }, "required": [ "label" ] }, "jailbreak_detected": { "type": "boolean" }, "jailbreak_enabled": { "type": "boolean" }, "jailbreak_score_available": { "type": "boolean" }, "jailbreak_type": { "type": "string" }, "learning": { "nullable": true, "type": "object", "properties": { "adaptation": { "nullable": true, "type": "object", "properties": { "action": { "type": "string" }, "base_model": { "type": "string" }, "candidate_set": { "type": "string" }, "decision": { "type": "string" }, "decision_tier": { "type": "integer" }, "learning": { "type": "string" }, "method": { "type": "string" }, "mode": { "type": "string" }, "proposal_model": { "type": "string" }, "reason": { "type": "string" }, "sampling": { "nullable": true, "type": "object", "properties": { "seed": { "type": "integer" }, "used": { "type": "boolean" } }, "required": [ "used" ] }, "scope": { "type": "string" }, "scores": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "cache_adjustment": { "type": "number" }, "cost_penalty": { "type": "number" }, "latency_adjustment": { "type": "number" }, "overuse_penalty": { "type": "number" }, "posterior_mean": { "type": "number" }, "predicted_quality": { "type": "number" }, "reliability_penalty": { "type": "number" }, "score": { "type": "number" } } } }, "strategy": { "type": "string" } } }, "protection": { "nullable": true, "type": "object", "properties": { "action": { "type": "string" }, "active_tool_loop": { "type": "boolean" }, "algorithm": { "type": "string" }, "base_method": { "type": "string" }, "base_model": { "type": "string" }, "base_scores": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "base_selected_model": { "type": "string" }, "cache_warmth": { "type": "number" }, "cache_warmth_ok": { "type": "boolean" }, "candidate_models": { "nullable": true, "type": "array", "items": { "type": "string" } }, "candidate_traces": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "base_score": { "type": "number" }, "current": { "type": "boolean" }, "final_score": { "type": "number" }, "frontier_cost_multiplier": { "type": "number" }, "handoff_penalty": { "type": "number" }, "net_switch_advantage": { "type": "number" }, "prefix_cache_benefit": { "type": "number" }, "prefix_cache_penalty": { "type": "number" }, "quality_gap": { "type": "number" }, "selector_delta": { "type": "number" }, "switch_history_penalty": { "type": "number" }, "tool_loop_penalty": { "type": "number" } } } }, "continuation_mass": { "type": "number" }, "current_model": { "type": "string" }, "decision_drift": { "type": "boolean" }, "decision_reason": { "type": "string" }, "final_model": { "type": "string" }, "final_scores": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "hard_lock_reason": { "type": "string" }, "hard_locked": { "type": "boolean" }, "has_non_portable_context": { "type": "boolean" }, "identity": { "nullable": true, "type": "object", "properties": { "conversation": { "type": "object", "properties": { "hash": { "type": "string" }, "required": { "type": "boolean" }, "source": { "type": "string" }, "status": { "type": "string" } } }, "headers": { "type": "object", "properties": { "conversation": { "type": "string" }, "session": { "type": "string" } } }, "memory_key_hash": { "type": "string" }, "scope": { "type": "string" }, "session": { "type": "object", "properties": { "hash": { "type": "string" }, "required": { "type": "boolean" }, "source": { "type": "string" }, "status": { "type": "string" } } } } }, "idle_expired": { "type": "boolean" }, "idle_for_seconds": { "type": "number" }, "idle_known": { "type": "boolean" }, "last_cache_accounting_source": { "type": "string" }, "last_decision_name": { "type": "string" }, "learning": { "type": "string" }, "memory_cached_tokens": { "type": "integer" }, "memory_estimated_cache_savings": { "type": "number" }, "memory_estimated_cached_tokens": { "type": "integer" }, "memory_prompt_tokens": { "type": "integer" }, "memory_turn_count": { "type": "integer" }, "method": { "type": "string" }, "missing_signals": { "nullable": true, "type": "array", "items": { "type": "string" } }, "mode": { "type": "string" }, "non_portable_context_reason": { "type": "string" }, "phase": { "type": "string" }, "proposal_model": { "type": "string" }, "reason": { "type": "string" }, "remaining_turn_prior": { "type": "number" }, "remaining_turn_prior_ok": { "type": "boolean" }, "remaining_turn_prior_rejected": { "type": "string" }, "remaining_turn_prior_sample_count": { "type": "integer" }, "remaining_turn_prior_source": { "type": "string" }, "remaining_turns_estimate": { "type": "number" }, "rescue": { "nullable": true, "type": "object", "properties": { "active": { "type": "boolean" } }, "required": [ "active" ] }, "sampling": { "type": "string" }, "scope": { "type": "string" }, "selected_model": { "type": "string" }, "stability_weight": { "type": "number" }, "stay_bias": { "type": "number" }, "switch_cost": { "type": "number" }, "switch_count": { "type": "integer" }, "switch_margin": { "type": "number" }, "turn_index": { "type": "integer" } } }, "protection_preflight": { "nullable": true, "type": "object", "properties": { "action": { "type": "string" }, "active_tool_loop": { "type": "boolean" }, "algorithm": { "type": "string" }, "base_method": { "type": "string" }, "base_model": { "type": "string" }, "base_scores": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "base_selected_model": { "type": "string" }, "cache_warmth": { "type": "number" }, "cache_warmth_ok": { "type": "boolean" }, "candidate_models": { "nullable": true, "type": "array", "items": { "type": "string" } }, "candidate_traces": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "base_score": { "type": "number" }, "current": { "type": "boolean" }, "final_score": { "type": "number" }, "frontier_cost_multiplier": { "type": "number" }, "handoff_penalty": { "type": "number" }, "net_switch_advantage": { "type": "number" }, "prefix_cache_benefit": { "type": "number" }, "prefix_cache_penalty": { "type": "number" }, "quality_gap": { "type": "number" }, "selector_delta": { "type": "number" }, "switch_history_penalty": { "type": "number" }, "tool_loop_penalty": { "type": "number" } } } }, "continuation_mass": { "type": "number" }, "current_model": { "type": "string" }, "decision_drift": { "type": "boolean" }, "decision_reason": { "type": "string" }, "final_model": { "type": "string" }, "final_scores": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "hard_lock_reason": { "type": "string" }, "hard_locked": { "type": "boolean" }, "has_non_portable_context": { "type": "boolean" }, "identity": { "nullable": true, "type": "object", "properties": { "conversation": { "type": "object", "properties": { "hash": { "type": "string" }, "required": { "type": "boolean" }, "source": { "type": "string" }, "status": { "type": "string" } } }, "headers": { "type": "object", "properties": { "conversation": { "type": "string" }, "session": { "type": "string" } } }, "memory_key_hash": { "type": "string" }, "scope": { "type": "string" }, "session": { "type": "object", "properties": { "hash": { "type": "string" }, "required": { "type": "boolean" }, "source": { "type": "string" }, "status": { "type": "string" } } } } }, "idle_expired": { "type": "boolean" }, "idle_for_seconds": { "type": "number" }, "idle_known": { "type": "boolean" }, "last_cache_accounting_source": { "type": "string" }, "last_decision_name": { "type": "string" }, "learning": { "type": "string" }, "memory_cached_tokens": { "type": "integer" }, "memory_estimated_cache_savings": { "type": "number" }, "memory_estimated_cached_tokens": { "type": "integer" }, "memory_prompt_tokens": { "type": "integer" }, "memory_turn_count": { "type": "integer" }, "method": { "type": "string" }, "missing_signals": { "nullable": true, "type": "array", "items": { "type": "string" } }, "mode": { "type": "string" }, "non_portable_context_reason": { "type": "string" }, "phase": { "type": "string" }, "proposal_model": { "type": "string" }, "reason": { "type": "string" }, "remaining_turn_prior": { "type": "number" }, "remaining_turn_prior_ok": { "type": "boolean" }, "remaining_turn_prior_rejected": { "type": "string" }, "remaining_turn_prior_sample_count": { "type": "integer" }, "remaining_turn_prior_source": { "type": "string" }, "remaining_turns_estimate": { "type": "number" }, "rescue": { "nullable": true, "type": "object", "properties": { "active": { "type": "boolean" } }, "required": [ "active" ] }, "sampling": { "type": "string" }, "scope": { "type": "string" }, "selected_model": { "type": "string" }, "stability_weight": { "type": "number" }, "stay_bias": { "type": "number" }, "switch_cost": { "type": "number" }, "switch_count": { "type": "integer" }, "switch_margin": { "type": "number" }, "turn_index": { "type": "integer" } } }, "protection_state_key": { "type": "string" } } }, "lifecycle_state": { "type": "string" }, "original_model": { "type": "string" }, "outcomes": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "idempotency_key": { "type": "string" }, "metadata": { "nullable": true, "type": "object", "additionalProperties": { "type": "string" } }, "reason": { "type": "string" }, "score": { "type": "number" }, "source": { "type": "string" }, "target": { "type": "string" }, "target_ref": { "type": "string" }, "timestamp": { "type": "string", "format": "date-time" }, "verdict": { "type": "string" } }, "required": [ "source", "target", "verdict" ] } }, "pii_blocked": { "type": "boolean" }, "pii_detected": { "type": "boolean" }, "pii_enabled": { "type": "boolean" }, "pii_entities": { "nullable": true, "type": "array", "items": { "type": "string" } }, "previous_response_id": { "type": "string" }, "projection_scores": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "projection_trace": { "nullable": true, "type": "object", "properties": { "mappings": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "boundary_distance": { "type": "number" }, "confidence": { "type": "number" }, "mapping_name": { "type": "string" }, "outputs": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "boundary_distance": { "type": "number" }, "matched": { "type": "boolean" }, "name": { "type": "string" } }, "required": [ "name", "matched", "boundary_distance" ] } }, "score_value": { "type": "number" }, "selected_output": { "type": "string" }, "source_score": { "type": "string" } }, "required": [ "mapping_name", "source_score", "score_value" ] } }, "partitions": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "contenders": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "normalized_score": { "nullable": true, "type": "number" }, "raw_score": { "type": "number" } }, "required": [ "name", "raw_score" ] } }, "default_used": { "type": "boolean" }, "group_name": { "type": "string" }, "margin": { "type": "number" }, "raw_winner_score": { "type": "number" }, "semantics": { "type": "string" }, "signal_type": { "type": "string" }, "temperature": { "type": "number" }, "winner": { "type": "string" }, "winner_score": { "type": "number" } }, "required": [ "group_name", "signal_type" ] } }, "schema_version": { "type": "string" }, "scores": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "inputs": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "contribution": { "type": "number" }, "kb": { "type": "string" }, "metric": { "type": "string" }, "name": { "type": "string" }, "type": { "type": "string" }, "value": { "type": "number" }, "weight": { "type": "number" } }, "required": [ "type", "weight", "value", "contribution" ] } }, "name": { "type": "string" }, "total": { "type": "number" } }, "required": [ "name", "total" ] } } }, "required": [ "schema_version" ] }, "projections": { "nullable": true, "type": "array", "items": { "type": "string" } }, "prompt": { "type": "string" }, "prompt_tokens": { "nullable": true, "type": "integer" }, "prompt_truncated": { "type": "boolean" }, "rag_backend": { "type": "string" }, "rag_context_length": { "type": "integer" }, "rag_enabled": { "type": "boolean" }, "rag_similarity_score": { "type": "number" }, "reasoning_mode": { "type": "string" }, "recipe": { "type": "string" }, "request_body": { "type": "string" }, "request_body_truncated": { "type": "boolean" }, "request_id": { "type": "string" }, "response_body": { "type": "string" }, "response_body_truncated": { "type": "boolean" }, "response_jailbreak_confidence": { "nullable": true, "type": "number" }, "response_jailbreak_decision": { "nullable": true, "type": "object", "properties": { "categories": { "nullable": true, "type": "array", "items": { "type": "string" } }, "label": { "type": "string" }, "score": { "nullable": true, "type": "object", "properties": { "Value": { "type": "number" } }, "required": [ "Value" ] }, "score_semantics": { "nullable": true, "type": "object", "properties": { "Calibrated": { "type": "boolean" }, "Direction": { "type": "string" }, "Maximum": { "nullable": true, "type": "number" }, "Minimum": { "nullable": true, "type": "number" }, "Unit": { "type": "string" } }, "required": [ "Unit", "Direction", "Minimum", "Maximum", "Calibrated" ] }, "source_label": { "type": "string" } }, "required": [ "label" ] }, "response_jailbreak_detected": { "type": "boolean" }, "response_jailbreak_score_available": { "type": "boolean" }, "response_jailbreak_type": { "type": "string" }, "response_status": { "type": "integer" }, "route_diagnostics": { "nullable": true, "type": "object", "properties": { "annotations": { "nullable": true, "type": "object", "additionalProperties": true }, "applied_unknown_policies": { "nullable": true, "type": "object", "additionalProperties": { "type": "string" } }, "context_compression_applied": { "type": "boolean" }, "context_compression_budget_mode": { "type": "string" }, "context_compression_cost_saved": { "type": "number" }, "context_compression_fallback": { "type": "string" }, "context_compression_format": { "type": "string" }, "context_compression_messages": { "type": "integer" }, "context_compression_omitted_chunks": { "type": "integer" }, "context_compression_quality": { "type": "string" }, "context_compression_recovery_keys": { "type": "integer" }, "context_compression_revision": { "type": "string" }, "context_compression_skip_reason": { "type": "string" }, "context_compression_strategy": { "type": "string" }, "context_compression_token_source": { "type": "string" }, "context_compression_tokens_after": { "type": "integer" }, "context_compression_tokens_before": { "type": "integer" }, "context_compression_trigger": { "type": "string" }, "decision": { "type": "string" }, "decision_priority": { "type": "integer" }, "decision_ranking": { "nullable": true, "type": "object", "properties": { "candidates": { "type": "integer" }, "comparable": { "type": "boolean" }, "decided_by": { "type": "string" }, "fallback_reason": { "type": "string" }, "reason": { "type": "string" }, "runner_up": { "type": "string" }, "score_kind": { "type": "string" }, "strategy": { "type": "string" }, "tier": { "type": "integer" }, "tiered": { "type": "boolean" }, "winner": { "type": "string" } }, "required": [ "strategy", "tiered", "tier", "comparable", "decided_by", "winner", "candidates" ] }, "decision_reason": { "type": "string" }, "decision_tier": { "type": "integer" }, "fusion_quorum": { "nullable": true, "type": "object", "properties": { "attempts": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "completion_tokens": { "type": "integer" }, "model": { "type": "string" }, "prompt_tokens": { "type": "integer" }, "state": { "type": "string" }, "total_tokens": { "type": "integer" } }, "required": [ "model", "state" ] } }, "disposition": { "type": "string" }, "fallback_target": { "type": "string" }, "required_count": { "type": "integer" }, "selected_policy": { "type": "string" }, "usable_count": { "type": "integer" } }, "required": [ "required_count", "usable_count" ] }, "hard_lock_reason": { "type": "string" }, "looper": { "nullable": true, "type": "object", "properties": { "algorithm": { "type": "string" }, "attempts": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "accepted": { "nullable": true, "type": "boolean" }, "actual_cost": { "nullable": true, "type": "number" }, "currency": { "type": "string" }, "discarded": { "type": "boolean" }, "estimated_cost": { "nullable": true, "type": "number" }, "estimated_tokens": { "nullable": true, "type": "integer" }, "first_byte_latency_ms": { "nullable": true, "type": "integer" }, "model": { "type": "string" }, "ordinal": { "type": "integer" }, "queue_latency_ms": { "nullable": true, "type": "integer" }, "reason": { "type": "string" }, "reserved_tokens": { "nullable": true, "type": "integer" }, "role": { "type": "string" }, "score": { "nullable": true, "type": "number" }, "selected": { "type": "boolean" }, "stage": { "type": "string" }, "status": { "type": "string" }, "synthesized": { "type": "boolean" }, "threshold": { "nullable": true, "type": "number" }, "total_latency_ms": { "type": "integer" }, "usable": { "nullable": true, "type": "boolean" }, "usage": { "type": "object", "properties": { "completion_tokens": { "type": "integer" }, "prompt_tokens": { "type": "integer" }, "total_tokens": { "type": "integer" } } }, "verifier_type": { "type": "string" }, "verifier_version": { "type": "string" } }, "required": [ "ordinal", "stage", "status", "total_latency_ms" ] } }, "attempts_truncated": { "type": "boolean" }, "dropped_attempt_count": { "type": "integer" }, "dropped_usage": { "type": "object", "properties": { "completion_tokens": { "type": "integer" }, "prompt_tokens": { "type": "integer" }, "total_tokens": { "type": "integer" } } }, "final_attempt_ordinal": { "type": "integer" }, "trace_id": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "version", "algorithm" ] }, "memory_backend": { "type": "string" }, "memory_fail_open": { "type": "boolean" }, "memory_fallback_reason": { "type": "string" }, "memory_reason": { "type": "string" }, "memory_result_count": { "type": "integer" }, "memory_status": { "type": "string" }, "original_model": { "type": "string" }, "prepared_dispatch": { "nullable": true, "type": "object", "properties": { "byte_length": { "type": "integer" }, "sha256": { "type": "string" }, "version": { "type": "integer" }, "wire_format": { "type": "string" } }, "required": [ "version", "wire_format", "sha256", "byte_length" ] }, "previous_model": { "type": "string" }, "prompt_helper_completion_tokens": { "type": "integer" }, "prompt_helper_latency_ms": { "type": "integer" }, "prompt_helper_model": { "type": "string" }, "prompt_helper_prompt_tokens": { "type": "integer" }, "prompt_helper_total_tokens": { "type": "integer" }, "proposal_model": { "type": "string" }, "request_demand_snapshots": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "counting_source": { "type": "string" }, "model": { "type": "string" }, "output_reserve_source": { "type": "string" }, "prompt_tokens": { "type": "integer" }, "representation": { "type": "string" }, "request_generation": { "type": "integer" }, "reserved_output_tokens": { "type": "integer" }, "stage": { "type": "string" }, "total_demand_known": { "type": "boolean" }, "total_demand_tokens": { "type": "integer" } }, "required": [ "stage", "representation", "prompt_tokens", "reserved_output_tokens", "total_demand_tokens", "total_demand_known", "counting_source", "output_reserve_source", "request_generation" ] } }, "selected_model": { "type": "string" }, "selection_method": { "type": "string" }, "selection_reasoning": { "type": "string" }, "selection_trace": { "nullable": true, "type": "object", "properties": { "final_survivors": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "LoRAName": { "type": "string" }, "Model": { "type": "string" }, "ReasoningDescription": { "type": "string" }, "ReasoningEffort": { "type": "string" }, "ReasoningMode": { "type": "string" }, "UseReasoning": { "nullable": true, "type": "boolean" }, "Weight": { "type": "number" } }, "required": [ "Model", "LoRAName", "Weight", "UseReasoning", "ReasoningDescription", "ReasoningMode", "ReasoningEffort" ] } }, "stages": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "action": { "type": "string" }, "available": { "type": "integer" }, "candidates": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "candidate": { "type": "object", "properties": { "LoRAName": { "type": "string" }, "Model": { "type": "string" }, "ReasoningDescription": { "type": "string" }, "ReasoningEffort": { "type": "string" }, "ReasoningMode": { "type": "string" }, "UseReasoning": { "nullable": true, "type": "boolean" }, "Weight": { "type": "number" } }, "required": [ "Model", "LoRAName", "Weight", "UseReasoning", "ReasoningDescription", "ReasoningMode", "ReasoningEffort" ] }, "elimination_reason": { "type": "string" }, "metric": { "type": "string" }, "value": { "nullable": true, "type": "number" } }, "required": [ "candidate" ] } }, "factor": { "type": "string" }, "metric": { "type": "string" }, "percentile": { "type": "integer" }, "reason": { "type": "string" }, "tolerance": { "type": "number" }, "total": { "type": "integer" } }, "required": [ "factor", "action", "reason", "tolerance", "available", "total", "candidates" ] } } }, "required": [ "stages", "final_survivors" ] }, "session_action": { "type": "string" }, "session_phase": { "type": "string" }, "session_policy_applied": { "type": "boolean" }, "session_reason": { "type": "string" }, "signal_errors": { "nullable": true, "type": "object", "additionalProperties": { "type": "string" } }, "topic_continuity": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "assistant_included": { "type": "boolean" }, "class": { "type": "string" }, "classify_us": { "type": "integer" }, "combined_score": { "type": "number" }, "confidence": { "type": "number" }, "coverage": { "type": "string" }, "entity_score": { "type": "number" }, "evaluator_version": { "type": "string" }, "excluded_content_present": { "type": "boolean" }, "fallback": { "type": "boolean" }, "feature_cap_reached": { "type": "boolean" }, "history_source": { "type": "string" }, "input_bytes": { "type": "integer" }, "lexical_score": { "type": "number" }, "live_prose_terms": { "type": "integer" }, "live_terms": { "type": "integer" }, "marker_ambiguous": { "type": "boolean" }, "max_entity_score": { "type": "number" }, "max_raw_score": { "type": "number" }, "prepare_extract_us": { "type": "integer" }, "prior_turns_examined": { "type": "integer" }, "reason": { "type": "string" }, "schema_version": { "type": "string" }, "signal": { "type": "string" } }, "required": [ "signal", "schema_version", "evaluator_version", "class", "confidence", "reason", "fallback", "coverage", "history_source", "assistant_included", "excluded_content_present", "feature_cap_reached", "marker_ambiguous", "prior_turns_examined", "input_bytes", "live_terms", "live_prose_terms", "lexical_score", "entity_score", "combined_score", "max_raw_score", "max_entity_score", "classify_us", "prepare_extract_us" ] } } } }, "selected_model": { "type": "string" }, "selection_method": { "type": "string" }, "session_id": { "type": "string" }, "session_policy": { "nullable": true, "type": "object", "additionalProperties": true }, "signal_confidences": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "signal_error_matches": { "nullable": true, "type": "object", "additionalProperties": { "type": "boolean" } }, "signal_values": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "signals": { "type": "object", "properties": { "authz": { "nullable": true, "type": "array", "items": { "type": "string" } }, "classifier": { "nullable": true, "type": "array", "items": { "type": "string" } }, "complexity": { "nullable": true, "type": "array", "items": { "type": "string" } }, "context": { "nullable": true, "type": "array", "items": { "type": "string" } }, "conversation": { "nullable": true, "type": "array", "items": { "type": "string" } }, "decision": { "nullable": true, "type": "array", "items": { "type": "string" } }, "domain": { "nullable": true, "type": "array", "items": { "type": "string" } }, "embedding": { "nullable": true, "type": "array", "items": { "type": "string" } }, "event": { "nullable": true, "type": "array", "items": { "type": "string" } }, "fact_check": { "nullable": true, "type": "array", "items": { "type": "string" } }, "input_modality": { "nullable": true, "type": "array", "items": { "type": "string" } }, "jailbreak": { "nullable": true, "type": "array", "items": { "type": "string" } }, "kb": { "nullable": true, "type": "array", "items": { "type": "string" } }, "keyword": { "nullable": true, "type": "array", "items": { "type": "string" } }, "language": { "nullable": true, "type": "array", "items": { "type": "string" } }, "metadata": { "nullable": true, "type": "array", "items": { "type": "string" } }, "modality": { "nullable": true, "type": "array", "items": { "type": "string" } }, "pii": { "nullable": true, "type": "array", "items": { "type": "string" } }, "preference": { "nullable": true, "type": "array", "items": { "type": "string" } }, "reask": { "nullable": true, "type": "array", "items": { "type": "string" } }, "safety": { "nullable": true, "type": "array", "items": { "type": "string" } }, "structure": { "nullable": true, "type": "array", "items": { "type": "string" } }, "user_feedback": { "nullable": true, "type": "array", "items": { "type": "string" } } } }, "streaming": { "type": "boolean" }, "terminal_reason": { "type": "string" }, "timestamp": { "type": "string", "format": "date-time" }, "tool_definitions": { "type": "string" }, "tool_definitions_truncated": { "type": "boolean" }, "tool_trace": { "nullable": true, "type": "object", "properties": { "dropped_step_count": { "type": "integer" }, "flow": { "type": "string" }, "stage": { "type": "string" }, "steps": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "api_type": { "type": "string" }, "arguments": { "type": "string" }, "content_redacted": { "type": "boolean" }, "output": { "type": "string" }, "raw_arguments": { "type": "string" }, "raw_output": { "type": "string" }, "role": { "type": "string" }, "source": { "type": "string" }, "status": { "type": "string" }, "text": { "type": "string" }, "tool_call_id": { "type": "string" }, "tool_name": { "type": "string" }, "truncated": { "type": "boolean" }, "type": { "type": "string" } }, "required": [ "type" ] } }, "steps_truncated": { "type": "boolean" }, "tool_names": { "nullable": true, "type": "array", "items": { "type": "string" } } } }, "total_tokens": { "nullable": true, "type": "integer" }, "turn_index": { "type": "integer" } }, "required": [ "id", "timestamp", "turn_index", "decision_tier", "decision_priority", "signals", "confidence_score_available", "lifecycle_state", "jailbreak_score_available", "response_jailbreak_score_available", "hallucination_score_available", "confidence_score" ] } }, "has_more": { "type": "boolean" }, "limit": { "type": "integer" }, "next_offset": { "nullable": true, "type": "integer" }, "object": { "type": "string" }, "offset": { "type": "integer" }, "total": { "type": "integer" } }, "required": [ "object", "count", "total", "limit", "offset", "has_more", "data" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "replay.read", "x-vllm-sr-sensitivity": "replay", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-plugin-operations": [ { "plugin": "router_replay", "mode": "read" }, { "plugin": "shadow_dispatch", "mode": "read" } ], "x-vllm-sr-visibility": "primary" } }, "/api/v1/observability/replays/aggregate": { "get": { "summary": "Aggregate Router Replay routing and cost metadata", "description": "Aggregate Router Replay routing and cost metadata", "operationId": "get_api_v1_observability_replays_aggregate", "tags": [ "observability" ], "parameters": [ { "name": "search", "in": "query", "description": "Case-insensitive text search across replay records.", "schema": { "type": "string" } }, { "name": "recipe", "in": "query", "description": "Filter by recipe name.", "schema": { "type": "string" } }, { "name": "decision", "in": "query", "description": "Filter by decision name.", "schema": { "type": "string" } }, { "name": "model", "in": "query", "description": "Filter by selected model.", "schema": { "type": "string" } }, { "name": "session_id", "in": "query", "description": "Filter by logical session identifier.", "schema": { "type": "string" } }, { "name": "cache_status", "in": "query", "description": "Filter by response-cache outcome.", "schema": { "type": "string", "enum": [ "all", "cached", "streamed" ] } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful replay response", "content": { "application/json": { "schema": { "type": "object", "properties": { "available_decisions": { "nullable": true, "type": "array", "items": { "type": "string" } }, "available_models": { "nullable": true, "type": "array", "items": { "type": "string" } }, "available_recipes": { "nullable": true, "type": "array", "items": { "type": "string" } }, "decision_distribution": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "value": { "type": "integer" } }, "required": [ "name", "value" ] } }, "lifecycle": { "type": "object", "properties": { "aborted": { "type": "integer" }, "completed": { "type": "integer" }, "failed": { "type": "integer" }, "in_progress": { "type": "integer" }, "unknown": { "type": "integer" } }, "required": [ "completed", "failed", "aborted", "in_progress", "unknown" ] }, "model_selection": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "value": { "type": "integer" } }, "required": [ "name", "value" ] } }, "object": { "type": "string" }, "record_count": { "type": "integer" }, "signal_distribution": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "value": { "type": "integer" } }, "required": [ "name", "value" ] } }, "summary": { "type": "object", "properties": { "actual_spend": { "type": "number" }, "baseline_spend": { "type": "number" }, "by_currency": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "actual_spend": { "type": "number" }, "baseline_spend": { "type": "number" }, "cost_record_count": { "type": "integer" }, "currency": { "type": "string" }, "total_saved": { "type": "number" } }, "required": [ "currency", "total_saved", "baseline_spend", "actual_spend", "cost_record_count" ] } }, "cost_record_count": { "type": "integer" }, "currency": { "type": "string" }, "excluded_record_count": { "type": "integer" }, "total_saved": { "type": "number" } }, "required": [ "total_saved", "baseline_spend", "actual_spend", "cost_record_count", "excluded_record_count" ] }, "token_breakdown": { "type": "object", "properties": { "by_decision": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "input_tokens": { "type": "integer" }, "name": { "type": "string" }, "output_tokens": { "type": "integer" }, "total_tokens": { "type": "integer" } }, "required": [ "name", "input_tokens", "output_tokens", "total_tokens" ] } }, "by_selected_model": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "input_tokens": { "type": "integer" }, "name": { "type": "string" }, "output_tokens": { "type": "integer" }, "total_tokens": { "type": "integer" } }, "required": [ "name", "input_tokens", "output_tokens", "total_tokens" ] } } }, "required": [ "by_decision", "by_selected_model" ] }, "token_volume": { "type": "object", "properties": { "excluded_record_count": { "type": "integer" }, "input_tokens": { "type": "integer" }, "output_tokens": { "type": "integer" }, "total_tokens": { "type": "integer" } }, "required": [ "input_tokens", "output_tokens", "total_tokens", "excluded_record_count" ] } }, "required": [ "object", "record_count", "lifecycle", "summary", "model_selection", "decision_distribution", "signal_distribution", "token_volume", "token_breakdown", "available_recipes", "available_decisions", "available_models" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "replay.read", "x-vllm-sr-sensitivity": "replay", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-plugin-operations": [ { "plugin": "router_replay", "mode": "read" }, { "plugin": "shadow_dispatch", "mode": "read" } ], "x-vllm-sr-visibility": "primary" } }, "/api/v1/observability/replays/dataset": { "get": { "summary": "Export a shadow comparison dataset manifest built from the selected Router Replay records", "description": "Export a shadow comparison dataset manifest built from the selected Router Replay records", "operationId": "get_api_v1_observability_replays_dataset", "tags": [ "observability" ], "parameters": [ { "name": "search", "in": "query", "description": "Case-insensitive text search across replay records.", "schema": { "type": "string" } }, { "name": "recipe", "in": "query", "description": "Filter by recipe name.", "schema": { "type": "string" } }, { "name": "decision", "in": "query", "description": "Filter by decision name.", "schema": { "type": "string" } }, { "name": "model", "in": "query", "description": "Filter by selected model.", "schema": { "type": "string" } }, { "name": "session_id", "in": "query", "description": "Filter by logical session identifier.", "schema": { "type": "string" } }, { "name": "cache_status", "in": "query", "description": "Filter by response-cache outcome.", "schema": { "type": "string", "enum": [ "all", "cached", "streamed" ] } }, { "name": "seed", "in": "query", "description": "Seed that fixes split assignment; the same records under the same seed reproduce the same manifest.", "required": true, "schema": { "type": "string" } }, { "name": "split", "in": "query", "description": "Repeatable split written as name:weight, for example train:8.", "required": true, "schema": { "type": "string" } }, { "name": "balance_by", "in": "query", "description": "Group a balance cap applies to. Requires balance_max.", "schema": { "type": "string", "enum": [ "recipe", "decision", "primary_model" ] } }, { "name": "balance_max", "in": "query", "description": "Most examples one group may contribute. Requires balance_by.", "schema": { "type": "integer" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Shadow comparison dataset manifest", "content": { "application/json": { "schema": { "type": "object", "properties": { "counts": { "type": "object", "properties": { "examples": { "type": "integer" }, "excluded": { "nullable": true, "type": "object", "additionalProperties": { "type": "integer" } }, "records": { "type": "integer" } }, "required": [ "records", "examples" ] }, "digest": { "type": "string" }, "examples": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "input_digest": { "type": "string" }, "lineage": { "type": "object", "properties": { "decision": { "type": "string" }, "recipe": { "type": "string" }, "replay_id": { "type": "string" }, "request_id": { "type": "string" } }, "required": [ "replay_id" ] }, "primary": { "type": "object", "properties": { "backend": { "type": "string" }, "model": { "type": "string" }, "output_digest": { "type": "string" }, "sample_rate": { "type": "string" } }, "required": [ "model", "output_digest" ] }, "shadows": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "backend": { "type": "string" }, "model": { "type": "string" }, "output_digest": { "type": "string" }, "sample_rate": { "type": "string" } }, "required": [ "model", "output_digest" ] } }, "split": { "type": "string" } }, "required": [ "id", "input_digest", "split", "primary", "shadows", "lineage" ] } }, "policy": { "type": "object", "properties": { "balance": { "nullable": true, "type": "object", "properties": { "by": { "type": "string" }, "max": { "type": "integer" } }, "required": [ "by", "max" ] }, "seed": { "type": "string" }, "splits": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "weight": { "type": "integer" } }, "required": [ "name", "weight" ] } } }, "required": [ "seed", "splits" ] }, "version": { "type": "string" } }, "required": [ "version", "digest", "policy", "counts", "examples" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "replay.read", "x-vllm-sr-sensitivity": "replay", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-plugin-operations": [ { "plugin": "router_replay", "mode": "read" }, { "plugin": "shadow_dispatch", "mode": "read" } ], "x-vllm-sr-visibility": "primary" } }, "/api/v1/observability/replays/dataset/judge-tasks": { "get": { "summary": "Build blinded pairwise judge tasks over the shadow comparison dataset", "description": "Build blinded pairwise judge tasks over the shadow comparison dataset", "operationId": "get_api_v1_observability_replays_dataset_judge_tasks", "tags": [ "observability" ], "parameters": [ { "name": "search", "in": "query", "description": "Case-insensitive text search across replay records.", "schema": { "type": "string" } }, { "name": "recipe", "in": "query", "description": "Filter by recipe name.", "schema": { "type": "string" } }, { "name": "decision", "in": "query", "description": "Filter by decision name.", "schema": { "type": "string" } }, { "name": "model", "in": "query", "description": "Filter by selected model.", "schema": { "type": "string" } }, { "name": "session_id", "in": "query", "description": "Filter by logical session identifier.", "schema": { "type": "string" } }, { "name": "cache_status", "in": "query", "description": "Filter by response-cache outcome.", "schema": { "type": "string", "enum": [ "all", "cached", "streamed" ] } }, { "name": "seed", "in": "query", "description": "Seed that fixes split assignment; the same records under the same seed reproduce the same manifest.", "required": true, "schema": { "type": "string" } }, { "name": "split", "in": "query", "description": "Repeatable split written as name:weight, for example train:8.", "required": true, "schema": { "type": "string" } }, { "name": "balance_by", "in": "query", "description": "Group a balance cap applies to. Requires balance_max.", "schema": { "type": "string", "enum": [ "recipe", "decision", "primary_model" ] } }, { "name": "balance_max", "in": "query", "description": "Most examples one group may contribute. Requires balance_by.", "schema": { "type": "integer" } }, { "name": "blinding_key", "in": "query", "description": "Secret that derives the opaque arm labels. Keep it from the judge, since it maps each label back to a model.", "required": true, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Blinded judge tasks", "content": { "application/json": { "schema": { "type": "object", "properties": { "counts": { "type": "object", "properties": { "excluded": { "nullable": true, "type": "object", "additionalProperties": { "type": "integer" } }, "pairs": { "type": "integer" }, "tasks": { "type": "integer" } }, "required": [ "pairs", "tasks" ] }, "manifest_digest": { "type": "string" }, "tasks": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "first": { "type": "object", "properties": { "arm": { "type": "string" }, "names_own_model": { "type": "boolean" }, "text": { "type": "string" } }, "required": [ "arm", "text" ] }, "id": { "type": "string" }, "input": { "type": "string" }, "input_digest": { "type": "string" }, "pair": { "type": "string" }, "second": { "type": "object", "properties": { "arm": { "type": "string" }, "names_own_model": { "type": "boolean" }, "text": { "type": "string" } }, "required": [ "arm", "text" ] } }, "required": [ "id", "pair", "input", "input_digest", "first", "second" ] } }, "version": { "type": "string" } }, "required": [ "version", "manifest_digest", "counts", "tasks" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "replay.detail", "x-vllm-sr-sensitivity": "replay", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-plugin-operations": [ { "plugin": "router_replay", "mode": "read" }, { "plugin": "shadow_dispatch", "mode": "read" } ], "x-vllm-sr-visibility": "primary" } }, "/api/v1/observability/replays/trajectory": { "get": { "summary": "Build a recipe-scoped session trajectory with each recorded routing result", "description": "Build a recipe-scoped session trajectory with each recorded routing result", "operationId": "get_api_v1_observability_replays_trajectory", "tags": [ "observability" ], "parameters": [ { "name": "session_id", "in": "query", "description": "Logical session whose tool trajectory should be returned.", "required": true, "schema": { "type": "string" } }, { "name": "recipe", "in": "query", "description": "Exact recipe scope; an empty value selects legacy unscoped records. Required when the session ID occurs in multiple recipes.", "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful replay response", "content": { "application/json": { "schema": { "type": "object", "properties": { "messages": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "content": { "type": "string" }, "conversation_id": { "type": "string" }, "role": { "type": "string" }, "tool_call_id": { "type": "string" }, "tool_calls": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "function": { "type": "object", "properties": { "arguments": { "type": "string" }, "name": { "type": "string" } }, "required": [ "name", "arguments" ] }, "id": { "type": "string" }, "type": { "type": "string" } }, "required": [ "id", "type", "function" ] } }, "tool_name": { "type": "string" }, "turn_index": { "type": "integer" } }, "required": [ "role", "turn_index" ] } }, "object": { "type": "string" }, "recipe": { "type": "string" }, "record_count": { "type": "integer" }, "routes": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "conversation_id": { "type": "string" }, "decision": { "type": "string" }, "duration_ms": { "type": "integer" }, "lifecycle_state": { "type": "string" }, "previous_model": { "type": "string" }, "record_id": { "type": "string" }, "response_status": { "type": "integer" }, "selected_model": { "type": "string" }, "selection_method": { "type": "string" }, "selection_reasoning": { "type": "string" }, "session_action": { "type": "string" }, "session_policy_applied": { "type": "boolean" }, "session_reason": { "type": "string" }, "timestamp": { "type": "string", "format": "date-time" }, "turn_index": { "type": "integer" } }, "required": [ "record_id", "timestamp", "turn_index", "session_policy_applied", "lifecycle_state", "duration_ms" ] } }, "session_id": { "type": "string" }, "turn_count": { "type": "integer" } }, "required": [ "object", "session_id", "recipe", "record_count", "turn_count", "messages", "routes" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "replay.read", "x-vllm-sr-sensitivity": "replay", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-plugin-operations": [ { "plugin": "router_replay", "mode": "read" }, { "plugin": "shadow_dispatch", "mode": "read" } ], "x-vllm-sr-visibility": "primary" } }, "/api/v1/observability/replays/{id}": { "get": { "summary": "Read one Router Replay record", "description": "Read one Router Replay record", "operationId": "get_api_v1_observability_replays_id", "tags": [ "observability" ], "parameters": [ { "name": "id", "in": "path", "description": "id path parameter", "required": true, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful replay response", "content": { "application/json": { "schema": { "type": "object", "properties": { "actual_cost": { "nullable": true, "type": "number" }, "baseline_cost": { "nullable": true, "type": "number" }, "baseline_model": { "nullable": true, "type": "string" }, "cache_entry_age_seconds": { "type": "number" }, "cache_hit_kind": { "type": "string" }, "cache_similarity": { "type": "number" }, "cache_source": { "type": "string" }, "cache_ttl_seconds": { "type": "integer" }, "cache_write_tokens": { "nullable": true, "type": "integer" }, "cached_prompt_tokens": { "nullable": true, "type": "integer" }, "category": { "type": "string" }, "completion_tokens": { "nullable": true, "type": "integer" }, "confidence_score": { "nullable": true, "type": "number" }, "confidence_score_available": { "type": "boolean" }, "context_token_count": { "type": "integer" }, "conversation_id": { "type": "string" }, "cost_savings": { "nullable": true, "type": "number" }, "currency": { "nullable": true, "type": "string" }, "decision": { "type": "string" }, "decision_priority": { "type": "integer" }, "decision_tier": { "type": "integer" }, "duration_ms": { "type": "integer" }, "ended_at": { "nullable": true, "type": "string", "format": "date-time" }, "from_cache": { "type": "boolean" }, "guardrails_enabled": { "type": "boolean" }, "hallucination_confidence": { "type": "number" }, "hallucination_detected": { "type": "boolean" }, "hallucination_enabled": { "type": "boolean" }, "hallucination_score_available": { "type": "boolean" }, "hallucination_score_kind": { "type": "string" }, "hallucination_span_details": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "end": { "type": "integer" }, "explanation": { "type": "string" }, "hallucination_confidence": { "type": "number" }, "score_available": { "type": "boolean" }, "severity": { "type": "integer" }, "start": { "type": "integer" }, "text": { "type": "string" } }, "required": [ "text", "start", "end", "score_available", "severity", "explanation" ] } }, "hallucination_spans": { "nullable": true, "type": "array", "items": { "type": "string" } }, "id": { "type": "string" }, "jailbreak_confidence": { "nullable": true, "type": "number" }, "jailbreak_decision": { "nullable": true, "type": "object", "properties": { "categories": { "nullable": true, "type": "array", "items": { "type": "string" } }, "label": { "type": "string" }, "score": { "nullable": true, "type": "object", "properties": { "Value": { "type": "number" } }, "required": [ "Value" ] }, "score_semantics": { "nullable": true, "type": "object", "properties": { "Calibrated": { "type": "boolean" }, "Direction": { "type": "string" }, "Maximum": { "nullable": true, "type": "number" }, "Minimum": { "nullable": true, "type": "number" }, "Unit": { "type": "string" } }, "required": [ "Unit", "Direction", "Minimum", "Maximum", "Calibrated" ] }, "source_label": { "type": "string" } }, "required": [ "label" ] }, "jailbreak_detected": { "type": "boolean" }, "jailbreak_enabled": { "type": "boolean" }, "jailbreak_score_available": { "type": "boolean" }, "jailbreak_type": { "type": "string" }, "learning": { "nullable": true, "type": "object", "properties": { "adaptation": { "nullable": true, "type": "object", "properties": { "action": { "type": "string" }, "base_model": { "type": "string" }, "candidate_set": { "type": "string" }, "decision": { "type": "string" }, "decision_tier": { "type": "integer" }, "learning": { "type": "string" }, "method": { "type": "string" }, "mode": { "type": "string" }, "proposal_model": { "type": "string" }, "reason": { "type": "string" }, "sampling": { "nullable": true, "type": "object", "properties": { "seed": { "type": "integer" }, "used": { "type": "boolean" } }, "required": [ "used" ] }, "scope": { "type": "string" }, "scores": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "cache_adjustment": { "type": "number" }, "cost_penalty": { "type": "number" }, "latency_adjustment": { "type": "number" }, "overuse_penalty": { "type": "number" }, "posterior_mean": { "type": "number" }, "predicted_quality": { "type": "number" }, "reliability_penalty": { "type": "number" }, "score": { "type": "number" } } } }, "strategy": { "type": "string" } } }, "protection": { "nullable": true, "type": "object", "properties": { "action": { "type": "string" }, "active_tool_loop": { "type": "boolean" }, "algorithm": { "type": "string" }, "base_method": { "type": "string" }, "base_model": { "type": "string" }, "base_scores": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "base_selected_model": { "type": "string" }, "cache_warmth": { "type": "number" }, "cache_warmth_ok": { "type": "boolean" }, "candidate_models": { "nullable": true, "type": "array", "items": { "type": "string" } }, "candidate_traces": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "base_score": { "type": "number" }, "current": { "type": "boolean" }, "final_score": { "type": "number" }, "frontier_cost_multiplier": { "type": "number" }, "handoff_penalty": { "type": "number" }, "net_switch_advantage": { "type": "number" }, "prefix_cache_benefit": { "type": "number" }, "prefix_cache_penalty": { "type": "number" }, "quality_gap": { "type": "number" }, "selector_delta": { "type": "number" }, "switch_history_penalty": { "type": "number" }, "tool_loop_penalty": { "type": "number" } } } }, "continuation_mass": { "type": "number" }, "current_model": { "type": "string" }, "decision_drift": { "type": "boolean" }, "decision_reason": { "type": "string" }, "final_model": { "type": "string" }, "final_scores": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "hard_lock_reason": { "type": "string" }, "hard_locked": { "type": "boolean" }, "has_non_portable_context": { "type": "boolean" }, "identity": { "nullable": true, "type": "object", "properties": { "conversation": { "type": "object", "properties": { "hash": { "type": "string" }, "required": { "type": "boolean" }, "source": { "type": "string" }, "status": { "type": "string" } } }, "headers": { "type": "object", "properties": { "conversation": { "type": "string" }, "session": { "type": "string" } } }, "memory_key_hash": { "type": "string" }, "scope": { "type": "string" }, "session": { "type": "object", "properties": { "hash": { "type": "string" }, "required": { "type": "boolean" }, "source": { "type": "string" }, "status": { "type": "string" } } } } }, "idle_expired": { "type": "boolean" }, "idle_for_seconds": { "type": "number" }, "idle_known": { "type": "boolean" }, "last_cache_accounting_source": { "type": "string" }, "last_decision_name": { "type": "string" }, "learning": { "type": "string" }, "memory_cached_tokens": { "type": "integer" }, "memory_estimated_cache_savings": { "type": "number" }, "memory_estimated_cached_tokens": { "type": "integer" }, "memory_prompt_tokens": { "type": "integer" }, "memory_turn_count": { "type": "integer" }, "method": { "type": "string" }, "missing_signals": { "nullable": true, "type": "array", "items": { "type": "string" } }, "mode": { "type": "string" }, "non_portable_context_reason": { "type": "string" }, "phase": { "type": "string" }, "proposal_model": { "type": "string" }, "reason": { "type": "string" }, "remaining_turn_prior": { "type": "number" }, "remaining_turn_prior_ok": { "type": "boolean" }, "remaining_turn_prior_rejected": { "type": "string" }, "remaining_turn_prior_sample_count": { "type": "integer" }, "remaining_turn_prior_source": { "type": "string" }, "remaining_turns_estimate": { "type": "number" }, "rescue": { "nullable": true, "type": "object", "properties": { "active": { "type": "boolean" } }, "required": [ "active" ] }, "sampling": { "type": "string" }, "scope": { "type": "string" }, "selected_model": { "type": "string" }, "stability_weight": { "type": "number" }, "stay_bias": { "type": "number" }, "switch_cost": { "type": "number" }, "switch_count": { "type": "integer" }, "switch_margin": { "type": "number" }, "turn_index": { "type": "integer" } } }, "protection_preflight": { "nullable": true, "type": "object", "properties": { "action": { "type": "string" }, "active_tool_loop": { "type": "boolean" }, "algorithm": { "type": "string" }, "base_method": { "type": "string" }, "base_model": { "type": "string" }, "base_scores": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "base_selected_model": { "type": "string" }, "cache_warmth": { "type": "number" }, "cache_warmth_ok": { "type": "boolean" }, "candidate_models": { "nullable": true, "type": "array", "items": { "type": "string" } }, "candidate_traces": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "base_score": { "type": "number" }, "current": { "type": "boolean" }, "final_score": { "type": "number" }, "frontier_cost_multiplier": { "type": "number" }, "handoff_penalty": { "type": "number" }, "net_switch_advantage": { "type": "number" }, "prefix_cache_benefit": { "type": "number" }, "prefix_cache_penalty": { "type": "number" }, "quality_gap": { "type": "number" }, "selector_delta": { "type": "number" }, "switch_history_penalty": { "type": "number" }, "tool_loop_penalty": { "type": "number" } } } }, "continuation_mass": { "type": "number" }, "current_model": { "type": "string" }, "decision_drift": { "type": "boolean" }, "decision_reason": { "type": "string" }, "final_model": { "type": "string" }, "final_scores": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "hard_lock_reason": { "type": "string" }, "hard_locked": { "type": "boolean" }, "has_non_portable_context": { "type": "boolean" }, "identity": { "nullable": true, "type": "object", "properties": { "conversation": { "type": "object", "properties": { "hash": { "type": "string" }, "required": { "type": "boolean" }, "source": { "type": "string" }, "status": { "type": "string" } } }, "headers": { "type": "object", "properties": { "conversation": { "type": "string" }, "session": { "type": "string" } } }, "memory_key_hash": { "type": "string" }, "scope": { "type": "string" }, "session": { "type": "object", "properties": { "hash": { "type": "string" }, "required": { "type": "boolean" }, "source": { "type": "string" }, "status": { "type": "string" } } } } }, "idle_expired": { "type": "boolean" }, "idle_for_seconds": { "type": "number" }, "idle_known": { "type": "boolean" }, "last_cache_accounting_source": { "type": "string" }, "last_decision_name": { "type": "string" }, "learning": { "type": "string" }, "memory_cached_tokens": { "type": "integer" }, "memory_estimated_cache_savings": { "type": "number" }, "memory_estimated_cached_tokens": { "type": "integer" }, "memory_prompt_tokens": { "type": "integer" }, "memory_turn_count": { "type": "integer" }, "method": { "type": "string" }, "missing_signals": { "nullable": true, "type": "array", "items": { "type": "string" } }, "mode": { "type": "string" }, "non_portable_context_reason": { "type": "string" }, "phase": { "type": "string" }, "proposal_model": { "type": "string" }, "reason": { "type": "string" }, "remaining_turn_prior": { "type": "number" }, "remaining_turn_prior_ok": { "type": "boolean" }, "remaining_turn_prior_rejected": { "type": "string" }, "remaining_turn_prior_sample_count": { "type": "integer" }, "remaining_turn_prior_source": { "type": "string" }, "remaining_turns_estimate": { "type": "number" }, "rescue": { "nullable": true, "type": "object", "properties": { "active": { "type": "boolean" } }, "required": [ "active" ] }, "sampling": { "type": "string" }, "scope": { "type": "string" }, "selected_model": { "type": "string" }, "stability_weight": { "type": "number" }, "stay_bias": { "type": "number" }, "switch_cost": { "type": "number" }, "switch_count": { "type": "integer" }, "switch_margin": { "type": "number" }, "turn_index": { "type": "integer" } } }, "protection_state_key": { "type": "string" } } }, "lifecycle_state": { "type": "string" }, "original_model": { "type": "string" }, "outcomes": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "idempotency_key": { "type": "string" }, "metadata": { "nullable": true, "type": "object", "additionalProperties": { "type": "string" } }, "reason": { "type": "string" }, "score": { "type": "number" }, "source": { "type": "string" }, "target": { "type": "string" }, "target_ref": { "type": "string" }, "timestamp": { "type": "string", "format": "date-time" }, "verdict": { "type": "string" } }, "required": [ "source", "target", "verdict" ] } }, "pii_blocked": { "type": "boolean" }, "pii_detected": { "type": "boolean" }, "pii_enabled": { "type": "boolean" }, "pii_entities": { "nullable": true, "type": "array", "items": { "type": "string" } }, "previous_response_id": { "type": "string" }, "projection_scores": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "projection_trace": { "nullable": true, "type": "object", "properties": { "mappings": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "boundary_distance": { "type": "number" }, "confidence": { "type": "number" }, "mapping_name": { "type": "string" }, "outputs": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "boundary_distance": { "type": "number" }, "matched": { "type": "boolean" }, "name": { "type": "string" } }, "required": [ "name", "matched", "boundary_distance" ] } }, "score_value": { "type": "number" }, "selected_output": { "type": "string" }, "source_score": { "type": "string" } }, "required": [ "mapping_name", "source_score", "score_value" ] } }, "partitions": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "contenders": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "normalized_score": { "nullable": true, "type": "number" }, "raw_score": { "type": "number" } }, "required": [ "name", "raw_score" ] } }, "default_used": { "type": "boolean" }, "group_name": { "type": "string" }, "margin": { "type": "number" }, "raw_winner_score": { "type": "number" }, "semantics": { "type": "string" }, "signal_type": { "type": "string" }, "temperature": { "type": "number" }, "winner": { "type": "string" }, "winner_score": { "type": "number" } }, "required": [ "group_name", "signal_type" ] } }, "schema_version": { "type": "string" }, "scores": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "inputs": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "contribution": { "type": "number" }, "kb": { "type": "string" }, "metric": { "type": "string" }, "name": { "type": "string" }, "type": { "type": "string" }, "value": { "type": "number" }, "weight": { "type": "number" } }, "required": [ "type", "weight", "value", "contribution" ] } }, "name": { "type": "string" }, "total": { "type": "number" } }, "required": [ "name", "total" ] } } }, "required": [ "schema_version" ] }, "projections": { "nullable": true, "type": "array", "items": { "type": "string" } }, "prompt": { "type": "string" }, "prompt_tokens": { "nullable": true, "type": "integer" }, "prompt_truncated": { "type": "boolean" }, "rag_backend": { "type": "string" }, "rag_context_length": { "type": "integer" }, "rag_enabled": { "type": "boolean" }, "rag_similarity_score": { "type": "number" }, "reasoning_mode": { "type": "string" }, "recipe": { "type": "string" }, "request_body": { "type": "string" }, "request_body_truncated": { "type": "boolean" }, "request_id": { "type": "string" }, "response_body": { "type": "string" }, "response_body_truncated": { "type": "boolean" }, "response_jailbreak_confidence": { "nullable": true, "type": "number" }, "response_jailbreak_decision": { "nullable": true, "type": "object", "properties": { "categories": { "nullable": true, "type": "array", "items": { "type": "string" } }, "label": { "type": "string" }, "score": { "nullable": true, "type": "object", "properties": { "Value": { "type": "number" } }, "required": [ "Value" ] }, "score_semantics": { "nullable": true, "type": "object", "properties": { "Calibrated": { "type": "boolean" }, "Direction": { "type": "string" }, "Maximum": { "nullable": true, "type": "number" }, "Minimum": { "nullable": true, "type": "number" }, "Unit": { "type": "string" } }, "required": [ "Unit", "Direction", "Minimum", "Maximum", "Calibrated" ] }, "source_label": { "type": "string" } }, "required": [ "label" ] }, "response_jailbreak_detected": { "type": "boolean" }, "response_jailbreak_score_available": { "type": "boolean" }, "response_jailbreak_type": { "type": "string" }, "response_status": { "type": "integer" }, "route_diagnostics": { "nullable": true, "type": "object", "properties": { "annotations": { "nullable": true, "type": "object", "additionalProperties": true }, "applied_unknown_policies": { "nullable": true, "type": "object", "additionalProperties": { "type": "string" } }, "context_compression_applied": { "type": "boolean" }, "context_compression_budget_mode": { "type": "string" }, "context_compression_cost_saved": { "type": "number" }, "context_compression_fallback": { "type": "string" }, "context_compression_format": { "type": "string" }, "context_compression_messages": { "type": "integer" }, "context_compression_omitted_chunks": { "type": "integer" }, "context_compression_quality": { "type": "string" }, "context_compression_recovery_keys": { "type": "integer" }, "context_compression_revision": { "type": "string" }, "context_compression_skip_reason": { "type": "string" }, "context_compression_strategy": { "type": "string" }, "context_compression_token_source": { "type": "string" }, "context_compression_tokens_after": { "type": "integer" }, "context_compression_tokens_before": { "type": "integer" }, "context_compression_trigger": { "type": "string" }, "decision": { "type": "string" }, "decision_priority": { "type": "integer" }, "decision_ranking": { "nullable": true, "type": "object", "properties": { "candidates": { "type": "integer" }, "comparable": { "type": "boolean" }, "decided_by": { "type": "string" }, "fallback_reason": { "type": "string" }, "reason": { "type": "string" }, "runner_up": { "type": "string" }, "score_kind": { "type": "string" }, "strategy": { "type": "string" }, "tier": { "type": "integer" }, "tiered": { "type": "boolean" }, "winner": { "type": "string" } }, "required": [ "strategy", "tiered", "tier", "comparable", "decided_by", "winner", "candidates" ] }, "decision_reason": { "type": "string" }, "decision_tier": { "type": "integer" }, "fusion_quorum": { "nullable": true, "type": "object", "properties": { "attempts": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "completion_tokens": { "type": "integer" }, "model": { "type": "string" }, "prompt_tokens": { "type": "integer" }, "state": { "type": "string" }, "total_tokens": { "type": "integer" } }, "required": [ "model", "state" ] } }, "disposition": { "type": "string" }, "fallback_target": { "type": "string" }, "required_count": { "type": "integer" }, "selected_policy": { "type": "string" }, "usable_count": { "type": "integer" } }, "required": [ "required_count", "usable_count" ] }, "hard_lock_reason": { "type": "string" }, "looper": { "nullable": true, "type": "object", "properties": { "algorithm": { "type": "string" }, "attempts": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "accepted": { "nullable": true, "type": "boolean" }, "actual_cost": { "nullable": true, "type": "number" }, "currency": { "type": "string" }, "discarded": { "type": "boolean" }, "estimated_cost": { "nullable": true, "type": "number" }, "estimated_tokens": { "nullable": true, "type": "integer" }, "first_byte_latency_ms": { "nullable": true, "type": "integer" }, "model": { "type": "string" }, "ordinal": { "type": "integer" }, "queue_latency_ms": { "nullable": true, "type": "integer" }, "reason": { "type": "string" }, "reserved_tokens": { "nullable": true, "type": "integer" }, "role": { "type": "string" }, "score": { "nullable": true, "type": "number" }, "selected": { "type": "boolean" }, "stage": { "type": "string" }, "status": { "type": "string" }, "synthesized": { "type": "boolean" }, "threshold": { "nullable": true, "type": "number" }, "total_latency_ms": { "type": "integer" }, "usable": { "nullable": true, "type": "boolean" }, "usage": { "type": "object", "properties": { "completion_tokens": { "type": "integer" }, "prompt_tokens": { "type": "integer" }, "total_tokens": { "type": "integer" } } }, "verifier_type": { "type": "string" }, "verifier_version": { "type": "string" } }, "required": [ "ordinal", "stage", "status", "total_latency_ms" ] } }, "attempts_truncated": { "type": "boolean" }, "dropped_attempt_count": { "type": "integer" }, "dropped_usage": { "type": "object", "properties": { "completion_tokens": { "type": "integer" }, "prompt_tokens": { "type": "integer" }, "total_tokens": { "type": "integer" } } }, "final_attempt_ordinal": { "type": "integer" }, "trace_id": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "version", "algorithm" ] }, "memory_backend": { "type": "string" }, "memory_fail_open": { "type": "boolean" }, "memory_fallback_reason": { "type": "string" }, "memory_reason": { "type": "string" }, "memory_result_count": { "type": "integer" }, "memory_status": { "type": "string" }, "original_model": { "type": "string" }, "prepared_dispatch": { "nullable": true, "type": "object", "properties": { "byte_length": { "type": "integer" }, "sha256": { "type": "string" }, "version": { "type": "integer" }, "wire_format": { "type": "string" } }, "required": [ "version", "wire_format", "sha256", "byte_length" ] }, "previous_model": { "type": "string" }, "prompt_helper_completion_tokens": { "type": "integer" }, "prompt_helper_latency_ms": { "type": "integer" }, "prompt_helper_model": { "type": "string" }, "prompt_helper_prompt_tokens": { "type": "integer" }, "prompt_helper_total_tokens": { "type": "integer" }, "proposal_model": { "type": "string" }, "request_demand_snapshots": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "counting_source": { "type": "string" }, "model": { "type": "string" }, "output_reserve_source": { "type": "string" }, "prompt_tokens": { "type": "integer" }, "representation": { "type": "string" }, "request_generation": { "type": "integer" }, "reserved_output_tokens": { "type": "integer" }, "stage": { "type": "string" }, "total_demand_known": { "type": "boolean" }, "total_demand_tokens": { "type": "integer" } }, "required": [ "stage", "representation", "prompt_tokens", "reserved_output_tokens", "total_demand_tokens", "total_demand_known", "counting_source", "output_reserve_source", "request_generation" ] } }, "selected_model": { "type": "string" }, "selection_method": { "type": "string" }, "selection_reasoning": { "type": "string" }, "selection_trace": { "nullable": true, "type": "object", "properties": { "final_survivors": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "LoRAName": { "type": "string" }, "Model": { "type": "string" }, "ReasoningDescription": { "type": "string" }, "ReasoningEffort": { "type": "string" }, "ReasoningMode": { "type": "string" }, "UseReasoning": { "nullable": true, "type": "boolean" }, "Weight": { "type": "number" } }, "required": [ "Model", "LoRAName", "Weight", "UseReasoning", "ReasoningDescription", "ReasoningMode", "ReasoningEffort" ] } }, "stages": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "action": { "type": "string" }, "available": { "type": "integer" }, "candidates": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "candidate": { "type": "object", "properties": { "LoRAName": { "type": "string" }, "Model": { "type": "string" }, "ReasoningDescription": { "type": "string" }, "ReasoningEffort": { "type": "string" }, "ReasoningMode": { "type": "string" }, "UseReasoning": { "nullable": true, "type": "boolean" }, "Weight": { "type": "number" } }, "required": [ "Model", "LoRAName", "Weight", "UseReasoning", "ReasoningDescription", "ReasoningMode", "ReasoningEffort" ] }, "elimination_reason": { "type": "string" }, "metric": { "type": "string" }, "value": { "nullable": true, "type": "number" } }, "required": [ "candidate" ] } }, "factor": { "type": "string" }, "metric": { "type": "string" }, "percentile": { "type": "integer" }, "reason": { "type": "string" }, "tolerance": { "type": "number" }, "total": { "type": "integer" } }, "required": [ "factor", "action", "reason", "tolerance", "available", "total", "candidates" ] } } }, "required": [ "stages", "final_survivors" ] }, "session_action": { "type": "string" }, "session_phase": { "type": "string" }, "session_policy_applied": { "type": "boolean" }, "session_reason": { "type": "string" }, "signal_errors": { "nullable": true, "type": "object", "additionalProperties": { "type": "string" } }, "topic_continuity": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "assistant_included": { "type": "boolean" }, "class": { "type": "string" }, "classify_us": { "type": "integer" }, "combined_score": { "type": "number" }, "confidence": { "type": "number" }, "coverage": { "type": "string" }, "entity_score": { "type": "number" }, "evaluator_version": { "type": "string" }, "excluded_content_present": { "type": "boolean" }, "fallback": { "type": "boolean" }, "feature_cap_reached": { "type": "boolean" }, "history_source": { "type": "string" }, "input_bytes": { "type": "integer" }, "lexical_score": { "type": "number" }, "live_prose_terms": { "type": "integer" }, "live_terms": { "type": "integer" }, "marker_ambiguous": { "type": "boolean" }, "max_entity_score": { "type": "number" }, "max_raw_score": { "type": "number" }, "prepare_extract_us": { "type": "integer" }, "prior_turns_examined": { "type": "integer" }, "reason": { "type": "string" }, "schema_version": { "type": "string" }, "signal": { "type": "string" } }, "required": [ "signal", "schema_version", "evaluator_version", "class", "confidence", "reason", "fallback", "coverage", "history_source", "assistant_included", "excluded_content_present", "feature_cap_reached", "marker_ambiguous", "prior_turns_examined", "input_bytes", "live_terms", "live_prose_terms", "lexical_score", "entity_score", "combined_score", "max_raw_score", "max_entity_score", "classify_us", "prepare_extract_us" ] } } } }, "selected_model": { "type": "string" }, "selection_method": { "type": "string" }, "session_id": { "type": "string" }, "session_policy": { "nullable": true, "type": "object", "additionalProperties": true }, "signal_confidences": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "signal_error_matches": { "nullable": true, "type": "object", "additionalProperties": { "type": "boolean" } }, "signal_values": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "signals": { "type": "object", "properties": { "authz": { "nullable": true, "type": "array", "items": { "type": "string" } }, "classifier": { "nullable": true, "type": "array", "items": { "type": "string" } }, "complexity": { "nullable": true, "type": "array", "items": { "type": "string" } }, "context": { "nullable": true, "type": "array", "items": { "type": "string" } }, "conversation": { "nullable": true, "type": "array", "items": { "type": "string" } }, "decision": { "nullable": true, "type": "array", "items": { "type": "string" } }, "domain": { "nullable": true, "type": "array", "items": { "type": "string" } }, "embedding": { "nullable": true, "type": "array", "items": { "type": "string" } }, "event": { "nullable": true, "type": "array", "items": { "type": "string" } }, "fact_check": { "nullable": true, "type": "array", "items": { "type": "string" } }, "input_modality": { "nullable": true, "type": "array", "items": { "type": "string" } }, "jailbreak": { "nullable": true, "type": "array", "items": { "type": "string" } }, "kb": { "nullable": true, "type": "array", "items": { "type": "string" } }, "keyword": { "nullable": true, "type": "array", "items": { "type": "string" } }, "language": { "nullable": true, "type": "array", "items": { "type": "string" } }, "metadata": { "nullable": true, "type": "array", "items": { "type": "string" } }, "modality": { "nullable": true, "type": "array", "items": { "type": "string" } }, "pii": { "nullable": true, "type": "array", "items": { "type": "string" } }, "preference": { "nullable": true, "type": "array", "items": { "type": "string" } }, "reask": { "nullable": true, "type": "array", "items": { "type": "string" } }, "safety": { "nullable": true, "type": "array", "items": { "type": "string" } }, "structure": { "nullable": true, "type": "array", "items": { "type": "string" } }, "user_feedback": { "nullable": true, "type": "array", "items": { "type": "string" } } } }, "streaming": { "type": "boolean" }, "terminal_reason": { "type": "string" }, "timestamp": { "type": "string", "format": "date-time" }, "tool_definitions": { "type": "string" }, "tool_definitions_truncated": { "type": "boolean" }, "tool_trace": { "nullable": true, "type": "object", "properties": { "dropped_step_count": { "type": "integer" }, "flow": { "type": "string" }, "stage": { "type": "string" }, "steps": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "api_type": { "type": "string" }, "arguments": { "type": "string" }, "content_redacted": { "type": "boolean" }, "output": { "type": "string" }, "raw_arguments": { "type": "string" }, "raw_output": { "type": "string" }, "role": { "type": "string" }, "source": { "type": "string" }, "status": { "type": "string" }, "text": { "type": "string" }, "tool_call_id": { "type": "string" }, "tool_name": { "type": "string" }, "truncated": { "type": "boolean" }, "type": { "type": "string" } }, "required": [ "type" ] } }, "steps_truncated": { "type": "boolean" }, "tool_names": { "nullable": true, "type": "array", "items": { "type": "string" } } } }, "total_tokens": { "nullable": true, "type": "integer" }, "turn_index": { "type": "integer" } }, "required": [ "id", "timestamp", "turn_index", "decision_tier", "decision_priority", "signals", "confidence_score_available", "lifecycle_state", "jailbreak_score_available", "response_jailbreak_score_available", "hallucination_score_available", "confidence_score" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "replay.read", "x-vllm-sr-sensitivity": "replay", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-plugin-operations": [ { "plugin": "router_replay", "mode": "read" }, { "plugin": "shadow_dispatch", "mode": "read" } ], "x-vllm-sr-visibility": "primary" } }, "/api/v1/plugins": { "get": { "summary": "Discover every registered recipe-scoped plugin, its schema, bindings, and supported operations", "description": "Discover every registered recipe-scoped plugin, its schema, bindings, and supported operations", "operationId": "get_api_v1_plugins", "tags": [ "plugins" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Registered plugin catalog", "content": { "application/json": { "schema": { "type": "object", "properties": { "plugins": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "bindings": { "type": "string" }, "configuration_scope": { "type": "string" }, "description": { "type": "string" }, "display_name": { "type": "string" }, "operations": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "method": { "type": "string" }, "mode": { "type": "string" }, "path": { "type": "string" } }, "required": [ "method", "path", "mode" ] } }, "schema": { "type": "string" }, "type": { "type": "string" } }, "required": [ "type", "display_name", "description", "configuration_scope", "schema", "bindings", "operations" ] } } }, "required": [ "plugins" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "docs.read", "x-vllm-sr-sensitivity": "public", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" } }, "/api/v1/plugins/context_compression/capabilities": { "get": { "summary": "Get context-compression capabilities", "description": "Get context-compression capabilities", "operationId": "get_api_v1_plugins_context_compression_capabilities", "tags": [ "plugins" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "json_structure_preserved": { "type": "boolean" }, "multimodal_preserved": { "type": "boolean" }, "protocol_metadata_kept": { "type": "boolean" }, "recovery": { "type": "boolean" }, "scoring_methods": { "nullable": true, "type": "array", "items": { "type": "string" } }, "strategies": { "nullable": true, "type": "array", "items": { "type": "string" } }, "targets": { "nullable": true, "type": "array", "items": { "type": "string" } } }, "required": [ "strategies", "scoring_methods", "targets", "recovery", "json_structure_preserved", "multimodal_preserved", "protocol_metadata_kept" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "compression.read", "x-vllm-sr-sensitivity": "operational", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-plugin-operations": [ { "plugin": "context_compression", "mode": "read" } ], "x-vllm-sr-visibility": "advanced" } }, "/api/v1/plugins/context_compression/health": { "get": { "summary": "Check context-compression runtime health", "description": "Check context-compression runtime health", "operationId": "get_api_v1_plugins_context_compression_health", "tags": [ "plugins" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "recovery": { "type": "string" }, "status": { "type": "string" } }, "required": [ "status", "recovery" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "compression.read", "x-vllm-sr-sensitivity": "operational", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-plugin-operations": [ { "plugin": "context_compression", "mode": "read" } ], "x-vllm-sr-visibility": "advanced" } }, "/api/v1/plugins/context_compression/preview": { "post": { "summary": "Preview context compression without persistence", "description": "Preview context compression without persistence", "operationId": "post_api_v1_plugins_context_compression_preview", "tags": [ "plugins" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "applied": { "type": "boolean" }, "available_input_tokens": { "type": "integer" }, "blocks_compressed": { "type": "integer" }, "fallback_reason": { "type": "string" }, "messages_compressed": { "type": "integer" }, "omitted_chunks": { "type": "integer" }, "quality": { "type": "string" }, "recovery_keys": { "type": "integer" }, "reserved_output_tokens": { "type": "integer" }, "skip_reason": { "type": "string" }, "target_request_tokens": { "type": "integer" }, "targets": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "block_index": { "type": "integer" }, "kind": { "type": "string" }, "message_index": { "type": "integer" }, "mode": { "type": "string" }, "original_tokens": { "type": "integer" }, "score": { "type": "number" }, "target_tokens": { "type": "integer" } }, "required": [ "message_index", "block_index", "kind", "mode", "original_tokens", "target_tokens", "score" ] } }, "token_counter_source": { "type": "string" }, "tokens_after": { "type": "integer" }, "tokens_before": { "type": "integer" }, "tokens_saved": { "type": "integer" }, "trigger_reason": { "type": "string" }, "valid": { "type": "boolean" }, "warnings": { "nullable": true, "type": "array", "items": { "type": "string" } } }, "required": [ "valid", "applied", "tokens_before", "tokens_after", "tokens_saved", "target_request_tokens", "available_input_tokens", "reserved_output_tokens", "messages_compressed", "blocks_compressed", "omitted_chunks", "recovery_keys", "token_counter_source" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "502": { "description": "Bad Gateway", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "configuration": {}, "context_window": { "type": "integer" }, "max_output_tokens": { "type": "integer" }, "model": { "type": "string" }, "request_body": {}, "requested_output_tokens": { "type": "integer" }, "trusted_scope_present": { "type": "boolean" } }, "required": [ "configuration", "request_body" ] } } } }, "x-vllm-sr-permission": "compression.preview", "x-vllm-sr-sensitivity": "operational", "x-vllm-sr-audit-action": "compression.preview", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-plugin-operations": [ { "plugin": "context_compression", "mode": "preview" } ], "x-vllm-sr-visibility": "advanced" } }, "/api/v1/plugins/fast_response/preview": { "post": { "summary": "Preview fixed assistant text before transport encoding; no persistence or backend calls", "description": "Preview fixed assistant text before transport encoding; no persistence or backend calls", "operationId": "post_api_v1_plugins_fast_response_preview", "tags": [ "plugins" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Fixed assistant text", "content": { "application/json": { "schema": { "type": "object", "properties": { "backend_calls": { "type": "boolean" }, "message": { "type": "string" }, "mode": { "type": "string" }, "persisted": { "type": "boolean" } }, "required": [ "mode", "persisted", "backend_calls", "message" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "binding": { "nullable": true, "type": "object", "properties": { "decision": { "type": "string" }, "recipe": { "type": "string" } }, "required": [ "recipe", "decision" ], "additionalProperties": false }, "configuration": { "nullable": true, "type": "object", "properties": { "message": { "type": "string" } }, "required": [ "message" ], "additionalProperties": false } }, "additionalProperties": false } } } }, "x-vllm-sr-permission": "config.read", "x-vllm-sr-sensitivity": "secret_view", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-plugin-operations": [ { "plugin": "fast_response", "mode": "preview" } ], "x-vllm-sr-visibility": "primary" } }, "/api/v1/plugins/hallucination/preview": { "post": { "summary": "Preview an active binding's hallucination policy and supplied fact-check/context conditions; mode=probe explicitly invokes configured detectors without generation or persistence", "description": "Preview an active binding's hallucination policy and supplied fact-check/context conditions; mode=probe explicitly invokes configured detectors without generation or persistence", "operationId": "post_api_v1_plugins_hallucination_preview", "tags": [ "plugins" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Guard policy and optional grounded detector evidence", "content": { "application/json": { "schema": { "type": "object", "properties": { "action": { "type": "string" }, "backend_calls": { "type": "boolean" }, "binding": { "type": "object", "properties": { "decision": { "type": "string" }, "recipe": { "type": "string" } }, "required": [ "recipe", "decision" ] }, "detected": { "type": "boolean" }, "detection_source": { "type": "string" }, "eligible": { "type": "boolean" }, "enabled": { "type": "boolean" }, "label": { "type": "string" }, "matched_rules": { "nullable": true, "type": "array", "items": { "type": "string" } }, "mode": { "type": "string" }, "persisted": { "type": "boolean" }, "reason": { "type": "string" }, "resolved": { "type": "boolean" }, "score": { "nullable": true, "type": "number" }, "score_kind": { "type": "string" }, "unsupported_spans": { "nullable": true, "type": "array", "items": { "type": "string" } } }, "required": [ "mode", "persisted", "backend_calls", "binding", "enabled", "eligible", "resolved", "detected", "action", "detection_source" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "504": { "description": "Gateway Timeout", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "binding": { "type": "object", "properties": { "decision": { "type": "string" }, "recipe": { "type": "string" } }, "required": [ "recipe", "decision" ], "additionalProperties": false }, "context": { "type": "string" }, "fact_check_needed": { "type": "boolean" }, "mode": { "type": "string" }, "question": { "type": "string" }, "response": { "type": "string" } }, "required": [ "binding", "question", "context", "response", "fact_check_needed" ], "additionalProperties": false } } } }, "x-vllm-sr-permission": "classify.invoke", "x-vllm-sr-sensitivity": "operational", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-plugin-operations": [ { "plugin": "hallucination", "mode": "preview" }, { "plugin": "hallucination", "mode": "probe" } ], "x-vllm-sr-visibility": "primary" } }, "/api/v1/plugins/header_mutation/preview": { "post": { "summary": "Preview ordered Envoy header operations; values require secret_view; no persistence or backend calls", "description": "Preview ordered Envoy header operations; values require secret_view; no persistence or backend calls", "operationId": "post_api_v1_plugins_header_mutation_preview", "tags": [ "plugins" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Ordered header mutation plan", "content": { "application/json": { "schema": { "type": "object", "properties": { "backend_calls": { "type": "boolean" }, "mode": { "type": "string" }, "mutations": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "operation": { "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "operation" ] } }, "persisted": { "type": "boolean" }, "values_redacted": { "type": "boolean" } }, "required": [ "mode", "persisted", "backend_calls", "mutations", "values_redacted" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "binding": { "nullable": true, "type": "object", "properties": { "decision": { "type": "string" }, "recipe": { "type": "string" } }, "required": [ "recipe", "decision" ], "additionalProperties": false }, "configuration": { "nullable": true, "type": "object", "properties": { "add": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "additionalProperties": false } }, "delete": { "nullable": true, "type": "array", "items": { "type": "string" } }, "update": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "additionalProperties": false } } }, "additionalProperties": false } }, "additionalProperties": false } } } }, "x-vllm-sr-permission": "config.read", "x-vllm-sr-sensitivity": "secret_view", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-plugin-operations": [ { "plugin": "header_mutation", "mode": "preview" } ], "x-vllm-sr-visibility": "primary" } }, "/api/v1/plugins/rag/preview": { "post": { "summary": "Preview configured RAG context injection using supplied_context; mode=probe retrieves from the configured backend without the RAG result cache or generation", "description": "Preview configured RAG context injection using supplied_context; mode=probe retrieves from the configured backend without the RAG result cache or generation", "operationId": "post_api_v1_plugins_rag_preview", "tags": [ "plugins" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Recipe-bound RAG preview and explicit effects", "content": { "application/json": { "schema": { "type": "object", "properties": { "backend": { "type": "string" }, "backend_calls": { "type": "boolean" }, "binding": { "type": "object", "properties": { "decision": { "type": "string" }, "recipe": { "type": "string" } }, "required": [ "recipe", "decision" ] }, "context": { "type": "string" }, "enabled": { "type": "boolean" }, "mode": { "type": "string" }, "persisted": { "type": "boolean" }, "request_body": {}, "similarity_score": { "type": "number" }, "stage": { "type": "string" } }, "required": [ "mode", "persisted", "backend_calls", "binding", "enabled", "stage", "backend", "context", "similarity_score", "request_body" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "409": { "description": "Conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "504": { "description": "Gateway Timeout", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "binding": { "type": "object", "properties": { "decision": { "type": "string" }, "recipe": { "type": "string" } }, "required": [ "recipe", "decision" ], "additionalProperties": false }, "format": { "type": "string" }, "mode": { "type": "string" }, "request_body": {}, "supplied_context": { "type": "string" } }, "required": [ "binding", "request_body" ], "additionalProperties": false } } } }, "x-vllm-sr-permission": "data.read", "x-vllm-sr-sensitivity": "config", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-plugin-operations": [ { "plugin": "rag", "mode": "preview" }, { "plugin": "rag", "mode": "probe" } ], "x-vllm-sr-visibility": "primary" } }, "/api/v1/plugins/request_params/preview": { "post": { "summary": "Preview the dispatch parameter policy, including blocked fields, defaults, and caps; no persistence or backend calls", "description": "Preview the dispatch parameter policy, including blocked fields, defaults, and caps; no persistence or backend calls", "operationId": "post_api_v1_plugins_request_params_preview", "tags": [ "plugins" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Transformed request and policy effects", "content": { "application/json": { "schema": { "type": "object", "properties": { "backend_calls": { "type": "boolean" }, "changed": { "type": "boolean" }, "diagnostics": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "Action": { "type": "string" }, "Field": { "type": "string" }, "Reason": { "type": "string" }, "Source": { "type": "string" }, "Target": { "type": "string" } }, "required": [ "Source", "Target", "Field", "Action", "Reason" ] } }, "format": { "type": "string" }, "mode": { "type": "string" }, "parameters": { "nullable": true, "type": "object", "properties": { "blocked": { "nullable": true, "type": "array", "items": { "type": "string" } }, "capped_candidate_count": { "type": "boolean" }, "capped_output_tokens": { "type": "boolean" }, "changed": { "type": "boolean" }, "defaulted_output_tokens": { "type": "boolean" } }, "required": [ "changed", "defaulted_output_tokens", "capped_output_tokens", "capped_candidate_count" ] }, "persisted": { "type": "boolean" }, "request_body": {} }, "required": [ "mode", "persisted", "backend_calls", "changed", "format", "request_body" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "binding": { "nullable": true, "type": "object", "properties": { "decision": { "type": "string" }, "recipe": { "type": "string" } }, "required": [ "recipe", "decision" ], "additionalProperties": false }, "configuration": { "nullable": true, "type": "object", "properties": { "blocked_params": { "nullable": true, "type": "array", "items": { "type": "string" } }, "default_max_tokens": { "oneOf": [ { "minimum": 1, "type": "integer" }, { "type": "string", "enum": [ "auto" ] } ], "nullable": true }, "max_n": { "nullable": true, "type": "integer" }, "max_tokens_limit": { "nullable": true, "type": "integer" }, "strip_unknown": { "type": "boolean" } }, "additionalProperties": false }, "format": { "type": "string" }, "request_body": {} }, "required": [ "request_body" ], "additionalProperties": false } } } }, "x-vllm-sr-permission": "config.read", "x-vllm-sr-sensitivity": "secret_view", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-plugin-operations": [ { "plugin": "request_params", "mode": "preview" } ], "x-vllm-sr-visibility": "primary" } }, "/api/v1/plugins/response_jailbreak/preview": { "post": { "summary": "Preview an active binding's response-jailbreak policy; mode=probe explicitly invokes its configured classifier without generation or persistence", "description": "Preview an active binding's response-jailbreak policy; mode=probe explicitly invokes its configured classifier without generation or persistence", "operationId": "post_api_v1_plugins_response_jailbreak_preview", "tags": [ "plugins" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Guard policy and optional classifier evidence", "content": { "application/json": { "schema": { "type": "object", "properties": { "action": { "type": "string" }, "backend_calls": { "type": "boolean" }, "binding": { "type": "object", "properties": { "decision": { "type": "string" }, "recipe": { "type": "string" } }, "required": [ "recipe", "decision" ] }, "detected": { "type": "boolean" }, "detection_source": { "type": "string" }, "eligible": { "type": "boolean" }, "enabled": { "type": "boolean" }, "label": { "type": "string" }, "matched_rules": { "nullable": true, "type": "array", "items": { "type": "string" } }, "mode": { "type": "string" }, "persisted": { "type": "boolean" }, "reason": { "type": "string" }, "resolved": { "type": "boolean" }, "score": { "nullable": true, "type": "number" }, "score_kind": { "type": "string" }, "unsupported_spans": { "nullable": true, "type": "array", "items": { "type": "string" } } }, "required": [ "mode", "persisted", "backend_calls", "binding", "enabled", "eligible", "resolved", "detected", "action", "detection_source" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "504": { "description": "Gateway Timeout", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "binding": { "type": "object", "properties": { "decision": { "type": "string" }, "recipe": { "type": "string" } }, "required": [ "recipe", "decision" ], "additionalProperties": false }, "mode": { "type": "string" }, "response": { "type": "string" } }, "required": [ "binding", "response" ], "additionalProperties": false } } } }, "x-vllm-sr-permission": "classify.invoke", "x-vllm-sr-sensitivity": "operational", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-plugin-operations": [ { "plugin": "response_jailbreak", "mode": "preview" }, { "plugin": "response_jailbreak", "mode": "probe" } ], "x-vllm-sr-visibility": "primary" } }, "/api/v1/plugins/system_prompt/preview": { "post": { "summary": "Preview system instruction changes using the dispatch protocol codec; no persistence or backend calls", "description": "Preview system instruction changes using the dispatch protocol codec; no persistence or backend calls", "operationId": "post_api_v1_plugins_system_prompt_preview", "tags": [ "plugins" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Transformed request", "content": { "application/json": { "schema": { "type": "object", "properties": { "backend_calls": { "type": "boolean" }, "changed": { "type": "boolean" }, "diagnostics": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "Action": { "type": "string" }, "Field": { "type": "string" }, "Reason": { "type": "string" }, "Source": { "type": "string" }, "Target": { "type": "string" } }, "required": [ "Source", "Target", "Field", "Action", "Reason" ] } }, "format": { "type": "string" }, "mode": { "type": "string" }, "parameters": { "nullable": true, "type": "object", "properties": { "blocked": { "nullable": true, "type": "array", "items": { "type": "string" } }, "capped_candidate_count": { "type": "boolean" }, "capped_output_tokens": { "type": "boolean" }, "changed": { "type": "boolean" }, "defaulted_output_tokens": { "type": "boolean" } }, "required": [ "changed", "defaulted_output_tokens", "capped_output_tokens", "capped_candidate_count" ] }, "persisted": { "type": "boolean" }, "request_body": {} }, "required": [ "mode", "persisted", "backend_calls", "changed", "format", "request_body" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "binding": { "nullable": true, "type": "object", "properties": { "decision": { "type": "string" }, "recipe": { "type": "string" } }, "required": [ "recipe", "decision" ], "additionalProperties": false }, "configuration": { "nullable": true, "type": "object", "properties": { "enabled": { "nullable": true, "type": "boolean" }, "mode": { "type": "string" }, "system_prompt": { "type": "string" } }, "additionalProperties": false }, "format": { "type": "string" }, "request_body": {} }, "required": [ "request_body" ], "additionalProperties": false } } } }, "x-vllm-sr-permission": "config.read", "x-vllm-sr-sensitivity": "secret_view", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-plugin-operations": [ { "plugin": "system_prompt", "mode": "preview" } ], "x-vllm-sr-visibility": "primary" } }, "/api/v1/plugins/tool_selection/preview": { "post": { "summary": "Preview the configured tool_selection policy; mode=probe permits configured retrieval and embedding calls but never executes tools", "description": "Preview the configured tool_selection policy; mode=probe permits configured retrieval and embedding calls but never executes tools", "operationId": "post_api_v1_plugins_tool_selection_preview", "tags": [ "plugins" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Recipe-bound tool selection result and explicit effects", "content": { "application/json": { "schema": { "type": "object", "properties": { "backend_calls": { "type": "boolean" }, "binding": { "type": "object", "properties": { "decision": { "type": "string" }, "recipe": { "type": "string" } }, "required": [ "recipe", "decision" ] }, "enabled": { "type": "boolean" }, "mode": { "type": "string" }, "persisted": { "type": "boolean" }, "plugin": { "type": "string" }, "request_body": {}, "selected_tools": { "nullable": true, "type": "array", "items": { "type": "string" } } }, "required": [ "mode", "persisted", "backend_calls", "binding", "plugin", "enabled", "selected_tools", "request_body" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "409": { "description": "Conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "504": { "description": "Gateway Timeout", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "binding": { "type": "object", "properties": { "decision": { "type": "string" }, "recipe": { "type": "string" } }, "required": [ "recipe", "decision" ], "additionalProperties": false }, "format": { "type": "string" }, "mode": { "type": "string" }, "request_body": {} }, "required": [ "binding", "request_body" ], "additionalProperties": false } } } }, "x-vllm-sr-permission": "config.read", "x-vllm-sr-sensitivity": "config", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-plugin-operations": [ { "plugin": "tool_selection", "mode": "preview" }, { "plugin": "tool_selection", "mode": "probe" } ], "x-vllm-sr-visibility": "primary" } }, "/api/v1/plugins/tools/preview": { "post": { "summary": "Preview the configured tools policy; mode=probe permits semantic tool retrieval but never executes tools", "description": "Preview the configured tools policy; mode=probe permits semantic tool retrieval but never executes tools", "operationId": "post_api_v1_plugins_tools_preview", "tags": [ "plugins" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Recipe-bound tool policy result and explicit effects", "content": { "application/json": { "schema": { "type": "object", "properties": { "backend_calls": { "type": "boolean" }, "binding": { "type": "object", "properties": { "decision": { "type": "string" }, "recipe": { "type": "string" } }, "required": [ "recipe", "decision" ] }, "enabled": { "type": "boolean" }, "mode": { "type": "string" }, "persisted": { "type": "boolean" }, "plugin": { "type": "string" }, "request_body": {}, "selected_tools": { "nullable": true, "type": "array", "items": { "type": "string" } } }, "required": [ "mode", "persisted", "backend_calls", "binding", "plugin", "enabled", "selected_tools", "request_body" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "409": { "description": "Conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "504": { "description": "Gateway Timeout", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "binding": { "type": "object", "properties": { "decision": { "type": "string" }, "recipe": { "type": "string" } }, "required": [ "recipe", "decision" ], "additionalProperties": false }, "format": { "type": "string" }, "mode": { "type": "string" }, "request_body": {} }, "required": [ "binding", "request_body" ], "additionalProperties": false } } } }, "x-vllm-sr-permission": "config.read", "x-vllm-sr-sensitivity": "config", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-plugin-operations": [ { "plugin": "tools", "mode": "preview" }, { "plugin": "tools", "mode": "probe" } ], "x-vllm-sr-visibility": "primary" } }, "/api/v1/plugins/{type}": { "get": { "summary": "Describe one canonical plugin type and its supported management operations", "description": "Describe one canonical plugin type and its supported management operations", "operationId": "get_api_v1_plugins_type", "tags": [ "plugins" ], "parameters": [ { "name": "type", "in": "path", "description": "type path parameter", "required": true, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Plugin descriptor", "content": { "application/json": { "schema": { "type": "object", "properties": { "bindings": { "type": "string" }, "configuration_scope": { "type": "string" }, "description": { "type": "string" }, "display_name": { "type": "string" }, "operations": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "method": { "type": "string" }, "mode": { "type": "string" }, "path": { "type": "string" } }, "required": [ "method", "path", "mode" ] } }, "schema": { "type": "string" }, "type": { "type": "string" } }, "required": [ "type", "display_name", "description", "configuration_scope", "schema", "bindings", "operations" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "docs.read", "x-vllm-sr-sensitivity": "public", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" } }, "/api/v1/plugins/{type}/bindings": { "get": { "summary": "Inspect active recipe and decision plugin bindings and published dependency availability; does not probe network health", "description": "Inspect active recipe and decision plugin bindings and published dependency availability; does not probe network health", "operationId": "get_api_v1_plugins_type_bindings", "tags": [ "plugins" ], "parameters": [ { "name": "type", "in": "path", "description": "type path parameter", "required": true, "schema": { "type": "string" } }, { "name": "recipe", "in": "query", "description": "Filter by exact recipe name.", "schema": { "type": "string" } }, { "name": "decision", "in": "query", "description": "Filter by exact decision name.", "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Active plugin bindings", "content": { "application/json": { "schema": { "type": "object", "properties": { "bindings": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "configuration": { "type": "string" }, "decision": { "type": "string" }, "dependencies": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "availability": { "type": "string" }, "health": { "type": "string" }, "name": { "type": "string" } }, "required": [ "name", "availability", "health" ] } }, "enabled": { "type": "boolean" }, "reachable": { "type": "boolean" }, "recipe": { "type": "string" }, "runtime_inspected": { "type": "boolean" }, "status": { "type": "string" } }, "required": [ "recipe", "decision", "enabled", "runtime_inspected", "reachable", "configuration", "dependencies", "status" ] } }, "source": { "type": "string" }, "type": { "type": "string" } }, "required": [ "type", "source", "bindings" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "config.read", "x-vllm-sr-sensitivity": "config", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" } }, "/api/v1/routing/preview": { "post": { "summary": "Preview configured signals and model selection without generating an answer. Supported native-output requests use backend render APIs to resolve per-candidate capacity; paths requiring execution remain unresolved. Learning uses read-only captured state with selection_provenance; preview_context supplies session identity and an optional preview-only sampling seed. A state-dependent or sampled result does not guarantee a later live selection. global.services.api.routing_preview controls the request deadline and concurrent worker bound.", "description": "Preview configured signals and model selection without generating an answer. Supported native-output requests use backend render APIs to resolve per-candidate capacity; paths requiring execution remain unresolved. Learning uses read-only captured state with selection_provenance; preview_context supplies session identity and an optional preview-only sampling seed. A state-dependent or sampled result does not guarantee a later live selection. global.services.api.routing_preview controls the request deadline and concurrent worker bound.", "operationId": "post_api_v1_routing_preview", "tags": [ "routing" ], "parameters": [ { "name": "trace", "in": "query", "description": "Include per-decision routing trace trees.", "schema": { "type": "boolean" } }, { "name": "x-sr-bench-expected-config-hash", "in": "header", "description": "Optional lowercase SHA-256 of the active runtime document. Rejects a mismatched generation before evaluating signals.", "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "applied_unknown_policies": { "nullable": true, "type": "object", "additionalProperties": { "type": "string" } }, "config_hash": { "type": "string" }, "decision_error": { "type": "string" }, "decision_ranking": { "nullable": true, "type": "object", "properties": { "candidates": { "type": "integer" }, "comparable": { "type": "boolean" }, "decided_by": { "type": "string" }, "fallback_reason": { "type": "string" }, "reason": { "type": "string" }, "runner_up": { "type": "string" }, "score_kind": { "type": "string" }, "strategy": { "type": "string" }, "tier": { "type": "integer" }, "tiered": { "type": "boolean" }, "winner": { "type": "string" } }, "required": [ "strategy", "tiered", "tier", "comparable", "decided_by", "winner", "candidates" ] }, "decision_result": { "nullable": true, "type": "object", "properties": { "algorithm": { "type": "string" }, "decision_name": { "type": "string" }, "matched_signals": { "nullable": true, "type": "object", "properties": { "action": { "nullable": true, "type": "array", "items": { "type": "string" } }, "authz": { "nullable": true, "type": "array", "items": { "type": "string" } }, "classifier": { "nullable": true, "type": "array", "items": { "type": "string" } }, "complexity": { "nullable": true, "type": "array", "items": { "type": "string" } }, "context": { "nullable": true, "type": "array", "items": { "type": "string" } }, "conversation": { "nullable": true, "type": "array", "items": { "type": "string" } }, "decision": { "nullable": true, "type": "array", "items": { "type": "string" } }, "domains": { "nullable": true, "type": "array", "items": { "type": "string" } }, "embeddings": { "nullable": true, "type": "array", "items": { "type": "string" } }, "event": { "nullable": true, "type": "array", "items": { "type": "string" } }, "fact_check": { "nullable": true, "type": "array", "items": { "type": "string" } }, "input_modality": { "nullable": true, "type": "array", "items": { "type": "string" } }, "jailbreak": { "nullable": true, "type": "array", "items": { "type": "string" } }, "kb": { "nullable": true, "type": "array", "items": { "type": "string" } }, "keywords": { "nullable": true, "type": "array", "items": { "type": "string" } }, "language": { "nullable": true, "type": "array", "items": { "type": "string" } }, "metadata": { "nullable": true, "type": "array", "items": { "type": "string" } }, "modality": { "nullable": true, "type": "array", "items": { "type": "string" } }, "pii": { "nullable": true, "type": "array", "items": { "type": "string" } }, "preferences": { "nullable": true, "type": "array", "items": { "type": "string" } }, "projection": { "nullable": true, "type": "array", "items": { "type": "string" } }, "reask": { "nullable": true, "type": "array", "items": { "type": "string" } }, "safety": { "nullable": true, "type": "array", "items": { "type": "string" } }, "structure": { "nullable": true, "type": "array", "items": { "type": "string" } }, "user_feedback": { "nullable": true, "type": "array", "items": { "type": "string" } } } }, "plugins": { "nullable": true, "type": "array", "items": { "type": "string" } }, "unmatched_signals": { "nullable": true, "type": "object", "properties": { "action": { "nullable": true, "type": "array", "items": { "type": "string" } }, "authz": { "nullable": true, "type": "array", "items": { "type": "string" } }, "classifier": { "nullable": true, "type": "array", "items": { "type": "string" } }, "complexity": { "nullable": true, "type": "array", "items": { "type": "string" } }, "context": { "nullable": true, "type": "array", "items": { "type": "string" } }, "conversation": { "nullable": true, "type": "array", "items": { "type": "string" } }, "decision": { "nullable": true, "type": "array", "items": { "type": "string" } }, "domains": { "nullable": true, "type": "array", "items": { "type": "string" } }, "embeddings": { "nullable": true, "type": "array", "items": { "type": "string" } }, "event": { "nullable": true, "type": "array", "items": { "type": "string" } }, "fact_check": { "nullable": true, "type": "array", "items": { "type": "string" } }, "input_modality": { "nullable": true, "type": "array", "items": { "type": "string" } }, "jailbreak": { "nullable": true, "type": "array", "items": { "type": "string" } }, "kb": { "nullable": true, "type": "array", "items": { "type": "string" } }, "keywords": { "nullable": true, "type": "array", "items": { "type": "string" } }, "language": { "nullable": true, "type": "array", "items": { "type": "string" } }, "metadata": { "nullable": true, "type": "array", "items": { "type": "string" } }, "modality": { "nullable": true, "type": "array", "items": { "type": "string" } }, "pii": { "nullable": true, "type": "array", "items": { "type": "string" } }, "preferences": { "nullable": true, "type": "array", "items": { "type": "string" } }, "projection": { "nullable": true, "type": "array", "items": { "type": "string" } }, "reask": { "nullable": true, "type": "array", "items": { "type": "string" } }, "safety": { "nullable": true, "type": "array", "items": { "type": "string" } }, "structure": { "nullable": true, "type": "array", "items": { "type": "string" } }, "user_feedback": { "nullable": true, "type": "array", "items": { "type": "string" } } } }, "used_signals": { "nullable": true, "type": "object", "properties": { "action": { "nullable": true, "type": "array", "items": { "type": "string" } }, "authz": { "nullable": true, "type": "array", "items": { "type": "string" } }, "classifier": { "nullable": true, "type": "array", "items": { "type": "string" } }, "complexity": { "nullable": true, "type": "array", "items": { "type": "string" } }, "context": { "nullable": true, "type": "array", "items": { "type": "string" } }, "conversation": { "nullable": true, "type": "array", "items": { "type": "string" } }, "decision": { "nullable": true, "type": "array", "items": { "type": "string" } }, "domains": { "nullable": true, "type": "array", "items": { "type": "string" } }, "embeddings": { "nullable": true, "type": "array", "items": { "type": "string" } }, "event": { "nullable": true, "type": "array", "items": { "type": "string" } }, "fact_check": { "nullable": true, "type": "array", "items": { "type": "string" } }, "input_modality": { "nullable": true, "type": "array", "items": { "type": "string" } }, "jailbreak": { "nullable": true, "type": "array", "items": { "type": "string" } }, "kb": { "nullable": true, "type": "array", "items": { "type": "string" } }, "keywords": { "nullable": true, "type": "array", "items": { "type": "string" } }, "language": { "nullable": true, "type": "array", "items": { "type": "string" } }, "metadata": { "nullable": true, "type": "array", "items": { "type": "string" } }, "modality": { "nullable": true, "type": "array", "items": { "type": "string" } }, "pii": { "nullable": true, "type": "array", "items": { "type": "string" } }, "preferences": { "nullable": true, "type": "array", "items": { "type": "string" } }, "projection": { "nullable": true, "type": "array", "items": { "type": "string" } }, "reask": { "nullable": true, "type": "array", "items": { "type": "string" } }, "safety": { "nullable": true, "type": "array", "items": { "type": "string" } }, "structure": { "nullable": true, "type": "array", "items": { "type": "string" } }, "user_feedback": { "nullable": true, "type": "array", "items": { "type": "string" } } } } }, "required": [ "decision_name", "algorithm", "used_signals", "matched_signals", "unmatched_signals" ] }, "eval_trace": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "confidence": { "type": "number" }, "decision_name": { "type": "string" }, "matched": { "type": "boolean" }, "on_unknown": { "type": "string" }, "root_trace": { "nullable": true, "type": "object", "properties": { "children": { "nullable": true, "type": "array", "items": { "nullable": true, "type": "object" } }, "confidence": { "type": "number" }, "confidence_scored": { "type": "boolean" }, "label": { "type": "string" }, "matched": { "type": "boolean" }, "node_type": { "type": "string" }, "signal_error": { "type": "string" }, "signal_name": { "type": "string" }, "signal_type": { "type": "string" }, "state": { "type": "string" } }, "required": [ "node_type", "state", "matched", "confidence" ] }, "state": { "type": "string" } }, "required": [ "decision_name", "state", "matched", "confidence", "root_trace" ] } }, "metrics": { "nullable": true, "type": "object", "properties": { "action": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "authz": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "classifier": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "complexity": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "context": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "conversation": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "decision": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "domain": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "embedding": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "event": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "fact_check": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "input_modality": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "jailbreak": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "kb": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "keyword": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "language": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "metadata": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "modality": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "pii": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "preference": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "reask": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "safety": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "structure": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "user_feedback": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] } }, "required": [ "keyword", "embedding", "domain", "fact_check", "user_feedback", "reask", "preference", "language", "context", "structure", "complexity", "modality", "authz", "jailbreak", "safety", "pii", "kb", "conversation", "event", "metadata", "classifier", "input_modality", "action", "decision" ] }, "original_text": { "type": "string" }, "recipe": { "type": "string" }, "recommended_models": { "nullable": true, "type": "array", "items": { "type": "string" } }, "requested_model": { "type": "string" }, "routing_decision": { "type": "string" }, "selected_model": { "type": "string" }, "selection_method": { "type": "string" }, "selection_provenance": { "nullable": true, "type": "object", "properties": { "captured_at": { "type": "string" }, "caveat": { "type": "string" }, "config_hash": { "type": "string" }, "mode": { "type": "string" }, "sampled": { "type": "boolean" }, "sampling_seed": { "nullable": true, "type": "integer" }, "state_dependent": { "type": "boolean" }, "state_hash": { "type": "string" } }, "required": [ "mode", "config_hash", "state_dependent", "sampled" ] }, "selection_reason": { "type": "string" }, "selection_status": { "type": "string" }, "selection_trace": { "nullable": true, "type": "object", "properties": { "final_survivors": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "LoRAName": { "type": "string" }, "Model": { "type": "string" }, "ReasoningDescription": { "type": "string" }, "ReasoningEffort": { "type": "string" }, "ReasoningMode": { "type": "string" }, "UseReasoning": { "nullable": true, "type": "boolean" }, "Weight": { "type": "number" } }, "required": [ "Model", "LoRAName", "Weight", "UseReasoning", "ReasoningDescription", "ReasoningMode", "ReasoningEffort" ] } }, "stages": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "action": { "type": "string" }, "available": { "type": "integer" }, "candidates": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "candidate": { "type": "object", "properties": { "LoRAName": { "type": "string" }, "Model": { "type": "string" }, "ReasoningDescription": { "type": "string" }, "ReasoningEffort": { "type": "string" }, "ReasoningMode": { "type": "string" }, "UseReasoning": { "nullable": true, "type": "boolean" }, "Weight": { "type": "number" } }, "required": [ "Model", "LoRAName", "Weight", "UseReasoning", "ReasoningDescription", "ReasoningMode", "ReasoningEffort" ] }, "elimination_reason": { "type": "string" }, "metric": { "type": "string" }, "value": { "nullable": true, "type": "number" } }, "required": [ "candidate" ] } }, "factor": { "type": "string" }, "metric": { "type": "string" }, "percentile": { "type": "integer" }, "reason": { "type": "string" }, "tolerance": { "type": "number" }, "total": { "type": "integer" } }, "required": [ "factor", "action", "reason", "tolerance", "available", "total", "candidates" ] } } }, "required": [ "stages", "final_survivors" ] }, "signal_confidences": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "signal_error_matches": { "nullable": true, "type": "object", "additionalProperties": { "type": "boolean" } }, "signal_errors": { "nullable": true, "type": "object", "additionalProperties": { "type": "string" } }, "signal_values": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } } }, "required": [ "original_text", "metrics" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } }, "x-vsr-config-hash": { "description": "SHA-256 of the actual runtime generation used by this Preview.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "412": { "description": "Precondition Failed", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "429": { "description": "Too Many Requests", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Decision unresolved, inference canceled, or server shutting down", "content": { "application/json": { "schema": { "oneOf": [ { "type": "object", "properties": { "applied_unknown_policies": { "nullable": true, "type": "object", "additionalProperties": { "type": "string" } }, "config_hash": { "type": "string" }, "decision_error": { "type": "string" }, "decision_ranking": { "nullable": true, "type": "object", "properties": { "candidates": { "type": "integer" }, "comparable": { "type": "boolean" }, "decided_by": { "type": "string" }, "fallback_reason": { "type": "string" }, "reason": { "type": "string" }, "runner_up": { "type": "string" }, "score_kind": { "type": "string" }, "strategy": { "type": "string" }, "tier": { "type": "integer" }, "tiered": { "type": "boolean" }, "winner": { "type": "string" } }, "required": [ "strategy", "tiered", "tier", "comparable", "decided_by", "winner", "candidates" ] }, "decision_result": { "nullable": true, "type": "object", "properties": { "algorithm": { "type": "string" }, "decision_name": { "type": "string" }, "matched_signals": { "nullable": true, "type": "object", "properties": { "action": { "nullable": true, "type": "array", "items": { "type": "string" } }, "authz": { "nullable": true, "type": "array", "items": { "type": "string" } }, "classifier": { "nullable": true, "type": "array", "items": { "type": "string" } }, "complexity": { "nullable": true, "type": "array", "items": { "type": "string" } }, "context": { "nullable": true, "type": "array", "items": { "type": "string" } }, "conversation": { "nullable": true, "type": "array", "items": { "type": "string" } }, "decision": { "nullable": true, "type": "array", "items": { "type": "string" } }, "domains": { "nullable": true, "type": "array", "items": { "type": "string" } }, "embeddings": { "nullable": true, "type": "array", "items": { "type": "string" } }, "event": { "nullable": true, "type": "array", "items": { "type": "string" } }, "fact_check": { "nullable": true, "type": "array", "items": { "type": "string" } }, "input_modality": { "nullable": true, "type": "array", "items": { "type": "string" } }, "jailbreak": { "nullable": true, "type": "array", "items": { "type": "string" } }, "kb": { "nullable": true, "type": "array", "items": { "type": "string" } }, "keywords": { "nullable": true, "type": "array", "items": { "type": "string" } }, "language": { "nullable": true, "type": "array", "items": { "type": "string" } }, "metadata": { "nullable": true, "type": "array", "items": { "type": "string" } }, "modality": { "nullable": true, "type": "array", "items": { "type": "string" } }, "pii": { "nullable": true, "type": "array", "items": { "type": "string" } }, "preferences": { "nullable": true, "type": "array", "items": { "type": "string" } }, "projection": { "nullable": true, "type": "array", "items": { "type": "string" } }, "reask": { "nullable": true, "type": "array", "items": { "type": "string" } }, "safety": { "nullable": true, "type": "array", "items": { "type": "string" } }, "structure": { "nullable": true, "type": "array", "items": { "type": "string" } }, "user_feedback": { "nullable": true, "type": "array", "items": { "type": "string" } } } }, "plugins": { "nullable": true, "type": "array", "items": { "type": "string" } }, "unmatched_signals": { "nullable": true, "type": "object", "properties": { "action": { "nullable": true, "type": "array", "items": { "type": "string" } }, "authz": { "nullable": true, "type": "array", "items": { "type": "string" } }, "classifier": { "nullable": true, "type": "array", "items": { "type": "string" } }, "complexity": { "nullable": true, "type": "array", "items": { "type": "string" } }, "context": { "nullable": true, "type": "array", "items": { "type": "string" } }, "conversation": { "nullable": true, "type": "array", "items": { "type": "string" } }, "decision": { "nullable": true, "type": "array", "items": { "type": "string" } }, "domains": { "nullable": true, "type": "array", "items": { "type": "string" } }, "embeddings": { "nullable": true, "type": "array", "items": { "type": "string" } }, "event": { "nullable": true, "type": "array", "items": { "type": "string" } }, "fact_check": { "nullable": true, "type": "array", "items": { "type": "string" } }, "input_modality": { "nullable": true, "type": "array", "items": { "type": "string" } }, "jailbreak": { "nullable": true, "type": "array", "items": { "type": "string" } }, "kb": { "nullable": true, "type": "array", "items": { "type": "string" } }, "keywords": { "nullable": true, "type": "array", "items": { "type": "string" } }, "language": { "nullable": true, "type": "array", "items": { "type": "string" } }, "metadata": { "nullable": true, "type": "array", "items": { "type": "string" } }, "modality": { "nullable": true, "type": "array", "items": { "type": "string" } }, "pii": { "nullable": true, "type": "array", "items": { "type": "string" } }, "preferences": { "nullable": true, "type": "array", "items": { "type": "string" } }, "projection": { "nullable": true, "type": "array", "items": { "type": "string" } }, "reask": { "nullable": true, "type": "array", "items": { "type": "string" } }, "safety": { "nullable": true, "type": "array", "items": { "type": "string" } }, "structure": { "nullable": true, "type": "array", "items": { "type": "string" } }, "user_feedback": { "nullable": true, "type": "array", "items": { "type": "string" } } } }, "used_signals": { "nullable": true, "type": "object", "properties": { "action": { "nullable": true, "type": "array", "items": { "type": "string" } }, "authz": { "nullable": true, "type": "array", "items": { "type": "string" } }, "classifier": { "nullable": true, "type": "array", "items": { "type": "string" } }, "complexity": { "nullable": true, "type": "array", "items": { "type": "string" } }, "context": { "nullable": true, "type": "array", "items": { "type": "string" } }, "conversation": { "nullable": true, "type": "array", "items": { "type": "string" } }, "decision": { "nullable": true, "type": "array", "items": { "type": "string" } }, "domains": { "nullable": true, "type": "array", "items": { "type": "string" } }, "embeddings": { "nullable": true, "type": "array", "items": { "type": "string" } }, "event": { "nullable": true, "type": "array", "items": { "type": "string" } }, "fact_check": { "nullable": true, "type": "array", "items": { "type": "string" } }, "input_modality": { "nullable": true, "type": "array", "items": { "type": "string" } }, "jailbreak": { "nullable": true, "type": "array", "items": { "type": "string" } }, "kb": { "nullable": true, "type": "array", "items": { "type": "string" } }, "keywords": { "nullable": true, "type": "array", "items": { "type": "string" } }, "language": { "nullable": true, "type": "array", "items": { "type": "string" } }, "metadata": { "nullable": true, "type": "array", "items": { "type": "string" } }, "modality": { "nullable": true, "type": "array", "items": { "type": "string" } }, "pii": { "nullable": true, "type": "array", "items": { "type": "string" } }, "preferences": { "nullable": true, "type": "array", "items": { "type": "string" } }, "projection": { "nullable": true, "type": "array", "items": { "type": "string" } }, "reask": { "nullable": true, "type": "array", "items": { "type": "string" } }, "safety": { "nullable": true, "type": "array", "items": { "type": "string" } }, "structure": { "nullable": true, "type": "array", "items": { "type": "string" } }, "user_feedback": { "nullable": true, "type": "array", "items": { "type": "string" } } } } }, "required": [ "decision_name", "algorithm", "used_signals", "matched_signals", "unmatched_signals" ] }, "eval_trace": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "confidence": { "type": "number" }, "decision_name": { "type": "string" }, "matched": { "type": "boolean" }, "on_unknown": { "type": "string" }, "root_trace": { "nullable": true, "type": "object", "properties": { "children": { "nullable": true, "type": "array", "items": { "nullable": true, "type": "object" } }, "confidence": { "type": "number" }, "confidence_scored": { "type": "boolean" }, "label": { "type": "string" }, "matched": { "type": "boolean" }, "node_type": { "type": "string" }, "signal_error": { "type": "string" }, "signal_name": { "type": "string" }, "signal_type": { "type": "string" }, "state": { "type": "string" } }, "required": [ "node_type", "state", "matched", "confidence" ] }, "state": { "type": "string" } }, "required": [ "decision_name", "state", "matched", "confidence", "root_trace" ] } }, "metrics": { "nullable": true, "type": "object", "properties": { "action": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "authz": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "classifier": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "complexity": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "context": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "conversation": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "decision": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "domain": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "embedding": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "event": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "fact_check": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "input_modality": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "jailbreak": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "kb": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "keyword": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "language": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "metadata": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "modality": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "pii": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "preference": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "reask": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "safety": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "structure": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] }, "user_feedback": { "type": "object", "properties": { "confidence": { "nullable": true, "type": "number" }, "confidence_available": { "nullable": true, "type": "boolean" }, "execution_time_ms": { "type": "number" }, "method": { "type": "string" }, "policy_default": { "type": "string" }, "rules": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "object", "properties": { "content_token_windows": { "nullable": true, "type": "array", "items": { "type": "array", "items": { "type": "integer" } } }, "device": { "type": "string" }, "execution_time_ms": { "type": "number" }, "input_tokens": { "type": "integer" }, "policy_sha256": { "type": "string" }, "precision": { "type": "string" }, "processed_tokens": { "type": "integer" }, "provider": { "type": "string" }, "thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "truncated": { "type": "boolean" }, "window_batch_size": { "type": "integer" } }, "required": [ "policy_sha256", "provider", "device", "precision", "input_tokens", "processed_tokens", "truncated", "content_token_windows", "thresholds", "window_batch_size", "execution_time_ms" ] } } }, "required": [ "execution_time_ms", "confidence" ] } }, "required": [ "keyword", "embedding", "domain", "fact_check", "user_feedback", "reask", "preference", "language", "context", "structure", "complexity", "modality", "authz", "jailbreak", "safety", "pii", "kb", "conversation", "event", "metadata", "classifier", "input_modality", "action", "decision" ] }, "original_text": { "type": "string" }, "recipe": { "type": "string" }, "recommended_models": { "nullable": true, "type": "array", "items": { "type": "string" } }, "requested_model": { "type": "string" }, "routing_decision": { "type": "string" }, "selected_model": { "type": "string" }, "selection_method": { "type": "string" }, "selection_provenance": { "nullable": true, "type": "object", "properties": { "captured_at": { "type": "string" }, "caveat": { "type": "string" }, "config_hash": { "type": "string" }, "mode": { "type": "string" }, "sampled": { "type": "boolean" }, "sampling_seed": { "nullable": true, "type": "integer" }, "state_dependent": { "type": "boolean" }, "state_hash": { "type": "string" } }, "required": [ "mode", "config_hash", "state_dependent", "sampled" ] }, "selection_reason": { "type": "string" }, "selection_status": { "type": "string" }, "selection_trace": { "nullable": true, "type": "object", "properties": { "final_survivors": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "LoRAName": { "type": "string" }, "Model": { "type": "string" }, "ReasoningDescription": { "type": "string" }, "ReasoningEffort": { "type": "string" }, "ReasoningMode": { "type": "string" }, "UseReasoning": { "nullable": true, "type": "boolean" }, "Weight": { "type": "number" } }, "required": [ "Model", "LoRAName", "Weight", "UseReasoning", "ReasoningDescription", "ReasoningMode", "ReasoningEffort" ] } }, "stages": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "action": { "type": "string" }, "available": { "type": "integer" }, "candidates": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "candidate": { "type": "object", "properties": { "LoRAName": { "type": "string" }, "Model": { "type": "string" }, "ReasoningDescription": { "type": "string" }, "ReasoningEffort": { "type": "string" }, "ReasoningMode": { "type": "string" }, "UseReasoning": { "nullable": true, "type": "boolean" }, "Weight": { "type": "number" } }, "required": [ "Model", "LoRAName", "Weight", "UseReasoning", "ReasoningDescription", "ReasoningMode", "ReasoningEffort" ] }, "elimination_reason": { "type": "string" }, "metric": { "type": "string" }, "value": { "nullable": true, "type": "number" } }, "required": [ "candidate" ] } }, "factor": { "type": "string" }, "metric": { "type": "string" }, "percentile": { "type": "integer" }, "reason": { "type": "string" }, "tolerance": { "type": "number" }, "total": { "type": "integer" } }, "required": [ "factor", "action", "reason", "tolerance", "available", "total", "candidates" ] } } }, "required": [ "stages", "final_survivors" ] }, "signal_confidences": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "signal_error_matches": { "nullable": true, "type": "object", "additionalProperties": { "type": "boolean" } }, "signal_errors": { "nullable": true, "type": "object", "additionalProperties": { "type": "string" } }, "signal_values": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } } }, "required": [ "original_text", "metrics" ] }, { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "504": { "description": "Gateway Timeout", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "function_call": {}, "functions": { "nullable": true, "type": "array", "items": {} }, "max_completion_tokens": {}, "max_tokens": {}, "messages": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "content": {}, "function_call": {}, "name": { "type": "string" }, "reasoning_content": {}, "refusal": {}, "role": { "type": "string" }, "tool_call_id": { "type": "string" }, "tool_calls": { "nullable": true, "type": "array", "items": {} } }, "required": [ "role", "content" ], "additionalProperties": false } }, "metadata": { "nullable": true, "type": "object", "additionalProperties": { "type": "string" } }, "model": { "type": "string" }, "options": { "nullable": true, "type": "object", "properties": { "confidence_threshold": { "type": "number" }, "include_explanation": { "type": "boolean" }, "return_probabilities": { "type": "boolean" }, "trace": { "type": "boolean" } }, "additionalProperties": false }, "preview_context": { "nullable": true, "type": "object", "properties": { "conversation_id": { "type": "string" }, "sampling_seed": { "nullable": true, "type": "integer" }, "session_id": { "type": "string" } }, "additionalProperties": false }, "response_format": {}, "text": { "type": "string" }, "tool_choice": {}, "tools": { "nullable": true, "type": "array", "items": {} } }, "additionalProperties": false } } } }, "x-vllm-sr-permission": "classify.invoke", "x-vllm-sr-sensitivity": "operational", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" } }, "/api/v1/status": { "get": { "summary": "Versioned replica-local startup and configuration status; not a deployment probe", "description": "Versioned replica-local startup and configuration status; not a deployment probe", "operationId": "get_api_v1_status", "tags": [ "system" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Replica-local observations; unknown readiness is not ready", "content": { "application/json": { "schema": { "type": "object", "properties": { "conditions": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "reason": { "type": "string" }, "status": { "type": "string" }, "type": { "type": "string" } }, "required": [ "type", "status", "reason" ] } }, "config": { "type": "object", "properties": { "activation_stage": { "type": "string" }, "activation_status": { "type": "string" }, "active_hash": { "type": "string" }, "active_version": { "type": "integer" }, "observed_attempt": { "type": "integer" }, "observed_hash": { "type": "string" } }, "required": [ "observed_attempt" ] }, "instance_id": { "type": "string" }, "observed_at": { "type": "string", "format": "date-time" }, "schema_version": { "type": "string" }, "scope": { "type": "string" }, "startup": { "nullable": true, "type": "object", "properties": { "observed_at": { "type": "string", "format": "date-time" }, "phase": { "type": "string" }, "ready": { "type": "boolean" } }, "required": [ "phase", "ready", "observed_at" ] } }, "required": [ "schema_version", "scope", "instance_id", "observed_at", "config", "conditions" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "ready.read", "x-vllm-sr-sensitivity": "operational", "x-vllm-sr-plane": "infrastructure", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" } }, "/api/v1/storage/context-recovery/invalidate": { "post": { "summary": "Invalidate a trusted context-recovery request scope", "description": "Invalidate a trusted context-recovery request scope", "operationId": "post_api_v1_storage_context_recovery_invalidate", "tags": [ "storage" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "deleted": { "type": "integer" } }, "required": [ "deleted" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "502": { "description": "Bad Gateway", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "decision": { "type": "string" }, "recipe": { "type": "string" }, "request_id": { "type": "string" }, "user_id": { "type": "string" } }, "required": [ "recipe", "decision", "user_id", "request_id" ] } } } }, "x-vllm-sr-permission": "compression.manage", "x-vllm-sr-sensitivity": "mutation", "x-vllm-sr-audit-action": "compression.recovery.invalidate", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-plugin-operations": [ { "plugin": "context_compression", "mode": "mutation" } ], "x-vllm-sr-visibility": "advanced" } }, "/api/v1/storage/files": { "get": { "summary": "List uploaded files", "description": "List uploaded files", "operationId": "get_api_v1_storage_files", "tags": [ "storage" ], "parameters": [ { "name": "purpose", "in": "query", "description": "Filter files by purpose.", "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "nullable": true, "type": "array", "items": { "nullable": true, "type": "object", "properties": { "bytes": { "type": "integer" }, "created_at": { "type": "integer" }, "filename": { "type": "string" }, "id": { "type": "string" }, "object": { "type": "string" }, "purpose": { "type": "string" }, "status": { "type": "string" } }, "required": [ "id", "object", "bytes", "created_at", "filename", "purpose", "status" ] } }, "object": { "type": "string" } }, "required": [ "object", "data" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "data.read", "x-vllm-sr-sensitivity": "config", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" }, "post": { "summary": "Upload a file", "description": "Upload a file", "operationId": "post_api_v1_storage_files", "tags": [ "storage" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "bytes": { "type": "integer" }, "created_at": { "type": "integer" }, "filename": { "type": "string" }, "id": { "type": "string" }, "object": { "type": "string" }, "purpose": { "type": "string" }, "status": { "type": "string" } }, "required": [ "id", "object", "bytes", "created_at", "filename", "purpose", "status" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "Multipart upload with a file field and optional purpose field. Documents (.txt, .md, .json, .csv, .html) by default; images (.png, .jpg, .jpeg, .gif, .webp) with purpose=vision. Limit: 52428800 bytes.", "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "properties": { "file": { "type": "string", "format": "binary" }, "purpose": { "type": "string" } } } } } }, "x-vllm-sr-permission": "data.write", "x-vllm-sr-sensitivity": "mutation", "x-vllm-sr-audit-action": "data.write", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" } }, "/api/v1/storage/files/{id}": { "get": { "summary": "Read uploaded-file metadata", "description": "Read uploaded-file metadata", "operationId": "get_api_v1_storage_files_id", "tags": [ "storage" ], "parameters": [ { "name": "id", "in": "path", "description": "id path parameter", "required": true, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "bytes": { "type": "integer" }, "created_at": { "type": "integer" }, "filename": { "type": "string" }, "id": { "type": "string" }, "object": { "type": "string" }, "purpose": { "type": "string" }, "status": { "type": "string" } }, "required": [ "id", "object", "bytes", "created_at", "filename", "purpose", "status" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "data.read", "x-vllm-sr-sensitivity": "config", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" }, "delete": { "summary": "Delete an uploaded file", "description": "Delete an uploaded file", "operationId": "delete_api_v1_storage_files_id", "tags": [ "storage" ], "parameters": [ { "name": "id", "in": "path", "description": "id path parameter", "required": true, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "deleted": { "type": "boolean" }, "id": { "type": "string" }, "object": { "type": "string" } }, "required": [ "id", "object", "deleted" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "data.write", "x-vllm-sr-sensitivity": "mutation", "x-vllm-sr-audit-action": "data.write", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" } }, "/api/v1/storage/files/{id}/content": { "get": { "summary": "Download uploaded-file content", "description": "Download uploaded-file content", "operationId": "get_api_v1_storage_files_id_content", "tags": [ "storage" ], "parameters": [ { "name": "id", "in": "path", "description": "id path parameter", "required": true, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Uploaded file bytes", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } }, "headers": { "Content-Disposition": { "description": "Download filename", "schema": { "type": "string" } }, "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "data.read", "x-vllm-sr-sensitivity": "config", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" } }, "/api/v1/storage/knowledge-bases": { "get": { "summary": "List configured knowledge bases", "description": "List configured knowledge bases", "operationId": "get_api_v1_storage_knowledge_bases", "tags": [ "storage" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "activation": { "nullable": true, "type": "object", "properties": { "attempt": { "type": "integer" }, "document_hash": { "type": "string" }, "error": { "type": "string" }, "finished_at": { "nullable": true, "type": "string", "format": "date-time" }, "reasons": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "path": { "type": "string" }, "stage": { "type": "string" } }, "required": [ "stage", "code", "message" ] } }, "source": { "type": "string" }, "stage": { "type": "string" }, "started_at": { "type": "string", "format": "date-time" }, "status": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "attempt", "document_hash", "source", "status", "stage", "started_at" ] }, "activation_status": { "type": "string" }, "bind_options": { "type": "object", "properties": { "groups": { "nullable": true, "type": "array", "items": { "type": "string" } }, "labels": { "nullable": true, "type": "array", "items": { "type": "string" } }, "metrics": { "nullable": true, "type": "array", "items": { "type": "string" } } }, "required": [ "labels", "groups", "metrics" ] }, "builtin": { "type": "boolean" }, "description": { "type": "string" }, "editable": { "type": "boolean" }, "generated_runtime_hash": { "type": "string" }, "groups": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "array", "items": { "type": "string" } } }, "label_thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "labels": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "description": { "type": "string" }, "exemplars": { "nullable": true, "type": "array", "items": { "type": "string" } }, "name": { "type": "string" } }, "required": [ "name", "exemplars" ] } }, "load_error": { "type": "string" }, "managed": { "type": "boolean" }, "metrics": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "negative_group": { "type": "string" }, "positive_group": { "type": "string" }, "type": { "type": "string" } }, "required": [ "name", "type" ] } }, "name": { "type": "string" }, "signal_references": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "match": { "type": "string" }, "name": { "type": "string" }, "target": { "type": "object", "properties": { "kind": { "type": "string" }, "value": { "type": "string" } }, "required": [ "kind", "value" ] } }, "required": [ "name", "target" ] } }, "source": { "type": "object", "properties": { "manifest": { "type": "string" }, "path": { "type": "string" } }, "required": [ "path" ] }, "threshold": { "type": "number" }, "type": { "type": "string" } }, "required": [ "name", "type", "builtin", "managed", "editable", "threshold", "source", "bind_options" ] } } }, "required": [ "items" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "config.read", "x-vllm-sr-sensitivity": "config", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" }, "post": { "summary": "Create a managed knowledge base", "description": "Create a managed knowledge base", "operationId": "post_api_v1_storage_knowledge_bases", "tags": [ "storage" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "activation": { "nullable": true, "type": "object", "properties": { "attempt": { "type": "integer" }, "document_hash": { "type": "string" }, "error": { "type": "string" }, "finished_at": { "nullable": true, "type": "string", "format": "date-time" }, "reasons": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "path": { "type": "string" }, "stage": { "type": "string" } }, "required": [ "stage", "code", "message" ] } }, "source": { "type": "string" }, "stage": { "type": "string" }, "started_at": { "type": "string", "format": "date-time" }, "status": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "attempt", "document_hash", "source", "status", "stage", "started_at" ] }, "activation_status": { "type": "string" }, "bind_options": { "type": "object", "properties": { "groups": { "nullable": true, "type": "array", "items": { "type": "string" } }, "labels": { "nullable": true, "type": "array", "items": { "type": "string" } }, "metrics": { "nullable": true, "type": "array", "items": { "type": "string" } } }, "required": [ "labels", "groups", "metrics" ] }, "builtin": { "type": "boolean" }, "description": { "type": "string" }, "editable": { "type": "boolean" }, "generated_runtime_hash": { "type": "string" }, "groups": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "array", "items": { "type": "string" } } }, "label_thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "labels": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "description": { "type": "string" }, "exemplars": { "nullable": true, "type": "array", "items": { "type": "string" } }, "name": { "type": "string" } }, "required": [ "name", "exemplars" ] } }, "load_error": { "type": "string" }, "managed": { "type": "boolean" }, "metrics": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "negative_group": { "type": "string" }, "positive_group": { "type": "string" }, "type": { "type": "string" } }, "required": [ "name", "type" ] } }, "name": { "type": "string" }, "signal_references": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "match": { "type": "string" }, "name": { "type": "string" }, "target": { "type": "object", "properties": { "kind": { "type": "string" }, "value": { "type": "string" } }, "required": [ "kind", "value" ] } }, "required": [ "name", "target" ] } }, "source": { "type": "object", "properties": { "manifest": { "type": "string" }, "path": { "type": "string" } }, "required": [ "path" ] }, "threshold": { "type": "number" }, "type": { "type": "string" } }, "required": [ "name", "type", "builtin", "managed", "editable", "threshold", "source", "bind_options" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "202": { "description": "Saved candidate awaiting publication (poll /api/v1/config/hash for its generated_runtime_hash), or, on a Kubernetes ConfigMap target, durably persisted with activation deferred to the router's next restart", "content": { "application/json": { "schema": { "type": "object", "properties": { "activation": { "nullable": true, "type": "object", "properties": { "attempt": { "type": "integer" }, "document_hash": { "type": "string" }, "error": { "type": "string" }, "finished_at": { "nullable": true, "type": "string", "format": "date-time" }, "reasons": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "path": { "type": "string" }, "stage": { "type": "string" } }, "required": [ "stage", "code", "message" ] } }, "source": { "type": "string" }, "stage": { "type": "string" }, "started_at": { "type": "string", "format": "date-time" }, "status": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "attempt", "document_hash", "source", "status", "stage", "started_at" ] }, "activation_status": { "type": "string" }, "bind_options": { "type": "object", "properties": { "groups": { "nullable": true, "type": "array", "items": { "type": "string" } }, "labels": { "nullable": true, "type": "array", "items": { "type": "string" } }, "metrics": { "nullable": true, "type": "array", "items": { "type": "string" } } }, "required": [ "labels", "groups", "metrics" ] }, "builtin": { "type": "boolean" }, "description": { "type": "string" }, "editable": { "type": "boolean" }, "generated_runtime_hash": { "type": "string" }, "groups": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "array", "items": { "type": "string" } } }, "label_thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "labels": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "description": { "type": "string" }, "exemplars": { "nullable": true, "type": "array", "items": { "type": "string" } }, "name": { "type": "string" } }, "required": [ "name", "exemplars" ] } }, "load_error": { "type": "string" }, "managed": { "type": "boolean" }, "metrics": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "negative_group": { "type": "string" }, "positive_group": { "type": "string" }, "type": { "type": "string" } }, "required": [ "name", "type" ] } }, "name": { "type": "string" }, "signal_references": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "match": { "type": "string" }, "name": { "type": "string" }, "target": { "type": "object", "properties": { "kind": { "type": "string" }, "value": { "type": "string" } }, "required": [ "kind", "value" ] } }, "required": [ "name", "target" ] } }, "source": { "type": "object", "properties": { "manifest": { "type": "string" }, "path": { "type": "string" } }, "required": [ "path" ] }, "threshold": { "type": "number" }, "type": { "type": "string" } }, "required": [ "name", "type", "builtin", "managed", "editable", "threshold", "source", "bind_options" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "409": { "description": "Conflict, including CONFIG_ACTIVATION_PENDING or CONFIG_ACTIVATION_FAILED while the saved candidate is not active", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Candidate persisted but runtime activation failed; inspect activation and recover through /api/v1/config", "content": { "application/json": { "schema": { "type": "object", "properties": { "activation": { "nullable": true, "type": "object", "properties": { "attempt": { "type": "integer" }, "document_hash": { "type": "string" }, "error": { "type": "string" }, "finished_at": { "nullable": true, "type": "string", "format": "date-time" }, "reasons": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "path": { "type": "string" }, "stage": { "type": "string" } }, "required": [ "stage", "code", "message" ] } }, "source": { "type": "string" }, "stage": { "type": "string" }, "started_at": { "type": "string", "format": "date-time" }, "status": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "attempt", "document_hash", "source", "status", "stage", "started_at" ] }, "activation_status": { "type": "string" }, "bind_options": { "type": "object", "properties": { "groups": { "nullable": true, "type": "array", "items": { "type": "string" } }, "labels": { "nullable": true, "type": "array", "items": { "type": "string" } }, "metrics": { "nullable": true, "type": "array", "items": { "type": "string" } } }, "required": [ "labels", "groups", "metrics" ] }, "builtin": { "type": "boolean" }, "description": { "type": "string" }, "editable": { "type": "boolean" }, "generated_runtime_hash": { "type": "string" }, "groups": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "array", "items": { "type": "string" } } }, "label_thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "labels": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "description": { "type": "string" }, "exemplars": { "nullable": true, "type": "array", "items": { "type": "string" } }, "name": { "type": "string" } }, "required": [ "name", "exemplars" ] } }, "load_error": { "type": "string" }, "managed": { "type": "boolean" }, "metrics": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "negative_group": { "type": "string" }, "positive_group": { "type": "string" }, "type": { "type": "string" } }, "required": [ "name", "type" ] } }, "name": { "type": "string" }, "signal_references": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "match": { "type": "string" }, "name": { "type": "string" }, "target": { "type": "object", "properties": { "kind": { "type": "string" }, "value": { "type": "string" } }, "required": [ "kind", "value" ] } }, "required": [ "name", "target" ] } }, "source": { "type": "object", "properties": { "manifest": { "type": "string" }, "path": { "type": "string" } }, "required": [ "path" ] }, "threshold": { "type": "number" }, "type": { "type": "string" } }, "required": [ "name", "type", "builtin", "managed", "editable", "threshold", "source", "bind_options" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "description": { "type": "string" }, "groups": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "array", "items": { "type": "string" } } }, "label_thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "labels": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "description": { "type": "string" }, "exemplars": { "nullable": true, "type": "array", "items": { "type": "string" } }, "name": { "type": "string" } }, "required": [ "name", "exemplars" ] } }, "metrics": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "negative_group": { "type": "string" }, "positive_group": { "type": "string" }, "type": { "type": "string" } }, "required": [ "name", "type" ] } }, "name": { "type": "string" }, "threshold": { "type": "number" } }, "required": [ "threshold", "labels" ] } } } }, "x-vllm-sr-permission": "config.write", "x-vllm-sr-sensitivity": "mutation", "x-vllm-sr-audit-action": "knowledge_base.save", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" } }, "/api/v1/storage/knowledge-bases/{name}": { "get": { "summary": "Read a knowledge base", "description": "Read a knowledge base", "operationId": "get_api_v1_storage_knowledge_bases_name", "tags": [ "storage" ], "parameters": [ { "name": "name", "in": "path", "description": "name path parameter", "required": true, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "activation": { "nullable": true, "type": "object", "properties": { "attempt": { "type": "integer" }, "document_hash": { "type": "string" }, "error": { "type": "string" }, "finished_at": { "nullable": true, "type": "string", "format": "date-time" }, "reasons": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "path": { "type": "string" }, "stage": { "type": "string" } }, "required": [ "stage", "code", "message" ] } }, "source": { "type": "string" }, "stage": { "type": "string" }, "started_at": { "type": "string", "format": "date-time" }, "status": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "attempt", "document_hash", "source", "status", "stage", "started_at" ] }, "activation_status": { "type": "string" }, "bind_options": { "type": "object", "properties": { "groups": { "nullable": true, "type": "array", "items": { "type": "string" } }, "labels": { "nullable": true, "type": "array", "items": { "type": "string" } }, "metrics": { "nullable": true, "type": "array", "items": { "type": "string" } } }, "required": [ "labels", "groups", "metrics" ] }, "builtin": { "type": "boolean" }, "description": { "type": "string" }, "editable": { "type": "boolean" }, "generated_runtime_hash": { "type": "string" }, "groups": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "array", "items": { "type": "string" } } }, "label_thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "labels": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "description": { "type": "string" }, "exemplars": { "nullable": true, "type": "array", "items": { "type": "string" } }, "name": { "type": "string" } }, "required": [ "name", "exemplars" ] } }, "load_error": { "type": "string" }, "managed": { "type": "boolean" }, "metrics": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "negative_group": { "type": "string" }, "positive_group": { "type": "string" }, "type": { "type": "string" } }, "required": [ "name", "type" ] } }, "name": { "type": "string" }, "signal_references": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "match": { "type": "string" }, "name": { "type": "string" }, "target": { "type": "object", "properties": { "kind": { "type": "string" }, "value": { "type": "string" } }, "required": [ "kind", "value" ] } }, "required": [ "name", "target" ] } }, "source": { "type": "object", "properties": { "manifest": { "type": "string" }, "path": { "type": "string" } }, "required": [ "path" ] }, "threshold": { "type": "number" }, "type": { "type": "string" } }, "required": [ "name", "type", "builtin", "managed", "editable", "threshold", "source", "bind_options" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "config.read", "x-vllm-sr-sensitivity": "config", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" }, "put": { "summary": "Update a managed knowledge base", "description": "Update a managed knowledge base", "operationId": "put_api_v1_storage_knowledge_bases_name", "tags": [ "storage" ], "parameters": [ { "name": "name", "in": "path", "description": "name path parameter", "required": true, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "activation": { "nullable": true, "type": "object", "properties": { "attempt": { "type": "integer" }, "document_hash": { "type": "string" }, "error": { "type": "string" }, "finished_at": { "nullable": true, "type": "string", "format": "date-time" }, "reasons": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "path": { "type": "string" }, "stage": { "type": "string" } }, "required": [ "stage", "code", "message" ] } }, "source": { "type": "string" }, "stage": { "type": "string" }, "started_at": { "type": "string", "format": "date-time" }, "status": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "attempt", "document_hash", "source", "status", "stage", "started_at" ] }, "activation_status": { "type": "string" }, "bind_options": { "type": "object", "properties": { "groups": { "nullable": true, "type": "array", "items": { "type": "string" } }, "labels": { "nullable": true, "type": "array", "items": { "type": "string" } }, "metrics": { "nullable": true, "type": "array", "items": { "type": "string" } } }, "required": [ "labels", "groups", "metrics" ] }, "builtin": { "type": "boolean" }, "description": { "type": "string" }, "editable": { "type": "boolean" }, "generated_runtime_hash": { "type": "string" }, "groups": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "array", "items": { "type": "string" } } }, "label_thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "labels": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "description": { "type": "string" }, "exemplars": { "nullable": true, "type": "array", "items": { "type": "string" } }, "name": { "type": "string" } }, "required": [ "name", "exemplars" ] } }, "load_error": { "type": "string" }, "managed": { "type": "boolean" }, "metrics": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "negative_group": { "type": "string" }, "positive_group": { "type": "string" }, "type": { "type": "string" } }, "required": [ "name", "type" ] } }, "name": { "type": "string" }, "signal_references": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "match": { "type": "string" }, "name": { "type": "string" }, "target": { "type": "object", "properties": { "kind": { "type": "string" }, "value": { "type": "string" } }, "required": [ "kind", "value" ] } }, "required": [ "name", "target" ] } }, "source": { "type": "object", "properties": { "manifest": { "type": "string" }, "path": { "type": "string" } }, "required": [ "path" ] }, "threshold": { "type": "number" }, "type": { "type": "string" } }, "required": [ "name", "type", "builtin", "managed", "editable", "threshold", "source", "bind_options" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "202": { "description": "Saved candidate awaiting publication (poll /api/v1/config/hash for its generated_runtime_hash), or, on a Kubernetes ConfigMap target, durably persisted with activation deferred to the router's next restart", "content": { "application/json": { "schema": { "type": "object", "properties": { "activation": { "nullable": true, "type": "object", "properties": { "attempt": { "type": "integer" }, "document_hash": { "type": "string" }, "error": { "type": "string" }, "finished_at": { "nullable": true, "type": "string", "format": "date-time" }, "reasons": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "path": { "type": "string" }, "stage": { "type": "string" } }, "required": [ "stage", "code", "message" ] } }, "source": { "type": "string" }, "stage": { "type": "string" }, "started_at": { "type": "string", "format": "date-time" }, "status": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "attempt", "document_hash", "source", "status", "stage", "started_at" ] }, "activation_status": { "type": "string" }, "bind_options": { "type": "object", "properties": { "groups": { "nullable": true, "type": "array", "items": { "type": "string" } }, "labels": { "nullable": true, "type": "array", "items": { "type": "string" } }, "metrics": { "nullable": true, "type": "array", "items": { "type": "string" } } }, "required": [ "labels", "groups", "metrics" ] }, "builtin": { "type": "boolean" }, "description": { "type": "string" }, "editable": { "type": "boolean" }, "generated_runtime_hash": { "type": "string" }, "groups": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "array", "items": { "type": "string" } } }, "label_thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "labels": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "description": { "type": "string" }, "exemplars": { "nullable": true, "type": "array", "items": { "type": "string" } }, "name": { "type": "string" } }, "required": [ "name", "exemplars" ] } }, "load_error": { "type": "string" }, "managed": { "type": "boolean" }, "metrics": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "negative_group": { "type": "string" }, "positive_group": { "type": "string" }, "type": { "type": "string" } }, "required": [ "name", "type" ] } }, "name": { "type": "string" }, "signal_references": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "match": { "type": "string" }, "name": { "type": "string" }, "target": { "type": "object", "properties": { "kind": { "type": "string" }, "value": { "type": "string" } }, "required": [ "kind", "value" ] } }, "required": [ "name", "target" ] } }, "source": { "type": "object", "properties": { "manifest": { "type": "string" }, "path": { "type": "string" } }, "required": [ "path" ] }, "threshold": { "type": "number" }, "type": { "type": "string" } }, "required": [ "name", "type", "builtin", "managed", "editable", "threshold", "source", "bind_options" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "409": { "description": "Conflict, including CONFIG_ACTIVATION_PENDING or CONFIG_ACTIVATION_FAILED while the saved candidate is not active", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Candidate persisted but runtime activation failed; inspect activation and recover through /api/v1/config", "content": { "application/json": { "schema": { "type": "object", "properties": { "activation": { "nullable": true, "type": "object", "properties": { "attempt": { "type": "integer" }, "document_hash": { "type": "string" }, "error": { "type": "string" }, "finished_at": { "nullable": true, "type": "string", "format": "date-time" }, "reasons": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "path": { "type": "string" }, "stage": { "type": "string" } }, "required": [ "stage", "code", "message" ] } }, "source": { "type": "string" }, "stage": { "type": "string" }, "started_at": { "type": "string", "format": "date-time" }, "status": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "attempt", "document_hash", "source", "status", "stage", "started_at" ] }, "activation_status": { "type": "string" }, "bind_options": { "type": "object", "properties": { "groups": { "nullable": true, "type": "array", "items": { "type": "string" } }, "labels": { "nullable": true, "type": "array", "items": { "type": "string" } }, "metrics": { "nullable": true, "type": "array", "items": { "type": "string" } } }, "required": [ "labels", "groups", "metrics" ] }, "builtin": { "type": "boolean" }, "description": { "type": "string" }, "editable": { "type": "boolean" }, "generated_runtime_hash": { "type": "string" }, "groups": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "array", "items": { "type": "string" } } }, "label_thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "labels": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "description": { "type": "string" }, "exemplars": { "nullable": true, "type": "array", "items": { "type": "string" } }, "name": { "type": "string" } }, "required": [ "name", "exemplars" ] } }, "load_error": { "type": "string" }, "managed": { "type": "boolean" }, "metrics": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "negative_group": { "type": "string" }, "positive_group": { "type": "string" }, "type": { "type": "string" } }, "required": [ "name", "type" ] } }, "name": { "type": "string" }, "signal_references": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "match": { "type": "string" }, "name": { "type": "string" }, "target": { "type": "object", "properties": { "kind": { "type": "string" }, "value": { "type": "string" } }, "required": [ "kind", "value" ] } }, "required": [ "name", "target" ] } }, "source": { "type": "object", "properties": { "manifest": { "type": "string" }, "path": { "type": "string" } }, "required": [ "path" ] }, "threshold": { "type": "number" }, "type": { "type": "string" } }, "required": [ "name", "type", "builtin", "managed", "editable", "threshold", "source", "bind_options" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "description": { "type": "string" }, "groups": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "array", "items": { "type": "string" } } }, "label_thresholds": { "nullable": true, "type": "object", "additionalProperties": { "type": "number" } }, "labels": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "description": { "type": "string" }, "exemplars": { "nullable": true, "type": "array", "items": { "type": "string" } }, "name": { "type": "string" } }, "required": [ "name", "exemplars" ] } }, "metrics": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "negative_group": { "type": "string" }, "positive_group": { "type": "string" }, "type": { "type": "string" } }, "required": [ "name", "type" ] } }, "name": { "type": "string" }, "threshold": { "type": "number" } }, "required": [ "threshold", "labels" ] } } } }, "x-vllm-sr-permission": "config.write", "x-vllm-sr-sensitivity": "mutation", "x-vllm-sr-audit-action": "knowledge_base.save", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" }, "delete": { "summary": "Delete a managed knowledge base", "description": "Delete a managed knowledge base", "operationId": "delete_api_v1_storage_knowledge_bases_name", "tags": [ "storage" ], "parameters": [ { "name": "name", "in": "path", "description": "name path parameter", "required": true, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "activation": { "nullable": true, "type": "object", "properties": { "attempt": { "type": "integer" }, "document_hash": { "type": "string" }, "error": { "type": "string" }, "finished_at": { "nullable": true, "type": "string", "format": "date-time" }, "reasons": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "path": { "type": "string" }, "stage": { "type": "string" } }, "required": [ "stage", "code", "message" ] } }, "source": { "type": "string" }, "stage": { "type": "string" }, "started_at": { "type": "string", "format": "date-time" }, "status": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "attempt", "document_hash", "source", "status", "stage", "started_at" ] }, "activation_status": { "type": "string" }, "generated_runtime_hash": { "type": "string" }, "name": { "type": "string" }, "status": { "type": "string" } }, "required": [ "status", "name" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "202": { "description": "Saved candidate awaiting publication (poll /api/v1/config/hash for its generated_runtime_hash), or, on a Kubernetes ConfigMap target, durably persisted with activation deferred to the router's next restart", "content": { "application/json": { "schema": { "type": "object", "properties": { "activation": { "nullable": true, "type": "object", "properties": { "attempt": { "type": "integer" }, "document_hash": { "type": "string" }, "error": { "type": "string" }, "finished_at": { "nullable": true, "type": "string", "format": "date-time" }, "reasons": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "path": { "type": "string" }, "stage": { "type": "string" } }, "required": [ "stage", "code", "message" ] } }, "source": { "type": "string" }, "stage": { "type": "string" }, "started_at": { "type": "string", "format": "date-time" }, "status": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "attempt", "document_hash", "source", "status", "stage", "started_at" ] }, "activation_status": { "type": "string" }, "generated_runtime_hash": { "type": "string" }, "name": { "type": "string" }, "status": { "type": "string" } }, "required": [ "status", "name" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "409": { "description": "Conflict, including CONFIG_ACTIVATION_PENDING or CONFIG_ACTIVATION_FAILED while the saved candidate is not active", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Candidate persisted but runtime activation failed; inspect activation and recover through /api/v1/config", "content": { "application/json": { "schema": { "type": "object", "properties": { "activation": { "nullable": true, "type": "object", "properties": { "attempt": { "type": "integer" }, "document_hash": { "type": "string" }, "error": { "type": "string" }, "finished_at": { "nullable": true, "type": "string", "format": "date-time" }, "reasons": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "path": { "type": "string" }, "stage": { "type": "string" } }, "required": [ "stage", "code", "message" ] } }, "source": { "type": "string" }, "stage": { "type": "string" }, "started_at": { "type": "string", "format": "date-time" }, "status": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "attempt", "document_hash", "source", "status", "stage", "started_at" ] }, "activation_status": { "type": "string" }, "generated_runtime_hash": { "type": "string" }, "name": { "type": "string" }, "status": { "type": "string" } }, "required": [ "status", "name" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "config.write", "x-vllm-sr-sensitivity": "mutation", "x-vllm-sr-audit-action": "knowledge_base.delete", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" } }, "/api/v1/storage/knowledge-bases/{name}/map/data.ndjson": { "get": { "summary": "Stream generated knowledge-base map data as NDJSON", "description": "Stream generated knowledge-base map data as NDJSON", "operationId": "get_api_v1_storage_knowledge_bases_name_map_data_ndjson", "tags": [ "storage" ], "parameters": [ { "name": "name", "in": "path", "description": "name path parameter", "required": true, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "One map point JSON object per line", "content": { "application/x-ndjson": { "schema": { "type": "string" } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "config.read", "x-vllm-sr-sensitivity": "config", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" } }, "/api/v1/storage/knowledge-bases/{name}/map/metadata": { "get": { "summary": "Read generated knowledge-base map metadata", "description": "Read generated knowledge-base map metadata", "operationId": "get_api_v1_storage_knowledge_bases_name_map_metadata", "tags": [ "storage" ], "parameters": [ { "name": "name", "in": "path", "description": "name path parameter", "required": true, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "description": { "type": "string" }, "group_count": { "type": "integer" }, "groups": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "array", "items": { "type": "string" } } }, "label_count": { "type": "integer" }, "label_names": { "nullable": true, "type": "array", "items": { "type": "string" } }, "model_type": { "type": "string" }, "name": { "type": "string" }, "point_count": { "type": "integer" }, "projection": { "type": "string" }, "topic_label_hint": { "nullable": true, "type": "array", "items": { "type": "string" } } }, "required": [ "name", "projection", "model_type", "point_count", "label_count", "group_count", "label_names" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "config.read", "x-vllm-sr-sensitivity": "config", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" } }, "/api/v1/storage/memories": { "get": { "summary": "List long-term memories", "description": "List long-term memories", "operationId": "get_api_v1_storage_memories", "tags": [ "storage" ], "parameters": [ { "name": "user_id", "in": "query", "description": "Development fallback identity when x-authz-user-id is unavailable.", "schema": { "type": "string" } }, { "name": "type", "in": "query", "description": "Comma-separated memory types: semantic, procedural, or episodic.", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "Maximum results; defaults to 20 and is capped at 100.", "schema": { "type": "integer" } }, { "name": "offset", "in": "query", "description": "Rows to skip after created_at descending, id descending. Best-effort under concurrent writes. Defaults to 0.", "schema": { "type": "integer" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "limit": { "type": "integer" }, "memories": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "access_count": { "type": "integer" }, "content": { "type": "string" }, "created_at": { "type": "string" }, "id": { "type": "string" }, "importance": { "type": "number" }, "source": { "type": "string" }, "type": { "type": "string" }, "updated_at": { "type": "string" }, "user_id": { "type": "string" } }, "required": [ "id", "type", "content", "user_id", "importance", "access_count", "created_at" ] } }, "offset": { "type": "integer" }, "total": { "type": "integer" } }, "required": [ "memories", "total", "limit", "offset" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "data.read", "x-vllm-sr-sensitivity": "config", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-plugin-operations": [ { "plugin": "memory", "mode": "read" } ], "x-vllm-sr-visibility": "advanced" }, "delete": { "summary": "Delete memories by scope", "description": "Delete memories by scope", "operationId": "delete_api_v1_storage_memories", "tags": [ "storage" ], "parameters": [ { "name": "user_id", "in": "query", "description": "Development fallback identity when x-authz-user-id is unavailable.", "schema": { "type": "string" } }, { "name": "type", "in": "query", "description": "Comma-separated memory types to delete: semantic, procedural, or episodic.", "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string" }, "success": { "type": "boolean" } }, "required": [ "success", "message" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "data.write", "x-vllm-sr-sensitivity": "mutation", "x-vllm-sr-audit-action": "memory.delete", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-plugin-operations": [ { "plugin": "memory", "mode": "mutation" } ], "x-vllm-sr-visibility": "advanced" } }, "/api/v1/storage/memories/{id}": { "get": { "summary": "Read one long-term memory", "description": "Read one long-term memory", "operationId": "get_api_v1_storage_memories_id", "tags": [ "storage" ], "parameters": [ { "name": "id", "in": "path", "description": "id path parameter", "required": true, "schema": { "type": "string" } }, { "name": "user_id", "in": "query", "description": "Development fallback identity when x-authz-user-id is unavailable.", "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "access_count": { "type": "integer" }, "content": { "type": "string" }, "created_at": { "type": "string" }, "id": { "type": "string" }, "importance": { "type": "number" }, "source": { "type": "string" }, "type": { "type": "string" }, "updated_at": { "type": "string" }, "user_id": { "type": "string" } }, "required": [ "id", "type", "content", "user_id", "importance", "access_count", "created_at" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "data.read", "x-vllm-sr-sensitivity": "config", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-plugin-operations": [ { "plugin": "memory", "mode": "read" } ], "x-vllm-sr-visibility": "advanced" }, "delete": { "summary": "Delete one long-term memory", "description": "Delete one long-term memory", "operationId": "delete_api_v1_storage_memories_id", "tags": [ "storage" ], "parameters": [ { "name": "id", "in": "path", "description": "id path parameter", "required": true, "schema": { "type": "string" } }, { "name": "user_id", "in": "query", "description": "Development fallback identity when x-authz-user-id is unavailable.", "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string" }, "success": { "type": "boolean" } }, "required": [ "success", "message" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "data.write", "x-vllm-sr-sensitivity": "mutation", "x-vllm-sr-audit-action": "memory.delete", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-plugin-operations": [ { "plugin": "memory", "mode": "mutation" } ], "x-vllm-sr-visibility": "advanced" } }, "/api/v1/storage/response-cache/capabilities": { "get": { "summary": "Get response-cache backend capabilities", "description": "Get response-cache backend capabilities", "operationId": "get_api_v1_storage_response_cache_capabilities", "tags": [ "storage" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "backend": { "type": "string" }, "consistency_model": { "type": "string" }, "exact": { "type": "boolean" }, "flush": { "type": "boolean" }, "invalidate": { "type": "boolean" }, "per_entry_ttl": { "type": "boolean" }, "semantic": { "type": "boolean" }, "shared": { "type": "boolean" }, "stats": { "type": "boolean" } }, "required": [ "backend", "exact", "semantic", "per_entry_ttl", "stats", "invalidate", "flush", "shared", "consistency_model" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "cache.read", "x-vllm-sr-sensitivity": "operational", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-plugin-operations": [ { "plugin": "response_cache", "mode": "read" } ], "x-vllm-sr-visibility": "advanced" } }, "/api/v1/storage/response-cache/flush": { "post": { "summary": "Advance a scoped or global response-cache epoch", "description": "Advance a scoped or global response-cache epoch", "operationId": "post_api_v1_storage_response_cache_flush", "tags": [ "storage" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "deleted": { "type": "integer" }, "dry_run": { "type": "boolean" }, "matched_estimate": { "type": "integer" } }, "required": [ "dry_run", "matched_estimate", "deleted" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "501": { "description": "Not Implemented", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "confirm": { "type": "string" }, "selector": { "type": "object", "properties": { "epoch": { "type": "string" }, "partition": { "nullable": true, "type": "object", "properties": { "decision": { "type": "string" }, "epoch": { "type": "string" }, "namespace": { "type": "string" }, "protocol": { "type": "string" }, "recipe": { "type": "string" }, "request_model": { "type": "string" }, "selected_model": { "type": "string" } } } } } }, "required": [ "selector", "confirm" ] } } } }, "x-vllm-sr-permission": "cache.manage", "x-vllm-sr-sensitivity": "mutation", "x-vllm-sr-audit-action": "cache.flush", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-plugin-operations": [ { "plugin": "response_cache", "mode": "mutation" } ], "x-vllm-sr-visibility": "advanced" } }, "/api/v1/storage/response-cache/health": { "get": { "summary": "Check response-cache backend health", "description": "Check response-cache backend health", "operationId": "get_api_v1_storage_response_cache_health", "tags": [ "storage" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "capabilities": { "type": "object", "properties": { "backend": { "type": "string" }, "consistency_model": { "type": "string" }, "exact": { "type": "boolean" }, "flush": { "type": "boolean" }, "invalidate": { "type": "boolean" }, "per_entry_ttl": { "type": "boolean" }, "semantic": { "type": "boolean" }, "shared": { "type": "boolean" }, "stats": { "type": "boolean" } }, "required": [ "backend", "exact", "semantic", "per_entry_ttl", "stats", "invalidate", "flush", "shared", "consistency_model" ] }, "status": { "type": "string" } }, "required": [ "status", "capabilities" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "cache.read", "x-vllm-sr-sensitivity": "operational", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-plugin-operations": [ { "plugin": "response_cache", "mode": "read" } ], "x-vllm-sr-visibility": "advanced" } }, "/api/v1/storage/response-cache/invalidate": { "post": { "summary": "Dry-run or invalidate a scoped response-cache partition", "description": "Dry-run or invalidate a scoped response-cache partition", "operationId": "post_api_v1_storage_response_cache_invalidate", "tags": [ "storage" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "deleted": { "type": "integer" }, "dry_run": { "type": "boolean" }, "matched_estimate": { "type": "integer" } }, "required": [ "dry_run", "matched_estimate", "deleted" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "501": { "description": "Not Implemented", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "dry_run": { "nullable": true, "type": "boolean" }, "selector": { "type": "object", "properties": { "epoch": { "type": "string" }, "partition": { "nullable": true, "type": "object", "properties": { "decision": { "type": "string" }, "epoch": { "type": "string" }, "namespace": { "type": "string" }, "protocol": { "type": "string" }, "recipe": { "type": "string" }, "request_model": { "type": "string" }, "selected_model": { "type": "string" } } } } } }, "required": [ "selector" ] } } } }, "x-vllm-sr-permission": "cache.invalidate", "x-vllm-sr-sensitivity": "mutation", "x-vllm-sr-audit-action": "cache.invalidate", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-plugin-operations": [ { "plugin": "response_cache", "mode": "mutation" } ], "x-vllm-sr-visibility": "advanced" } }, "/api/v1/storage/response-cache/stats": { "get": { "summary": "Get redacted response-cache statistics", "description": "Get redacted response-cache statistics", "operationId": "get_api_v1_storage_response_cache_stats", "tags": [ "storage" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "exact_hit_count": { "type": "integer" }, "fail_open_count": { "type": "integer" }, "hit_count": { "type": "integer" }, "hit_ratio": { "type": "number" }, "invalidation_count": { "type": "integer" }, "l1_entries": { "type": "integer" }, "l1_hit_count": { "type": "integer" }, "l2_hit_count": { "type": "integer" }, "last_cleanup_time": { "nullable": true, "type": "string", "format": "date-time" }, "miss_count": { "type": "integer" }, "semantic_hit_count": { "type": "integer" }, "singleflight_waiters": { "type": "integer" }, "stale_miss_count": { "type": "integer" }, "total_entries": { "type": "integer" } }, "required": [ "total_entries", "hit_count", "miss_count", "hit_ratio", "exact_hit_count", "semantic_hit_count", "l1_hit_count", "l2_hit_count", "l1_entries", "singleflight_waiters", "invalidation_count", "stale_miss_count", "fail_open_count" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "cache.read", "x-vllm-sr-sensitivity": "operational", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-plugin-operations": [ { "plugin": "response_cache", "mode": "read" } ], "x-vllm-sr-visibility": "advanced" } }, "/api/v1/storage/response-cache/test": { "post": { "summary": "Validate and probe a response-cache candidate configuration", "description": "Validate and probe a response-cache candidate configuration", "operationId": "post_api_v1_storage_response_cache_test", "tags": [ "storage" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "capabilities": { "type": "object", "properties": { "backend": { "type": "string" }, "consistency_model": { "type": "string" }, "exact": { "type": "boolean" }, "flush": { "type": "boolean" }, "invalidate": { "type": "boolean" }, "per_entry_ttl": { "type": "boolean" }, "semantic": { "type": "boolean" }, "shared": { "type": "boolean" }, "stats": { "type": "boolean" } }, "required": [ "backend", "exact", "semantic", "per_entry_ttl", "stats", "invalidate", "flush", "shared", "consistency_model" ] }, "healthy": { "type": "boolean" }, "valid": { "type": "boolean" } }, "required": [ "valid", "healthy", "capabilities" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Candidate backend is unhealthy or its embedding runtime is unavailable", "content": { "application/json": { "schema": { "oneOf": [ { "type": "object", "properties": { "capabilities": { "type": "object", "properties": { "backend": { "type": "string" }, "consistency_model": { "type": "string" }, "exact": { "type": "boolean" }, "flush": { "type": "boolean" }, "invalidate": { "type": "boolean" }, "per_entry_ttl": { "type": "boolean" }, "semantic": { "type": "boolean" }, "shared": { "type": "boolean" }, "stats": { "type": "boolean" } }, "required": [ "backend", "exact", "semantic", "per_entry_ttl", "stats", "invalidate", "flush", "shared", "consistency_model" ] }, "healthy": { "type": "boolean" }, "valid": { "type": "boolean" } }, "required": [ "valid", "healthy", "capabilities" ] }, { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "configuration": {} }, "required": [ "configuration" ] } } } }, "x-vllm-sr-permission": "cache.manage", "x-vllm-sr-sensitivity": "operational", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-plugin-operations": [ { "plugin": "response_cache", "mode": "probe" } ], "x-vllm-sr-visibility": "advanced" } }, "/api/v1/storage/vector-stores": { "get": { "summary": "List vector stores", "description": "List vector stores", "operationId": "get_api_v1_storage_vector_stores", "tags": [ "storage" ], "parameters": [ { "name": "limit", "in": "query", "description": "Maximum results; defaults to 20 and is capped at 100.", "schema": { "type": "integer" } }, { "name": "order", "in": "query", "description": "Sort order by creation time.", "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "after", "in": "query", "description": "Return results after this cursor.", "schema": { "type": "string" } }, { "name": "before", "in": "query", "description": "Return results before this cursor; mutually exclusive with after.", "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "nullable": true, "type": "array", "items": { "nullable": true, "type": "object", "properties": { "backend_type": { "type": "string" }, "created_at": { "type": "integer" }, "expires_after": { "nullable": true, "type": "object", "properties": { "anchor": { "type": "string" }, "days": { "type": "integer" } }, "required": [ "anchor", "days" ] }, "file_counts": { "type": "object", "properties": { "completed": { "type": "integer" }, "failed": { "type": "integer" }, "in_progress": { "type": "integer" }, "total": { "type": "integer" } }, "required": [ "in_progress", "completed", "failed", "total" ] }, "id": { "type": "string" }, "metadata": { "nullable": true, "type": "object", "additionalProperties": true }, "name": { "type": "string" }, "object": { "type": "string" }, "status": { "type": "string" } }, "required": [ "id", "object", "name", "created_at", "status", "file_counts", "backend_type" ] } }, "object": { "type": "string" } }, "required": [ "object", "data" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "data.read", "x-vllm-sr-sensitivity": "config", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-plugin-operations": [ { "plugin": "rag", "mode": "read" } ], "x-vllm-sr-visibility": "primary" }, "post": { "summary": "Create a vector store", "description": "Create a vector store", "operationId": "post_api_v1_storage_vector_stores", "tags": [ "storage" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "backend_type": { "type": "string" }, "created_at": { "type": "integer" }, "expires_after": { "nullable": true, "type": "object", "properties": { "anchor": { "type": "string" }, "days": { "type": "integer" } }, "required": [ "anchor", "days" ] }, "file_counts": { "type": "object", "properties": { "completed": { "type": "integer" }, "failed": { "type": "integer" }, "in_progress": { "type": "integer" }, "total": { "type": "integer" } }, "required": [ "in_progress", "completed", "failed", "total" ] }, "id": { "type": "string" }, "metadata": { "nullable": true, "type": "object", "additionalProperties": true }, "name": { "type": "string" }, "object": { "type": "string" }, "status": { "type": "string" } }, "required": [ "id", "object", "name", "created_at", "status", "file_counts", "backend_type" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 1048576 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "expires_after": { "nullable": true, "type": "object", "properties": { "anchor": { "type": "string" }, "days": { "type": "integer" } }, "required": [ "anchor", "days" ] }, "metadata": { "nullable": true, "type": "object", "additionalProperties": true }, "name": { "type": "string" } }, "required": [ "name" ] } } } }, "x-vllm-sr-permission": "data.write", "x-vllm-sr-sensitivity": "mutation", "x-vllm-sr-audit-action": "data.write", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-plugin-operations": [ { "plugin": "rag", "mode": "mutation" } ], "x-vllm-sr-visibility": "primary" } }, "/api/v1/storage/vector-stores/{id}": { "get": { "summary": "Read a vector store", "description": "Read a vector store", "operationId": "get_api_v1_storage_vector_stores_id", "tags": [ "storage" ], "parameters": [ { "name": "id", "in": "path", "description": "id path parameter", "required": true, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "backend_type": { "type": "string" }, "created_at": { "type": "integer" }, "expires_after": { "nullable": true, "type": "object", "properties": { "anchor": { "type": "string" }, "days": { "type": "integer" } }, "required": [ "anchor", "days" ] }, "file_counts": { "type": "object", "properties": { "completed": { "type": "integer" }, "failed": { "type": "integer" }, "in_progress": { "type": "integer" }, "total": { "type": "integer" } }, "required": [ "in_progress", "completed", "failed", "total" ] }, "id": { "type": "string" }, "metadata": { "nullable": true, "type": "object", "additionalProperties": true }, "name": { "type": "string" }, "object": { "type": "string" }, "status": { "type": "string" } }, "required": [ "id", "object", "name", "created_at", "status", "file_counts", "backend_type" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "data.read", "x-vllm-sr-sensitivity": "config", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-plugin-operations": [ { "plugin": "rag", "mode": "read" } ], "x-vllm-sr-visibility": "primary" }, "post": { "summary": "Update a vector store", "description": "Update a vector store", "operationId": "post_api_v1_storage_vector_stores_id", "tags": [ "storage" ], "parameters": [ { "name": "id", "in": "path", "description": "id path parameter", "required": true, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "backend_type": { "type": "string" }, "created_at": { "type": "integer" }, "expires_after": { "nullable": true, "type": "object", "properties": { "anchor": { "type": "string" }, "days": { "type": "integer" } }, "required": [ "anchor", "days" ] }, "file_counts": { "type": "object", "properties": { "completed": { "type": "integer" }, "failed": { "type": "integer" }, "in_progress": { "type": "integer" }, "total": { "type": "integer" } }, "required": [ "in_progress", "completed", "failed", "total" ] }, "id": { "type": "string" }, "metadata": { "nullable": true, "type": "object", "additionalProperties": true }, "name": { "type": "string" }, "object": { "type": "string" }, "status": { "type": "string" } }, "required": [ "id", "object", "name", "created_at", "status", "file_counts", "backend_type" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 1048576 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "expires_after": { "nullable": true, "type": "object", "properties": { "anchor": { "type": "string" }, "days": { "type": "integer" } }, "required": [ "anchor", "days" ] }, "metadata": { "nullable": true, "type": "object", "additionalProperties": true }, "name": { "nullable": true, "type": "string" } } } } } }, "x-vllm-sr-permission": "data.write", "x-vllm-sr-sensitivity": "mutation", "x-vllm-sr-audit-action": "data.write", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-plugin-operations": [ { "plugin": "rag", "mode": "mutation" } ], "x-vllm-sr-visibility": "primary" }, "delete": { "summary": "Delete a vector store", "description": "Delete a vector store", "operationId": "delete_api_v1_storage_vector_stores_id", "tags": [ "storage" ], "parameters": [ { "name": "id", "in": "path", "description": "id path parameter", "required": true, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "deleted": { "type": "boolean" }, "id": { "type": "string" }, "object": { "type": "string" } }, "required": [ "id", "object", "deleted" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "data.write", "x-vllm-sr-sensitivity": "mutation", "x-vllm-sr-audit-action": "data.write", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-plugin-operations": [ { "plugin": "rag", "mode": "mutation" } ], "x-vllm-sr-visibility": "primary" } }, "/api/v1/storage/vector-stores/{id}/files": { "get": { "summary": "List files attached to a vector store", "description": "List files attached to a vector store", "operationId": "get_api_v1_storage_vector_stores_id_files", "tags": [ "storage" ], "parameters": [ { "name": "id", "in": "path", "description": "id path parameter", "required": true, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "nullable": true, "type": "array", "items": { "nullable": true, "type": "object", "properties": { "chunking_strategy": { "nullable": true, "type": "object", "properties": { "static": { "nullable": true, "type": "object", "properties": { "chunk_overlap_tokens": { "type": "integer" }, "max_chunk_size_tokens": { "type": "integer" } }, "required": [ "max_chunk_size_tokens", "chunk_overlap_tokens" ] }, "type": { "type": "string" } }, "required": [ "type" ] }, "created_at": { "type": "integer" }, "file_id": { "type": "string" }, "id": { "type": "string" }, "last_error": { "nullable": true, "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ] }, "object": { "type": "string" }, "status": { "type": "string" }, "vector_store_id": { "type": "string" } }, "required": [ "id", "object", "vector_store_id", "file_id", "status", "created_at" ] } }, "object": { "type": "string" } }, "required": [ "object", "data" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "data.read", "x-vllm-sr-sensitivity": "config", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-plugin-operations": [ { "plugin": "rag", "mode": "read" } ], "x-vllm-sr-visibility": "primary" }, "post": { "summary": "Attach a file to a vector store", "description": "Attach a file to a vector store", "operationId": "post_api_v1_storage_vector_stores_id_files", "tags": [ "storage" ], "parameters": [ { "name": "id", "in": "path", "description": "id path parameter", "required": true, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "chunking_strategy": { "nullable": true, "type": "object", "properties": { "static": { "nullable": true, "type": "object", "properties": { "chunk_overlap_tokens": { "type": "integer" }, "max_chunk_size_tokens": { "type": "integer" } }, "required": [ "max_chunk_size_tokens", "chunk_overlap_tokens" ] }, "type": { "type": "string" } }, "required": [ "type" ] }, "created_at": { "type": "integer" }, "file_id": { "type": "string" }, "id": { "type": "string" }, "last_error": { "nullable": true, "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ] }, "object": { "type": "string" }, "status": { "type": "string" }, "vector_store_id": { "type": "string" } }, "required": [ "id", "object", "vector_store_id", "file_id", "status", "created_at" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 1048576 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "chunking_strategy": { "nullable": true, "type": "object", "properties": { "static": { "nullable": true, "type": "object", "properties": { "chunk_overlap_tokens": { "type": "integer" }, "max_chunk_size_tokens": { "type": "integer" } }, "required": [ "max_chunk_size_tokens", "chunk_overlap_tokens" ] }, "type": { "type": "string" } }, "required": [ "type" ] }, "file_id": { "type": "string" } }, "required": [ "file_id" ] } } } }, "x-vllm-sr-permission": "data.write", "x-vllm-sr-sensitivity": "mutation", "x-vllm-sr-audit-action": "data.write", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" } }, "/api/v1/storage/vector-stores/{id}/files/{file_id}": { "delete": { "summary": "Detach a file from a vector store", "description": "Detach a file from a vector store", "operationId": "delete_api_v1_storage_vector_stores_id_files_file_id", "tags": [ "storage" ], "parameters": [ { "name": "id", "in": "path", "description": "id path parameter", "required": true, "schema": { "type": "string" } }, { "name": "file_id", "in": "path", "description": "file_id path parameter", "required": true, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "deleted": { "type": "boolean" }, "id": { "type": "string" }, "object": { "type": "string" } }, "required": [ "id", "object", "deleted" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "data.write", "x-vllm-sr-sensitivity": "mutation", "x-vllm-sr-audit-action": "data.write", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" } }, "/api/v1/storage/vector-stores/{id}/search": { "post": { "summary": "Search a vector store", "description": "Search a vector store", "operationId": "post_api_v1_storage_vector_stores_id_search", "tags": [ "storage" ], "parameters": [ { "name": "id", "in": "path", "description": "id path parameter", "required": true, "schema": { "type": "string" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "bm25_score": { "nullable": true, "type": "number" }, "chunk_index": { "type": "integer" }, "content": { "type": "string" }, "file_id": { "type": "string" }, "filename": { "type": "string" }, "ngram_score": { "nullable": true, "type": "number" }, "score": { "type": "number" }, "vector_score": { "nullable": true, "type": "number" } }, "required": [ "file_id", "filename", "content", "score", "chunk_index" ] } }, "object": { "type": "string" } }, "required": [ "object", "data" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "413": { "description": "Request body too large", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Service Unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "requestBody": { "description": "application/json request payload. Limit: 1048576 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "filters": { "nullable": true, "type": "object", "additionalProperties": true }, "hybrid": { "nullable": true, "type": "object", "properties": { "bm25_b": { "type": "number" }, "bm25_k1": { "type": "number" }, "bm25_weight": { "type": "number" }, "mode": { "type": "string" }, "ngram_size": { "type": "integer" }, "ngram_weight": { "type": "number" }, "rrf_constant": { "type": "integer" }, "vector_weight": { "type": "number" } } }, "max_num_results": { "type": "integer" }, "query": { "type": "string" }, "ranking_options": { "nullable": true, "type": "object", "properties": { "score_threshold": { "type": "number" } } } }, "required": [ "query" ] } } } }, "x-vllm-sr-permission": "data.read", "x-vllm-sr-sensitivity": "operational", "x-vllm-sr-plane": "management", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-plugin-operations": [ { "plugin": "rag", "mode": "probe" } ], "x-vllm-sr-visibility": "primary" } }, "/docs": { "get": { "summary": "Interactive Swagger UI documentation", "description": "Interactive Swagger UI documentation", "operationId": "get_docs", "tags": [ "system" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Interactive API documentation", "content": { "text/html": { "schema": { "type": "string" } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "docs.read", "x-vllm-sr-sensitivity": "public", "x-vllm-sr-plane": "infrastructure", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" } }, "/health": { "get": { "summary": "Health check endpoint", "description": "Health check endpoint", "operationId": "get_health", "tags": [ "system" ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "service": { "type": "string" }, "serving_mode": { "type": "string" }, "status": { "type": "string" } }, "required": [ "serving_mode", "status", "service" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "health.read", "x-vllm-sr-sensitivity": "public", "x-vllm-sr-plane": "infrastructure", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" } }, "/openapi.json": { "get": { "summary": "OpenAPI 3.0 specification; optionally narrowed to one path or operation", "description": "OpenAPI 3.0 specification; optionally narrowed to one path or operation", "operationId": "get_openapi_json", "tags": [ "system" ], "parameters": [ { "name": "path", "in": "query", "description": "Exact API path to return, for example /api/v1/config.", "schema": { "type": "string" } }, { "name": "method", "in": "query", "description": "HTTP method to return for the selected path.", "schema": { "type": "string", "enum": [ "GET", "POST", "PATCH", "PUT", "DELETE" ] } }, { "name": "capability", "in": "query", "description": "Return operations in one capability group.", "schema": { "type": "string" } }, { "name": "audience", "in": "query", "description": "Return operations intended for agent, operator, client, or internal callers.", "schema": { "type": "string", "enum": [ "agent", "operator", "client", "internal" ] } }, { "name": "plane", "in": "query", "description": "Return operations from one API plane.", "schema": { "type": "string", "enum": [ "infrastructure", "management", "diagnostic", "data" ] } }, { "name": "visibility", "in": "query", "description": "Return primary or advanced operations.", "schema": { "type": "string", "enum": [ "primary", "advanced" ] } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "components": { "type": "object", "properties": { "schemas": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "$ref": { "type": "string" }, "additionalProperties": {}, "description": { "type": "string" }, "enum": { "nullable": true, "type": "array", "items": { "type": "string" } }, "format": { "type": "string" }, "items": { "nullable": true, "type": "object" }, "minimum": { "nullable": true, "type": "integer" }, "nullable": { "type": "boolean" }, "oneOf": { "nullable": true, "type": "array", "items": { "type": "object" } }, "properties": { "nullable": true, "type": "object", "additionalProperties": { "type": "object" } }, "required": { "nullable": true, "type": "array", "items": { "type": "string" } }, "type": { "type": "string" } } } }, "securitySchemes": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "bearerFormat": { "type": "string" }, "description": { "type": "string" }, "scheme": { "type": "string" }, "type": { "type": "string" } }, "required": [ "type", "scheme" ] } } } }, "info": { "type": "object", "properties": { "description": { "type": "string" }, "title": { "type": "string" }, "version": { "type": "string" } }, "required": [ "title", "description", "version" ] }, "openapi": { "type": "string" }, "paths": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "delete": { "nullable": true, "type": "object", "properties": { "deprecated": { "type": "boolean" }, "description": { "type": "string" }, "operationId": { "type": "string" }, "parameters": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "description": { "type": "string" }, "in": { "type": "string" }, "name": { "type": "string" }, "required": { "type": "boolean" }, "schema": { "type": "object", "properties": { "$ref": { "type": "string" }, "additionalProperties": {}, "description": { "type": "string" }, "enum": { "nullable": true, "type": "array", "items": { "type": "string" } }, "format": { "type": "string" }, "items": { "nullable": true, "type": "object" }, "minimum": { "nullable": true, "type": "integer" }, "nullable": { "type": "boolean" }, "oneOf": { "nullable": true, "type": "array", "items": { "type": "object" } }, "properties": { "nullable": true, "type": "object", "additionalProperties": { "type": "object" } }, "required": { "nullable": true, "type": "array", "items": { "type": "string" } }, "type": { "type": "string" } } } }, "required": [ "name", "in", "schema" ] } }, "requestBody": { "nullable": true, "type": "object", "properties": { "content": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "schema": { "nullable": true, "type": "object", "properties": { "$ref": { "type": "string" }, "additionalProperties": {}, "description": { "type": "string" }, "enum": { "nullable": true, "type": "array", "items": { "type": "string" } }, "format": { "type": "string" }, "items": { "nullable": true, "type": "object" }, "minimum": { "nullable": true, "type": "integer" }, "nullable": { "type": "boolean" }, "oneOf": { "nullable": true, "type": "array", "items": { "type": "object" } }, "properties": { "nullable": true, "type": "object", "additionalProperties": { "type": "object" } }, "required": { "nullable": true, "type": "array", "items": { "type": "string" } }, "type": { "type": "string" } } } } } }, "description": { "type": "string" }, "required": { "type": "boolean" } }, "required": [ "content" ] }, "responses": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "content": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "schema": { "nullable": true, "type": "object", "properties": { "$ref": { "type": "string" }, "additionalProperties": {}, "description": { "type": "string" }, "enum": { "nullable": true, "type": "array", "items": { "type": "string" } }, "format": { "type": "string" }, "items": { "nullable": true, "type": "object" }, "minimum": { "nullable": true, "type": "integer" }, "nullable": { "type": "boolean" }, "oneOf": { "nullable": true, "type": "array", "items": { "type": "object" } }, "properties": { "nullable": true, "type": "object", "additionalProperties": { "type": "object" } }, "required": { "nullable": true, "type": "array", "items": { "type": "string" } }, "type": { "type": "string" } } } } } }, "description": { "type": "string" }, "headers": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "description": { "type": "string" }, "schema": { "type": "object", "properties": { "$ref": { "type": "string" }, "additionalProperties": {}, "description": { "type": "string" }, "enum": { "nullable": true, "type": "array", "items": { "type": "string" } }, "format": { "type": "string" }, "items": { "nullable": true, "type": "object" }, "minimum": { "nullable": true, "type": "integer" }, "nullable": { "type": "boolean" }, "oneOf": { "nullable": true, "type": "array", "items": { "type": "object" } }, "properties": { "nullable": true, "type": "object", "additionalProperties": { "type": "object" } }, "required": { "nullable": true, "type": "array", "items": { "type": "string" } }, "type": { "type": "string" } } } }, "required": [ "schema" ] } } }, "required": [ "description" ] } }, "security": { "nullable": true, "type": "array", "items": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "array", "items": { "type": "string" } } } }, "summary": { "type": "string" }, "tags": { "nullable": true, "type": "array", "items": { "type": "string" } }, "x-vllm-sr-audiences": { "nullable": true, "type": "array", "items": { "type": "string" } }, "x-vllm-sr-audit-action": { "type": "string" }, "x-vllm-sr-permission": { "type": "string" }, "x-vllm-sr-plane": { "type": "string" }, "x-vllm-sr-plugin-operations": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "mode": { "type": "string" }, "plugin": { "type": "string" } }, "required": [ "plugin", "mode" ] } }, "x-vllm-sr-sensitivity": { "type": "string" }, "x-vllm-sr-stability": { "type": "string" }, "x-vllm-sr-visibility": { "type": "string" } }, "required": [ "summary", "responses", "x-vllm-sr-permission", "x-vllm-sr-sensitivity", "x-vllm-sr-plane", "x-vllm-sr-audiences", "x-vllm-sr-stability", "x-vllm-sr-visibility" ] }, "get": { "nullable": true, "type": "object", "properties": { "deprecated": { "type": "boolean" }, "description": { "type": "string" }, "operationId": { "type": "string" }, "parameters": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "description": { "type": "string" }, "in": { "type": "string" }, "name": { "type": "string" }, "required": { "type": "boolean" }, "schema": { "type": "object", "properties": { "$ref": { "type": "string" }, "additionalProperties": {}, "description": { "type": "string" }, "enum": { "nullable": true, "type": "array", "items": { "type": "string" } }, "format": { "type": "string" }, "items": { "nullable": true, "type": "object" }, "minimum": { "nullable": true, "type": "integer" }, "nullable": { "type": "boolean" }, "oneOf": { "nullable": true, "type": "array", "items": { "type": "object" } }, "properties": { "nullable": true, "type": "object", "additionalProperties": { "type": "object" } }, "required": { "nullable": true, "type": "array", "items": { "type": "string" } }, "type": { "type": "string" } } } }, "required": [ "name", "in", "schema" ] } }, "requestBody": { "nullable": true, "type": "object", "properties": { "content": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "schema": { "nullable": true, "type": "object", "properties": { "$ref": { "type": "string" }, "additionalProperties": {}, "description": { "type": "string" }, "enum": { "nullable": true, "type": "array", "items": { "type": "string" } }, "format": { "type": "string" }, "items": { "nullable": true, "type": "object" }, "minimum": { "nullable": true, "type": "integer" }, "nullable": { "type": "boolean" }, "oneOf": { "nullable": true, "type": "array", "items": { "type": "object" } }, "properties": { "nullable": true, "type": "object", "additionalProperties": { "type": "object" } }, "required": { "nullable": true, "type": "array", "items": { "type": "string" } }, "type": { "type": "string" } } } } } }, "description": { "type": "string" }, "required": { "type": "boolean" } }, "required": [ "content" ] }, "responses": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "content": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "schema": { "nullable": true, "type": "object", "properties": { "$ref": { "type": "string" }, "additionalProperties": {}, "description": { "type": "string" }, "enum": { "nullable": true, "type": "array", "items": { "type": "string" } }, "format": { "type": "string" }, "items": { "nullable": true, "type": "object" }, "minimum": { "nullable": true, "type": "integer" }, "nullable": { "type": "boolean" }, "oneOf": { "nullable": true, "type": "array", "items": { "type": "object" } }, "properties": { "nullable": true, "type": "object", "additionalProperties": { "type": "object" } }, "required": { "nullable": true, "type": "array", "items": { "type": "string" } }, "type": { "type": "string" } } } } } }, "description": { "type": "string" }, "headers": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "description": { "type": "string" }, "schema": { "type": "object", "properties": { "$ref": { "type": "string" }, "additionalProperties": {}, "description": { "type": "string" }, "enum": { "nullable": true, "type": "array", "items": { "type": "string" } }, "format": { "type": "string" }, "items": { "nullable": true, "type": "object" }, "minimum": { "nullable": true, "type": "integer" }, "nullable": { "type": "boolean" }, "oneOf": { "nullable": true, "type": "array", "items": { "type": "object" } }, "properties": { "nullable": true, "type": "object", "additionalProperties": { "type": "object" } }, "required": { "nullable": true, "type": "array", "items": { "type": "string" } }, "type": { "type": "string" } } } }, "required": [ "schema" ] } } }, "required": [ "description" ] } }, "security": { "nullable": true, "type": "array", "items": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "array", "items": { "type": "string" } } } }, "summary": { "type": "string" }, "tags": { "nullable": true, "type": "array", "items": { "type": "string" } }, "x-vllm-sr-audiences": { "nullable": true, "type": "array", "items": { "type": "string" } }, "x-vllm-sr-audit-action": { "type": "string" }, "x-vllm-sr-permission": { "type": "string" }, "x-vllm-sr-plane": { "type": "string" }, "x-vllm-sr-plugin-operations": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "mode": { "type": "string" }, "plugin": { "type": "string" } }, "required": [ "plugin", "mode" ] } }, "x-vllm-sr-sensitivity": { "type": "string" }, "x-vllm-sr-stability": { "type": "string" }, "x-vllm-sr-visibility": { "type": "string" } }, "required": [ "summary", "responses", "x-vllm-sr-permission", "x-vllm-sr-sensitivity", "x-vllm-sr-plane", "x-vllm-sr-audiences", "x-vllm-sr-stability", "x-vllm-sr-visibility" ] }, "patch": { "nullable": true, "type": "object", "properties": { "deprecated": { "type": "boolean" }, "description": { "type": "string" }, "operationId": { "type": "string" }, "parameters": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "description": { "type": "string" }, "in": { "type": "string" }, "name": { "type": "string" }, "required": { "type": "boolean" }, "schema": { "type": "object", "properties": { "$ref": { "type": "string" }, "additionalProperties": {}, "description": { "type": "string" }, "enum": { "nullable": true, "type": "array", "items": { "type": "string" } }, "format": { "type": "string" }, "items": { "nullable": true, "type": "object" }, "minimum": { "nullable": true, "type": "integer" }, "nullable": { "type": "boolean" }, "oneOf": { "nullable": true, "type": "array", "items": { "type": "object" } }, "properties": { "nullable": true, "type": "object", "additionalProperties": { "type": "object" } }, "required": { "nullable": true, "type": "array", "items": { "type": "string" } }, "type": { "type": "string" } } } }, "required": [ "name", "in", "schema" ] } }, "requestBody": { "nullable": true, "type": "object", "properties": { "content": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "schema": { "nullable": true, "type": "object", "properties": { "$ref": { "type": "string" }, "additionalProperties": {}, "description": { "type": "string" }, "enum": { "nullable": true, "type": "array", "items": { "type": "string" } }, "format": { "type": "string" }, "items": { "nullable": true, "type": "object" }, "minimum": { "nullable": true, "type": "integer" }, "nullable": { "type": "boolean" }, "oneOf": { "nullable": true, "type": "array", "items": { "type": "object" } }, "properties": { "nullable": true, "type": "object", "additionalProperties": { "type": "object" } }, "required": { "nullable": true, "type": "array", "items": { "type": "string" } }, "type": { "type": "string" } } } } } }, "description": { "type": "string" }, "required": { "type": "boolean" } }, "required": [ "content" ] }, "responses": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "content": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "schema": { "nullable": true, "type": "object", "properties": { "$ref": { "type": "string" }, "additionalProperties": {}, "description": { "type": "string" }, "enum": { "nullable": true, "type": "array", "items": { "type": "string" } }, "format": { "type": "string" }, "items": { "nullable": true, "type": "object" }, "minimum": { "nullable": true, "type": "integer" }, "nullable": { "type": "boolean" }, "oneOf": { "nullable": true, "type": "array", "items": { "type": "object" } }, "properties": { "nullable": true, "type": "object", "additionalProperties": { "type": "object" } }, "required": { "nullable": true, "type": "array", "items": { "type": "string" } }, "type": { "type": "string" } } } } } }, "description": { "type": "string" }, "headers": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "description": { "type": "string" }, "schema": { "type": "object", "properties": { "$ref": { "type": "string" }, "additionalProperties": {}, "description": { "type": "string" }, "enum": { "nullable": true, "type": "array", "items": { "type": "string" } }, "format": { "type": "string" }, "items": { "nullable": true, "type": "object" }, "minimum": { "nullable": true, "type": "integer" }, "nullable": { "type": "boolean" }, "oneOf": { "nullable": true, "type": "array", "items": { "type": "object" } }, "properties": { "nullable": true, "type": "object", "additionalProperties": { "type": "object" } }, "required": { "nullable": true, "type": "array", "items": { "type": "string" } }, "type": { "type": "string" } } } }, "required": [ "schema" ] } } }, "required": [ "description" ] } }, "security": { "nullable": true, "type": "array", "items": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "array", "items": { "type": "string" } } } }, "summary": { "type": "string" }, "tags": { "nullable": true, "type": "array", "items": { "type": "string" } }, "x-vllm-sr-audiences": { "nullable": true, "type": "array", "items": { "type": "string" } }, "x-vllm-sr-audit-action": { "type": "string" }, "x-vllm-sr-permission": { "type": "string" }, "x-vllm-sr-plane": { "type": "string" }, "x-vllm-sr-plugin-operations": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "mode": { "type": "string" }, "plugin": { "type": "string" } }, "required": [ "plugin", "mode" ] } }, "x-vllm-sr-sensitivity": { "type": "string" }, "x-vllm-sr-stability": { "type": "string" }, "x-vllm-sr-visibility": { "type": "string" } }, "required": [ "summary", "responses", "x-vllm-sr-permission", "x-vllm-sr-sensitivity", "x-vllm-sr-plane", "x-vllm-sr-audiences", "x-vllm-sr-stability", "x-vllm-sr-visibility" ] }, "post": { "nullable": true, "type": "object", "properties": { "deprecated": { "type": "boolean" }, "description": { "type": "string" }, "operationId": { "type": "string" }, "parameters": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "description": { "type": "string" }, "in": { "type": "string" }, "name": { "type": "string" }, "required": { "type": "boolean" }, "schema": { "type": "object", "properties": { "$ref": { "type": "string" }, "additionalProperties": {}, "description": { "type": "string" }, "enum": { "nullable": true, "type": "array", "items": { "type": "string" } }, "format": { "type": "string" }, "items": { "nullable": true, "type": "object" }, "minimum": { "nullable": true, "type": "integer" }, "nullable": { "type": "boolean" }, "oneOf": { "nullable": true, "type": "array", "items": { "type": "object" } }, "properties": { "nullable": true, "type": "object", "additionalProperties": { "type": "object" } }, "required": { "nullable": true, "type": "array", "items": { "type": "string" } }, "type": { "type": "string" } } } }, "required": [ "name", "in", "schema" ] } }, "requestBody": { "nullable": true, "type": "object", "properties": { "content": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "schema": { "nullable": true, "type": "object", "properties": { "$ref": { "type": "string" }, "additionalProperties": {}, "description": { "type": "string" }, "enum": { "nullable": true, "type": "array", "items": { "type": "string" } }, "format": { "type": "string" }, "items": { "nullable": true, "type": "object" }, "minimum": { "nullable": true, "type": "integer" }, "nullable": { "type": "boolean" }, "oneOf": { "nullable": true, "type": "array", "items": { "type": "object" } }, "properties": { "nullable": true, "type": "object", "additionalProperties": { "type": "object" } }, "required": { "nullable": true, "type": "array", "items": { "type": "string" } }, "type": { "type": "string" } } } } } }, "description": { "type": "string" }, "required": { "type": "boolean" } }, "required": [ "content" ] }, "responses": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "content": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "schema": { "nullable": true, "type": "object", "properties": { "$ref": { "type": "string" }, "additionalProperties": {}, "description": { "type": "string" }, "enum": { "nullable": true, "type": "array", "items": { "type": "string" } }, "format": { "type": "string" }, "items": { "nullable": true, "type": "object" }, "minimum": { "nullable": true, "type": "integer" }, "nullable": { "type": "boolean" }, "oneOf": { "nullable": true, "type": "array", "items": { "type": "object" } }, "properties": { "nullable": true, "type": "object", "additionalProperties": { "type": "object" } }, "required": { "nullable": true, "type": "array", "items": { "type": "string" } }, "type": { "type": "string" } } } } } }, "description": { "type": "string" }, "headers": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "description": { "type": "string" }, "schema": { "type": "object", "properties": { "$ref": { "type": "string" }, "additionalProperties": {}, "description": { "type": "string" }, "enum": { "nullable": true, "type": "array", "items": { "type": "string" } }, "format": { "type": "string" }, "items": { "nullable": true, "type": "object" }, "minimum": { "nullable": true, "type": "integer" }, "nullable": { "type": "boolean" }, "oneOf": { "nullable": true, "type": "array", "items": { "type": "object" } }, "properties": { "nullable": true, "type": "object", "additionalProperties": { "type": "object" } }, "required": { "nullable": true, "type": "array", "items": { "type": "string" } }, "type": { "type": "string" } } } }, "required": [ "schema" ] } } }, "required": [ "description" ] } }, "security": { "nullable": true, "type": "array", "items": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "array", "items": { "type": "string" } } } }, "summary": { "type": "string" }, "tags": { "nullable": true, "type": "array", "items": { "type": "string" } }, "x-vllm-sr-audiences": { "nullable": true, "type": "array", "items": { "type": "string" } }, "x-vllm-sr-audit-action": { "type": "string" }, "x-vllm-sr-permission": { "type": "string" }, "x-vllm-sr-plane": { "type": "string" }, "x-vllm-sr-plugin-operations": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "mode": { "type": "string" }, "plugin": { "type": "string" } }, "required": [ "plugin", "mode" ] } }, "x-vllm-sr-sensitivity": { "type": "string" }, "x-vllm-sr-stability": { "type": "string" }, "x-vllm-sr-visibility": { "type": "string" } }, "required": [ "summary", "responses", "x-vllm-sr-permission", "x-vllm-sr-sensitivity", "x-vllm-sr-plane", "x-vllm-sr-audiences", "x-vllm-sr-stability", "x-vllm-sr-visibility" ] }, "put": { "nullable": true, "type": "object", "properties": { "deprecated": { "type": "boolean" }, "description": { "type": "string" }, "operationId": { "type": "string" }, "parameters": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "description": { "type": "string" }, "in": { "type": "string" }, "name": { "type": "string" }, "required": { "type": "boolean" }, "schema": { "type": "object", "properties": { "$ref": { "type": "string" }, "additionalProperties": {}, "description": { "type": "string" }, "enum": { "nullable": true, "type": "array", "items": { "type": "string" } }, "format": { "type": "string" }, "items": { "nullable": true, "type": "object" }, "minimum": { "nullable": true, "type": "integer" }, "nullable": { "type": "boolean" }, "oneOf": { "nullable": true, "type": "array", "items": { "type": "object" } }, "properties": { "nullable": true, "type": "object", "additionalProperties": { "type": "object" } }, "required": { "nullable": true, "type": "array", "items": { "type": "string" } }, "type": { "type": "string" } } } }, "required": [ "name", "in", "schema" ] } }, "requestBody": { "nullable": true, "type": "object", "properties": { "content": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "schema": { "nullable": true, "type": "object", "properties": { "$ref": { "type": "string" }, "additionalProperties": {}, "description": { "type": "string" }, "enum": { "nullable": true, "type": "array", "items": { "type": "string" } }, "format": { "type": "string" }, "items": { "nullable": true, "type": "object" }, "minimum": { "nullable": true, "type": "integer" }, "nullable": { "type": "boolean" }, "oneOf": { "nullable": true, "type": "array", "items": { "type": "object" } }, "properties": { "nullable": true, "type": "object", "additionalProperties": { "type": "object" } }, "required": { "nullable": true, "type": "array", "items": { "type": "string" } }, "type": { "type": "string" } } } } } }, "description": { "type": "string" }, "required": { "type": "boolean" } }, "required": [ "content" ] }, "responses": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "content": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "schema": { "nullable": true, "type": "object", "properties": { "$ref": { "type": "string" }, "additionalProperties": {}, "description": { "type": "string" }, "enum": { "nullable": true, "type": "array", "items": { "type": "string" } }, "format": { "type": "string" }, "items": { "nullable": true, "type": "object" }, "minimum": { "nullable": true, "type": "integer" }, "nullable": { "type": "boolean" }, "oneOf": { "nullable": true, "type": "array", "items": { "type": "object" } }, "properties": { "nullable": true, "type": "object", "additionalProperties": { "type": "object" } }, "required": { "nullable": true, "type": "array", "items": { "type": "string" } }, "type": { "type": "string" } } } } } }, "description": { "type": "string" }, "headers": { "nullable": true, "type": "object", "additionalProperties": { "type": "object", "properties": { "description": { "type": "string" }, "schema": { "type": "object", "properties": { "$ref": { "type": "string" }, "additionalProperties": {}, "description": { "type": "string" }, "enum": { "nullable": true, "type": "array", "items": { "type": "string" } }, "format": { "type": "string" }, "items": { "nullable": true, "type": "object" }, "minimum": { "nullable": true, "type": "integer" }, "nullable": { "type": "boolean" }, "oneOf": { "nullable": true, "type": "array", "items": { "type": "object" } }, "properties": { "nullable": true, "type": "object", "additionalProperties": { "type": "object" } }, "required": { "nullable": true, "type": "array", "items": { "type": "string" } }, "type": { "type": "string" } } } }, "required": [ "schema" ] } } }, "required": [ "description" ] } }, "security": { "nullable": true, "type": "array", "items": { "nullable": true, "type": "object", "additionalProperties": { "nullable": true, "type": "array", "items": { "type": "string" } } } }, "summary": { "type": "string" }, "tags": { "nullable": true, "type": "array", "items": { "type": "string" } }, "x-vllm-sr-audiences": { "nullable": true, "type": "array", "items": { "type": "string" } }, "x-vllm-sr-audit-action": { "type": "string" }, "x-vllm-sr-permission": { "type": "string" }, "x-vllm-sr-plane": { "type": "string" }, "x-vllm-sr-plugin-operations": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "mode": { "type": "string" }, "plugin": { "type": "string" } }, "required": [ "plugin", "mode" ] } }, "x-vllm-sr-sensitivity": { "type": "string" }, "x-vllm-sr-stability": { "type": "string" }, "x-vllm-sr-visibility": { "type": "string" } }, "required": [ "summary", "responses", "x-vllm-sr-permission", "x-vllm-sr-sensitivity", "x-vllm-sr-plane", "x-vllm-sr-audiences", "x-vllm-sr-stability", "x-vllm-sr-visibility" ] } } } }, "servers": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "description": { "type": "string" }, "url": { "type": "string" } }, "required": [ "url", "description" ] } }, "tags": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "description": { "type": "string" }, "name": { "type": "string" } }, "required": [ "name" ] } } }, "required": [ "openapi", "info", "servers", "paths" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "404": { "description": "Not Found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "docs.read", "x-vllm-sr-sensitivity": "public", "x-vllm-sr-plane": "infrastructure", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" } }, "/ready": { "get": { "summary": "Readiness endpoint that turns green only after startup completes", "description": "Readiness endpoint that turns green only after startup completes", "operationId": "get_ready", "tags": [ "system" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "downloading_model": { "type": "string" }, "message": { "type": "string" }, "pending_models": { "nullable": true, "type": "array", "items": { "type": "string" } }, "phase": { "type": "string" }, "ready": { "type": "boolean" }, "ready_models": { "type": "integer" }, "service": { "type": "string" }, "status": { "type": "string" }, "total_models": { "type": "integer" } }, "required": [ "status", "service", "ready" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Startup is incomplete", "content": { "application/json": { "schema": { "type": "object", "properties": { "downloading_model": { "type": "string" }, "message": { "type": "string" }, "pending_models": { "nullable": true, "type": "array", "items": { "type": "string" } }, "phase": { "type": "string" }, "ready": { "type": "boolean" }, "ready_models": { "type": "integer" }, "service": { "type": "string" }, "status": { "type": "string" }, "total_models": { "type": "integer" } }, "required": [ "status", "service", "ready" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "ready.read", "x-vllm-sr-sensitivity": "operational", "x-vllm-sr-plane": "infrastructure", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" } }, "/startup-status": { "get": { "summary": "Detailed router startup and model-download status", "description": "Detailed router startup and model-download status", "operationId": "get_startup_status", "tags": [ "system" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "downloading_model": { "type": "string" }, "embedding_provider": { "nullable": true, "type": "object", "properties": { "api_key_env": { "type": "string" }, "api_key_env_set": { "nullable": true, "type": "boolean" }, "backend": { "type": "string" }, "dimension": { "type": "integer" }, "healthy": { "nullable": true, "type": "boolean" }, "last_checked_at": { "type": "string" }, "last_probe_error": { "type": "string" }, "mode": { "type": "string" }, "model": { "type": "string" } } }, "message": { "type": "string" }, "model_deployments": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "artifact": { "type": "string" }, "name": { "type": "string" }, "process": { "type": "string" }, "ready": { "type": "boolean" }, "reason": { "type": "string" }, "state": { "type": "string" } }, "required": [ "name", "state", "ready" ] } }, "pending_models": { "nullable": true, "type": "array", "items": { "type": "string" } }, "phase": { "type": "string" }, "ready": { "type": "boolean" }, "ready_models": { "type": "integer" }, "total_models": { "type": "integer" }, "updated_at": { "type": "string" } }, "required": [ "phase", "ready" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Startup status could not be encoded", "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "503": { "description": "Startup state or readiness is unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "downloading_model": { "type": "string" }, "embedding_provider": { "nullable": true, "type": "object", "properties": { "api_key_env": { "type": "string" }, "api_key_env_set": { "nullable": true, "type": "boolean" }, "backend": { "type": "string" }, "dimension": { "type": "integer" }, "healthy": { "nullable": true, "type": "boolean" }, "last_checked_at": { "type": "string" }, "last_probe_error": { "type": "string" }, "mode": { "type": "string" }, "model": { "type": "string" } } }, "message": { "type": "string" }, "model_deployments": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "artifact": { "type": "string" }, "name": { "type": "string" }, "process": { "type": "string" }, "ready": { "type": "boolean" }, "reason": { "type": "string" }, "state": { "type": "string" } }, "required": [ "name", "state", "ready" ] } }, "pending_models": { "nullable": true, "type": "array", "items": { "type": "string" } }, "phase": { "type": "string" }, "ready": { "type": "boolean" }, "ready_models": { "type": "integer" }, "total_models": { "type": "integer" }, "updated_at": { "type": "string" } }, "required": [ "phase", "ready" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "ready.read", "x-vllm-sr-sensitivity": "operational", "x-vllm-sr-plane": "infrastructure", "x-vllm-sr-audiences": [ "agent", "operator" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" } }, "/v1/models": { "get": { "summary": "OpenAI-compatible public model and Entrypoint listing", "description": "OpenAI-compatible public model and Entrypoint listing", "operationId": "get_v1_models", "tags": [ "inventory" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "nullable": true, "type": "array", "items": { "type": "object", "properties": { "created": { "type": "integer" }, "description": { "type": "string" }, "id": { "type": "string" }, "logo_url": { "type": "string" }, "object": { "type": "string" }, "owned_by": { "type": "string" }, "routing": { "type": "object", "properties": { "api": { "type": "string" }, "default_route": { "type": "boolean" }, "recipe": { "type": "string" }, "resolution": { "type": "string" }, "selectable": { "type": "boolean" }, "source": { "type": "string" } }, "required": [ "api", "resolution", "selectable" ] } }, "required": [ "id", "object", "created", "owned_by", "routing" ] } }, "object": { "type": "string" } }, "required": [ "object", "data" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "401": { "description": "A management bearer token is required or invalid when bearer authentication is enabled", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "403": { "description": "The authenticated role lacks the operation permission", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } }, "500": { "description": "Management authentication configuration is invalid", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "code", "message" ] } }, "required": [ "error" ] } } }, "headers": { "X-Request-Id": { "description": "Correlation identifier for this management request.", "schema": { "type": "string" } } } } }, "x-vllm-sr-permission": "config.read", "x-vllm-sr-sensitivity": "config", "x-vllm-sr-plane": "data", "x-vllm-sr-audiences": [ "agent", "client" ], "x-vllm-sr-stability": "stable", "x-vllm-sr-visibility": "primary" } } }, "components": { "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "opaque management token", "description": "Required when global.services.management_api.auth.mode is bearer." } } } }