{ "openapi": "3.0.0", "info": { "title": "Infermax Customer API", "version": "0.1.0", "description": "External Customer integration reference generated from the current backend. Public documentation does not grant API access or establish hosted availability. API credentials, project permissions and qualified capacity are required. This site does not execute API requests." }, "servers": [ { "url": "https://api.infermax.ai", "description": "Canonical API origin; confirm availability in Console client setup." } ], "tags": [ { "name": "Managed Inference" }, { "name": "Compute Access" }, { "name": "Usage & Account" } ], "paths": { "/v1/models": { "get": { "description": "Up to 100 explicitly entitled published models. availability reflects fresh deployment probes; check model health before admission.", "operationId": "ModelsController_models", "parameters": [], "responses": { "200": { "description": "Persisted contract response; runtime readiness is not implied", "content": { "application/json": { "schema": { "type": "object", "properties": { "object": { "type": "string", "enum": [ "list" ] }, "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "object": { "type": "string", "enum": [ "model" ] }, "created": { "type": "integer" }, "owned_by": { "type": "string" }, "display_name": { "type": "string" }, "context_window": { "type": "integer" }, "max_output_tokens": { "type": "integer" }, "availability": { "type": "string", "enum": [ "available", "unavailable" ] } } } } } } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "summary": "Eligible model catalog; listing does not mean a runtime is ready", "tags": [ "Managed Inference" ] } }, "/v1/model-catalog": { "get": { "operationId": "ModelCatalogController_list", "parameters": [], "responses": { "200": { "description": "Successful operation.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductCatalogPage" } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "401": { "description": "Missing, expired or revoked authentication", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "403": { "description": "Role, scope, Origin or CSRF denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "409": { "description": "Idempotency, version or state conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "413": { "description": "Body exceeds64KiB", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "422": { "description": "Invalid reference or value", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } } }, "security": [ { "bearer": [] } ], "summary": "Source-backed catalog search; availability remains proof-checked and separate from entitlement", "tags": [ "Managed Inference" ] } }, "/v1/model-catalog/{id}": { "get": { "operationId": "ModelCatalogController_detail", "parameters": [ { "name": "id", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful operation.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductCatalogDetail" } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "401": { "description": "Missing, expired or revoked authentication", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "403": { "description": "Role, scope, Origin or CSRF denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "409": { "description": "Idempotency, version or state conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "413": { "description": "Body exceeds64KiB", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "422": { "description": "Invalid reference or value", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } } }, "security": [ { "bearer": [] } ], "summary": "Visible model details; hidden and unpublished IDs return 404", "tags": [ "Managed Inference" ] } }, "/v1/endpoints": { "get": { "operationId": "CustomerPanelReads_endpoints", "parameters": [ { "name": "limit", "required": false, "in": "query", "schema": { "maximum": 100, "default": 50, "type": "number" } }, { "name": "after", "required": false, "in": "query", "schema": { "type": "string" } }, { "name": "search", "required": false, "in": "query", "schema": { "type": "string" } }, { "name": "sort", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "id", "name" ] } }, { "name": "direction", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "asc", "desc" ] } } ], "responses": { "200": { "description": "Successful operation.", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": true } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "tags": [ "Managed Inference" ], "summary": "List project endpoints" } }, "/v1/endpoints/{id}/revision": { "get": { "operationId": "CustomerLifecycleController_revision", "parameters": [ { "name": "id", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful operation.", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": true } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "tags": [ "Managed Inference" ], "summary": "Read the endpoint revision" } }, "/v1/operations/{id}": { "get": { "operationId": "CustomerLifecycleController_operation", "parameters": [ { "name": "id", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful operation.", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": true } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "tags": [ "Managed Inference" ], "summary": "Read operation state" } }, "/v1/models/{id}/health": { "get": { "operationId": "ModelsController_health", "parameters": [ { "name": "id", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Persisted contract response; runtime readiness is not implied", "content": { "application/json": { "schema": { "type": "object", "properties": { "model": { "type": "string" }, "status": { "type": "string", "enum": [ "available", "unavailable" ] }, "reason": { "type": "string" }, "acceptingRequests": { "type": "boolean" }, "runtimeCapabilities": { "type": "object", "properties": { "adapter": { "type": "string" }, "liveQualified": { "type": "boolean" }, "version": { "type": "string" }, "textChatTokenization": { "type": "boolean" }, "requestStatus": { "type": "string" }, "cancellationAcknowledgement": { "type": "string" }, "disconnectCancellation": { "type": "string" }, "modelWeightRevision": { "type": "string" } } } } } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "summary": "Model readiness, separate from API/database health", "tags": [ "Managed Inference" ] } }, "/v1/chat/completions": { "post": { "description": "Bounded text/tool Chat Completions with JSON/SSE and qualified reasoning deltas. Active endpoint revision admission and durable request mapping precede dispatch. Missing Idempotency-Key creates an independent attempt; explicit-key replay never redispatches. Unkeyed client retries may create new attempts after ambiguous failures. Response content is not retained. Legacy text fixtures remain compatible; no implicit fallback from an assigned unready V1 route, images or customer-selected upstream URL.", "operationId": "InferenceController_chat", "parameters": [ { "name": "Idempotency-Key", "required": false, "in": "header", "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "example": "unique-key-for-this-operation" }, { "in": "header", "name": "X-Infermax-Attribution", "required": false, "description": "Optional JSON: feature (DIRECT_API, AGENT, SUB_AGENT, TASK), runId UUID, parentRunId UUID. Max1024 characters. SUB_AGENT requires an existing same-project parent. Immutable lineage; no content or personal data. Text modality is server-recorded; omitted feature stays unknown.", "schema": { "type": "string", "maxLength": 1024 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "model", "messages" ], "properties": { "model": { "type": "string", "pattern": "^[a-z0-9][a-z0-9._-]{1,99}$" }, "messages": { "type": "array", "minItems": 1, "maxItems": 64, "items": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "role", "content" ], "properties": { "role": { "type": "string", "enum": [ "system", "user" ] }, "content": { "type": "string", "maxLength": 32000 } } }, { "type": "object", "additionalProperties": false, "required": [ "role", "content" ], "properties": { "role": { "type": "string", "enum": [ "assistant" ] }, "content": { "type": "string", "maxLength": 32000, "nullable": true }, "reasoning_content": { "type": "string", "maxLength": 32000, "nullable": true }, "tool_calls": { "type": "array", "minItems": 1, "maxItems": 32, "items": { "type": "object", "additionalProperties": false, "required": [ "id", "type", "function" ], "properties": { "id": { "type": "string", "maxLength": 128 }, "type": { "type": "string", "enum": [ "function" ] }, "function": { "type": "object", "additionalProperties": false, "required": [ "name", "arguments" ], "properties": { "name": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,64}$" }, "arguments": { "type": "string", "maxLength": 32000 } } } } } } } }, { "type": "object", "additionalProperties": false, "required": [ "role", "content", "tool_call_id" ], "properties": { "role": { "type": "string", "enum": [ "tool" ] }, "content": { "type": "string", "maxLength": 32000 }, "tool_call_id": { "type": "string", "maxLength": 128 } } } ] } }, "stream": { "type": "boolean", "default": false }, "max_completion_tokens": { "type": "integer", "minimum": 1, "maximum": 100000, "default": 256 }, "max_tokens": { "type": "integer", "minimum": 1, "maximum": 100000, "description": "Alias; if both caps are supplied they must agree." }, "tools": { "type": "array", "maxItems": 32, "items": { "type": "object", "additionalProperties": false, "required": [ "type", "function" ], "properties": { "type": { "type": "string", "enum": [ "function" ] }, "function": { "type": "object", "additionalProperties": false, "required": [ "name", "parameters" ], "properties": { "name": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,64}$" }, "description": { "type": "string", "maxLength": 8192 }, "parameters": { "type": "object", "additionalProperties": true }, "strict": { "type": "boolean" } } } } } }, "tool_choice": { "oneOf": [ { "type": "string", "enum": [ "auto", "none", "required" ] }, { "type": "object", "additionalProperties": false, "required": [ "type", "function" ], "properties": { "type": { "type": "string", "enum": [ "function" ] }, "function": { "type": "object", "additionalProperties": false, "required": [ "name" ], "properties": { "name": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,64}$" } } } } } ] }, "stream_options": { "type": "object", "additionalProperties": false, "required": [ "include_usage" ], "properties": { "include_usage": { "type": "boolean" } } }, "temperature": { "type": "number", "minimum": 0, "maximum": 2 }, "top_p": { "type": "number", "exclusiveMinimum": true, "minimum": 0, "maximum": 1 }, "parallel_tool_calls": { "type": "boolean" } } } } } }, "responses": { "200": { "description": "Completion or SSE stream; runtime-reported usage only", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "object": { "type": "string" }, "model": { "type": "string" }, "choices": { "type": "array", "items": { "type": "object" } }, "usage": { "type": "object" } } } }, "text/event-stream": { "schema": { "type": "string" } } }, "headers": { "X-Infermax-Request-Id": { "description": "UUID of the durably registered project-scoped inference attempt. Present only after registration, including recorded rejection/cancellation. Explicit-key replay references the same attempt and never proves another dispatch or charge. Not the ingress X-Request-Id or a trace ID. Missing header means no receipt correlation can be inferred.", "schema": { "type": "string", "format": "uuid" } } } }, "400": { "description": "Invalid request or CONTEXT_LIMIT_EXCEEDED: chat-template input plus requested output cannot fit the catalog/runtime window; no inference dispatch or usage", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string", "format": "uuid" }, "retryable": { "type": "boolean" }, "dispatched": { "type": "boolean" } } } } } } }, "headers": { "X-Infermax-Request-Id": { "description": "UUID of the durably registered project-scoped inference attempt. Present only after registration, including recorded rejection/cancellation. Explicit-key replay references the same attempt and never proves another dispatch or charge. Not the ingress X-Request-Id or a trace ID. Missing header means no receipt correlation can be inferred.", "schema": { "type": "string", "format": "uuid" } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "REPLAY_UNAVAILABLE: inspect request status; content is not retained", "headers": { "X-Infermax-Request-Id": { "description": "UUID of the durably registered project-scoped inference attempt. Present only after registration, including recorded rejection/cancellation. Explicit-key replay references the same attempt and never proves another dispatch or charge. Not the ingress X-Request-Id or a trace ID. Missing header means no receipt correlation can be inferred.", "schema": { "type": "string", "format": "uuid" } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "CONCURRENCY_LIMIT; Retry-After: 1", "headers": { "X-Infermax-Request-Id": { "description": "UUID of the durably registered project-scoped inference attempt. Present only after registration, including recorded rejection/cancellation. Explicit-key replay references the same attempt and never proves another dispatch or charge. Not the ingress X-Request-Id or a trace ID. Missing header means no receipt correlation can be inferred.", "schema": { "type": "string", "format": "uuid" } } } }, "502": { "description": "Runtime failed or deadline exceeded; inspect durable request status before retrying", "headers": { "X-Infermax-Request-Id": { "description": "UUID of the durably registered project-scoped inference attempt. Present only after registration, including recorded rejection/cancellation. Explicit-key replay references the same attempt and never proves another dispatch or charge. Not the ingress X-Request-Id or a trace ID. Missing header means no receipt correlation can be inferred.", "schema": { "type": "string", "format": "uuid" } } } }, "503": { "description": "MODEL_NOT_READY or tokenizer/version/model/revision/template verification failed or timed out. No inference dispatched; no token usage or monetary event created.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string", "description": "Bounded readiness/admission rejection code; includes MODEL_NOT_READY and tokenizer/lineage failures" }, "message": { "type": "string" }, "type": { "type": "string" }, "requestId": { "type": "string", "format": "uuid" }, "retryable": { "type": "boolean", "enum": [ false ] } } } } }, "example": { "error": { "code": "MODEL_NOT_READY", "message": "No qualified model runtime is connected. No inference was executed or billed.", "type": "service_unavailable", "requestId": "123e4567-e89b-12d3-a456-426614174000", "retryable": false } } } }, "headers": { "X-Infermax-Request-Id": { "description": "UUID of the durably registered project-scoped inference attempt. Present only after registration, including recorded rejection/cancellation. Explicit-key replay references the same attempt and never proves another dispatch or charge. Not the ingress X-Request-Id or a trace ID. Missing header means no receipt correlation can be inferred.", "schema": { "type": "string", "format": "uuid" } } } } }, "security": [ { "bearer": [] } ], "summary": "Chat completion or SSE stream from an admitted private runtime", "tags": [ "Managed Inference" ] } }, "/v1/inference/limits": { "get": { "operationId": "InferenceController_limits", "parameters": [], "responses": { "200": { "description": "Persisted contract response; runtime readiness is not implied", "content": { "application/json": { "schema": { "type": "object", "properties": { "configuredConcurrency": { "type": "integer" }, "acceptingRequests": { "type": "boolean" }, "runtimeCapabilities": { "type": "object", "properties": { "adapter": { "type": "string" }, "liveQualified": { "type": "boolean" }, "version": { "type": "string" }, "textChatTokenization": { "type": "boolean" }, "requestStatus": { "type": "string" }, "cancellationAcknowledgement": { "type": "string" }, "disconnectCancellation": { "type": "string" }, "modelWeightRevision": { "type": "string" } } }, "runtimeConnected": { "type": "boolean" } } } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "tags": [ "Managed Inference" ], "summary": "GET /v1/inference/limits" } }, "/v1/inference/requests": { "get": { "operationId": "InferenceController_requests", "parameters": [ { "name": "limit", "required": false, "in": "query", "schema": { "maximum": 100, "default": 50, "type": "number" } }, { "name": "after", "required": false, "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Persisted contract response; runtime readiness is not implied", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "project_id": { "type": "string", "format": "uuid" }, "api_key_id": { "type": "string", "format": "uuid" }, "model_id": { "type": "string" }, "deployment_id": { "type": "string", "format": "uuid", "nullable": true }, "state": { "type": "string", "enum": [ "REJECTED", "ADMITTED", "RUNNING", "SUCCEEDED", "FAILED", "CANCELLED", "UNKNOWN" ] }, "error_code": { "type": "string", "nullable": true }, "max_output_tokens": { "type": "integer" }, "runtime_digest": { "type": "string", "nullable": true }, "probe_id": { "type": "string", "format": "uuid", "nullable": true }, "deadline_at": { "type": "string", "format": "date-time" }, "started_at": { "type": "string", "format": "date-time" }, "completed_at": { "type": "string", "format": "date-time", "nullable": true }, "dispatch_started_at": { "type": "string", "format": "date-time", "nullable": true, "description": "Durable inference dispatch boundary; does not prove GPU execution." } } } }, "nextCursor": { "type": "string", "format": "uuid", "nullable": true } } } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "tags": [ "Managed Inference" ], "summary": "List inference requests" } }, "/v1/inference/requests/{id}": { "get": { "operationId": "InferenceController_request", "parameters": [ { "name": "id", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Persisted contract response; runtime readiness is not implied", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "project_id": { "type": "string", "format": "uuid" }, "api_key_id": { "type": "string", "format": "uuid" }, "model_id": { "type": "string" }, "deployment_id": { "type": "string", "format": "uuid", "nullable": true }, "state": { "type": "string", "enum": [ "REJECTED", "ADMITTED", "RUNNING", "SUCCEEDED", "FAILED", "CANCELLED", "UNKNOWN" ] }, "error_code": { "type": "string", "nullable": true }, "max_output_tokens": { "type": "integer" }, "runtime_digest": { "type": "string", "nullable": true }, "probe_id": { "type": "string", "format": "uuid", "nullable": true }, "deadline_at": { "type": "string", "format": "date-time" }, "started_at": { "type": "string", "format": "date-time" }, "completed_at": { "type": "string", "format": "date-time", "nullable": true }, "dispatch_started_at": { "type": "string", "format": "date-time", "nullable": true, "description": "Durable inference dispatch boundary; does not prove GPU execution." } } } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "tags": [ "Managed Inference" ], "summary": "Read an inference request" } }, "/v1/inference/requests/{id}/cancel": { "post": { "operationId": "InferenceController_cancel", "parameters": [ { "name": "Idempotency-Key", "required": true, "in": "header", "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "example": "unique-key-for-this-operation" }, { "name": "id", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful operation.", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": true } } } }, "202": { "description": "" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "tags": [ "Managed Inference" ], "summary": "Request cancellation" } }, "/v1/requests/{id}/receipt": { "get": { "operationId": "ReceiptController_read[0]", "parameters": [ { "name": "id", "required": true, "in": "path", "schema": { "type": "string" } }, { "name": "project", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Project-scoped durable attempt and original usage receipt. Export acknowledgement is not native meter reconciliation or a charge.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "request": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "string", "format": "uuid" }, "state": { "type": "string" }, "modelId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time" }, "completedAt": { "type": "string", "format": "date-time", "nullable": true } }, "required": [ "id", "state", "modelId", "startedAt", "completedAt" ] }, "receipt": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "NOT_RECORDED" ] } }, "required": [ "status" ] }, { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "RECORDED" ] }, "id": { "type": "string", "format": "uuid" }, "sourceEventId": { "type": "string" }, "recordedAt": { "type": "string", "format": "date-time" }, "measurementStatus": { "type": "string", "enum": [ "MEASURED", "UNKNOWN" ] }, "executionMode": { "type": "string", "enum": [ "REAL", "SIMULATED" ] }, "inputTokens": { "type": "string", "nullable": true }, "outputTokens": { "type": "string", "nullable": true }, "cachedInputTokens": { "type": "string", "nullable": true } }, "required": [ "status", "id", "sourceEventId", "recordedAt", "measurementStatus", "executionMode", "inputTokens", "outputTokens", "cachedInputTokens" ] } ] }, "export": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "NOT_ENQUEUED", "ACKNOWLEDGED", "FAILED", "PENDING" ] }, "acknowledgedAt": { "type": "string", "format": "date-time", "nullable": true }, "attempts": { "type": "integer", "nullable": true, "minimum": 0 }, "reconciliation": { "type": "string", "enum": [ "NOT_CHECKED" ] } }, "required": [ "status", "acknowledgedAt", "attempts", "reconciliation" ] }, "trace": { "type": "object", "additionalProperties": false, "properties": { "status": { "type": "string", "enum": [ "RESTRICTED", "UNAVAILABLE", "RECORDED" ] }, "reason": { "type": "string" }, "traceId": { "type": "string", "pattern": "^[a-f0-9]{32}$" }, "spanId": { "type": "string", "pattern": "^[a-f0-9]{16}$" }, "recordedAt": { "type": "string", "format": "date-time" }, "ingestion": { "type": "string", "enum": [ "NOT_VERIFIED" ] }, "links": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "kind": { "type": "string", "enum": [ "LANGFUSE", "SIGNOZ" ] }, "label": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "authenticationRequired": { "type": "boolean", "enum": [ true ] } }, "required": [ "kind", "label", "url", "authenticationRequired" ] } } }, "required": [ "status", "links" ] }, "financialStatus": { "type": "string", "enum": [ "NOT_EVALUATED" ] } }, "required": [ "request", "receipt", "export", "trace", "financialStatus" ] } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "tags": [ "Managed Inference" ], "summary": "Read a request receipt" } }, "/v1/compute/offers": { "get": { "operationId": "CustomerController_offers", "parameters": [ { "name": "limit", "required": false, "in": "query", "schema": { "maximum": 100, "default": 50, "type": "number" } }, { "name": "after", "required": false, "in": "query", "schema": { "type": "string" } }, { "name": "search", "required": false, "in": "query", "schema": { "type": "string" } }, { "name": "region", "required": false, "in": "query", "schema": { "type": "string" } }, { "name": "availability", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "AVAILABLE", "UNAVAILABLE" ] } } ], "responses": { "200": { "description": "Successful operation.", "content": { "application/json": { "schema": { "type": "object", "required": [ "items", "nextCursor" ], "properties": { "items": { "type": "array", "items": { "type": "object", "required": [ "id", "pool_id" ], "properties": { "id": { "type": "string", "format": "uuid" }, "pool_id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "published": { "type": "boolean" }, "price_per_unit_hour": { "type": "string", "nullable": true }, "currency": { "type": "string" }, "rate_status": { "type": "string", "enum": [ "UNKNOWN", "FIXTURE", "ACCEPTED" ] }, "rate_version": { "type": "string", "format": "uuid" }, "created_at": { "type": "string", "format": "date-time" }, "provider_id": { "type": "string", "format": "uuid" }, "gpu_model": { "type": "string" }, "region": { "type": "string" }, "unit_gpus": { "type": "integer" }, "execution_mode": { "type": "string" }, "observed_at": { "type": "string", "format": "date-time" }, "available_units": { "type": "string", "description": "Current availability in allocation units; reservation rechecks atomically." } } } }, "nextCursor": { "type": "string", "format": "uuid", "nullable": true } } } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "summary": "List eligible offers; availability is not a hold", "tags": [ "Compute Access" ] } }, "/v1/compute/offers/{id}": { "get": { "operationId": "CustomerController_offer", "parameters": [ { "name": "id", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful operation.", "content": { "application/json": { "schema": { "type": "object", "required": [ "id", "pool_id" ], "properties": { "id": { "type": "string", "format": "uuid" }, "pool_id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "published": { "type": "boolean" }, "price_per_unit_hour": { "type": "string", "nullable": true }, "currency": { "type": "string" }, "rate_status": { "type": "string", "enum": [ "UNKNOWN", "FIXTURE", "ACCEPTED" ] }, "rate_version": { "type": "string", "format": "uuid" }, "created_at": { "type": "string", "format": "date-time" }, "provider_id": { "type": "string", "format": "uuid" }, "gpu_model": { "type": "string" }, "region": { "type": "string" }, "unit_gpus": { "type": "integer" }, "execution_mode": { "type": "string" }, "observed_at": { "type": "string", "format": "date-time" }, "available_units": { "type": "string", "description": "Current availability in allocation units; reservation rechecks atomically." } } } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "tags": [ "Compute Access" ], "summary": "GET /v1/compute/offers/{id}" } }, "/v1/compute/limits": { "get": { "operationId": "CustomerController_limits", "parameters": [], "responses": { "200": { "description": "Successful operation.", "content": { "application/json": { "schema": { "type": "object", "properties": { "gpu_quota": { "type": "integer" }, "occupied_gpus": { "type": "string" } } } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "tags": [ "Compute Access" ], "summary": "GET /v1/compute/limits" } }, "/v1/compute/offers/{id}/storage": { "get": { "operationId": "ManagedComputeController_storage", "parameters": [ { "name": "id", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful operation.", "content": { "application/json": { "schema": { "type": "object", "required": [ "id", "pool_id" ], "properties": { "id": { "type": "string", "format": "uuid" }, "pool_id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "published": { "type": "boolean" }, "price_per_unit_hour": { "type": "string", "nullable": true }, "currency": { "type": "string" }, "rate_status": { "type": "string", "enum": [ "UNKNOWN", "FIXTURE", "ACCEPTED" ] }, "rate_version": { "type": "string", "format": "uuid" }, "created_at": { "type": "string", "format": "date-time" }, "provider_id": { "type": "string", "format": "uuid" }, "gpu_model": { "type": "string" }, "region": { "type": "string" }, "unit_gpus": { "type": "integer" }, "execution_mode": { "type": "string" }, "observed_at": { "type": "string", "format": "date-time" }, "available_units": { "type": "string", "description": "Current availability in allocation units; reservation rechecks atomically." } } } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "tags": [ "Compute Access" ], "summary": "Read storage options for an offer" } }, "/v1/compute/quotes": { "post": { "operationId": "ManagedComputeController_quote", "parameters": [ { "name": "Idempotency-Key", "required": true, "in": "header", "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "example": "unique-key-for-this-operation" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagedQuoteInput" } } } }, "responses": { "201": { "description": "Successful operation.", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": true } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "tags": [ "Compute Access" ], "summary": "Quote a compute request" } }, "/v1/compute/storage/profiles": { "get": { "operationId": "StorageController_profiles", "parameters": [], "responses": { "200": { "description": "Successful operation.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "items": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "string" }, "version": { "type": "integer", "minimum": 1 }, "digest": { "type": "string" }, "providerId": { "type": "string", "format": "uuid" }, "executionMode": { "type": "string", "enum": [ "SIMULATED", "REAL" ] }, "controller": { "type": "string", "enum": [ "FIXTURE", "DSTACK" ] }, "regions": { "type": "array", "items": { "type": "string" } }, "sizesGiB": { "type": "array", "items": { "type": "integer", "minimum": 1 } }, "supportedActions": { "type": "array", "items": { "type": "string", "enum": [ "CREATE", "ATTACH", "DETACH", "RETAIN", "DELETE" ] } }, "available": { "type": "boolean" }, "reason": { "type": "string", "nullable": true } }, "required": [ "id", "version", "digest", "providerId", "executionMode", "controller", "regions", "sizesGiB", "supportedActions", "available", "reason" ] } } }, "required": [ "items" ] } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "tags": [ "Compute Access" ], "summary": "List eligible storage profiles" } }, "/v1/compute/storage/quotes": { "post": { "operationId": "StorageController_quote", "parameters": [ { "name": "Idempotency-Key", "required": true, "in": "header", "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "example": "unique-key-for-this-operation" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "profileId": { "type": "string", "maxLength": 100 }, "profileVersion": { "type": "integer", "minimum": 1 }, "region": { "type": "string", "maxLength": 100 }, "sizeGiB": { "type": "integer", "minimum": 1, "maximum": 1048576 }, "liabilityEndAt": { "type": "string", "format": "date-time" } }, "required": [ "profileId", "profileVersion", "region", "sizeGiB", "liabilityEndAt" ] } } } }, "responses": { "201": { "description": "Successful operation.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "string", "format": "uuid" }, "project_id": { "type": "string", "format": "uuid" }, "provider_id": { "type": "string", "format": "uuid" }, "profile_digest": { "type": "string" }, "execution_mode": { "type": "string", "enum": [ "SIMULATED", "REAL" ] }, "region": { "type": "string" }, "size_gib": { "type": "integer", "minimum": 1 }, "currency": { "type": "string", "enum": [ "USD" ] }, "liability_micros": { "type": "string", "pattern": "^[0-9]+$", "nullable": true }, "liability_end_at": { "type": "string", "format": "date-time" }, "valid_until": { "type": "string", "format": "date-time" }, "terms_digest": { "type": "string", "nullable": true }, "source_ref": { "type": "string", "nullable": true }, "created_by": { "type": "string", "format": "uuid" }, "created_at": { "type": "string", "format": "date-time" } }, "required": [ "id", "project_id", "provider_id", "profile_digest", "execution_mode", "region", "size_gib", "currency", "liability_micros", "liability_end_at", "valid_until", "terms_digest", "source_ref", "created_by", "created_at" ] } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "tags": [ "Compute Access" ], "summary": "Quote storage" } }, "/v1/compute/storage/volumes": { "post": { "operationId": "StorageController_create", "parameters": [ { "name": "Idempotency-Key", "required": true, "in": "header", "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "example": "unique-key-for-this-operation" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "quoteId": { "type": "string", "format": "uuid" }, "retainOnRelease": { "type": "boolean" } }, "required": [ "quoteId", "retainOnRelease" ] } } } }, "responses": { "201": { "description": "Successful operation.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "string", "format": "uuid" }, "project_id": { "type": "string", "format": "uuid" }, "provider_id": { "type": "string", "format": "uuid" }, "profile_digest": { "type": "string" }, "execution_mode": { "type": "string", "enum": [ "SIMULATED", "REAL" ] }, "region": { "type": "string" }, "size_gib": { "type": "integer", "minimum": 1 }, "quote_id": { "type": "string", "format": "uuid" }, "controller": { "type": "string", "enum": [ "DSTACK", "FIXTURE" ] }, "retain_on_release": { "type": "boolean" }, "state": { "type": "string", "enum": [ "REQUESTED", "CREATING", "AVAILABLE", "ATTACHING", "ATTACHED", "DETACHING", "RETAINED", "DELETING", "ABSENT", "UNKNOWN", "FAILED" ] }, "liability_status": { "type": "string", "enum": [ "UNKNOWN", "RETAINED", "RELEASED" ] }, "version": { "type": "integer", "minimum": 0 }, "created_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" } }, "required": [ "id", "project_id", "provider_id", "profile_digest", "execution_mode", "region", "size_gib", "quote_id", "controller", "retain_on_release", "state", "liability_status", "version", "created_at", "updated_at" ] } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "tags": [ "Compute Access" ], "summary": "Create a storage volume" }, "get": { "operationId": "StorageController_list", "parameters": [], "responses": { "200": { "description": "Successful operation.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "items": { "type": "array", "maxItems": 100, "items": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "string", "format": "uuid" }, "project_id": { "type": "string", "format": "uuid" }, "provider_id": { "type": "string", "format": "uuid" }, "profile_digest": { "type": "string" }, "execution_mode": { "type": "string", "enum": [ "SIMULATED", "REAL" ] }, "region": { "type": "string" }, "size_gib": { "type": "integer", "minimum": 1 }, "retain_on_release": { "type": "boolean" }, "state": { "type": "string", "enum": [ "REQUESTED", "CREATING", "AVAILABLE", "ATTACHING", "ATTACHED", "DETACHING", "RETAINED", "DELETING", "ABSENT", "UNKNOWN", "FAILED" ] }, "liability_status": { "type": "string", "enum": [ "UNKNOWN", "RETAINED", "RELEASED" ] }, "version": { "type": "integer", "minimum": 0 }, "created_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" }, "cleanup_requested": { "type": "boolean" }, "currency": { "type": "string", "enum": [ "USD" ] }, "liability_micros": { "type": "string", "pattern": "^[0-9]+$", "nullable": true }, "liability_end_at": { "type": "string", "format": "date-time" } }, "required": [ "id", "project_id", "provider_id", "profile_digest", "execution_mode", "region", "size_gib", "retain_on_release", "state", "liability_status", "version", "created_at", "updated_at", "cleanup_requested", "currency", "liability_micros", "liability_end_at" ] } }, "truncated": { "type": "boolean" } }, "required": [ "items", "truncated" ] } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "tags": [ "Compute Access" ], "summary": "List project storage volumes" } }, "/v1/compute/storage/volumes/{id}": { "get": { "operationId": "StorageController_read", "parameters": [ { "name": "id", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful operation.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "string", "format": "uuid" }, "project_id": { "type": "string", "format": "uuid" }, "provider_id": { "type": "string", "format": "uuid" }, "profile_digest": { "type": "string" }, "execution_mode": { "type": "string", "enum": [ "SIMULATED", "REAL" ] }, "region": { "type": "string" }, "size_gib": { "type": "integer", "minimum": 1 }, "retain_on_release": { "type": "boolean" }, "state": { "type": "string", "enum": [ "REQUESTED", "CREATING", "AVAILABLE", "ATTACHING", "ATTACHED", "DETACHING", "RETAINED", "DELETING", "ABSENT", "UNKNOWN", "FAILED" ] }, "liability_status": { "type": "string", "enum": [ "UNKNOWN", "RETAINED", "RELEASED" ] }, "version": { "type": "integer", "minimum": 0 }, "created_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" }, "cleanup_requested": { "type": "boolean" }, "currency": { "type": "string", "enum": [ "USD" ] }, "liability_micros": { "type": "string", "pattern": "^[0-9]+$", "nullable": true }, "liability_end_at": { "type": "string", "format": "date-time" } }, "required": [ "id", "project_id", "provider_id", "profile_digest", "execution_mode", "region", "size_gib", "retain_on_release", "state", "liability_status", "version", "created_at", "updated_at", "cleanup_requested", "currency", "liability_micros", "liability_end_at" ] } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "tags": [ "Compute Access" ], "summary": "Read a storage volume" } }, "/v1/compute/storage/volumes/{id}/commands": { "post": { "operationId": "StorageController_command", "parameters": [ { "name": "id", "required": true, "in": "path", "schema": { "type": "string" } }, { "name": "Idempotency-Key", "required": true, "in": "header", "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "example": "unique-key-for-this-operation" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "oneOf": [ { "type": "object", "additionalProperties": false, "properties": { "action": { "type": "string", "enum": [ "ATTACH", "DETACH" ] }, "instanceId": { "type": "string", "format": "uuid" }, "expectedVersion": { "type": "integer", "minimum": 0 } }, "required": [ "action", "instanceId", "expectedVersion" ] }, { "type": "object", "additionalProperties": false, "properties": { "action": { "type": "string", "enum": [ "RETAIN", "DELETE" ] }, "expectedVersion": { "type": "integer", "minimum": 0 } }, "required": [ "action", "expectedVersion" ] } ] } } } }, "responses": { "201": { "description": "Successful operation.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "string", "format": "uuid" }, "project_id": { "type": "string", "format": "uuid" }, "provider_id": { "type": "string", "format": "uuid" }, "profile_digest": { "type": "string" }, "execution_mode": { "type": "string", "enum": [ "SIMULATED", "REAL" ] }, "region": { "type": "string" }, "size_gib": { "type": "integer", "minimum": 1 }, "quote_id": { "type": "string", "format": "uuid" }, "controller": { "type": "string", "enum": [ "DSTACK", "FIXTURE" ] }, "retain_on_release": { "type": "boolean" }, "state": { "type": "string", "enum": [ "REQUESTED", "CREATING", "AVAILABLE", "ATTACHING", "ATTACHED", "DETACHING", "RETAINED", "DELETING", "ABSENT", "UNKNOWN", "FAILED" ] }, "liability_status": { "type": "string", "enum": [ "UNKNOWN", "RETAINED", "RELEASED" ] }, "version": { "type": "integer", "minimum": 0 }, "created_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" } }, "required": [ "id", "project_id", "provider_id", "profile_digest", "execution_mode", "region", "size_gib", "quote_id", "controller", "retain_on_release", "state", "liability_status", "version", "created_at", "updated_at" ] } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "tags": [ "Compute Access" ], "summary": "Request a storage lifecycle command" } }, "/v1/compute/budget": { "get": { "operationId": "ComputeBudgetController_read", "parameters": [], "responses": { "200": { "description": "Successful operation.", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": true } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "tags": [ "Compute Access" ], "summary": "Read project compute budget" } }, "/v1/compute/waitlist": { "get": { "operationId": "WaitlistController_list", "parameters": [], "responses": { "200": { "description": "Successful operation.", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "intent_id": { "type": "string", "format": "uuid" }, "state": { "type": "string" }, "email_opt_in": { "type": "boolean" }, "created_at": { "type": "string", "format": "date-time" }, "spec": { "type": "object" } }, "required": [ "id", "intent_id", "state", "email_opt_in", "created_at", "spec" ], "additionalProperties": false } } }, "required": [ "items" ], "additionalProperties": false } } } }, "400": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "401": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "403": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "404": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "409": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "413": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "422": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "429": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "500": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "503": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } } }, "security": [ { "bearer": [] } ], "tags": [ "Compute Access" ], "summary": "List availability alerts" }, "post": { "operationId": "WaitlistController_join", "parameters": [ { "name": "Idempotency-Key", "required": true, "in": "header", "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "example": "unique-key-for-this-operation" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WaitlistInput" } } } }, "responses": { "201": { "description": "Successful operation.", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "state": { "type": "string" }, "email_opt_in": { "type": "boolean" } }, "required": [ "id", "state", "email_opt_in" ], "additionalProperties": false } } } }, "400": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "401": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "403": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "404": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "409": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "413": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "422": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "429": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "500": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "503": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } } }, "security": [ { "bearer": [] } ], "tags": [ "Compute Access" ], "summary": "Create an availability alert" } }, "/v1/compute/waitlist/{id}": { "get": { "operationId": "WaitlistController_detail", "parameters": [ { "name": "id", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful operation.", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "intent_id": { "type": "string", "format": "uuid" }, "state": { "type": "string" }, "email_opt_in": { "type": "boolean" }, "created_at": { "type": "string", "format": "date-time" }, "spec": { "type": "object" } }, "required": [ "id", "intent_id", "state", "email_opt_in", "created_at", "spec" ], "additionalProperties": false } } } }, "400": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "401": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "403": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "404": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "409": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "413": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "422": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "429": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "500": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "503": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } } }, "security": [ { "bearer": [] } ], "tags": [ "Compute Access" ], "summary": "Read an availability alert" } }, "/v1/compute/waitlist/{id}/cancel": { "post": { "operationId": "WaitlistController_cancel", "parameters": [ { "name": "id", "required": true, "in": "path", "schema": { "type": "string" } }, { "name": "Idempotency-Key", "required": true, "in": "header", "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "example": "unique-key-for-this-operation" } ], "responses": { "201": { "description": "Successful operation.", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "state": { "type": "string" } }, "required": [ "id", "state" ], "additionalProperties": false } } } }, "400": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "401": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "403": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "404": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "409": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "413": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "422": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "429": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "500": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "503": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } } }, "security": [ { "bearer": [] } ], "tags": [ "Compute Access" ], "summary": "Cancel an availability alert" } }, "/v1/compute/reservations": { "post": { "operationId": "CustomerController_reserve", "parameters": [ { "name": "Idempotency-Key", "required": true, "in": "header", "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "example": "unique-key-for-this-operation" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReservationInput" } } } }, "responses": { "201": { "description": "Successful operation.", "content": { "application/json": { "schema": { "type": "object", "required": [ "id", "state", "expires_at" ], "properties": { "id": { "type": "string", "format": "uuid" }, "project_id": { "type": "string", "format": "uuid" }, "pool_id": { "type": "string", "format": "uuid" }, "offer_id": { "type": "string", "format": "uuid" }, "units": { "type": "integer" }, "unit_gpus": { "type": "integer" }, "state": { "type": "string", "enum": [ "HELD", "CONSUMED", "CANCELLED", "EXPIRED" ] }, "expires_at": { "type": "string", "format": "date-time" }, "requested_end_at": { "type": "string", "format": "date-time" }, "price_snapshot": { "type": "object", "properties": { "amount": { "type": "string", "nullable": true }, "currency": { "type": "string" }, "unit": { "type": "string" }, "status": { "type": "string" }, "version": { "type": "string", "format": "uuid" } } }, "created_at": { "type": "string", "format": "date-time" } } } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "summary": "Hold whole allocation units for five minutes", "tags": [ "Compute Access" ] }, "get": { "operationId": "CustomerController_reservations", "parameters": [ { "name": "limit", "required": false, "in": "query", "schema": { "maximum": 100, "default": 50, "type": "number" } }, { "name": "after", "required": false, "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful operation.", "content": { "application/json": { "schema": { "type": "object", "required": [ "items", "nextCursor" ], "properties": { "items": { "type": "array", "items": { "type": "object", "required": [ "id", "state", "expires_at" ], "properties": { "id": { "type": "string", "format": "uuid" }, "project_id": { "type": "string", "format": "uuid" }, "pool_id": { "type": "string", "format": "uuid" }, "offer_id": { "type": "string", "format": "uuid" }, "units": { "type": "integer" }, "unit_gpus": { "type": "integer" }, "state": { "type": "string", "enum": [ "HELD", "CONSUMED", "CANCELLED", "EXPIRED" ] }, "expires_at": { "type": "string", "format": "date-time" }, "requested_end_at": { "type": "string", "format": "date-time" }, "price_snapshot": { "type": "object", "properties": { "amount": { "type": "string", "nullable": true }, "currency": { "type": "string" }, "unit": { "type": "string" }, "status": { "type": "string" }, "version": { "type": "string", "format": "uuid" } } }, "created_at": { "type": "string", "format": "date-time" } } } }, "nextCursor": { "type": "string", "format": "uuid", "nullable": true } } } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "tags": [ "Compute Access" ], "summary": "GET /v1/compute/reservations" } }, "/v1/compute/reservations/{id}": { "get": { "operationId": "CustomerController_reservation", "parameters": [ { "name": "id", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful operation.", "content": { "application/json": { "schema": { "type": "object", "required": [ "id", "state", "expires_at" ], "properties": { "id": { "type": "string", "format": "uuid" }, "project_id": { "type": "string", "format": "uuid" }, "pool_id": { "type": "string", "format": "uuid" }, "offer_id": { "type": "string", "format": "uuid" }, "units": { "type": "integer" }, "unit_gpus": { "type": "integer" }, "state": { "type": "string", "enum": [ "HELD", "CONSUMED", "CANCELLED", "EXPIRED" ] }, "expires_at": { "type": "string", "format": "date-time" }, "requested_end_at": { "type": "string", "format": "date-time" }, "price_snapshot": { "type": "object", "properties": { "amount": { "type": "string", "nullable": true }, "currency": { "type": "string" }, "unit": { "type": "string" }, "status": { "type": "string" }, "version": { "type": "string", "format": "uuid" } } }, "created_at": { "type": "string", "format": "date-time" } } } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "tags": [ "Compute Access" ], "summary": "GET /v1/compute/reservations/{id}" } }, "/v1/compute/reservations/{id}/cancel": { "post": { "operationId": "CustomerController_cancel", "parameters": [ { "name": "id", "required": true, "in": "path", "schema": { "type": "string" } }, { "name": "Idempotency-Key", "required": true, "in": "header", "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "example": "unique-key-for-this-operation" } ], "responses": { "200": { "description": "Successful operation.", "content": { "application/json": { "schema": { "type": "object", "required": [ "id", "state", "expires_at" ], "properties": { "id": { "type": "string", "format": "uuid" }, "project_id": { "type": "string", "format": "uuid" }, "pool_id": { "type": "string", "format": "uuid" }, "offer_id": { "type": "string", "format": "uuid" }, "units": { "type": "integer" }, "unit_gpus": { "type": "integer" }, "state": { "type": "string", "enum": [ "HELD", "CONSUMED", "CANCELLED", "EXPIRED" ] }, "expires_at": { "type": "string", "format": "date-time" }, "requested_end_at": { "type": "string", "format": "date-time" }, "price_snapshot": { "type": "object", "properties": { "amount": { "type": "string", "nullable": true }, "currency": { "type": "string" }, "unit": { "type": "string" }, "status": { "type": "string" }, "version": { "type": "string", "format": "uuid" } } }, "created_at": { "type": "string", "format": "date-time" } } } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "tags": [ "Compute Access" ], "summary": "POST /v1/compute/reservations/{id}/cancel" } }, "/v1/compute/instances": { "post": { "operationId": "CustomerController_create", "parameters": [ { "name": "Idempotency-Key", "required": true, "in": "header", "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "example": "unique-key-for-this-operation" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InstanceInput" } } } }, "responses": { "202": { "description": "Durable intent accepted. Poll the resource; compute is not ready yet.", "content": { "application/json": { "schema": { "type": "object", "required": [ "id", "state", "execution_mode", "reservation_id" ], "properties": { "id": { "type": "string", "format": "uuid" }, "project_id": { "type": "string", "format": "uuid" }, "reservation_id": { "type": "string", "format": "uuid" }, "pool_id": { "type": "string", "format": "uuid" }, "units": { "type": "integer" }, "unit_gpus": { "type": "integer" }, "execution_mode": { "type": "string", "enum": [ "SIMULATED", "REAL" ] }, "state": { "type": "string", "enum": [ "REQUESTED", "PROVISIONING", "READY", "RECONCILING", "DRAINING", "RELEASED" ] }, "external_id": { "type": "string", "format": "uuid", "nullable": true }, "requested_end_at": { "type": "string", "format": "date-time" }, "expiry_review_required": { "type": "boolean" }, "version": { "type": "integer" }, "created_at": { "type": "string", "format": "date-time" }, "ready_at": { "type": "string", "format": "date-time", "nullable": true }, "released_at": { "type": "string", "format": "date-time", "nullable": true } } } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "summary": "Consume hold and enqueue provisioning; poll returned instance ID", "tags": [ "Compute Access" ] }, "get": { "operationId": "CustomerController_instances", "parameters": [ { "name": "limit", "required": false, "in": "query", "schema": { "maximum": 100, "default": 50, "type": "number" } }, { "name": "after", "required": false, "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful operation.", "content": { "application/json": { "schema": { "type": "object", "required": [ "items", "nextCursor" ], "properties": { "items": { "type": "array", "items": { "type": "object", "required": [ "id", "state", "execution_mode", "reservation_id" ], "properties": { "id": { "type": "string", "format": "uuid" }, "project_id": { "type": "string", "format": "uuid" }, "reservation_id": { "type": "string", "format": "uuid" }, "pool_id": { "type": "string", "format": "uuid" }, "units": { "type": "integer" }, "unit_gpus": { "type": "integer" }, "execution_mode": { "type": "string", "enum": [ "SIMULATED", "REAL" ] }, "state": { "type": "string", "enum": [ "REQUESTED", "PROVISIONING", "READY", "RECONCILING", "DRAINING", "RELEASED" ] }, "external_id": { "type": "string", "format": "uuid", "nullable": true }, "requested_end_at": { "type": "string", "format": "date-time" }, "expiry_review_required": { "type": "boolean" }, "version": { "type": "integer" }, "created_at": { "type": "string", "format": "date-time" }, "ready_at": { "type": "string", "format": "date-time", "nullable": true }, "released_at": { "type": "string", "format": "date-time", "nullable": true } } } }, "nextCursor": { "type": "string", "format": "uuid", "nullable": true } } } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "tags": [ "Compute Access" ], "summary": "GET /v1/compute/instances" } }, "/v1/compute/instances/{id}": { "get": { "operationId": "CustomerController_instance", "parameters": [ { "name": "id", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful operation.", "content": { "application/json": { "schema": { "type": "object", "required": [ "id", "state", "execution_mode", "reservation_id" ], "properties": { "id": { "type": "string", "format": "uuid" }, "project_id": { "type": "string", "format": "uuid" }, "reservation_id": { "type": "string", "format": "uuid" }, "pool_id": { "type": "string", "format": "uuid" }, "units": { "type": "integer" }, "unit_gpus": { "type": "integer" }, "execution_mode": { "type": "string", "enum": [ "SIMULATED", "REAL" ] }, "state": { "type": "string", "enum": [ "REQUESTED", "PROVISIONING", "READY", "RECONCILING", "DRAINING", "RELEASED" ] }, "external_id": { "type": "string", "format": "uuid", "nullable": true }, "requested_end_at": { "type": "string", "format": "date-time" }, "expiry_review_required": { "type": "boolean" }, "version": { "type": "integer" }, "created_at": { "type": "string", "format": "date-time" }, "ready_at": { "type": "string", "format": "date-time", "nullable": true }, "released_at": { "type": "string", "format": "date-time", "nullable": true } } } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "tags": [ "Compute Access" ], "summary": "GET /v1/compute/instances/{id}" }, "delete": { "operationId": "CustomerController_release", "parameters": [ { "name": "id", "required": true, "in": "path", "schema": { "type": "string" } }, { "name": "Idempotency-Key", "required": true, "in": "header", "schema": { "type": "string", "minLength": 1, "maxLength": 128 }, "example": "unique-key-for-this-operation" } ], "responses": { "202": { "description": "Durable intent accepted. Poll the resource; compute is not ready yet.", "content": { "application/json": { "schema": { "type": "object", "required": [ "id", "state", "execution_mode", "reservation_id" ], "properties": { "id": { "type": "string", "format": "uuid" }, "project_id": { "type": "string", "format": "uuid" }, "reservation_id": { "type": "string", "format": "uuid" }, "pool_id": { "type": "string", "format": "uuid" }, "units": { "type": "integer" }, "unit_gpus": { "type": "integer" }, "execution_mode": { "type": "string", "enum": [ "SIMULATED", "REAL" ] }, "state": { "type": "string", "enum": [ "REQUESTED", "PROVISIONING", "READY", "RECONCILING", "DRAINING", "RELEASED" ] }, "external_id": { "type": "string", "format": "uuid", "nullable": true }, "requested_end_at": { "type": "string", "format": "date-time" }, "expiry_review_required": { "type": "boolean" }, "version": { "type": "integer" }, "created_at": { "type": "string", "format": "date-time" }, "ready_at": { "type": "string", "format": "date-time", "nullable": true }, "released_at": { "type": "string", "format": "date-time", "nullable": true } } } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "summary": "Request release; capacity remains occupied until cleanup is verified", "tags": [ "Compute Access" ] } }, "/v1/compute/instances/{id}/events": { "get": { "operationId": "CustomerController_events", "parameters": [ { "name": "id", "required": true, "in": "path", "schema": { "type": "string" } }, { "name": "after", "required": false, "in": "query", "schema": { "default": 0, "type": "number" } } ], "responses": { "200": { "description": "Successful operation.", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "sequence": { "type": "string" }, "type": { "type": "string" }, "data": { "type": "object" }, "created_at": { "type": "string", "format": "date-time" } } } } } } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "tags": [ "Compute Access" ], "summary": "GET /v1/compute/instances/{id}/events" } }, "/v1/compute/instances/{id}/access": { "get": { "operationId": "CustomerController_access", "parameters": [ { "name": "id", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful operation.", "content": { "application/json": { "schema": { "type": "object", "properties": { "instanceId": { "type": "string", "format": "uuid" }, "status": { "type": "string", "enum": [ "DEFERRED" ] }, "executionMode": { "type": "string" }, "connection": { "type": "string", "nullable": true }, "reason": { "type": "string" } } } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "summary": "Access status; transport integration deferred until provider access arrives", "tags": [ "Compute Access" ] } }, "/v1/allocations/{id}": { "get": { "operationId": "AllocationsController_get", "parameters": [ { "name": "id", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful operation.", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": true } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "tags": [ "Compute Access" ], "summary": "Read allocation state" } }, "/v1/infrastructure/operations/{id}": { "get": { "operationId": "AllocationsController_operation", "parameters": [ { "name": "id", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful operation.", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": true } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "tags": [ "Compute Access" ], "summary": "Read infrastructure operation state" } }, "/v1/usage/report": { "get": { "operationId": "ProjectUsageController_report", "parameters": [ { "name": "from", "required": true, "in": "query", "schema": { "type": "string" } }, { "name": "to", "required": true, "in": "query", "schema": { "type": "string" } }, { "name": "timezone", "required": true, "in": "query", "schema": { "default": "UTC", "allOf": [ { "$ref": "#/components/schemas/Object" } ] } }, { "name": "bucket", "required": true, "in": "query", "schema": { "type": "string", "enum": [ "day", "week", "month" ] } }, { "name": "groupBy", "required": true, "in": "query", "schema": { "type": "string", "enum": [ "project", "key", "deployment", "model", "modality", "feature", "run" ] } }, { "name": "projectId", "required": false, "in": "query", "schema": { "type": "string" } }, { "name": "keyId", "required": false, "in": "query", "schema": { "type": "string" } }, { "name": "deploymentId", "required": false, "in": "query", "description": "Legacy deployment or serving revision ID; rows retain both identities separately.", "schema": { "type": "string" } }, { "name": "model", "required": false, "in": "query", "schema": { "type": "string" } }, { "name": "modality", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "TEXT", "UNKNOWN" ] } }, { "name": "feature", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "DIRECT_API", "AGENT", "SUB_AGENT", "TASK", "UNKNOWN" ] } }, { "name": "executionMode", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "SIMULATED", "REAL", "UNKNOWN" ] } }, { "name": "rootRunId", "required": false, "in": "query", "description": "Include a project-scoped run and all descendants, counting each request once.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful operation.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "scope", "authorizedProjectIds", "from", "to", "timezone", "bucket", "groupBy", "rootRunId", "semantics", "items" ], "properties": { "scope": { "type": "string", "enum": [ "PROJECT", "AUTHORIZED_WORKSPACE_PROJECTS" ] }, "authorizedProjectIds": { "type": "array", "items": { "type": "string", "format": "uuid" } }, "from": { "type": "string", "format": "date-time" }, "to": { "type": "string", "format": "date-time" }, "timezone": { "type": "string" }, "bucket": { "type": "string", "enum": [ "day", "week", "month" ] }, "groupBy": { "type": "string", "enum": [ "project", "key", "deployment", "model", "modality", "feature", "run" ] }, "rootRunId": { "type": "string", "format": "uuid", "nullable": true }, "semantics": { "type": "object", "additionalProperties": false, "required": [ "time", "window", "weekStart", "units", "money", "lineage", "empty", "attribution" ], "properties": { "time": { "type": "string" }, "window": { "type": "string" }, "weekStart": { "type": "string" }, "units": { "type": "string" }, "money": { "type": "string" }, "lineage": { "type": "string" }, "empty": { "type": "string" }, "attribution": { "type": "string" } } }, "items": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "bucket_start", "execution_mode", "requests", "succeeded", "unsuccessful", "pending_or_unknown", "measured_records", "unknown_records", "unrecorded_requests", "known_input_tokens", "known_output_tokens", "input_tokens", "output_tokens" ], "properties": { "bucket_start": { "type": "string", "format": "date-time" }, "execution_mode": { "type": "string", "enum": [ "SIMULATED", "REAL", "UNKNOWN", "CONFLICT" ] }, "requests": { "type": "string", "pattern": "^[0-9]+$" }, "succeeded": { "type": "string", "pattern": "^[0-9]+$" }, "unsuccessful": { "type": "string", "pattern": "^[0-9]+$" }, "pending_or_unknown": { "type": "string", "pattern": "^[0-9]+$" }, "measured_records": { "type": "string", "pattern": "^[0-9]+$" }, "unknown_records": { "type": "string", "pattern": "^[0-9]+$" }, "unrecorded_requests": { "type": "string", "pattern": "^[0-9]+$" }, "known_input_tokens": { "type": "string", "pattern": "^[0-9]+$", "nullable": true }, "known_output_tokens": { "type": "string", "pattern": "^[0-9]+$", "nullable": true }, "input_tokens": { "type": "string", "pattern": "^[0-9]+$", "nullable": true }, "output_tokens": { "type": "string", "pattern": "^[0-9]+$", "nullable": true }, "project_id": { "type": "string", "format": "uuid" }, "api_key_id": { "type": "string", "format": "uuid" }, "deployment_id": { "type": "string", "format": "uuid", "nullable": true }, "revision_id": { "type": "string", "format": "uuid", "nullable": true }, "endpoint_id": { "type": "string", "format": "uuid", "nullable": true }, "model_id": { "type": "string" }, "modality": { "type": "string" }, "feature": { "type": "string" }, "feature_source": { "type": "string", "nullable": true }, "run_id": { "type": "string", "format": "uuid", "nullable": true }, "parent_run_id": { "type": "string", "format": "uuid", "nullable": true } } } } } } } } }, "400": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "401": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "403": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "404": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "409": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "413": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "422": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "429": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "500": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "503": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } } }, "security": [ { "bearer": [] } ], "summary": "Bounded project consumption; unknown attribution and tokens preserved. Not charges.", "tags": [ "Usage & Account" ] } }, "/v1/usage/charges": { "get": { "operationId": "CustomerFinancialController_read", "parameters": [ { "name": "from", "required": true, "in": "query", "schema": { "format": "date-time", "type": "string" } }, { "name": "to", "required": true, "in": "query", "schema": { "format": "date-time", "type": "string" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "domain", "scope", "from", "to", "currency", "status", "netAmountMicros", "entries", "charges", "reversals", "items", "truncated", "receiptCoverage", "semantics" ], "properties": { "domain": { "type": "string", "enum": [ "CUSTOMER_CHARGE", "SUPPLIER_SETTLEMENT" ] }, "scope": { "type": "string", "enum": [ "PROJECT", "PROVIDER" ] }, "from": { "type": "string", "format": "date-time" }, "to": { "type": "string", "format": "date-time" }, "currency": { "type": "string", "enum": [ "USD" ] }, "status": { "type": "string", "enum": [ "TARIFF_UNAVAILABLE", "NO_POSTED_ENTRIES", "POSTED" ] }, "netAmountMicros": { "type": "string", "pattern": "^-?[0-9]+$", "nullable": true }, "entries": { "type": "string", "pattern": "^[0-9]+$" }, "charges": { "type": "string", "pattern": "^[0-9]+$" }, "reversals": { "type": "string", "pattern": "^[0-9]+$" }, "truncated": { "type": "boolean" }, "semantics": { "type": "string" }, "receiptCoverage": { "type": "object", "additionalProperties": false, "required": [ "real_requests", "known_receipts", "unknown_or_incomplete_receipts", "unposted_known_receipts", "posted_receipts", "reversed_receipts", "dispatched_unrecorded_requests", "not_dispatched_unrecorded_requests", "status", "timeBasis" ], "properties": { "real_requests": { "type": "string", "pattern": "^[0-9]+$" }, "known_receipts": { "type": "string", "pattern": "^[0-9]+$" }, "unknown_or_incomplete_receipts": { "type": "string", "pattern": "^[0-9]+$" }, "unposted_known_receipts": { "type": "string", "pattern": "^[0-9]+$" }, "posted_receipts": { "type": "string", "pattern": "^[0-9]+$" }, "reversed_receipts": { "type": "string", "pattern": "^[0-9]+$" }, "dispatched_unrecorded_requests": { "type": "string", "pattern": "^[0-9]+$" }, "not_dispatched_unrecorded_requests": { "type": "string", "pattern": "^[0-9]+$" }, "status": { "type": "string", "enum": [ "NO_REAL_REQUESTS", "COMPLETE", "PARTIAL" ] }, "timeBasis": { "type": "string" } } }, "items": { "type": "array", "maxItems": 100, "items": { "type": "object", "additionalProperties": false, "required": [ "id", "kind", "amountMicros", "currency", "occurredAt", "postedAt", "tariffId", "tariffVersion", "digest", "reversesId" ], "properties": { "id": { "type": "string", "format": "uuid" }, "kind": { "type": "string", "enum": [ "CHARGE", "REVERSAL" ] }, "amountMicros": { "type": "string", "pattern": "^-?[0-9]+$" }, "currency": { "type": "string", "enum": [ "USD" ] }, "occurredAt": { "type": "string", "format": "date-time" }, "postedAt": { "type": "string", "format": "date-time" }, "tariffId": { "type": "string" }, "tariffVersion": { "type": "string" }, "digest": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "reversesId": { "type": "string", "format": "uuid", "nullable": true } } } } } } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "summary": "Own-project posted customer tariffs; missing postings are not zero or complete billing", "tags": [ "Usage & Account" ] } }, "/v1/allocation-usage": { "get": { "operationId": "AllocationUsageController_list", "parameters": [ { "name": "limit", "required": false, "in": "query", "schema": { "maximum": 100, "default": 50, "type": "number" } }, { "name": "after", "required": false, "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful operation.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "items", "nextCursor", "quantityKind", "billingStatus" ], "properties": { "items": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "id", "binding_id", "instance_id", "project_id", "provider_id", "execution_mode", "started_at", "ended_at", "gpu_seconds", "certainty", "state", "source_event_id" ], "properties": { "id": { "type": "string", "format": "uuid" }, "binding_id": { "type": "string", "format": "uuid" }, "instance_id": { "type": "string", "format": "uuid" }, "project_id": { "type": "string", "format": "uuid" }, "provider_id": { "type": "string", "format": "uuid" }, "execution_mode": { "type": "string", "enum": [ "REAL", "SIMULATED" ] }, "started_at": { "type": "string", "format": "date-time" }, "ended_at": { "type": "string", "format": "date-time" }, "gpu_seconds": { "type": "string", "nullable": true }, "certainty": { "type": "string", "enum": [ "KNOWN", "UNKNOWN" ] }, "state": { "type": "string" }, "source_event_id": { "type": "string" } } } }, "nextCursor": { "type": "string", "format": "uuid", "nullable": true }, "quantityKind": { "type": "string", "enum": [ "ALLOCATION_OCCUPANCY" ] }, "billingStatus": { "type": "string", "enum": [ "NOT_BILLING" ] } } } } } }, "400": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "401": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "403": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "404": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "409": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "413": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "422": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "429": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "500": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } }, "503": { "description": "Fail-closed request or dependency error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProductManagementErrorEnvelope" } } } } }, "security": [ { "bearer": [] } ], "tags": [ "Usage & Account" ], "summary": "Read allocation occupancy" } }, "/v1/telemetry/query": { "post": { "operationId": "CustomerTelemetryController_query", "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "projectId", "deploymentId", "from", "to", "stepSeconds", "metrics" ], "properties": { "projectId": { "type": "string", "format": "uuid", "nullable": true }, "deploymentId": { "type": "string", "format": "uuid", "nullable": true }, "from": { "type": "string", "format": "date-time" }, "to": { "type": "string", "format": "date-time" }, "stepSeconds": { "type": "integer", "minimum": 1, "maximum": 86400 }, "metrics": { "type": "array", "minItems": 1, "maxItems": 12, "uniqueItems": true, "items": { "type": "string" } } } } } } }, "responses": { "200": { "description": "" }, "201": { "description": "Successful operation.", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "additionalProperties": true } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "summary": "Bounded project ledger telemetry; missing observations remain unavailable", "tags": [ "Usage & Account" ] } }, "/v1/telemetry/distributions": { "post": { "operationId": "LatencyDistributionsController_query[0]", "parameters": [], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "projectId": { "type": "string", "format": "uuid" }, "from": { "type": "string", "format": "date-time" }, "to": { "type": "string", "format": "date-time" }, "unit": { "type": "string", "enum": [ "ms" ] }, "quantiles": { "type": "array", "minItems": 3, "maxItems": 3, "items": { "type": "number", "enum": [ 0.5, 0.95, 0.99 ] } }, "source": { "type": "string", "enum": [ "inference_timing_samples", "ClickHouse projection of inference_timing_samples" ] }, "aggregation": { "type": "string" }, "rows": { "type": "array", "maxItems": 12, "items": { "type": "object", "additionalProperties": false, "properties": { "execution_mode": { "type": "string", "enum": [ "REAL", "SIMULATED", null ], "nullable": true }, "outcome": { "type": "string", "enum": [ "SUCCEEDED", "FAILED", "CANCELLED", "UNKNOWN" ] }, "samples": { "type": "integer", "minimum": 0 }, "ttft_samples": { "type": "integer", "minimum": 0 }, "ttft_ms": { "type": "array", "nullable": true, "minItems": 3, "maxItems": 3, "items": { "type": "number", "minimum": 0 } }, "completion_ms": { "type": "array", "nullable": true, "minItems": 3, "maxItems": 3, "items": { "type": "number", "minimum": 0 } } }, "required": [ "execution_mode", "outcome", "samples", "ttft_samples", "ttft_ms", "completion_ms" ] } }, "status": { "type": "string", "enum": [ "MEASURED", "UNAVAILABLE" ] } }, "required": [ "projectId", "from", "to", "unit", "quantiles", "source", "aggregation", "rows", "status" ] } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "tags": [ "Usage & Account" ], "summary": "Query latency distributions" } }, "/v1/inference/usage": { "get": { "operationId": "InferenceController_usage", "parameters": [ { "name": "limit", "required": false, "in": "query", "schema": { "maximum": 100, "default": 50, "type": "number" } }, { "name": "after", "required": false, "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Persisted contract response; runtime readiness is not implied", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "project_id": { "type": "string", "format": "uuid" }, "request_id": { "type": "string", "format": "uuid" }, "source_event_id": { "type": "string" }, "execution_mode": { "type": "string", "enum": [ "SIMULATED", "REAL" ] }, "input_tokens": { "type": "string", "nullable": true, "description": "PostgreSQL bigint serialized as a decimal string" }, "output_tokens": { "type": "string", "nullable": true }, "measurement_status": { "type": "string", "enum": [ "MEASURED", "UNKNOWN" ] }, "reconciliation": { "type": "object", "properties": { "outcome": { "type": "string" }, "measurement_status": { "type": "string" }, "input_tokens": { "type": "string", "nullable": true }, "output_tokens": { "type": "string", "nullable": true } }, "nullable": true }, "created_at": { "type": "string", "format": "date-time" } } } }, "nextCursor": { "type": "string", "format": "uuid", "nullable": true } } } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "summary": "Inference work units with execution mode and measurement status", "tags": [ "Usage & Account" ] } }, "/v1/compute/usage": { "get": { "operationId": "CustomerController_usage", "parameters": [ { "name": "limit", "required": false, "in": "query", "schema": { "maximum": 100, "default": 50, "type": "number" } }, { "name": "after", "required": false, "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful operation.", "content": { "application/json": { "schema": { "type": "object", "required": [ "items", "nextCursor" ], "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "project_id": { "type": "string", "format": "uuid" }, "instance_id": { "type": "string", "format": "uuid" }, "source_event_id": { "type": "string" }, "started_at": { "type": "string", "format": "date-time" }, "ended_at": { "type": "string", "format": "date-time" }, "gpu_seconds": { "type": "string" }, "unit_seconds": { "type": "string" }, "execution_mode": { "type": "string", "enum": [ "SIMULATED" ] } } } }, "nextCursor": { "type": "string", "format": "uuid", "nullable": true } } } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "summary": "Finalized sandbox occupancy after release; not an invoice or live GPU measurement", "tags": [ "Usage & Account" ] } }, "/v1/compute/usage/intervals": { "get": { "operationId": "CustomerController_intervals", "parameters": [ { "name": "limit", "required": false, "in": "query", "schema": { "maximum": 100, "default": 50, "type": "number" } }, { "name": "after", "required": false, "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful operation.", "content": { "application/json": { "schema": { "type": "object", "required": [ "items", "nextCursor" ], "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "project_id": { "type": "string", "format": "uuid" }, "instance_id": { "type": "string", "format": "uuid" }, "source_event_id": { "type": "string" }, "started_at": { "type": "string", "format": "date-time" }, "ended_at": { "type": "string", "format": "date-time" }, "gpu_seconds": { "type": "string" }, "unit_seconds": { "type": "string" }, "execution_mode": { "type": "string", "enum": [ "SIMULATED" ] }, "resource_id": { "type": "string", "format": "uuid" }, "rate_status": { "type": "string", "enum": [ "UNKNOWN" ] }, "quantity_kind": { "type": "string", "enum": [ "OCCUPANCY" ] }, "final_interval": { "type": "boolean" } } } }, "nextCursor": { "type": "string", "format": "uuid", "nullable": true } } } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "401": { "description": "Missing or revoked API key", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "403": { "description": "Role or policy denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "404": { "description": "Resource absent or not visible", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "409": { "description": "Idempotency, capacity, quota or state conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "413": { "description": "Request body exceeds 64 KiB", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "422": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "429": { "description": "Rate limit; honor Retry-After", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } }, "503": { "description": "Dependency unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "security": [ { "bearer": [] } ], "summary": "Incremental simulated occupancy intervals, unknown rates; do not add to final lifetime totals", "tags": [ "Usage & Account" ] } } }, "components": { "schemas": { "ProductCatalogPage": { "type": "object", "additionalProperties": false, "required": [ "items", "nextCursor" ], "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/ProductCatalogItem" }, "maxItems": 100 }, "nextCursor": { "type": "string", "nullable": true } } }, "ProductCatalogItem": { "type": "object", "additionalProperties": false, "required": [ "id", "displayName", "family", "modalities", "capabilities", "limits", "visibility", "entitled", "availability", "qualification", "metadataSource", "price" ], "properties": { "id": { "type": "string", "minLength": 1 }, "displayName": { "type": "string" }, "family": { "type": "string", "nullable": true }, "modalities": { "type": "array", "items": { "type": "string", "enum": [ "text", "image", "audio", "video" ] }, "nullable": true }, "capabilities": { "$ref": "#/components/schemas/ProductCatalogCapabilities" }, "limits": { "$ref": "#/components/schemas/ProductCatalogLimits" }, "visibility": { "type": "string", "enum": [ "PUBLISHED" ] }, "entitled": { "type": "boolean" }, "availability": { "$ref": "#/components/schemas/ProductCatalogAvailability" }, "qualification": { "$ref": "#/components/schemas/ProductCatalogQualification" }, "metadataSource": { "type": "string", "nullable": true }, "price": { "type": "object", "additionalProperties": false, "required": [ "amount", "currency", "unit", "source", "version", "approvedAt" ], "properties": { "amount": { "type": "string", "pattern": "^[0-9]{1,18}([.][0-9]{1,12})?$" }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "unit": { "type": "string", "enum": [ "MILLION_INPUT_TOKENS", "MILLION_OUTPUT_TOKENS", "REQUEST" ] }, "source": { "type": "string", "minLength": 1, "maxLength": 500 }, "version": { "type": "string", "minLength": 1, "maxLength": 100 }, "approvedAt": { "type": "string", "format": "date-time" } }, "nullable": true } } }, "ProductCatalogCapabilities": { "type": "object", "additionalProperties": false, "required": [ "tools", "streaming", "structuredOutput" ], "properties": { "tools": { "type": "boolean", "nullable": true }, "streaming": { "type": "boolean", "nullable": true }, "structuredOutput": { "type": "boolean", "nullable": true } } }, "ProductCatalogLimits": { "type": "object", "additionalProperties": false, "required": [ "contextTokens", "maxOutputTokens" ], "properties": { "contextTokens": { "type": "integer", "minimum": 1 }, "maxOutputTokens": { "type": "integer", "minimum": 1 } } }, "ProductCatalogAvailability": { "type": "object", "additionalProperties": false, "required": [ "status", "reason", "executionMode" ], "properties": { "status": { "type": "string", "enum": [ "AVAILABLE", "UNAVAILABLE" ] }, "reason": { "type": "string", "enum": [ "NOT_ENTITLED", "REVISION_PROOF_CURRENT", "NO_FRESH_READY_REVISION" ] }, "executionMode": { "type": "string", "enum": [ "SIMULATED", "REAL", null ], "nullable": true } } }, "ProductCatalogQualification": { "type": "object", "additionalProperties": false, "required": [ "status" ], "properties": { "status": { "type": "string", "enum": [ "REAL_PROOF_CURRENT", "FIXTURE_PROOF_CURRENT", "UNVERIFIED" ] } } }, "ProductManagementErrorEnvelope": { "oneOf": [ { "$ref": "#/components/schemas/ProductManagementFilterError" }, { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "object", "additionalProperties": false, "required": [ "code" ], "properties": { "code": { "enum": [ "RATE_LIMITED" ], "type": "string" } } } } } ] }, "ProductManagementFilterError": { "type": "object", "additionalProperties": false, "required": [ "error" ], "properties": { "error": { "type": "object", "additionalProperties": false, "required": [ "code", "message", "type", "requestId", "retryable", "dispatched" ], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "type": { "type": "string", "enum": [ "server_error", "rate_limit_error", "invalid_request_error" ] }, "requestId": { "type": "string" }, "retryable": { "type": "boolean" }, "dispatched": { "enum": [ false ], "type": "boolean" }, "details": { "type": "array", "items": { "type": "string" } } } } } }, "ProductCatalogDetail": { "type": "object", "additionalProperties": false, "required": [ "id", "displayName", "family", "modalities", "capabilities", "limits", "visibility", "entitled", "availability", "qualification", "metadataSource", "price", "apiExample", "configurationGuidance" ], "properties": { "id": { "type": "string", "minLength": 1 }, "displayName": { "type": "string" }, "family": { "type": "string", "nullable": true }, "modalities": { "type": "array", "items": { "type": "string", "enum": [ "text", "image", "audio", "video" ] }, "nullable": true }, "capabilities": { "$ref": "#/components/schemas/ProductCatalogCapabilities" }, "limits": { "$ref": "#/components/schemas/ProductCatalogLimits" }, "visibility": { "type": "string", "enum": [ "PUBLISHED" ] }, "entitled": { "type": "boolean" }, "availability": { "$ref": "#/components/schemas/ProductCatalogAvailability" }, "qualification": { "$ref": "#/components/schemas/ProductCatalogQualification" }, "metadataSource": { "type": "string", "nullable": true }, "price": { "type": "object", "additionalProperties": false, "required": [ "amount", "currency", "unit", "source", "version", "approvedAt" ], "properties": { "amount": { "type": "string", "pattern": "^[0-9]{1,18}([.][0-9]{1,12})?$" }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "unit": { "type": "string", "enum": [ "MILLION_INPUT_TOKENS", "MILLION_OUTPUT_TOKENS", "REQUEST" ] }, "source": { "type": "string", "minLength": 1, "maxLength": 500 }, "version": { "type": "string", "minLength": 1, "maxLength": 100 }, "approvedAt": { "type": "string", "format": "date-time" } }, "nullable": true }, "apiExample": { "type": "object", "additionalProperties": false, "required": [ "method", "path", "body" ], "properties": { "method": { "type": "string", "enum": [ "POST" ] }, "path": { "type": "string", "enum": [ "/v1/chat/completions" ] }, "body": { "type": "object", "additionalProperties": false, "required": [ "model", "messages", "stream", "max_tokens" ], "properties": { "model": { "type": "string" }, "messages": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "role", "content" ], "properties": { "role": { "type": "string", "enum": [ "user" ] }, "content": { "type": "string" } } }, "minItems": 1, "maxItems": 1 }, "stream": { "enum": [ false ], "type": "boolean" }, "max_tokens": { "type": "integer", "minimum": 1, "maximum": 128 } } } }, "nullable": true }, "configurationGuidance": { "type": "array", "items": { "type": "string" } } } }, "ManagedQuoteInput": { "type": "object", "properties": { "offerId": { "type": "string" }, "requestedEndAt": { "type": "string" } }, "required": [ "offerId", "requestedEndAt" ] }, "WaitlistInput": { "type": "object", "properties": { "intentId": { "type": "string" }, "email": { "type": "boolean" } }, "required": [ "intentId", "email" ] }, "ReservationInput": { "type": "object", "properties": { "acceptedQuoteId": { "type": "string", "description": "Exact immutable liability quote accepted for a budget-controlled allocation." }, "acceptedPolicyId": { "type": "string", "description": "Exact approved compute policy accepted by customer; required for policy-backed supply." }, "offerId": { "type": "string" }, "units": { "type": "number", "example": 1, "description": "Whole allocation units, not fractional GPUs." }, "requestedEndAt": { "type": "string", "example": "2026-11-01T12:00:00Z", "description": "UTC end time, within 31 days. Expiry triggers operator review, not automatic destruction." } }, "required": [ "offerId", "units", "requestedEndAt" ] }, "InstanceInput": { "type": "object", "properties": { "reservationId": { "type": "string" } }, "required": [ "reservationId" ] }, "Object": { "type": "object", "properties": {} } }, "securitySchemes": { "bearer": { "type": "http", "scheme": "bearer", "description": "Use an authorized project key. Inference-only keys cannot perform compute management; telemetry:read is required for scoped-key usage reporting." } } }, "x-infermax-audience": "external-customer", "x-infermax-visibility": "public" }