{ "openapi": "3.0.0", "info": { "title": "Semantic Router Apiserver", "description": "HTTP router apiserver for classification utilities, config management, and service introspection", "version": "v1" }, "servers": [ { "url": "/", "description": "Router Apiserver" } ], "tags": [ { "name": "system", "description": "Health, readiness, and API contract discovery." }, { "name": "routing", "description": "Preview routing behavior without invoking a generation backend." }, { "name": "diagnostics", "description": "Invoke low-level classifiers, embeddings, NLI, and similarity diagnostics." }, { "name": "inventory", "description": "Inspect configured and loaded model and classifier resources." }, { "name": "observability", "description": "Inspect routing replays and metrics, and submit outcome evidence." }, { "name": "response-cache", "description": "Inspect and manage the response-cache service." }, { "name": "context-compression", "description": "Inspect, preview, and manage context compression." }, { "name": "config", "description": "Validate, inspect, apply, version, and roll back Router configuration and Recipes." }, { "name": "storage", "description": "Manage Router-owned knowledge bases, memories, files, and vector stores." } ], "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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" }, "timestamp": { "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": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" }, "timestamp": { "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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" }, "timestamp": { "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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" }, "timestamp": { "type": "string" } } } } } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "description": { "type": "string" }, "entrypoints": { "type": "array", "items": { "type": "string" } }, "name": { "type": "string" }, "routing": { "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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" }, "timestamp": { "type": "string" } } } } } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "description": { "type": "string" }, "entrypoints": { "type": "array", "items": { "type": "string" } }, "name": { "type": "string" }, "routing": { "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": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" }, "timestamp": { "type": "string" } } } } } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "string" } }, "required": [ "version" ], "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": "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": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" }, "timestamp": { "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": { "type": "object" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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/context-compression/capabilities": { "get": { "summary": "Get context-compression capabilities", "description": "Get context-compression capabilities", "operationId": "get_api_v1_context_compression_capabilities", "tags": [ "context-compression" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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-visibility": "advanced" } }, "/api/v1/context-compression/health": { "get": { "summary": "Check context-compression runtime health", "description": "Check context-compression runtime health", "operationId": "get_api_v1_context_compression_health", "tags": [ "context-compression" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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-visibility": "advanced" } }, "/api/v1/context-compression/preview": { "post": { "summary": "Preview context compression without persistence", "description": "Preview context compression without persistence", "operationId": "post_api_v1_context_compression_preview", "tags": [ "context-compression" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" }, "timestamp": { "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-visibility": "advanced" } }, "/api/v1/context-compression/recovery/invalidate": { "post": { "summary": "Invalidate a trusted context-recovery request scope", "description": "Invalidate a trusted context-recovery request scope", "operationId": "post_api_v1_context_compression_recovery_invalidate", "tags": [ "context-compression" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" }, "timestamp": { "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-visibility": "advanced" } }, "/api/v1/context-compression/stats": { "get": { "summary": "Get redacted context-compression statistics", "description": "Get redacted context-compression statistics", "operationId": "get_api_v1_context_compression_stats", "tags": [ "context-compression" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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-visibility": "advanced" } }, "/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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" }, "timestamp": { "type": "string" } } } } } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "options": { "type": "object", "properties": { "confidence_threshold": { "type": "number" }, "include_explanation": { "type": "boolean" }, "return_probabilities": { "type": "boolean" } } }, "task_type": { "type": "string" }, "texts": { "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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" }, "timestamp": { "type": "string" } } } } } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "intent_options": { "type": "object", "properties": { "confidence_threshold": { "type": "number" }, "include_explanation": { "type": "boolean" }, "return_probabilities": { "type": "boolean" }, "trace": { "type": "boolean" } } }, "pii_options": { "type": "object", "properties": { "confidence_threshold": { "type": "number" }, "entity_types": { "type": "array", "items": { "type": "string" } }, "mask_entities": { "type": "boolean" }, "return_positions": { "type": "boolean" }, "reveal_entity_text": { "type": "boolean" } } }, "security_options": { "type": "object", "properties": { "detection_types": { "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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" }, "timestamp": { "type": "string" } } } } } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "options": { "type": "object", "properties": { "confidence_threshold": { "type": "number" } } }, "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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" }, "timestamp": { "type": "string" } } } } } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "function_call": {}, "functions": { "type": "array", "items": {} }, "max_completion_tokens": {}, "max_tokens": {}, "messages": { "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": { "type": "array", "items": {} } }, "required": [ "role", "content" ] } }, "metadata": { "type": "object", "additionalProperties": { "type": "string" } }, "model": { "type": "string" }, "options": { "type": "object", "properties": { "confidence_threshold": { "type": "number" }, "include_explanation": { "type": "boolean" }, "return_probabilities": { "type": "boolean" }, "trace": { "type": "boolean" } } }, "response_format": {}, "text": { "type": "string" }, "tool_choice": {}, "tools": { "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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" }, "timestamp": { "type": "string" } } } } } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "options": { "type": "object", "properties": { "confidence_threshold": { "type": "number" }, "entity_types": { "type": "array", "items": { "type": "string" } }, "mask_entities": { "type": "boolean" }, "return_positions": { "type": "boolean" }, "reveal_entity_text": { "type": "boolean" } } }, "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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" }, "timestamp": { "type": "string" } } } } } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "options": { "type": "object", "properties": { "detection_types": { "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/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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" }, "timestamp": { "type": "string" } } } } } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "options": { "type": "object", "properties": { "confidence_threshold": { "type": "number" } } }, "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 and image embeddings", "description": "Generate text and image embeddings", "operationId": "post_api_v1_diagnostics_embeddings", "tags": [ "diagnostics" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" }, "timestamp": { "type": "string" } } } } } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "dimension": { "type": "integer" }, "images": { "type": "array", "items": { "type": "string" } }, "latency_priority": { "type": "number" }, "model": { "type": "string" }, "quality_priority": { "type": "number" }, "sequence_length": { "type": "integer" }, "target_layer": { "type": "integer" }, "texts": { "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/nli": { "post": { "summary": "Natural language inference classification for premise and hypothesis pairs", "description": "Natural language inference classification for premise and hypothesis pairs", "operationId": "post_api_v1_diagnostics_nli", "tags": [ "diagnostics" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" }, "timestamp": { "type": "string" } } } } } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "hypothesis": { "type": "string" }, "premise": { "type": "string" } }, "required": [ "premise", "hypothesis" ] } } } }, "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": { "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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" }, "timestamp": { "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" }, "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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" }, "timestamp": { "type": "string" } } } } } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "candidates": { "type": "array", "items": { "type": "string" } }, "dimension": { "type": "integer" }, "latency_priority": { "type": "number" }, "model": { "type": "string" }, "quality_priority": { "type": "number" }, "query": { "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/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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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/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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" }, "timestamp": { "type": "string" } } } } } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "metadata": { "type": "object", "additionalProperties": { "type": "string" } }, "reason": { "type": "string" }, "replay_id": { "type": "string" }, "score": { "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/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 response", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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-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 response", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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-visibility": "primary" } }, "/api/v1/observability/replays/trajectory": { "get": { "summary": "Build a Router Replay session trajectory", "description": "Build a Router Replay session trajectory", "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" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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-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 response", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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-visibility": "primary" } }, "/api/v1/response-cache/audit": { "get": { "summary": "Get redacted response-cache mutation audit entries", "description": "Get redacted response-cache mutation audit entries", "operationId": "get_api_v1_response_cache_audit", "tags": [ "response-cache" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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-visibility": "advanced" } }, "/api/v1/response-cache/capabilities": { "get": { "summary": "Get response-cache backend capabilities", "description": "Get response-cache backend capabilities", "operationId": "get_api_v1_response_cache_capabilities", "tags": [ "response-cache" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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-visibility": "advanced" } }, "/api/v1/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_response_cache_flush", "tags": [ "response-cache" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" }, "timestamp": { "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": { "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-visibility": "advanced" } }, "/api/v1/response-cache/health": { "get": { "summary": "Check response-cache backend health", "description": "Check response-cache backend health", "operationId": "get_api_v1_response_cache_health", "tags": [ "response-cache" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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-visibility": "advanced" } }, "/api/v1/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_response_cache_invalidate", "tags": [ "response-cache" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" }, "timestamp": { "type": "string" } } } } } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "dry_run": { "type": "boolean" }, "selector": { "type": "object", "properties": { "epoch": { "type": "string" }, "partition": { "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-visibility": "advanced" } }, "/api/v1/response-cache/stats": { "get": { "summary": "Get redacted response-cache statistics", "description": "Get redacted response-cache statistics", "operationId": "get_api_v1_response_cache_stats", "tags": [ "response-cache" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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-visibility": "advanced" } }, "/api/v1/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_response_cache_test", "tags": [ "response-cache" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" }, "timestamp": { "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-visibility": "advanced" } }, "/api/v1/routing/preview": { "post": { "summary": "Preview all configured signals and the resulting route without invoking a generation backend", "description": "Preview all configured signals and the resulting route without invoking a generation backend", "operationId": "post_api_v1_routing_preview", "tags": [ "routing" ], "parameters": [ { "name": "trace", "in": "query", "description": "Include per-decision routing trace trees.", "schema": { "type": "boolean" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" }, "timestamp": { "type": "string" } } } } } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "function_call": {}, "functions": { "type": "array", "items": {} }, "max_completion_tokens": {}, "max_tokens": {}, "messages": { "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": { "type": "array", "items": {} } }, "required": [ "role", "content" ], "additionalProperties": false } }, "metadata": { "type": "object", "additionalProperties": { "type": "string" } }, "model": { "type": "string" }, "options": { "type": "object", "properties": { "confidence_threshold": { "type": "number" }, "include_explanation": { "type": "boolean" }, "return_probabilities": { "type": "boolean" }, "trace": { "type": "boolean" } }, "additionalProperties": false }, "response_format": {}, "text": { "type": "string" }, "tool_choice": {}, "tools": { "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/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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" }, "timestamp": { "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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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": "Knowledge base created", "content": { "application/json": { "schema": { "type": "object" } } } }, "202": { "description": "Saved candidate awaiting whole-generation publication; poll /api/v1/config/hash until active_runtime_hash matches generated_runtime_hash", "content": { "application/json": { "schema": { "type": "object", "properties": { "activation_status": { "type": "string", "enum": [ "pending" ] }, "generated_runtime_hash": { "type": "string", "description": "Exact candidate runtime document hash, when available" } }, "required": [ "activation_status" ] } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } } } } } } }, "409": { "description": "Conflict, including CONFIG_ACTIVATION_PENDING when a saved candidate has not activated; no second KB mutation is persisted", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" }, "timestamp": { "type": "string" } } } } } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "description": { "type": "string" }, "groups": { "type": "object", "additionalProperties": { "type": "array", "items": { "type": "string" } } }, "label_thresholds": { "type": "object", "additionalProperties": { "type": "number" } }, "labels": { "type": "array", "items": { "type": "object", "properties": { "description": { "type": "string" }, "exemplars": { "type": "array", "items": { "type": "string" } }, "name": { "type": "string" } }, "required": [ "name", "exemplars" ] } }, "metrics": { "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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" } } } }, "202": { "description": "Saved candidate awaiting whole-generation publication; poll /api/v1/config/hash until active_runtime_hash matches generated_runtime_hash", "content": { "application/json": { "schema": { "type": "object", "properties": { "activation_status": { "type": "string", "enum": [ "pending" ] }, "generated_runtime_hash": { "type": "string", "description": "Exact candidate runtime document hash, when available" } }, "required": [ "activation_status" ] } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } } } } } } }, "409": { "description": "Conflict, including CONFIG_ACTIVATION_PENDING when a saved candidate has not activated; no second KB mutation is persisted", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" }, "timestamp": { "type": "string" } } } } } } } } }, "requestBody": { "description": "application/json request payload. Limit: 10485760 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "description": { "type": "string" }, "groups": { "type": "object", "additionalProperties": { "type": "array", "items": { "type": "string" } } }, "label_thresholds": { "type": "object", "additionalProperties": { "type": "number" } }, "labels": { "type": "array", "items": { "type": "object", "properties": { "description": { "type": "string" }, "exemplars": { "type": "array", "items": { "type": "string" } }, "name": { "type": "string" } }, "required": [ "name", "exemplars" ] } }, "metrics": { "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" } } } }, "202": { "description": "Saved candidate awaiting whole-generation publication; poll /api/v1/config/hash until active_runtime_hash matches generated_runtime_hash", "content": { "application/json": { "schema": { "type": "object", "properties": { "activation_status": { "type": "string", "enum": [ "pending" ] }, "generated_runtime_hash": { "type": "string", "description": "Exact candidate runtime document hash, when available" } }, "required": [ "activation_status" ] } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "type": "string" } } } } } } } }, "409": { "description": "Conflict, including CONFIG_ACTIVATION_PENDING when a saved candidate has not activated; no second KB mutation is persisted", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" } } ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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": "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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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-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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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": "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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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-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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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": "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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" }, "timestamp": { "type": "string" } } } } } } } } }, "requestBody": { "description": "application/json request payload. Limit: 1048576 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "expires_after": { "type": "object", "properties": { "anchor": { "type": "string" }, "days": { "type": "integer" } }, "required": [ "anchor", "days" ] }, "metadata": { "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-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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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": "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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" }, "timestamp": { "type": "string" } } } } } } } } }, "requestBody": { "description": "application/json request payload. Limit: 1048576 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "expires_after": { "type": "object", "properties": { "anchor": { "type": "string" }, "days": { "type": "integer" } }, "required": [ "anchor", "days" ] }, "metadata": { "type": "object", "additionalProperties": true }, "name": { "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" }, "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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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}/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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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": "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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" }, "timestamp": { "type": "string" } } } } } } } } }, "requestBody": { "description": "application/json request payload. Limit: 1048576 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "chunking_strategy": { "type": "object", "properties": { "static": { "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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" }, "timestamp": { "type": "string" } } } } } } } } }, "requestBody": { "description": "application/json request payload. Limit: 1048576 bytes.", "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "filters": { "type": "object", "additionalProperties": true }, "hybrid": { "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": { "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-visibility": "primary" } }, "/docs": { "get": { "summary": "Interactive Swagger UI documentation", "description": "Interactive Swagger UI documentation", "operationId": "get_docs", "tags": [ "system" ], "security": [ {}, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "timestamp": { "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." } } } }