{ "openapi": "3.1.0", "info": { "title": "Lugemi API", "version": "0.1.0", "description": "Lugemi language, speech, and voice API. This document is built from the live route table at startup, so every endpoint the API serves is listed. Authenticate with an API key (Authorization: Bearer lg_live_… or lg_test_…) or, for console routes, a Lugemi session token." }, "servers": [ { "url": "https://api.lugemi.com", "description": "Production" } ], "components": { "securitySchemes": { "ApiKeyAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "lg_live_ | lg_test_", "description": "API key from the console (lg_live_… production label, lg_test_… soft sandbox)." }, "ClerkAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT", "description": "Clerk session JWT for console routes." } }, "schemas": { "Error": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "request_id": { "type": "string" } }, "required": [ "code", "message", "request_id" ] } }, "required": [ "error" ] }, "TranslateRequest": { "type": "object", "required": [ "text", "source", "target" ], "properties": { "text": { "type": "string", "minLength": 1 }, "source": { "type": "string", "description": "Source language code, or \"auto\" to detect first.", "example": "en" }, "target": { "type": "string", "example": "sw" } } }, "DetectRequest": { "type": "object", "required": [ "text" ], "properties": { "text": { "type": "string", "minLength": 1 } } }, "DetectResponse": { "type": "object", "properties": { "language": { "type": "string" }, "confidence": { "type": "number" }, "provider": { "type": "string" } }, "required": [ "language", "confidence", "provider" ] }, "TranslateResponse": { "type": "object", "properties": { "text": { "type": "string" }, "source": { "type": "string" }, "target": { "type": "string" }, "provider": { "type": "string" }, "characters": { "type": "integer" }, "glossaryApplied": { "type": "integer" }, "tmHit": { "type": "boolean" }, "reviewId": { "type": "string" }, "qualityScore": { "type": "integer" }, "needsReview": { "type": "boolean" }, "detection": { "nullable": true, "allOf": [ { "$ref": "#/components/schemas/DetectResponse" } ], "description": "Present when source was \"auto\"." } }, "required": [ "text", "source", "target", "provider", "characters" ] }, "ChatMessage": { "type": "object", "required": [ "role", "content" ], "properties": { "role": { "type": "string", "enum": [ "system", "user", "assistant" ] }, "content": { "type": "string" } } }, "ChatCompletionRequest": { "type": "object", "required": [ "messages" ], "description": "Text chatbot turn. System/persona is the workspace `chat` prompt (client system messages are dropped). Pass prior user/assistant turns in messages for history. Optional translateReplyTo MTs the assistant reply into a registry language.", "properties": { "messages": { "type": "array", "items": { "$ref": "#/components/schemas/ChatMessage" }, "minItems": 1, "description": "Conversation turns. At least one user message required. Client system roles are ignored in favor of the workspace prompt." }, "model": { "type": "string", "description": "Optional OpenAI model override" }, "translateReplyTo": { "type": "string", "description": "Optional registry language code to machine-translate the assistant reply into (source auto). Soft-fails to the English reply when a full-sentence pack is missing.", "example": "sw" } } }, "ChatCompletionResponse": { "type": "object", "properties": { "id": { "type": "string" }, "object": { "type": "string", "example": "chat.completion" }, "model": { "type": "string" }, "provider": { "type": "string" }, "choices": { "type": "array", "items": { "type": "object", "properties": { "index": { "type": "integer" }, "message": { "$ref": "#/components/schemas/ChatMessage" }, "finish_reason": { "type": "string" } } } }, "usage": { "type": "object", "properties": { "prompt_tokens": { "type": "integer" }, "completion_tokens": { "type": "integer" }, "total_tokens": { "type": "integer" } } }, "translated": { "type": "boolean" }, "translateReplyTo": { "type": "string", "nullable": true } } }, "VoiceAgentTurnRequest": { "type": "object", "description": "Spoken voice-chat agent turn. Prefer multipart/form-data with an audio file; text is a fallback for CI and text-only probes.", "properties": { "file": { "type": "string", "format": "binary", "description": "Utterance audio (mp3, wav, m4a, webm, ogg, flac)" }, "text": { "type": "string", "description": "Text utterance when no audio file is provided" }, "language": { "type": "string", "description": "Optional STT language hint. Omit or pass \"auto\" for automatic detection.", "example": "auto" }, "autoDetectLanguage": { "type": "boolean", "description": "When true (default), refine language via text detect if ASR omits it.", "default": true }, "replyLanguage": { "type": "string", "description": "Force reply language. Defaults to detected language." }, "translateReplyTo": { "type": "string", "description": "Alias of replyLanguage — same field name as chat completions." }, "voice": { "type": "string", "description": "Optional own:* / catalog TTS voice override" }, "emotion": { "type": "string", "description": "Optional Emotion Voice profile id" }, "format": { "type": "string", "enum": [ "mp3", "wav", "opus", "aac", "flac" ] }, "sessionId": { "type": "string", "description": "Optional session from POST /v1/voice/agent/sessions for multi-turn history" } } }, "VoiceAgentTurnResponse": { "type": "object", "properties": { "sessionId": { "type": "string", "nullable": true }, "userText": { "type": "string", "description": "Transcript or input text" }, "replyText": { "type": "string" }, "detectedLanguage": { "type": "string", "nullable": true }, "replyLanguage": { "type": "string", "nullable": true }, "translated": { "type": "boolean" }, "audioBase64": { "type": "string", "nullable": true }, "mimeType": { "type": "string", "nullable": true }, "audioId": { "type": "string", "nullable": true }, "voice": { "type": "string" }, "emotionProfile": { "type": "string", "nullable": true }, "tts": { "type": "object", "properties": { "quality": { "type": "string", "enum": [ "neural", "espeak", "formant", "unavailable" ] }, "synthEngine": { "type": "string", "nullable": true }, "verificationStatus": { "type": "string", "nullable": true }, "honesty": { "type": "string" } } }, "providers": { "type": "object", "properties": { "stt": { "type": "string", "nullable": true }, "chat": { "type": "string" }, "translate": { "type": "string", "nullable": true }, "tts": { "type": "string", "nullable": true } } }, "model": { "type": "string" } } }, "Job": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string", "enum": [ "batch_translate", "document_translate", "workflow" ] }, "status": { "type": "string", "enum": [ "queued", "running", "succeeded", "failed" ] }, "input": { "type": "object" }, "result": { "type": "object", "nullable": true }, "error": { "type": "string", "nullable": true }, "webhookUrl": { "type": "string", "nullable": true }, "webhookStatus": { "type": "string", "nullable": true }, "attempts": { "type": "integer" }, "createdAt": { "type": "string", "format": "date-time" }, "startedAt": { "type": "string", "format": "date-time", "nullable": true }, "completedAt": { "type": "string", "format": "date-time", "nullable": true } } }, "Workflow": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "steps": { "type": "array", "items": { "type": "object" }, "description": "Directed steps: transcribe | translate | notify" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" } } }, "Language": { "type": "object", "properties": { "code": { "type": "string" }, "name": { "type": "string" }, "nativeName": { "type": "string", "nullable": true }, "script": { "type": "string", "nullable": true }, "rtl": { "type": "boolean" }, "tier": { "type": "string", "enum": [ "vendor", "strategic_african" ] } } } } }, "paths": { "/docs": { "get": { "operationId": "openApiGetDocs", "summary": "Get docs", "responses": { "200": { "description": "Success. The body is written directly by the handler (for example audio bytes or a file download).", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "System" ] } }, "/health": { "get": { "summary": "Health check", "operationId": "getHealth", "responses": { "200": { "description": "Service is up (includes in-process translate latency snapshot)", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string", "example": "ok" }, "translateLatency": { "type": "object", "properties": { "samples": { "type": "integer" }, "p50Ms": { "type": "number", "nullable": true }, "p95Ms": { "type": "number", "nullable": true }, "p99Ms": { "type": "number", "nullable": true }, "maxMs": { "type": "number", "nullable": true } } } } } } } } }, "tags": [ "System" ] } }, "/swagger": { "get": { "operationId": "openApiGetSwagger", "summary": "Get swagger", "responses": { "200": { "description": "Success. The body is written directly by the handler (for example audio bytes or a file download).", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "System" ] } }, "/v1/accents": { "get": { "summary": "List accent catalog", "operationId": "listAccents", "parameters": [ { "name": "language", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Filter by language code" } ], "responses": { "200": { "description": "Accent rows" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Accents" ] } }, "/v1/accents/{code}": { "get": { "summary": "Get accent by code", "operationId": "getAccent", "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Accent detail" }, "404": { "description": "Not found" } }, "tags": [ "Accents" ] } }, "/v1/accents/analytics": { "get": { "summary": "Accent Intelligence analytics", "operationId": "getAccentAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Org accent detect/classify usage" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Accents" ] } }, "/v1/accents/classify": { "post": { "summary": "Classify spoken accent (ranked candidates)", "operationId": "classifyAccent", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Classification with confidence band" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Accents" ] } }, "/v1/accents/detect": { "post": { "summary": "Detect spoken accent cues", "operationId": "detectAccent", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Detected accent candidates" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Accents" ] } }, "/v1/accents/engine": { "get": { "summary": "Accent Intelligence engine catalog", "operationId": "getAccentEngine", "responses": { "200": { "description": "Accent capabilities and honesty notes" } }, "tags": [ "Accents" ] } }, "/v1/accents/identity": { "get": { "operationId": "accentsListIdentity", "summary": "List identity", "parameters": [ { "name": "speechVariety", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "language", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "region", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "country", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Accents" ] } }, "/v1/accents/identity/{id}": { "get": { "operationId": "accentsGetIdentity", "summary": "Get identity", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Accents" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/accents/identity/{id}/demo": { "get": { "operationId": "accentsIdentityDemo", "summary": "Identity demo", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Accents" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/accessline/calls": { "get": { "operationId": "accessLineListCalls", "summary": "List calls", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Accessline" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/accessline/calls/{id}": { "get": { "operationId": "accessLineGetCall", "summary": "Get call", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Accessline" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/accessline/calls/{id}/handoff": { "post": { "operationId": "accessLineHandoff", "summary": "Handoff", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Accessline" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/accessline/calls/{id}/summary": { "get": { "operationId": "accessLineSummary", "summary": "Summary", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Accessline" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/accessline/capabilities": { "get": { "operationId": "accessLineCapabilities", "summary": "Capabilities", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Accessline" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/accessline/catalog": { "get": { "operationId": "accessLineCatalog", "summary": "Catalog", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Accessline" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/accessline/lines": { "get": { "operationId": "accessLineListLines", "summary": "List lines", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Accessline" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] }, "post": { "operationId": "accessLineCreateLine", "summary": "Create line", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Accessline" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/accessline/lines/{id}": { "get": { "operationId": "accessLineGetLine", "summary": "Get line", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Accessline" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/accessline/metrics": { "get": { "operationId": "accessLineMetrics", "summary": "Metrics", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Accessline" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/accessline/simulate/{callId}/dtmf": { "post": { "operationId": "accessLineSimulateDtmf", "summary": "Simulate dtmf", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Accessline" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "callId", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/accessline/simulate/{callId}/hangup": { "post": { "operationId": "accessLineSimulateHangup", "summary": "Simulate hangup", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Accessline" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "callId", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/accessline/simulate/{callId}/speech": { "post": { "operationId": "accessLineSimulateSpeech", "summary": "Simulate speech", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Accessline" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "callId", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/accessline/simulate/start": { "post": { "operationId": "accessLineSimulateStart", "summary": "Simulate start", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Accessline" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/accessline/telephony/numbers": { "get": { "operationId": "accessLineListProviderNumbers", "summary": "List provider numbers", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Accessline" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/accessline/twilio/gather": { "post": { "operationId": "accessLineTwilioGather", "summary": "Gather", "responses": { "200": { "description": "Success. The body is written directly by the handler (for example audio bytes or a file download).", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "Accessline" ] } }, "/v1/accessline/twilio/inbound": { "post": { "operationId": "accessLineTwilioInbound", "summary": "Inbound", "responses": { "200": { "description": "Success. The body is written directly by the handler (for example audio bytes or a file download).", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "Accessline" ] } }, "/v1/accessline/twilio/status": { "post": { "operationId": "accessLineTwilioStatus", "summary": "Status", "responses": { "204": { "description": "Success", "content": { "application/json": { "schema": {} } } } }, "tags": [ "Accessline" ] } }, "/v1/admin/dealbridge/catalog": { "get": { "operationId": "dealBridgeAdminCatalog", "summary": "Catalog", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Dealbridge" ], "security": [ { "ClerkAuth": [] } ], "x-lugemi-access": "platform-admin" } }, "/v1/admin/dealbridge/pilot": { "get": { "operationId": "dealBridgeAdminPilot", "summary": "Pilot", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Dealbridge" ], "security": [ { "ClerkAuth": [] } ], "x-lugemi-access": "platform-admin" } }, "/v1/admin/dealbridge/pilot/config": { "post": { "operationId": "dealBridgeAdminUpsertConfig", "summary": "Upsert config", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Dealbridge" ], "security": [ { "ClerkAuth": [] } ], "x-lugemi-access": "platform-admin" } }, "/v1/admin/dealbridge/pilot/export": { "get": { "operationId": "dealBridgeAdminExport", "summary": "Export", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Dealbridge" ], "security": [ { "ClerkAuth": [] } ], "x-lugemi-access": "platform-admin" } }, "/v1/admin/organizations": { "get": { "summary": "Search organizations (platform admin)", "operationId": "adminSearchOrganizations", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "q", "in": "query", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "maximum": 100 } } ], "responses": { "200": { "description": "Matching organizations" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not a platform admin" } }, "tags": [ "Admin · Organizations" ], "x-lugemi-access": "platform-admin" } }, "/v1/admin/organizations/{id}": { "get": { "summary": "Organization detail for platform admin", "operationId": "adminGetOrganization", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Usage, keys, members" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Organizations" ], "x-lugemi-access": "platform-admin" } }, "/v1/admin/organizations/{id}/disable": { "post": { "summary": "Disable or re-enable an organization", "operationId": "adminDisableOrganization", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "disabled": { "type": "boolean", "default": true }, "reason": { "type": "string" } } } } } }, "responses": { "201": { "description": "Updated org" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Organizations" ], "x-lugemi-access": "platform-admin" } }, "/v1/admin/organizations/{id}/revoke-keys": { "post": { "summary": "Revoke all API keys for an organization", "operationId": "adminRevokeOrganizationKeys", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "201": { "description": "Revoke count" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Organizations" ], "x-lugemi-access": "platform-admin" } }, "/v1/admin/pilot-requests": { "get": { "operationId": "pilotRequestsAdminList", "summary": "List", "parameters": [ { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Pilot requests" ], "security": [ { "ClerkAuth": [] } ], "x-lugemi-access": "platform-admin" } }, "/v1/admin/pilot-requests/{id}": { "patch": { "operationId": "pilotRequestsAdminSetStatus", "summary": "Set status", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Pilot requests" ], "security": [ { "ClerkAuth": [] } ], "x-lugemi-access": "platform-admin", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/admin/plans": { "get": { "summary": "List Lugemi plan filters for the admin console", "operationId": "adminListPlans", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Plan id/name pairs" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not a platform admin" } }, "tags": [ "Admin · Plans" ], "x-lugemi-access": "platform-admin" }, "post": { "operationId": "adminCreatePlan", "summary": "Create plan", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Plans" ], "security": [ { "ClerkAuth": [] } ], "x-lugemi-access": "platform-admin" } }, "/v1/admin/plans/{id}": { "patch": { "operationId": "adminUpdatePlan", "summary": "Update plan", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Plans" ], "security": [ { "ClerkAuth": [] } ], "x-lugemi-access": "platform-admin", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/admin/status": { "get": { "summary": "Whether the current user is a platform admin", "operationId": "getAdminStatus", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "{ admin: boolean }" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Status" ] } }, "/v1/admin/voice-data/dialects": { "get": { "operationId": "voiceDataAdminDialects", "summary": "Dialects", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Voice data" ], "security": [ { "ClerkAuth": [] } ], "x-lugemi-access": "platform-admin" } }, "/v1/admin/voice-data/export": { "get": { "operationId": "voiceDataAdminExport", "summary": "Export", "parameters": [ { "name": "dialect", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success. The body is written directly by the handler (for example audio bytes or a file download).", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Voice data" ], "security": [ { "ClerkAuth": [] } ], "x-lugemi-access": "platform-admin" } }, "/v1/admin/voice-data/feedback": { "get": { "operationId": "voiceDataAdminFeedback", "summary": "Feedback", "parameters": [ { "name": "dialect", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Voice data" ], "security": [ { "ClerkAuth": [] } ], "x-lugemi-access": "platform-admin" } }, "/v1/admin/voice-data/overview": { "get": { "operationId": "voiceDataAdminOverview", "summary": "Overview", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Voice data" ], "security": [ { "ClerkAuth": [] } ], "x-lugemi-access": "platform-admin" } }, "/v1/admin/voice-data/prompts": { "get": { "operationId": "voiceDataAdminPrompts", "summary": "Prompts", "parameters": [ { "name": "dialect", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Voice data" ], "security": [ { "ClerkAuth": [] } ], "x-lugemi-access": "platform-admin" }, "post": { "operationId": "voiceDataAdminAddPrompts", "summary": "Add prompts", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Voice data" ], "security": [ { "ClerkAuth": [] } ], "x-lugemi-access": "platform-admin" } }, "/v1/admin/voice-data/prompts/{id}": { "patch": { "operationId": "voiceDataAdminUpdatePrompt", "summary": "Update prompt", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Voice data" ], "security": [ { "ClerkAuth": [] } ], "x-lugemi-access": "platform-admin", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/admin/voice-data/recordings": { "get": { "operationId": "voiceDataAdminRecordings", "summary": "Recordings", "parameters": [ { "name": "status", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "dialect", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "speakerId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Voice data" ], "security": [ { "ClerkAuth": [] } ], "x-lugemi-access": "platform-admin" } }, "/v1/admin/voice-data/recordings/{id}": { "patch": { "operationId": "voiceDataAdminUpdateRecording", "summary": "Update recording", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Voice data" ], "security": [ { "ClerkAuth": [] } ], "x-lugemi-access": "platform-admin", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/admin/voice-data/recordings/{id}/audio": { "get": { "operationId": "voiceDataAdminAudio", "summary": "Audio", "responses": { "200": { "description": "Success. The body is written directly by the handler (for example audio bytes or a file download).", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Voice data" ], "security": [ { "ClerkAuth": [] } ], "x-lugemi-access": "platform-admin", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/admin/voice-data/speakers": { "get": { "operationId": "voiceDataAdminSpeakers", "summary": "Speakers", "parameters": [ { "name": "dialect", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Voice data" ], "security": [ { "ClerkAuth": [] } ], "x-lugemi-access": "platform-admin" }, "post": { "operationId": "voiceDataAdminCreateSpeaker", "summary": "Create speaker", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Voice data" ], "security": [ { "ClerkAuth": [] } ], "x-lugemi-access": "platform-admin" } }, "/v1/admin/voice-data/speakers/{id}": { "delete": { "operationId": "voiceDataAdminDeleteSpeaker", "summary": "Delete speaker", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Voice data" ], "security": [ { "ClerkAuth": [] } ], "x-lugemi-access": "platform-admin", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/admin/workspaces": { "get": { "summary": "List all workspaces (platform admin)", "operationId": "adminListWorkspaces", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Paginated workspace directory" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Workspaces" ], "x-lugemi-access": "platform-admin" }, "post": { "summary": "Create a customer workspace (platform admin)", "operationId": "adminCreateWorkspace", "security": [ { "ClerkAuth": [] } ], "responses": { "201": { "description": "Created workspace" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Workspaces" ], "x-lugemi-access": "platform-admin" } }, "/v1/admin/workspaces/{id}": { "get": { "summary": "Workspace detail for platform admin", "operationId": "adminGetWorkspace", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Workspace detail" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Workspaces" ], "x-lugemi-access": "platform-admin" }, "patch": { "summary": "Update workspace plan, quotas, region, or feature overrides", "operationId": "adminUpdateWorkspace", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Updated workspace" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Workspaces" ], "x-lugemi-access": "platform-admin" } }, "/v1/admin/workspaces/{id}/audit": { "get": { "summary": "Workspace audit snippet", "operationId": "adminWorkspaceAudit", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Audit events" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Workspaces" ], "x-lugemi-access": "platform-admin" } }, "/v1/admin/workspaces/{id}/invites": { "post": { "summary": "Invite a user to a workspace", "operationId": "adminInviteWorkspace", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "201": { "description": "Invite created" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Workspaces" ], "x-lugemi-access": "platform-admin" } }, "/v1/admin/workspaces/{id}/members": { "get": { "summary": "List workspace members", "operationId": "adminWorkspaceMembers", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Members" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Workspaces" ], "x-lugemi-access": "platform-admin" } }, "/v1/admin/workspaces/{id}/open-as": { "post": { "summary": "Open as workspace (admin session org context)", "operationId": "adminOpenAsWorkspace", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "201": { "description": "organizationId + workspaceId" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Workspaces" ], "x-lugemi-access": "platform-admin" } }, "/v1/admin/workspaces/{id}/plan": { "post": { "operationId": "adminAssignPlan", "summary": "Assign plan", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Workspaces" ], "security": [ { "ClerkAuth": [] } ], "x-lugemi-access": "platform-admin", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/admin/workspaces/{id}/resume": { "post": { "summary": "Resume a suspended workspace", "operationId": "adminResumeWorkspace", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "201": { "description": "Resumed" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Workspaces" ], "x-lugemi-access": "platform-admin" } }, "/v1/admin/workspaces/{id}/revoke-keys": { "post": { "summary": "Revoke all API keys for a workspace", "operationId": "adminRevokeWorkspaceKeys", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "201": { "description": "Keys revoked" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not a platform admin" }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Workspaces" ], "x-lugemi-access": "platform-admin" } }, "/v1/admin/workspaces/{id}/suspend": { "post": { "summary": "Suspend a workspace", "operationId": "adminSuspendWorkspace", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "201": { "description": "Suspended" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Workspaces" ], "x-lugemi-access": "platform-admin" } }, "/v1/admin/workspaces/{id}/usage": { "get": { "summary": "Workspace usage summary", "operationId": "adminWorkspaceUsage", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Usage + quota" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Workspaces" ], "x-lugemi-access": "platform-admin" } }, "/v1/admin/workspaces/analytics": { "get": { "summary": "Cross-workspace usage analytics", "operationId": "adminWorkspaceAnalytics", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Aggregated usage" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Workspaces" ], "x-lugemi-access": "platform-admin" } }, "/v1/admin/workspaces/audit": { "get": { "summary": "Platform admin audit log", "operationId": "adminPlatformAudit", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "AdminAuditEvent rows" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Workspaces" ], "x-lugemi-access": "platform-admin" } }, "/v1/admin/workspaces/bulk": { "post": { "summary": "Bulk suspend, resume, or CSV export", "operationId": "adminBulkWorkspaces", "security": [ { "ClerkAuth": [] } ], "responses": { "201": { "description": "Bulk result or CSV" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Admin · Workspaces" ], "x-lugemi-access": "platform-admin" } }, "/v1/african-intelligence-cloud/engine": { "get": { "summary": "African Intelligence Cloud engine catalog", "operationId": "getAfricanIntelligenceCloudEngine", "responses": { "200": { "description": "African Intelligence Cloud catalog + honesty" } }, "tags": [ "African intelligence cloud" ] } }, "/v1/african-intelligence-cloud/monitoring": { "get": { "summary": "African Intelligence Cloud monitoring", "operationId": "getAfricanIntelligenceCloudMonitoring", "responses": { "200": { "description": "Monitoring snapshot" } }, "tags": [ "African intelligence cloud" ] } }, "/v1/african-intelligence-cloud/overview": { "get": { "summary": "African Intelligence Cloud org overview", "operationId": "getAfricanIntelligenceCloudOverview", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Session usage + product catalog" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "African intelligence cloud" ] } }, "/v1/african-intelligence-cloud/products": { "get": { "summary": "African Intelligence Cloud products", "operationId": "listAfricanIntelligenceCloudProducts", "responses": { "200": { "description": "African Intelligence Cloud products" } }, "tags": [ "African intelligence cloud" ] } }, "/v1/african-intelligence-cloud/routing": { "get": { "summary": "African Intelligence routing table", "operationId": "getAfricanIntelligenceCloudRouting", "responses": { "200": { "description": "Static routing catalog" } }, "tags": [ "African intelligence cloud" ] } }, "/v1/african-knowledge-graph/edges": { "get": { "summary": "List African knowledge graph edges", "operationId": "listAfricanKnowledgeGraphEdges", "responses": { "200": { "description": "Graph edges" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "African knowledge graph" ] } }, "/v1/african-knowledge-graph/engine": { "get": { "summary": "African Knowledge Graph engine catalog", "operationId": "getAfricanKnowledgeGraphEngine", "responses": { "200": { "description": "African Knowledge Graph catalog + honesty" } }, "tags": [ "African knowledge graph" ] } }, "/v1/african-knowledge-graph/monitoring": { "get": { "summary": "African Knowledge Graph monitoring", "operationId": "getAfricanKnowledgeGraphMonitoring", "responses": { "200": { "description": "Monitoring snapshot" } }, "tags": [ "African knowledge graph" ] } }, "/v1/african-knowledge-graph/nodes": { "get": { "summary": "List African knowledge graph nodes", "operationId": "listAfricanKnowledgeGraphNodes", "responses": { "200": { "description": "Graph nodes" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "African knowledge graph" ] } }, "/v1/african-knowledge-graph/products": { "get": { "summary": "African Knowledge Graph products", "operationId": "listAfricanKnowledgeGraphProducts", "responses": { "200": { "description": "African Knowledge Graph products" } }, "tags": [ "African knowledge graph" ] } }, "/v1/african-knowledge-graph/query": { "get": { "summary": "Query African knowledge graph", "operationId": "queryAfricanKnowledgeGraph", "responses": { "200": { "description": "Filtered nodes/edges" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "African knowledge graph" ] } }, "/v1/african-language-registry/engine": { "get": { "summary": "African Language Registry engine catalog", "operationId": "getAfricanLanguageRegistryEngine", "responses": { "200": { "description": "African Language Registry catalog + honesty" } }, "tags": [ "African language registry" ] } }, "/v1/african-language-registry/families": { "get": { "summary": "List language families", "operationId": "listAfricanLanguageRegistryFamilies", "responses": { "200": { "description": "Family metadata" } }, "tags": [ "African language registry" ] } }, "/v1/african-language-registry/languages": { "get": { "summary": "List African language registry entries", "operationId": "listAfricanLanguageRegistryLanguages", "responses": { "200": { "description": "Language seed entries" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "African language registry" ] } }, "/v1/african-language-registry/monitoring": { "get": { "summary": "African Language Registry monitoring", "operationId": "getAfricanLanguageRegistryMonitoring", "responses": { "200": { "description": "Monitoring snapshot" } }, "tags": [ "African language registry" ] } }, "/v1/african-language-registry/products": { "get": { "summary": "African Language Registry products", "operationId": "listAfricanLanguageRegistryProducts", "responses": { "200": { "description": "African Language Registry products" } }, "tags": [ "African language registry" ] } }, "/v1/agent-fabric/collaborate": { "post": { "summary": "Sandbox agent collaboration via Agent Runtime", "operationId": "collaborateAgentFabric", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Collaboration session" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Agent fabric" ] } }, "/v1/agent-fabric/discover": { "get": { "summary": "Discover workspace agents via Agent Runtime", "operationId": "discoverAgentFabric", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Agent list" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Agent fabric" ] } }, "/v1/agent-fabric/distribute": { "post": { "summary": "Plan agent distribution to same-org workspaces", "operationId": "distributeAgentFabric", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Distribution plan + optional Event Fabric event" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Agent fabric" ] } }, "/v1/agent-fabric/engine": { "get": { "summary": "Agent Fabric engine (alias of products)", "operationId": "getAgentFabricEngine", "responses": { "200": { "description": "Catalog + honesty" } }, "tags": [ "Agent fabric" ] } }, "/v1/agent-fabric/federate": { "post": { "summary": "List agent federation handoff targets", "operationId": "federateAgentFabric", "responses": { "200": { "description": "Federation handoff catalog" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Agent fabric" ] } }, "/v1/agent-fabric/marketplace": { "get": { "summary": "Agent marketplace listing counts", "operationId": "marketplaceAgentFabric", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Listing counts" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Agent fabric" ] } }, "/v1/agent-fabric/monitoring": { "get": { "summary": "Agent Fabric monitoring", "operationId": "getAgentFabricMonitoring", "responses": { "200": { "description": "Counters + honesty" } }, "tags": [ "Agent fabric" ] } }, "/v1/agent-fabric/overview": { "get": { "summary": "Agent Fabric org overview", "operationId": "getAgentFabricOverview", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Session + pipelines + counters" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Agent fabric" ] } }, "/v1/agent-fabric/pipeline": { "post": { "summary": "Plan an agent pipeline (ordered Runtime handoffs)", "operationId": "planAgentFabricPipeline", "responses": { "200": { "description": "Pipeline + routed steps" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Agent fabric" ] } }, "/v1/agent-fabric/products": { "get": { "summary": "Agent Fabric capability catalog", "operationId": "listAgentFabricProducts", "responses": { "200": { "description": "Agent router capabilities, pipelines, Runtime handoff honesty" } }, "tags": [ "Agent fabric" ] } }, "/v1/agent-fabric/route": { "post": { "summary": "Plan agent routing for selected kinds", "operationId": "planAgentFabricRoute", "responses": { "200": { "description": "Router plan" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Agent fabric" ] } }, "/v1/agent-fabric/routes": { "get": { "summary": "Agent Fabric routing table", "operationId": "listAgentFabricRoutes", "responses": { "200": { "description": "kind → Runtime/Policy handoffs" } }, "tags": [ "Agent fabric" ] } }, "/v1/agent-fabric/schedule": { "post": { "summary": "Schedule stub via Agent Runtime", "operationId": "scheduleAgentFabric", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Schedule record" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Agent fabric" ] } }, "/v1/agent-fabric/stream": { "get": { "summary": "Agent Fabric SSE realtime ticks", "operationId": "streamAgentFabric", "responses": { "200": { "description": "text/event-stream ticks" } }, "tags": [ "Agent fabric" ] } }, "/v1/agent-fabric/versions": { "get": { "summary": "Agent Fabric version catalog", "operationId": "listAgentFabricVersions", "responses": { "200": { "description": "Router/pipeline/sandbox versions" } }, "tags": [ "Agent fabric" ] } }, "/v1/agent-marketplace/analytics": { "get": { "summary": "Agent marketplace analytics", "operationId": "getAgentMarketplaceAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Aggregates" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Agent marketplace" ] } }, "/v1/agent-marketplace/engine": { "get": { "summary": "Agent Marketplace engine catalog", "operationId": "getAgentMarketplaceEngine", "responses": { "200": { "description": "Agent marketplace capabilities, Stripe honesty, sandbox + Policy hard-gate denials" } }, "tags": [ "Agent marketplace" ] } }, "/v1/agent-marketplace/installs": { "get": { "operationId": "agentMarketplaceInstalls", "summary": "Installs", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Agent marketplace" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/agent-marketplace/listings": { "get": { "summary": "List agent marketplace listings", "operationId": "listAgentMarketplaceListings", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Published or mine agent listings" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Agent marketplace" ] }, "post": { "summary": "Publish an Agent Runtime agent as a marketplace listing", "operationId": "publishAgentMarketplaceListing", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Listing created" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Agent marketplace" ] } }, "/v1/agent-marketplace/listings/{id}": { "delete": { "operationId": "agentMarketplaceUnpublish", "summary": "Unpublish", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Agent marketplace" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/agent-marketplace/listings/{id}/install": { "post": { "summary": "Install an agent listing into Agent Runtime (sandboxed)", "operationId": "installAgentMarketplaceListing", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Sandboxed agent installed" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Policy deny" }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Agent marketplace" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/agent-marketplace/listings/{id}/reviews": { "get": { "summary": "List agent listing reviews", "operationId": "listAgentMarketplaceReviews", "responses": { "200": { "description": "Reviews" }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Agent marketplace" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] }, "post": { "summary": "Upsert an agent listing review", "operationId": "reviewAgentMarketplaceListing", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Review saved" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Agent marketplace" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/agent-marketplace/listings/{id}/run": { "post": { "summary": "Run an installed marketplace agent (Policy-gated sandbox)", "operationId": "runAgentMarketplaceListing", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Sandbox run result (may be denied)" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not installed or policy deny" }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Agent marketplace" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/agent-marketplace/listings/{id}/update": { "post": { "operationId": "agentMarketplaceUpdate", "summary": "Update", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Agent marketplace" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/agent-marketplace/monitoring": { "get": { "summary": "Agent marketplace monitoring", "operationId": "getAgentMarketplaceMonitoring", "responses": { "200": { "description": "Capability status snapshot" } }, "tags": [ "Agent marketplace" ] } }, "/v1/agent-marketplace/products": { "get": { "summary": "Agent Marketplace products (alias of engine)", "operationId": "listAgentMarketplaceProducts", "responses": { "200": { "description": "Agent marketplace catalog + honesty" } }, "tags": [ "Agent marketplace" ] } }, "/v1/agent-marketplace/sales": { "get": { "summary": "Agent marketplace publisher sales", "operationId": "listAgentMarketplaceSales", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Sale receipts + fee honesty" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Agent marketplace" ] } }, "/v1/agent-operating-system/engine": { "get": { "summary": "Agent Operating System engine", "operationId": "getAgentOperatingSystemEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Agent operating system" ] } }, "/v1/agent-operating-system/execute": { "get": { "summary": "Execute via Agent Operating System", "operationId": "executeAgentOperatingSystem", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Agent operating system" ] } }, "/v1/agent-operating-system/monitoring": { "get": { "summary": "Agent Operating System monitoring", "operationId": "getAgentOperatingSystemMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Agent operating system" ] } }, "/v1/agent-operating-system/products": { "get": { "summary": "Agent Operating System products", "operationId": "listAgentOperatingSystemProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Agent operating system" ] } }, "/v1/agent-operating-system/query": { "get": { "summary": "Query Agent Operating System", "operationId": "queryAgentOperatingSystem", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Agent operating system" ] } }, "/v1/agent-operating-system/route": { "get": { "summary": "Route via Agent Operating System", "operationId": "routeAgentOperatingSystem", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Agent operating system" ] } }, "/v1/agent-operating-system/routes": { "get": { "summary": "Agent Operating System routes", "operationId": "listAgentOperatingSystemRoutes", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Agent operating system" ] } }, "/v1/agent-runtime/agents": { "get": { "summary": "List agents", "operationId": "listAgentRuntimeAgents", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Workspace agents" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Agent runtime" ] }, "post": { "summary": "Create agent", "operationId": "createAgentRuntimeAgent", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Agent created (draft)" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Agent runtime" ] } }, "/v1/agent-runtime/agents/{id}": { "get": { "summary": "Get agent", "operationId": "getAgentRuntimeAgent", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Agent" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Agent runtime" ] } }, "/v1/agent-runtime/agents/{id}/lifecycle": { "post": { "summary": "Update agent lifecycle", "operationId": "lifecycleAgentRuntimeAgent", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Lifecycle updated" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Agent runtime" ] } }, "/v1/agent-runtime/analytics": { "get": { "summary": "Agent Runtime analytics", "operationId": "getAgentRuntimeAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Aggregates" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Agent runtime" ] } }, "/v1/agent-runtime/collaborate": { "post": { "summary": "Sandbox multi-agent collaboration", "operationId": "collaborateAgentRuntime", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Collaboration session" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Agent runtime" ] } }, "/v1/agent-runtime/engine": { "get": { "summary": "Agent Runtime catalog", "operationId": "getAgentRuntimeEngine", "responses": { "200": { "description": "Agent sandbox capabilities, permissions, honesty" } }, "tags": [ "Agent runtime" ] } }, "/v1/agent-runtime/marketplace": { "get": { "summary": "Agent marketplace counts", "operationId": "getAgentRuntimeMarketplace", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Listing counts" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Agent runtime" ] } }, "/v1/agent-runtime/memory": { "post": { "summary": "Put agent memory", "operationId": "putAgentRuntimeMemory", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Memory stored via Memory Runtime" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Agent runtime" ] } }, "/v1/agent-runtime/monitoring": { "get": { "summary": "Agent Runtime monitoring", "operationId": "getAgentRuntimeMonitoring", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Monitoring + safety" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Agent runtime" ] } }, "/v1/agent-runtime/permissions": { "get": { "summary": "Agent Runtime grantable permissions", "operationId": "listAgentRuntimePermissions", "responses": { "200": { "description": "Allowlist + denied actions" } }, "tags": [ "Agent runtime" ] } }, "/v1/agent-runtime/run": { "post": { "summary": "Run agent (sandbox + hard permissions)", "operationId": "runAgentRuntime", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Sandbox run result" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Permission/policy hard deny" } }, "tags": [ "Agent runtime" ] } }, "/v1/agent-runtime/schedule": { "post": { "summary": "Schedule agent run (record only)", "operationId": "scheduleAgentRuntime", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Schedule recorded" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Agent runtime" ] } }, "/v1/agentops-platform/agents": { "get": { "summary": "List AgentOps Platform agents", "operationId": "listAgentopsPlatformAgents", "responses": { "200": { "description": "Filtered catalog rows" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AgentOps platform" ] } }, "/v1/agentops-platform/engine": { "get": { "summary": "AgentOps Platform engine catalog", "operationId": "getAgentopsPlatformEngine", "responses": { "200": { "description": "Engine catalog" } }, "tags": [ "AgentOps platform" ] } }, "/v1/agentops-platform/monitoring": { "get": { "summary": "AgentOps Platform monitoring", "operationId": "getAgentopsPlatformMonitoring", "responses": { "200": { "description": "Monitoring snapshot" } }, "tags": [ "AgentOps platform" ] } }, "/v1/agentops-platform/products": { "get": { "summary": "AgentOps Platform products alias", "operationId": "listAgentopsPlatformProducts", "responses": { "200": { "description": "Engine catalog" } }, "tags": [ "AgentOps platform" ] } }, "/v1/agentops-platform/query": { "get": { "summary": "Query AgentOps Platform", "operationId": "queryAgentopsPlatform", "responses": { "200": { "description": "Filtered catalog rows" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AgentOps platform" ] } }, "/v1/agents/engine": { "get": { "summary": "Builders agents catalog (chatbot + voice agent)", "description": "Public capability catalog listing Chatbot (`POST /v1/chat/completions`) and Voice Agent (`POST /v1/voice/agent/turn`) APIs, auth, and honest language coverage notes. No authentication required.", "operationId": "buildersAgentsEngine", "security": [], "responses": { "200": { "description": "Chatbot + Voice Agent capability cards and API map" } }, "tags": [ "Agents" ] } }, "/v1/agents/profiles": { "get": { "tags": [ "Agents" ], "summary": "List chatbot and voice agent profiles", "operationId": "listAgentProfiles", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Workspace agent profiles" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/agents/profiles/{kind}": { "get": { "tags": [ "Agents" ], "summary": "Get agent profile (chatbot or voice_agent)", "operationId": "getAgentProfile", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Profile with persona and behaviours" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "parameters": [ { "name": "kind", "in": "path", "required": true, "schema": { "type": "string" } } ] }, "patch": { "tags": [ "Agents" ], "summary": "Update agent profile", "operationId": "updateAgentProfile", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Updated profile" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "parameters": [ { "name": "kind", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/agents/profiles/{kind}/avatar": { "get": { "tags": [ "Agents" ], "summary": "Download agent profile picture", "operationId": "getAgentAvatar", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Image bytes" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "parameters": [ { "name": "kind", "in": "path", "required": true, "schema": { "type": "string" } } ] }, "post": { "tags": [ "Agents" ], "summary": "Upload agent profile picture", "operationId": "uploadAgentAvatar", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Profile with avatar URL" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "parameters": [ { "name": "kind", "in": "path", "required": true, "schema": { "type": "string" } } ] }, "delete": { "tags": [ "Agents" ], "summary": "Remove agent profile picture", "operationId": "deleteAgentAvatar", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Profile without avatar" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "parameters": [ { "name": "kind", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/agricultural-intelligence/engine": { "get": { "summary": "Agricultural Intelligence engine catalog", "operationId": "getAgriculturalIntelligenceEngine", "responses": { "200": { "description": "Agricultural Intelligence catalog + honesty" } }, "tags": [ "Agricultural intelligence" ] } }, "/v1/agricultural-intelligence/monitoring": { "get": { "summary": "Agricultural Intelligence monitoring", "operationId": "getAgriculturalIntelligenceMonitoring", "responses": { "200": { "description": "Monitoring snapshot" } }, "tags": [ "Agricultural intelligence" ] } }, "/v1/agricultural-intelligence/products": { "get": { "summary": "Agricultural Intelligence products", "operationId": "listAgriculturalIntelligenceProducts", "responses": { "200": { "description": "Agricultural Intelligence products" } }, "tags": [ "Agricultural intelligence" ] } }, "/v1/agricultural-intelligence/query": { "get": { "summary": "Query Agricultural Intelligence terms", "operationId": "queryAgriculturalIntelligenceTerms", "responses": { "200": { "description": "Filtered domain terms" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Agricultural intelligence" ] } }, "/v1/agricultural-intelligence/terms": { "get": { "summary": "List Agricultural Intelligence terms", "operationId": "listAgriculturalIntelligenceTerms", "responses": { "200": { "description": "Domain terms" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Agricultural intelligence" ] } }, "/v1/ai-drift-detection/check": { "get": { "summary": "Drift clear check for Continuous Learning promote", "operationId": "checkAiDriftDetection", "responses": { "200": { "description": "Drift clear status" } }, "tags": [ "AI drift detection" ] } }, "/v1/ai-drift-detection/engine": { "get": { "summary": "AI Drift Detection engine catalog", "operationId": "getAiDriftDetectionEngine", "responses": { "200": { "description": "Engine catalog" } }, "tags": [ "AI drift detection" ] } }, "/v1/ai-drift-detection/monitoring": { "get": { "summary": "AI Drift Detection monitoring", "operationId": "getAiDriftDetectionMonitoring", "responses": { "200": { "description": "Monitoring snapshot" } }, "tags": [ "AI drift detection" ] } }, "/v1/ai-drift-detection/products": { "get": { "summary": "AI Drift Detection products alias", "operationId": "listAiDriftDetectionProducts", "responses": { "200": { "description": "Engine catalog" } }, "tags": [ "AI drift detection" ] } }, "/v1/ai-drift-detection/query": { "get": { "summary": "Query AI Drift Detection", "operationId": "queryAiDriftDetection", "responses": { "200": { "description": "Filtered catalog rows" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI drift detection" ] } }, "/v1/ai-drift-detection/signals": { "get": { "summary": "List AI Drift Detection signals", "operationId": "listAiDriftDetectionSignals", "responses": { "200": { "description": "Filtered catalog rows" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI drift detection" ] } }, "/v1/ai-engineering-standards/check/list": { "get": { "summary": "AI engineering check list", "operationId": "listAiEngineeringStandardsCheckList", "responses": { "200": { "description": "OK" } }, "tags": [ "AI engineering standards" ] } }, "/v1/ai-engineering-standards/checks": { "get": { "summary": "AI engineering retroactive checks", "operationId": "listAiEngineeringStandardsChecks", "responses": { "200": { "description": "OK" } }, "tags": [ "AI engineering standards" ] } }, "/v1/ai-engineering-standards/engine": { "get": { "summary": "AI Engineering Standards engine", "operationId": "getAiEngineeringStandardsEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "AI engineering standards" ] } }, "/v1/ai-engineering-standards/execute": { "get": { "summary": "Execute via AI Engineering Standards", "operationId": "executeAiEngineeringStandards", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI engineering standards" ] } }, "/v1/ai-engineering-standards/monitoring": { "get": { "summary": "AI Engineering Standards monitoring", "operationId": "getAiEngineeringStandardsMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "AI engineering standards" ] } }, "/v1/ai-engineering-standards/products": { "get": { "summary": "AI Engineering Standards products", "operationId": "listAiEngineeringStandardsProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "AI engineering standards" ] } }, "/v1/ai-engineering-standards/query": { "get": { "summary": "Query AI Engineering Standards", "operationId": "queryAiEngineeringStandards", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI engineering standards" ] } }, "/v1/ai-engineering-standards/route": { "get": { "summary": "Route via AI Engineering Standards", "operationId": "routeAiEngineeringStandards", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI engineering standards" ] } }, "/v1/ai-engineering-standards/routes": { "get": { "summary": "AI Engineering Standards routes", "operationId": "listAiEngineeringStandardsRoutes", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI engineering standards" ] } }, "/v1/ai-fabric/engine": { "get": { "summary": "AI Fabric engine (alias of products)", "operationId": "getAiFabricEngine", "responses": { "200": { "description": "Fabric catalog + honesty" } }, "tags": [ "AI fabric" ] } }, "/v1/ai-fabric/monitoring": { "get": { "summary": "AI Fabric foundation monitoring", "operationId": "getAiFabricMonitoring", "responses": { "200": { "description": "Bus status snapshot + honesty" } }, "tags": [ "AI fabric" ] } }, "/v1/ai-fabric/overview": { "get": { "summary": "AI Fabric org overview", "operationId": "getAiFabricOverview", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Session usage, deferred buses, safety notes" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI fabric" ] } }, "/v1/ai-fabric/products": { "get": { "summary": "AI Fabric bus catalog", "operationId": "listAiFabricBuses", "responses": { "200": { "description": "Internal fabric buses, architecture, and policy hard-gate honesty" } }, "tags": [ "AI fabric" ] } }, "/v1/ai-fabric/routing": { "get": { "summary": "AI Fabric service-discovery routing table", "operationId": "getAiFabricRouting", "responses": { "200": { "description": "Static cloud/runtime route catalog" } }, "tags": [ "AI fabric" ] } }, "/v1/ai-governance-platform/approvals": { "get": { "summary": "AI Governance Platform approvals", "operationId": "listAiGovernancePlatformApprovals", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI governance platform" ] } }, "/v1/ai-governance-platform/approvals/{id}/approve": { "post": { "summary": "Approve governance approval", "operationId": "approveAiGovernancePlatformApproval", "responses": { "200": { "description": "Updated approval" }, "201": { "description": "Updated approval" }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI governance platform" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/ai-governance-platform/approvals/{id}/reject": { "post": { "summary": "Reject governance approval", "operationId": "rejectAiGovernancePlatformApproval", "responses": { "200": { "description": "Updated approval" }, "201": { "description": "Updated approval" }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI governance platform" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/ai-governance-platform/check": { "get": { "summary": "Check AI Governance Platform", "operationId": "checkAiGovernancePlatform", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI governance platform" ] } }, "/v1/ai-governance-platform/engine": { "get": { "summary": "AI Governance Platform engine", "operationId": "getAiGovernancePlatformEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "AI governance platform" ] } }, "/v1/ai-governance-platform/monitoring": { "get": { "summary": "AI Governance Platform monitoring", "operationId": "getAiGovernancePlatformMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "AI governance platform" ] } }, "/v1/ai-governance-platform/products": { "get": { "summary": "AI Governance Platform products", "operationId": "listAiGovernancePlatformProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "AI governance platform" ] } }, "/v1/ai-governance-platform/query": { "get": { "summary": "Query AI Governance Platform", "operationId": "queryAiGovernancePlatform", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI governance platform" ] } }, "/v1/ai-governance-platform/status/{id}": { "get": { "summary": "Governance approval status", "operationId": "getAiGovernancePlatformStatus", "responses": { "200": { "description": "Approval status" }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI governance platform" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/ai-kernel/engine": { "get": { "summary": "AI Kernel engine (alias of products)", "operationId": "getAiKernelEngine", "responses": { "200": { "description": "Kernel catalog + honesty" } }, "tags": [ "AI kernel" ] } }, "/v1/ai-kernel/monitoring": { "get": { "summary": "AI Kernel foundation monitoring", "operationId": "getAiKernelMonitoring", "responses": { "200": { "description": "Runtime status snapshot + safety honesty" } }, "tags": [ "AI kernel" ] } }, "/v1/ai-kernel/overview": { "get": { "summary": "AI Kernel org overview", "operationId": "getAiKernelOverview", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Session usage, deferred runtimes, safety notes" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI kernel" ] } }, "/v1/ai-kernel/products": { "get": { "summary": "AI Kernel runtime catalog", "operationId": "listAiKernelRuntimes", "responses": { "200": { "description": "Internal kernel runtimes, architecture, and safety notes" } }, "tags": [ "AI kernel" ] } }, "/v1/ai-memory-operating-system/engine": { "get": { "summary": "AI Memory Operating System engine", "operationId": "getAiMemoryOperatingSystemEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "AI memory operating system" ] } }, "/v1/ai-memory-operating-system/execute": { "get": { "summary": "Execute via AI Memory Operating System", "operationId": "executeAiMemoryOperatingSystem", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI memory operating system" ] } }, "/v1/ai-memory-operating-system/monitoring": { "get": { "summary": "AI Memory Operating System monitoring", "operationId": "getAiMemoryOperatingSystemMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "AI memory operating system" ] } }, "/v1/ai-memory-operating-system/products": { "get": { "summary": "AI Memory Operating System products", "operationId": "listAiMemoryOperatingSystemProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "AI memory operating system" ] } }, "/v1/ai-memory-operating-system/query": { "get": { "summary": "Query AI Memory Operating System", "operationId": "queryAiMemoryOperatingSystem", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI memory operating system" ] } }, "/v1/ai-memory-operating-system/route": { "get": { "summary": "Route via AI Memory Operating System", "operationId": "routeAiMemoryOperatingSystem", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI memory operating system" ] } }, "/v1/ai-memory-operating-system/routes": { "get": { "summary": "AI Memory Operating System routes", "operationId": "listAiMemoryOperatingSystemRoutes", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI memory operating system" ] } }, "/v1/ai-operations-dashboard/engine": { "get": { "summary": "AI Operations Dashboard engine catalog", "operationId": "getAiOperationsDashboardEngine", "responses": { "200": { "description": "Engine catalog" } }, "tags": [ "AI operations dashboard" ] } }, "/v1/ai-operations-dashboard/monitoring": { "get": { "summary": "AI Operations Dashboard monitoring", "operationId": "getAiOperationsDashboardMonitoring", "responses": { "200": { "description": "Monitoring snapshot" } }, "tags": [ "AI operations dashboard" ] } }, "/v1/ai-operations-dashboard/products": { "get": { "summary": "AI Operations Dashboard products alias", "operationId": "listAiOperationsDashboardProducts", "responses": { "200": { "description": "Engine catalog" } }, "tags": [ "AI operations dashboard" ] } }, "/v1/ai-operations-dashboard/query": { "get": { "summary": "Query AI Operations Dashboard", "operationId": "queryAiOperationsDashboard", "responses": { "200": { "description": "Filtered catalog rows" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI operations dashboard" ] } }, "/v1/ai-operations-dashboard/snapshot": { "get": { "summary": "List AI Operations Dashboard snapshot", "operationId": "listAiOperationsDashboardSnapshot", "responses": { "200": { "description": "Filtered catalog rows" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI operations dashboard" ] } }, "/v1/ai-orchestration/analytics": { "get": { "summary": "AI Orchestration analytics", "operationId": "getAiOrchestrationAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Run audit aggregates" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI orchestration" ] } }, "/v1/ai-orchestration/engine": { "get": { "summary": "AI Orchestration catalog", "operationId": "getAiOrchestrationEngine", "responses": { "200": { "description": "Pipelines and multi-cloud-agent honesty notes" } }, "tags": [ "AI orchestration" ] } }, "/v1/ai-orchestration/monitoring": { "get": { "summary": "AI Orchestration monitoring snapshot", "operationId": "getAiOrchestrationMonitoring", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Monitoring snapshot" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI orchestration" ] } }, "/v1/ai-orchestration/pipelines": { "get": { "summary": "Orchestration pipelines", "operationId": "listAiOrchestrationPipelines", "responses": { "200": { "description": "Named e2e pipelines" } }, "tags": [ "AI orchestration" ] } }, "/v1/ai-orchestration/run": { "post": { "summary": "Run an orchestration pipeline", "operationId": "runAiOrchestration", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Step results from real gateway/engine calls" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI orchestration" ] } }, "/v1/ai-publication-platform/engine": { "get": { "summary": "AI Publication Platform engine catalog", "operationId": "getAiPublicationPlatformEngine", "responses": { "200": { "description": "AI Publication Platform catalog + honesty" } }, "tags": [ "AI publication platform" ] } }, "/v1/ai-publication-platform/monitoring": { "get": { "summary": "AI Publication Platform monitoring", "operationId": "getAiPublicationPlatformMonitoring", "responses": { "200": { "description": "Monitoring snapshot" } }, "tags": [ "AI publication platform" ] } }, "/v1/ai-publication-platform/products": { "get": { "summary": "AI Publication Platform products", "operationId": "listAiPublicationPlatformProducts", "responses": { "200": { "description": "AI Publication Platform products" } }, "tags": [ "AI publication platform" ] } }, "/v1/ai-publication-platform/publications": { "get": { "summary": "List publications", "operationId": "listAiPublicationPlatformPublications", "responses": { "200": { "description": "List publications" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI publication platform" ] } }, "/v1/ai-publication-platform/query": { "get": { "summary": "Query AI Publication Platform", "operationId": "queryAiPublicationPlatform", "responses": { "200": { "description": "Filtered catalog rows" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI publication platform" ] } }, "/v1/ai-router/analytics": { "get": { "summary": "AI Router analytics", "operationId": "getAiRouterAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Decision aggregates" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI router" ] } }, "/v1/ai-router/decisions": { "get": { "summary": "Recent dry-run route decisions", "operationId": "listAiRouterDecisions", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Decision log" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI router" ] } }, "/v1/ai-router/engine": { "get": { "summary": "AI Router catalog", "operationId": "getAiRouterEngine", "responses": { "200": { "description": "Capabilities, honesty, and spend-safety notes" } }, "tags": [ "AI router" ] } }, "/v1/ai-router/features": { "get": { "summary": "Routable inference features", "operationId": "listAiRouterFeatures", "responses": { "200": { "description": "Feature → gateway API map" } }, "tags": [ "AI router" ] } }, "/v1/ai-router/monitoring": { "get": { "summary": "AI Router monitoring", "operationId": "getAiRouterMonitoring", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Monitoring + honesty snapshot" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI router" ] } }, "/v1/ai-router/policies": { "get": { "summary": "Workspace AI Router policy", "operationId": "getAiRouterPolicy", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Org/workspace policy or defaults" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI router" ] }, "put": { "summary": "Upsert workspace AI Router policy", "operationId": "upsertAiRouterPolicy", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Policy saved" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Router mode disabled" } }, "tags": [ "AI router" ] } }, "/v1/ai-router/providers": { "get": { "summary": "Router provider IDs", "operationId": "listAiRouterProviders", "responses": { "200": { "description": "Gateway provider IDs used by router" } }, "tags": [ "AI router" ] } }, "/v1/ai-router/resolve": { "post": { "summary": "Dry-run resolve model/provider route", "operationId": "resolveAiRouter", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Selected candidate + ordered fallback chain" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "No candidates available" } }, "tags": [ "AI router" ] } }, "/v1/ai-runtime-analytics/cache": { "get": { "summary": "Cache hit/miss aggregates", "operationId": "getAiRuntimeAnalyticsCache", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Intelligent Cache hit rates" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI runtime analytics" ] } }, "/v1/ai-runtime-analytics/cost": { "get": { "summary": "Runtime cost aggregates", "operationId": "getAiRuntimeAnalyticsCost", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Ledger + GPU hourly (report-only)" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI runtime analytics" ] } }, "/v1/ai-runtime-analytics/cpu": { "get": { "summary": "CPU host/process snapshot", "operationId": "getAiRuntimeAnalyticsCpu", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Nest host/process CPU snapshot" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI runtime analytics" ] } }, "/v1/ai-runtime-analytics/customers": { "get": { "summary": "Customer/workspace activity", "operationId": "getAiRuntimeAnalyticsCustomers", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Org/workspace activity counts" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI runtime analytics" ] } }, "/v1/ai-runtime-analytics/engine": { "get": { "summary": "AI Runtime Analytics catalog", "operationId": "getAiRuntimeAnalyticsEngine", "responses": { "200": { "description": "Capabilities and honesty flags" } }, "tags": [ "AI runtime analytics" ] } }, "/v1/ai-runtime-analytics/errors": { "get": { "summary": "Error proxies", "operationId": "getAiRuntimeAnalyticsErrors", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Failed batch/streaming + audit proxies" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI runtime analytics" ] } }, "/v1/ai-runtime-analytics/gpu": { "get": { "summary": "GPU usage aggregates", "operationId": "getAiRuntimeAnalyticsGpu", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Sandbox GPU allocation aggregates" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI runtime analytics" ] } }, "/v1/ai-runtime-analytics/latency": { "get": { "summary": "Runtime latency proxies", "operationId": "getAiRuntimeAnalyticsLatency", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "p50/p95 latency proxies" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI runtime analytics" ] } }, "/v1/ai-runtime-analytics/models": { "get": { "summary": "Model selection aggregates", "operationId": "getAiRuntimeAnalyticsModels", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Router + serving model aggregates" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI runtime analytics" ] } }, "/v1/ai-runtime-analytics/monitoring": { "get": { "summary": "Runtime analytics monitoring", "operationId": "getAiRuntimeAnalyticsMonitoring", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Monitoring + honesty snapshot" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI runtime analytics" ] } }, "/v1/ai-runtime-analytics/overview": { "get": { "summary": "Runtime analytics overview", "operationId": "getAiRuntimeAnalyticsOverview", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Bundled Inference Cloud aggregates" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI runtime analytics" ] } }, "/v1/ai-runtime-analytics/report": { "get": { "summary": "Bundled runtime analytics report", "operationId": "getAiRuntimeAnalyticsReport", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Full JSON report" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI runtime analytics" ] } }, "/v1/ai-runtime-analytics/requests": { "get": { "summary": "Request counts", "operationId": "getAiRuntimeAnalyticsRequests", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Request aggregates" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI runtime analytics" ] } }, "/v1/ai-runtime-analytics/streaming": { "get": { "summary": "Streaming session aggregates", "operationId": "getAiRuntimeAnalyticsStreaming", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Streaming Runtime aggregates" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI runtime analytics" ] } }, "/v1/ai-runtime-analytics/throughput": { "get": { "summary": "Runtime throughput", "operationId": "getAiRuntimeAnalyticsThroughput", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Decisions/usage/batch/streaming rates" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI runtime analytics" ] } }, "/v1/ai-safety-platform/check": { "get": { "summary": "Check AI Safety Platform", "operationId": "checkAiSafetyPlatform", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI safety platform" ] } }, "/v1/ai-safety-platform/detections": { "get": { "summary": "AI Safety Platform detections", "operationId": "listAiSafetyPlatformDetections", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI safety platform" ] } }, "/v1/ai-safety-platform/engine": { "get": { "summary": "AI Safety Platform engine", "operationId": "getAiSafetyPlatformEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "AI safety platform" ] } }, "/v1/ai-safety-platform/evaluate": { "get": { "summary": "Evaluate AI Safety Platform", "operationId": "evaluateAiSafetyPlatform", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI safety platform" ] }, "post": { "operationId": "aiSafetyPlatformEvaluate", "summary": "Evaluate", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI safety platform" ] } }, "/v1/ai-safety-platform/monitoring": { "get": { "summary": "AI Safety Platform monitoring", "operationId": "getAiSafetyPlatformMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "AI safety platform" ] } }, "/v1/ai-safety-platform/products": { "get": { "summary": "AI Safety Platform products", "operationId": "listAiSafetyPlatformProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "AI safety platform" ] } }, "/v1/ai-safety-platform/query": { "get": { "summary": "Query AI Safety Platform", "operationId": "queryAiSafetyPlatform", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI safety platform" ] } }, "/v1/ai-scheduler/engine": { "get": { "summary": "AI Scheduler engine", "operationId": "getAiSchedulerEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "AI scheduler" ] } }, "/v1/ai-scheduler/execute": { "get": { "summary": "Execute via AI Scheduler", "operationId": "executeAiScheduler", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI scheduler" ] } }, "/v1/ai-scheduler/monitoring": { "get": { "summary": "AI Scheduler monitoring", "operationId": "getAiSchedulerMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "AI scheduler" ] } }, "/v1/ai-scheduler/products": { "get": { "summary": "AI Scheduler products", "operationId": "listAiSchedulerProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "AI scheduler" ] } }, "/v1/ai-scheduler/query": { "get": { "summary": "Query AI Scheduler", "operationId": "queryAiScheduler", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI scheduler" ] } }, "/v1/ai-scheduler/route": { "get": { "summary": "Route via AI Scheduler", "operationId": "routeAiScheduler", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI scheduler" ] } }, "/v1/ai-scheduler/routes": { "get": { "summary": "AI Scheduler routes", "operationId": "listAiSchedulerRoutes", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "AI scheduler" ] } }, "/v1/align": { "post": { "summary": "Forced alignment for captions (SRT/VTT + word timings)", "operationId": "alignSpeechText", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "text" ], "properties": { "text": { "type": "string" }, "language": { "type": "string" }, "durationMs": { "type": "number" }, "wpm": { "type": "number" } } } } } }, "responses": { "200": { "description": "Word timings with SRT and VTT exports" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Align" ] } }, "/v1/analytics": { "get": { "operationId": "analyticsCatalog", "summary": "Catalog", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } } }, "tags": [ "Analytics" ] } }, "/v1/analytics/costs": { "get": { "operationId": "analyticsCosts", "summary": "Costs", "parameters": [ { "name": "to", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Analytics" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/analytics/countries": { "get": { "operationId": "analyticsCountries", "summary": "Countries", "parameters": [ { "name": "to", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Analytics" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/analytics/dialects": { "get": { "operationId": "analyticsDialects", "summary": "Dialects", "parameters": [ { "name": "to", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Analytics" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/analytics/languages": { "get": { "operationId": "analyticsLanguages", "summary": "Languages", "parameters": [ { "name": "to", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Analytics" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/analytics/latency": { "get": { "operationId": "analyticsLatency", "summary": "Latency", "parameters": [ { "name": "to", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Analytics" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/analytics/monitoring": { "get": { "operationId": "analyticsMonitoring", "summary": "Monitoring", "parameters": [ { "name": "to", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Analytics" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/analytics/overview": { "get": { "summary": "Org analytics overview (volume, estimated cost, job error rate)", "operationId": "getAnalyticsOverview", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "from", "in": "query", "schema": { "type": "string", "format": "date-time" }, "description": "Period start (default: first day of current UTC month)" }, { "name": "to", "in": "query", "schema": { "type": "string", "format": "date-time" }, "description": "Period end exclusive (default: now)" } ], "responses": { "200": { "description": "Aggregates from usage_events, translation_requests, and jobs" }, "400": { "description": "Invalid period", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Analytics" ] } }, "/v1/analytics/quality": { "get": { "operationId": "analyticsQuality", "summary": "Quality", "parameters": [ { "name": "to", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Analytics" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/analytics/reports/enterprise": { "get": { "operationId": "analyticsEnterpriseReport", "summary": "Enterprise report", "parameters": [ { "name": "to", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Analytics" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/analytics/translation": { "get": { "operationId": "analyticsTranslation", "summary": "Translation", "parameters": [ { "name": "to", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Analytics" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/api-engineering-standards/engine": { "get": { "summary": "API Engineering Standards engine", "operationId": "getApiEngineeringStandardsEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "API engineering standards" ] } }, "/v1/api-engineering-standards/execute": { "get": { "summary": "Execute via API Engineering Standards", "operationId": "executeApiEngineeringStandards", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "API engineering standards" ] } }, "/v1/api-engineering-standards/monitoring": { "get": { "summary": "API Engineering Standards monitoring", "operationId": "getApiEngineeringStandardsMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "API engineering standards" ] } }, "/v1/api-engineering-standards/products": { "get": { "summary": "API Engineering Standards products", "operationId": "listApiEngineeringStandardsProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "API engineering standards" ] } }, "/v1/api-engineering-standards/query": { "get": { "summary": "Query API Engineering Standards", "operationId": "queryApiEngineeringStandards", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "API engineering standards" ] } }, "/v1/api-engineering-standards/route": { "get": { "summary": "Route via API Engineering Standards", "operationId": "routeApiEngineeringStandards", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "API engineering standards" ] } }, "/v1/api-engineering-standards/routes": { "get": { "summary": "API Engineering Standards routes", "operationId": "listApiEngineeringStandardsRoutes", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "API engineering standards" ] } }, "/v1/api-keys": { "get": { "summary": "List API keys", "operationId": "listApiKeys", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Key prefixes (secrets never returned)" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "API keys" ] }, "post": { "summary": "Create API key", "operationId": "createApiKey", "security": [ { "ClerkAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string" } } } } } }, "responses": { "201": { "description": "Created; includes secret once" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "API keys" ] } }, "/v1/api-keys/{id}": { "delete": { "summary": "Revoke API key", "operationId": "revokeApiKey", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Revoked" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "API keys" ] } }, "/v1/api-keys/ensure": { "post": { "operationId": "apiKeysEnsureLive", "summary": "Ensure live", "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "API keys" ], "security": [ { "ClerkAuth": [] } ] } }, "/v1/architecture-governance/adr-series": { "get": { "summary": "ADR series note", "operationId": "getArchitectureGovernanceAdrSeries", "responses": { "200": { "description": "OK" } }, "tags": [ "Architecture governance" ] } }, "/v1/architecture-governance/engine": { "get": { "summary": "Architecture Governance engine", "operationId": "getArchitectureGovernanceEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Architecture governance" ] } }, "/v1/architecture-governance/execute": { "get": { "summary": "Execute via Architecture Governance", "operationId": "executeArchitectureGovernance", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Architecture governance" ] } }, "/v1/architecture-governance/monitoring": { "get": { "summary": "Architecture Governance monitoring", "operationId": "getArchitectureGovernanceMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Architecture governance" ] } }, "/v1/architecture-governance/products": { "get": { "summary": "Architecture Governance products", "operationId": "listArchitectureGovernanceProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Architecture governance" ] } }, "/v1/architecture-governance/query": { "get": { "summary": "Query Architecture Governance", "operationId": "queryArchitectureGovernance", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Architecture governance" ] } }, "/v1/architecture-governance/route": { "get": { "summary": "Route via Architecture Governance", "operationId": "routeArchitectureGovernance", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Architecture governance" ] } }, "/v1/architecture-governance/routes": { "get": { "summary": "Architecture Governance routes", "operationId": "listArchitectureGovernanceRoutes", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Architecture governance" ] } }, "/v1/atlas/capabilities": { "get": { "summary": "Atlas capabilities", "operationId": "listAtlasCapabilities", "responses": { "200": { "description": "Reasoning/planning handoffs; specialists deferred" } }, "tags": [ "Atlas" ] } }, "/v1/atlas/engine": { "get": { "summary": "Atlas family scaffold engine", "operationId": "getAtlasEngine", "responses": { "200": { "description": "Atlas capability map + honesty (scaffold only — no trained weights)" } }, "tags": [ "Atlas" ] } }, "/v1/atlas/monitoring": { "get": { "summary": "Atlas scaffold monitoring", "operationId": "getAtlasMonitoring", "responses": { "200": { "description": "Capability status snapshot + honesty" } }, "tags": [ "Atlas" ] } }, "/v1/atlas/overview": { "get": { "summary": "Atlas org overview", "operationId": "getAtlasOverview", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Session usage, deferred specialists, links" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Atlas" ] } }, "/v1/audio-intelligence/analytics": { "get": { "summary": "Audio Intelligence analytics", "operationId": "getAudioIntelligenceAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Org audit-derived usage" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Audio intelligence" ] } }, "/v1/audio-intelligence/analyze": { "post": { "summary": "Analyze audio for noise and silence", "operationId": "analyzeAudioIntelligence", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Noise/silence metrics" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Audio intelligence" ] } }, "/v1/audio-intelligence/analyze/stream": { "post": { "summary": "Stream audio analysis progress (SSE)", "operationId": "streamAudioAnalyze", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "SSE analysis events" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Audio intelligence" ] } }, "/v1/audio-intelligence/echo": { "get": { "summary": "Echo cancellation status (deferred)", "operationId": "getAudioEchoStatus", "responses": { "200": { "description": "AEC deferred status" } }, "tags": [ "Audio intelligence" ] } }, "/v1/audio-intelligence/engine": { "get": { "summary": "Audio Intelligence engine catalog", "operationId": "getAudioEngine", "responses": { "200": { "description": "Noise/silence/enhance capabilities" } }, "tags": [ "Audio intelligence" ] } }, "/v1/audio-intelligence/enhance": { "post": { "summary": "Enhance audio (noise gate)", "operationId": "enhanceAudioIntelligence", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Enhanced WAV base64" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Audio intelligence" ] } }, "/v1/audio-intelligence/isolate": { "post": { "summary": "Isolate voice via energy VAD", "operationId": "isolateAudioVoice", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Isolated WAV base64" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Audio intelligence" ] } }, "/v1/audio-intelligence/silence": { "post": { "summary": "Detect silence regions", "operationId": "detectAudioSilence", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Silence regions" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Audio intelligence" ] } }, "/v1/audio-intelligence/stems": { "post": { "operationId": "audioIntelligenceStems", "summary": "Stems", "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "properties": {}, "additionalProperties": { "type": "string", "format": "binary" } } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Audio intelligence" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/audio-intelligence/upscale": { "post": { "summary": "Upscale audio sample rate (linear)", "operationId": "upscaleAudioIntelligence", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Upsampled WAV base64" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Audio intelligence" ] } }, "/v1/audio/speech": { "post": { "summary": "Synthesize speech (text-to-speech)", "operationId": "createSpeech", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "text", "voice" ], "properties": { "text": { "type": "string", "maxLength": 4096 }, "voice": { "type": "string", "example": "own:ak-gh-fante-female", "description": "First-party own:* voice id (e.g. own:ak-gh-fante-female Fante/Mfantse Cape Coast, own:ha-gh-male Ghanaian Hausa/Zongo), or clone:{voiceCloneId}. Akan varieties are not interchangeable — use distinct Fante/Asante/Akuapem voice ids." }, "language": { "type": "string", "example": "ak-GH", "description": "BCP-47 language tag. Akan: ak-GH with variety via voice (own:ak-gh-fante-female → fante). Hausa product default is ha-GH (Ghanaian Zongo); use ha-NG for Kano. ISO 639-3 fat also routes to Fante." }, "format": { "type": "string", "enum": [ "mp3", "wav", "opus", "aac", "flac" ] } } } } } }, "responses": { "200": { "description": "Audio bytes", "content": { "audio/mpeg": { "schema": { "type": "string", "format": "binary" } } }, "headers": { "X-Lugemi-Provider": { "schema": { "type": "string" } }, "X-Lugemi-Voice": { "schema": { "type": "string" } }, "X-Lugemi-Variety": { "schema": { "type": "string" }, "description": "e.g. fante (Fante/Mfantse), asante, akuapem; or zongo (Ghanaian Hausa default) / kano" }, "X-Lugemi-Dialect": { "schema": { "type": "string" }, "description": "e.g. ak-gh-fante, ak-gh-asante, ha-gh-zongo, ha-ng-kano" }, "X-Lugemi-Audio-Clean": { "schema": { "type": "string" }, "description": "spectral_gate_v2 on L1 neural corridor WAVs" }, "X-Lugemi-Characters": { "schema": { "type": "string" } }, "X-Lugemi-Watermark": { "schema": { "type": "string" }, "description": "required when synthesizing an approved voice clone" } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "OPENAI_API_KEY / ECHO_INSTANT_CLONE_API_KEY not configured", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Audio" ] } }, "/v1/audio/transcriptions": { "post": { "summary": "Transcribe audio (speech-to-text)", "operationId": "createTranscription", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "required": [ "file" ], "properties": { "file": { "type": "string", "format": "binary" }, "language": { "type": "string", "description": "Optional ISO-639-1 language hint" } } } } } }, "responses": { "200": { "description": "Transcript", "content": { "application/json": { "schema": { "type": "object", "properties": { "text": { "type": "string" }, "language": { "type": "string", "nullable": true }, "durationSeconds": { "type": "number" }, "durationMinutes": { "type": "number" }, "provider": { "type": "string" } } } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "OPENAI_API_KEY not configured", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Audio" ] } }, "/v1/audio/voices": { "get": { "summary": "List TTS voices", "operationId": "listVoices", "responses": { "200": { "description": "Vendor voice catalog", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "gender": { "type": "string" }, "languages": { "type": "array", "items": { "type": "string" } }, "provider": { "type": "string" } } } } } } } } } }, "tags": [ "Audio" ] } }, "/v1/audit-events": { "get": { "summary": "List audit events", "operationId": "listAuditEvents", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "limit", "in": "query", "schema": { "type": "integer", "default": 50, "maximum": 200 } } ], "responses": { "200": { "description": "Recent audit events for the organization" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Forbidden for members", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Audit events" ] } }, "/v1/baobab/af/national": { "get": { "operationId": "baobabCatalogueAfNational", "summary": "Af national", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } } }, "tags": [ "Baobab" ] } }, "/v1/baobab/af/research": { "get": { "operationId": "baobabCatalogueAfResearch", "summary": "Af research", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } } }, "tags": [ "Baobab" ] } }, "/v1/baobab/af/slo": { "get": { "operationId": "baobabCatalogueAfSlo", "summary": "Af slo", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } } }, "tags": [ "Baobab" ] } }, "/v1/baobab/af/unlock": { "get": { "operationId": "baobabCatalogueAfUnlock", "summary": "Af unlock", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } } }, "tags": [ "Baobab" ] } }, "/v1/baobab/am/national": { "get": { "summary": "Baobab Amharic national API surface", "operationId": "getBaobabYoNational_get_2", "responses": { "200": { "description": "Citizen/education/ministry/enterprise tiers for Addis Ababa / Oyo Amharic with spectral_gate_v2 clarity" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/am/research": { "get": { "summary": "Baobab Amharic generative LM research slot", "operationId": "getBaobabYoResearch_get_2", "responses": { "200": { "description": "research_planned — generative_inference_live false" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/am/slo": { "get": { "summary": "Baobab Amharic ministry SLA operational targets", "operationId": "getBaobabYoSlo_get_2", "responses": { "200": { "description": "targets_not_contractual_sla" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/am/unlock": { "get": { "summary": "Baobab Amharic trainingEligible unlock checklist", "operationId": "getBaobabYoUnlock_get_2", "responses": { "200": { "description": "Locked unlock gates" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/ee/national": { "get": { "summary": "Baobab Ewe national API surface", "operationId": "getBaobabEeNational", "responses": { "200": { "description": "Citizen/education/ministry/enterprise tiers for Anlo Ewe with spectral_gate_v2 clarity" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/ee/research": { "get": { "summary": "Baobab Ewe generative LM research slot", "operationId": "getBaobabEeResearch", "responses": { "200": { "description": "research_planned — generative_inference_live false" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/ee/slo": { "get": { "summary": "Baobab Ewe ministry SLA operational targets", "operationId": "getBaobabEeSlo", "responses": { "200": { "description": "targets_not_contractual_sla" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/ee/unlock": { "get": { "summary": "Baobab Ewe trainingEligible unlock checklist", "operationId": "getBaobabEeUnlock", "responses": { "200": { "description": "Locked unlock gates" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/engine": { "get": { "operationId": "baobabCatalogueEngine", "summary": "Engine", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } } }, "tags": [ "Baobab" ] } }, "/v1/baobab/fante/national": { "get": { "summary": "Baobab Fante national API surface", "operationId": "getBaobabFanteNational", "responses": { "200": { "description": "Citizen/education/ministry/enterprise tiers for Cape Coast Fante — not Asante/Akuapem" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/fante/research": { "get": { "summary": "Baobab Fante generative LM research slot", "operationId": "getBaobabFanteResearch", "responses": { "200": { "description": "research_planned — generative_inference_live false" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/fante/slo": { "get": { "summary": "Baobab Fante ministry SLA operational targets", "operationId": "getBaobabFanteSlo", "responses": { "200": { "description": "targets_not_contractual_sla" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/fante/unlock": { "get": { "summary": "Baobab Fante trainingEligible unlock checklist", "operationId": "getBaobabFanteUnlock", "responses": { "200": { "description": "Locked unlock gates" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/fil/national": { "get": { "summary": "Baobab Tagalog national tiers", "operationId": "getBaobabFilNational", "responses": { "200": { "description": "Manila Tagalog national tier surfaces" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/fil/research": { "get": { "summary": "Baobab Tagalog research slot", "operationId": "getBaobabFilResearch", "responses": { "200": { "description": "research_planned generative slot" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/fil/slo": { "get": { "summary": "Baobab Tagalog SLO dashboard", "operationId": "getBaobabFilSlo", "responses": { "200": { "description": "targets_not_contractual_sla" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/fil/unlock": { "get": { "summary": "Baobab Tagalog training unlock", "operationId": "getBaobabFilUnlock", "responses": { "200": { "description": "trainingEligible locked gates" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/fr-ci/national": { "get": { "summary": "Baobab Ivorian French national tiers", "operationId": "getBaobabFrCiNational", "responses": { "200": { "description": "Abidjan Ivorian French national tier surfaces" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/fr-ci/research": { "get": { "summary": "Baobab Ivorian French research slot", "operationId": "getBaobabFrCiResearch", "responses": { "200": { "description": "research_planned generative slot" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/fr-ci/slo": { "get": { "summary": "Baobab Ivorian French SLO dashboard", "operationId": "getBaobabFrCiSlo", "responses": { "200": { "description": "targets_not_contractual_sla" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/fr-ci/unlock": { "get": { "summary": "Baobab Ivorian French training unlock", "operationId": "getBaobabFrCiUnlock", "responses": { "200": { "description": "trainingEligible locked gates" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/fr-sn/national": { "get": { "summary": "Baobab Senegalese French national tiers", "operationId": "getBaobabFrSnNational", "responses": { "200": { "description": "Dakar Senegalese French national tier surfaces" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/fr-sn/research": { "get": { "summary": "Baobab Senegalese French research slot", "operationId": "getBaobabFrSnResearch", "responses": { "200": { "description": "research_planned generative slot" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/fr-sn/slo": { "get": { "summary": "Baobab Senegalese French SLO dashboard", "operationId": "getBaobabFrSnSlo", "responses": { "200": { "description": "targets_not_contractual_sla" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/fr-sn/unlock": { "get": { "summary": "Baobab Senegalese French training unlock", "operationId": "getBaobabFrSnUnlock", "responses": { "200": { "description": "trainingEligible locked gates" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/ga/national": { "get": { "summary": "Baobab Ga national API surface", "operationId": "getBaobabGaNational", "responses": { "200": { "description": "Citizen/education/ministry/enterprise tiers for Accra Ga, residency honesty, open-eval pointers" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/ga/research": { "get": { "summary": "Baobab Ga generative LM research slot", "operationId": "getBaobabGaResearch", "responses": { "200": { "description": "Research_planned generative LM slot for Accra Ga — generative_inference_live false" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/ga/slo": { "get": { "summary": "Baobab Ga ministry SLA operational targets", "operationId": "getBaobabGaSlo", "responses": { "200": { "description": "Operational SLO dashboard — targets_not_contractual_sla; Accra GPU island false" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/ga/unlock": { "get": { "summary": "Baobab Ga trainingEligible unlock checklist", "operationId": "getBaobabGaUnlock", "responses": { "200": { "description": "Locked unlock gates — trainingEligible remains false until Accra Ga consent/held-out evidence" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/ha-ng/national": { "get": { "summary": "Baobab Nigeria Hausa national API surface", "operationId": "getBaobabHaNgNational", "responses": { "200": { "description": "Citizen/education/ministry/enterprise tiers for Kano Hausa with spectral_gate_v2 clarity" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/ha-ng/research": { "get": { "summary": "Baobab Nigeria Hausa generative LM research slot", "operationId": "getBaobabHaNgResearch", "responses": { "200": { "description": "research_planned — generative_inference_live false" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/ha-ng/slo": { "get": { "summary": "Baobab Nigeria Hausa ministry SLA operational targets", "operationId": "getBaobabHaNgSlo", "responses": { "200": { "description": "targets_not_contractual_sla" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/ha-ng/unlock": { "get": { "summary": "Baobab Nigeria Hausa trainingEligible unlock checklist", "operationId": "getBaobabHaNgUnlock", "responses": { "200": { "description": "Locked unlock gates" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/ha/national": { "get": { "summary": "Baobab Hausa national API surface", "operationId": "getBaobabHaNational", "responses": { "200": { "description": "Citizen/education/ministry/enterprise tiers for Ghanaian Hausa (Zongo) with spectral_gate_v2 clarity" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/ha/research": { "get": { "summary": "Baobab Hausa generative LM research slot", "operationId": "getBaobabHaResearch", "responses": { "200": { "description": "research_planned — generative_inference_live false" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/ha/slo": { "get": { "summary": "Baobab Hausa ministry SLA operational targets", "operationId": "getBaobabHaSlo", "responses": { "200": { "description": "targets_not_contractual_sla" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/ha/unlock": { "get": { "summary": "Baobab Hausa trainingEligible unlock checklist", "operationId": "getBaobabHaUnlock", "responses": { "200": { "description": "Locked unlock gates" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/ig/national": { "get": { "summary": "Baobab Igbo national API surface", "operationId": "getBaobabIgNational", "responses": { "200": { "description": "Citizen/education/ministry/enterprise tiers for Enugu / Central Igbo with spectral_gate_v2 clarity" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/ig/research": { "get": { "summary": "Baobab Igbo generative LM research slot", "operationId": "getBaobabIgResearch", "responses": { "200": { "description": "research_planned — generative_inference_live false" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/ig/slo": { "get": { "summary": "Baobab Igbo ministry SLA operational targets", "operationId": "getBaobabIgSlo", "responses": { "200": { "description": "targets_not_contractual_sla" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/ig/unlock": { "get": { "summary": "Baobab Igbo trainingEligible unlock checklist", "operationId": "getBaobabIgUnlock", "responses": { "200": { "description": "Locked unlock gates" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/models": { "get": { "summary": "Baobab national model catalogue", "operationId": "listBaobabNationalModels", "responses": { "200": { "description": "Public catalogue of Baobab national models (baobab-twi, baobab-ga, baobab-ha, baobab-ee, baobab-fante, baobab-yo, baobab-ig, baobab-ha-ng, baobab-sw, baobab-am, baobab-af, baobab-zu)" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/sw/national": { "get": { "summary": "Baobab Kiswahili national API surface", "operationId": "getBaobabYoNational_get", "responses": { "200": { "description": "Citizen/education/ministry/enterprise tiers for Nairobi / Oyo Kiswahili with spectral_gate_v2 clarity" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/sw/research": { "get": { "summary": "Baobab Kiswahili generative LM research slot", "operationId": "getBaobabYoResearch_get", "responses": { "200": { "description": "research_planned — generative_inference_live false" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/sw/slo": { "get": { "summary": "Baobab Kiswahili ministry SLA operational targets", "operationId": "getBaobabYoSlo_get", "responses": { "200": { "description": "targets_not_contractual_sla" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/sw/unlock": { "get": { "summary": "Baobab Kiswahili trainingEligible unlock checklist", "operationId": "getBaobabYoUnlock_get", "responses": { "200": { "description": "Locked unlock gates" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/twi/national": { "get": { "summary": "Baobab Twi national API surface", "operationId": "getBaobabTwiNational", "responses": { "200": { "description": "Citizen/education/ministry/enterprise tiers, residency honesty, SLA targets, open-eval pointers" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/twi/research": { "get": { "summary": "Baobab Twi Phase D generative LM research slot", "operationId": "getBaobabTwiResearch", "responses": { "200": { "description": "Research_planned generative LM slot, acceptance gates, native-task harness summary — generative_inference_live false" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/twi/slo": { "get": { "summary": "Baobab Twi ministry SLA operational targets", "operationId": "getBaobabTwiSlo", "responses": { "200": { "description": "Operational SLO dashboard — targets_not_contractual_sla; Accra GPU island false" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/twi/unlock": { "get": { "summary": "Baobab Twi trainingEligible unlock checklist", "operationId": "getBaobabTwiUnlock", "responses": { "200": { "description": "Locked unlock gates — trainingEligible remains false until consent/held-out evidence" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/yo/national": { "get": { "summary": "Baobab Yoruba national API surface", "operationId": "getBaobabYoNational", "responses": { "200": { "description": "Citizen/education/ministry/enterprise tiers for Lagos / Oyo Yoruba with spectral_gate_v2 clarity" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/yo/research": { "get": { "summary": "Baobab Yoruba generative LM research slot", "operationId": "getBaobabYoResearch", "responses": { "200": { "description": "research_planned — generative_inference_live false" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/yo/slo": { "get": { "summary": "Baobab Yoruba ministry SLA operational targets", "operationId": "getBaobabYoSlo", "responses": { "200": { "description": "targets_not_contractual_sla" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/yo/unlock": { "get": { "summary": "Baobab Yoruba trainingEligible unlock checklist", "operationId": "getBaobabYoUnlock", "responses": { "200": { "description": "Locked unlock gates" } }, "tags": [ "Baobab" ] } }, "/v1/baobab/zu/national": { "get": { "operationId": "baobabCatalogueZuNational", "summary": "Zu national", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } } }, "tags": [ "Baobab" ] } }, "/v1/baobab/zu/research": { "get": { "operationId": "baobabCatalogueZuResearch", "summary": "Zu research", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } } }, "tags": [ "Baobab" ] } }, "/v1/baobab/zu/slo": { "get": { "operationId": "baobabCatalogueZuSlo", "summary": "Zu slo", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } } }, "tags": [ "Baobab" ] } }, "/v1/baobab/zu/unlock": { "get": { "operationId": "baobabCatalogueZuUnlock", "summary": "Zu unlock", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } } }, "tags": [ "Baobab" ] } }, "/v1/batch-runtime/analytics": { "get": { "summary": "Batch Runtime analytics", "operationId": "getBatchRuntimeAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Run aggregates" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Batch runtime" ] } }, "/v1/batch-runtime/engine": { "get": { "summary": "Batch Runtime catalog", "operationId": "getBatchRuntimeEngine", "responses": { "200": { "description": "Capabilities, ceilings, and honesty flags" } }, "tags": [ "Batch runtime" ] } }, "/v1/batch-runtime/kinds": { "get": { "summary": "Batch job kinds", "operationId": "listBatchRuntimeKinds", "responses": { "200": { "description": "Translation/speech/OCR/embedding/training/video map" } }, "tags": [ "Batch runtime" ] } }, "/v1/batch-runtime/monitoring": { "get": { "summary": "Batch Runtime monitoring", "operationId": "getBatchRuntimeMonitoring", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Monitoring + honesty snapshot" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Batch runtime" ] } }, "/v1/batch-runtime/runs": { "get": { "summary": "List batch runs", "operationId": "listBatchRuns", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Org/workspace runs (priority-ordered)" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Batch runtime" ] }, "post": { "summary": "Create batch run", "operationId": "createBatchRun", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Run created (translation may delegate to BullMQ)" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Hard item ceiling exceeded" } }, "tags": [ "Batch runtime" ] } }, "/v1/batch-runtime/runs/{id}": { "get": { "summary": "Get batch run", "operationId": "getBatchRun", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Run detail" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Batch runtime" ] } }, "/v1/batch-runtime/runs/{id}/checkpoint": { "post": { "summary": "Update sandbox checkpoint cursor", "operationId": "checkpointBatchRun", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Checkpoint updated" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Batch runtime" ] } }, "/v1/batch-runtime/runs/{id}/retry": { "post": { "summary": "Retry batch run within hard budget", "operationId": "retryBatchRun", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Retried" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Retry budget exhausted" }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Batch runtime" ] } }, "/v1/batch-runtime/runs/{id}/start": { "post": { "summary": "Start a scheduled batch run", "operationId": "startBatchRun", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Scheduled run started" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Batch runtime" ] } }, "/v1/benchmark-platform/engine": { "get": { "summary": "Benchmark Platform engine catalog", "operationId": "getBenchmarkPlatformEngine", "responses": { "200": { "description": "Benchmark Platform catalog + honesty" } }, "tags": [ "Benchmark platform" ] } }, "/v1/benchmark-platform/leaderboard": { "get": { "summary": "List benchmark leaderboard rows", "operationId": "listBenchmarkPlatformLeaderboard", "responses": { "200": { "description": "List benchmark leaderboard rows" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Benchmark platform" ] } }, "/v1/benchmark-platform/monitoring": { "get": { "summary": "Benchmark Platform monitoring", "operationId": "getBenchmarkPlatformMonitoring", "responses": { "200": { "description": "Monitoring snapshot" } }, "tags": [ "Benchmark platform" ] } }, "/v1/benchmark-platform/products": { "get": { "summary": "Benchmark Platform products", "operationId": "listBenchmarkPlatformProducts", "responses": { "200": { "description": "Benchmark Platform products" } }, "tags": [ "Benchmark platform" ] } }, "/v1/benchmark-platform/query": { "get": { "summary": "Query Benchmark Platform", "operationId": "queryBenchmarkPlatform", "responses": { "200": { "description": "Filtered catalog rows" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Benchmark platform" ] } }, "/v1/billing/checkout": { "post": { "summary": "Create Stripe Checkout session for Pro", "operationId": "createBillingCheckout", "security": [ { "ClerkAuth": [] } ], "responses": { "201": { "description": "Checkout URL" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Stripe not configured", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Billing" ] } }, "/v1/billing/plans": { "get": { "operationId": "billingPlans", "summary": "Plans", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } } }, "tags": [ "Billing" ] } }, "/v1/billing/portal": { "post": { "summary": "Create Stripe Customer Portal session", "operationId": "createBillingPortal", "security": [ { "ClerkAuth": [] } ], "responses": { "201": { "description": "Portal URL" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Billing" ] } }, "/v1/billing/summary": { "get": { "summary": "Billing and quota summary", "operationId": "getBillingSummary", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Plan, quota, and usage" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Billing" ] } }, "/v1/billing/topups": { "get": { "operationId": "billingTopUps", "summary": "Top ups", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } } }, "tags": [ "Billing" ] } }, "/v1/billing/topups/purchase": { "post": { "operationId": "billingPurchaseTopUp", "summary": "Purchase top up", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Billing" ], "security": [ { "ClerkAuth": [] } ] } }, "/v1/billing/webhook": { "post": { "summary": "Stripe webhook receiver", "operationId": "stripeWebhook", "responses": { "201": { "description": "Acknowledged" }, "400": { "description": "Invalid signature", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Billing" ] } }, "/v1/call-intelligence/analytics": { "get": { "summary": "Call Intelligence analytics", "operationId": "getCallIntelligenceAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Org audit-derived usage" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Call intelligence" ] } }, "/v1/call-intelligence/analyze/stream": { "post": { "summary": "Stream call ingest/analyze (SSE)", "operationId": "streamCallAnalyze", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "SSE call events" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Call intelligence" ] } }, "/v1/call-intelligence/bridges": { "get": { "tags": [ "Call Intelligence" ], "summary": "List telephony bridges (Twilio, LiveKit, Connect, Genesys, …)", "operationId": "listCallIntelligenceBridges", "responses": { "200": { "description": "Bridge catalog" } } } }, "/v1/call-intelligence/bridges/amazon-connect/lambda": { "post": { "tags": [ "Call Intelligence" ], "summary": "Amazon Connect Lambda / Contact Flow bridge", "operationId": "callIntelligenceAmazonConnect", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Flat contact attributes" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/call-intelligence/bridges/genesys/architect": { "post": { "tags": [ "Call Intelligence" ], "summary": "Genesys Cloud Architect data-action bridge", "operationId": "callIntelligenceGenesys", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Turn result" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/call-intelligence/bridges/livekit/webhook": { "post": { "tags": [ "Call Intelligence" ], "summary": "LiveKit room webhook / agent turn", "operationId": "callIntelligenceLivekit", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Webhook ack or turn result" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/call-intelligence/bridges/telnyx/call-control": { "post": { "tags": [ "Call Intelligence" ], "summary": "Telnyx Call Control webhook bridge", "operationId": "callIntelligenceTelnyx", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Turn result or ack" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/call-intelligence/bridges/twilio/media": { "post": { "tags": [ "Call Intelligence" ], "summary": "Twilio Media Streams frame ingest (HTTPS relay)", "operationId": "callIntelligenceTwilioMedia", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Frame accepted" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/call-intelligence/bridges/twilio/recording": { "post": { "operationId": "callIntelligenceBridgesTwilioRecording", "summary": "Twilio recording", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Call intelligence" ] } }, "/v1/call-intelligence/bridges/twilio/turn": { "post": { "tags": [ "Call Intelligence" ], "summary": "Twilio Record callback → Call Intelligence turn", "operationId": "callIntelligenceTwilioTurn", "responses": { "200": { "description": "TwiML Say + Hangup" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/call-intelligence/bridges/twilio/voice": { "post": { "tags": [ "Call Intelligence" ], "summary": "Twilio Voice webhook (TwiML)", "operationId": "callIntelligenceTwilioVoice", "responses": { "200": { "description": "TwiML XML" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/call-intelligence/bridges/vonage/event": { "post": { "tags": [ "Call Intelligence" ], "summary": "Vonage NCCO event bridge", "operationId": "callIntelligenceVonage", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "NCCO talk action or ack" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/call-intelligence/calls": { "get": { "summary": "List call records", "operationId": "listCallRecords", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Workspace calls" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Call intelligence" ] }, "post": { "summary": "Ingest call (transcript and/or recording)", "operationId": "createCallRecord", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Created call with optional analysis" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Call intelligence" ] } }, "/v1/call-intelligence/calls/{id}": { "get": { "operationId": "callIntelligenceGet", "summary": "Get", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Call intelligence" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/call-intelligence/calls/{id}/analyze": { "post": { "summary": "Analyze an existing call", "operationId": "analyzeCallRecord", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Updated call analysis" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Call intelligence" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/call-intelligence/compliance": { "get": { "tags": [ "Call Intelligence" ], "summary": "Get Call Intelligence compliance settings", "operationId": "getCallIntelligenceCompliance", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Consent, retention, residency" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "patch": { "tags": [ "Call Intelligence" ], "summary": "Update Call Intelligence compliance settings", "operationId": "updateCallIntelligenceCompliance", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Updated compliance" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/call-intelligence/engine": { "get": { "summary": "Call Intelligence engine catalog", "operationId": "getCallIntelligenceEngine", "responses": { "200": { "description": "Call analytics capabilities" } }, "tags": [ "Call intelligence" ] } }, "/v1/call-intelligence/ingress/sip/invite": { "post": { "tags": [ "Call Intelligence" ], "summary": "SIP INVITE notify → create session", "operationId": "callIntelligenceSipInvite", "responses": { "200": { "description": "Session for inbound SIP call" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/call-intelligence/ingress/sip/trunks": { "get": { "tags": [ "Call Intelligence" ], "summary": "List SIP trunks", "operationId": "listCallIntelligenceSipTrunks", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Registered trunks" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "post": { "tags": [ "Call Intelligence" ], "summary": "Register SIP trunk", "operationId": "createCallIntelligenceSipTrunk", "security": [ { "ClerkAuth": [] } ], "responses": { "201": { "description": "Trunk created" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/call-intelligence/ingress/webrtc/offer": { "post": { "tags": [ "Call Intelligence" ], "summary": "WebRTC SDP offer → session + media upload paths", "operationId": "callIntelligenceWebRtcOffer", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Session + ICE servers + media upload URLs" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/call-intelligence/report": { "get": { "summary": "Call Intelligence workspace report", "operationId": "getCallIntelligenceReport", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Aggregated call metrics" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Call intelligence" ] } }, "/v1/call-intelligence/sessions": { "post": { "tags": [ "Call Intelligence" ], "summary": "Create realtime Call Intelligence session", "operationId": "createCallIntelligenceSession", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Session created (consent may be required)" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/call-intelligence/sessions/{id}": { "get": { "tags": [ "Call Intelligence" ], "summary": "Get Call Intelligence session", "operationId": "getCallIntelligenceSession", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Session metadata" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/call-intelligence/sessions/{id}/media": { "post": { "tags": [ "Call Intelligence" ], "summary": "Ingest media-stream frame envelope", "operationId": "callIntelligenceMedia", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Frame accepted" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/call-intelligence/sessions/{id}/turn": { "post": { "tags": [ "Call Intelligence" ], "summary": "Process a call turn (audio or text)", "operationId": "callIntelligenceTurn", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Transcript, captions, suggested or spoken reply" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/call-intelligence/telephony": { "get": { "tags": [ "Call Intelligence" ], "summary": "Realtime telephony / CCaaS catalog", "operationId": "getCallIntelligenceTelephony", "responses": { "200": { "description": "Modes, bridges, ingress, compliance, and SDK pointers" } } } }, "/v1/chat/attachments": { "post": { "tags": [ "Chat" ], "summary": "Ingest chat file attachments into text context", "description": "OCR images, extract PDF/DOCX/text, or transcribe audio/video. Returns attachment excerpts + a contextBlock you can append to a user message.", "operationId": "chatAttachmentsIngest", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "required": [ "files" ], "properties": { "files": { "type": "array", "items": { "type": "string", "format": "binary" } } } } } } }, "responses": { "200": { "description": "Extracted attachment context" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/chat/completions": { "post": { "summary": "Chatbot turn (Atlas chat completions)", "description": "Build a text chatbot with Lugemi. Auth: Bearer API key or session JWT. Persona comes from the workspace chatbot agent profile. Include prior turns in messages. Optional translateReplyTo machine-translates the assistant reply. Multipart: send `files` (images, PDF/DOCX, text, audio, video) plus `messages` JSON — files are OCR’d / extracted / transcribed into the last user message.", "operationId": "chatCompletions", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChatCompletionRequest" } }, "multipart/form-data": { "schema": { "type": "object", "properties": { "messages": { "type": "string", "description": "JSON array of chat messages" }, "text": { "type": "string", "description": "Shortcut single user message" }, "translateReplyTo": { "type": "string" }, "model": { "type": "string" }, "files": { "type": "array", "items": { "type": "string", "format": "binary" }, "description": "png/jpg/webp/gif, pdf/docx/txt/md/html, audio, video" } } } } } }, "responses": { "200": { "description": "Assistant reply (optionally translated); includes attachments metadata when files were sent", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChatCompletionResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Provider not configured", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Chat" ] } }, "/v1/cloud/overview": { "get": { "summary": "Workspace Console operator overview", "operationId": "getCloudOverview", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Org, workspace, billing, residency, feature flags, and entitlements" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Cloud" ] } }, "/v1/compliance-platform/controls": { "get": { "summary": "List Compliance Platform rows", "operationId": "listCompliancePlatformRows", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Compliance platform" ] } }, "/v1/compliance-platform/engine": { "get": { "summary": "Compliance Platform engine", "operationId": "getCompliancePlatformEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Compliance platform" ] } }, "/v1/compliance-platform/monitoring": { "get": { "summary": "Compliance Platform monitoring", "operationId": "getCompliancePlatformMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Compliance platform" ] } }, "/v1/compliance-platform/products": { "get": { "summary": "Compliance Platform products", "operationId": "listCompliancePlatformProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Compliance platform" ] } }, "/v1/compliance-platform/query": { "get": { "summary": "Query Compliance Platform", "operationId": "queryCompliancePlatform", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Compliance platform" ] } }, "/v1/connector-marketplace/analytics": { "get": { "summary": "Connector marketplace analytics", "operationId": "getConnectorMarketplaceAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Aggregates" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Connector marketplace" ] } }, "/v1/connector-marketplace/engine": { "get": { "summary": "Connector Marketplace engine catalog", "operationId": "getConnectorMarketplaceEngine", "responses": { "200": { "description": "Connector marketplace capabilities, Stripe honesty, iPaaS / live-outbound denials" } }, "tags": [ "Connector marketplace" ] } }, "/v1/connector-marketplace/installs": { "get": { "operationId": "connectorMarketplaceInstalls", "summary": "Installs", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Connector marketplace" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/connector-marketplace/listings": { "get": { "summary": "List connector marketplace listings", "operationId": "listConnectorMarketplaceListings", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Published or mine connector listings" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Connector marketplace" ] }, "post": { "summary": "Publish a connector catalog key as a marketplace listing", "operationId": "publishConnectorMarketplaceListing", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Listing created" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Connector marketplace" ] } }, "/v1/connector-marketplace/listings/{id}": { "delete": { "operationId": "connectorMarketplaceUnpublish", "summary": "Unpublish", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Connector marketplace" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/connector-marketplace/listings/{id}/install": { "post": { "summary": "Install a connector listing entitlement", "operationId": "installConnectorMarketplaceListing", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Connector entitlement installed" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Policy deny" }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Connector marketplace" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/connector-marketplace/listings/{id}/reviews": { "get": { "summary": "List connector listing reviews", "operationId": "listConnectorMarketplaceReviews", "responses": { "200": { "description": "Reviews" }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Connector marketplace" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] }, "post": { "summary": "Upsert a connector listing review", "operationId": "reviewConnectorMarketplaceListing", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Review saved" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Connector marketplace" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/connector-marketplace/listings/{id}/update": { "post": { "operationId": "connectorMarketplaceUpdate", "summary": "Update", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Connector marketplace" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/connector-marketplace/monitoring": { "get": { "summary": "Connector marketplace monitoring", "operationId": "getConnectorMarketplaceMonitoring", "responses": { "200": { "description": "Capability status snapshot" } }, "tags": [ "Connector marketplace" ] } }, "/v1/connector-marketplace/products": { "get": { "summary": "Connector Marketplace products (alias of engine)", "operationId": "listConnectorMarketplaceProducts", "responses": { "200": { "description": "Connector marketplace catalog + honesty" } }, "tags": [ "Connector marketplace" ] } }, "/v1/connector-marketplace/sales": { "get": { "summary": "Connector marketplace publisher sales", "operationId": "listConnectorMarketplaceSales", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Sale receipts + fee honesty" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Connector marketplace" ] } }, "/v1/connectors/platform": { "get": { "summary": "List Lugemi Studio platform connector installers", "operationId": "listPlatformConnectors", "parameters": [ { "name": "category", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Filter by category (voice, messaging, crm, …)" } ], "responses": { "200": { "description": "Platform connector registry" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Connectors" ] } }, "/v1/connectors/platform/{id}": { "get": { "summary": "Platform connector integration guide + SDK snippets", "operationId": "getPlatformConnector", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Integration guide" }, "404": { "description": "Unknown connector" } }, "tags": [ "Connectors" ] } }, "/v1/connectors/platform/{id}/connect": { "post": { "operationId": "platformConnectorsConnect", "summary": "Connect", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Connectors" ], "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/connectors/platform/{id}/connection": { "delete": { "operationId": "platformConnectorsDisconnect", "summary": "Disconnect", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Connectors" ], "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/connectors/platform/{id}/demo": { "post": { "summary": "Soft-sandbox demo hook for a platform connector", "operationId": "demoPlatformConnector", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "text": { "type": "string" }, "source": { "type": "string" }, "target": { "type": "string" } } } } } }, "responses": { "200": { "description": "Demo wiring tips + next API calls" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Unknown connector" } }, "tags": [ "Connectors" ] } }, "/v1/connectors/platform/{id}/reverify": { "post": { "operationId": "platformConnectorsReverify", "summary": "Reverify", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Connectors" ], "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/connectors/platform/connections": { "get": { "operationId": "platformConnectorsConnections", "summary": "Connections", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Connectors" ], "security": [ { "ClerkAuth": [] } ] } }, "/v1/connectors/platform/engine": { "get": { "summary": "Platform connectors engine overview", "operationId": "platformConnectorsEngine", "responses": { "200": { "description": "Engine catalog with core Lugemi APIs" } }, "tags": [ "Connectors" ] } }, "/v1/connectors/slack/commands": { "post": { "summary": "Slack slash command webhook", "operationId": "slackSlashCommand", "responses": { "200": { "description": "Slack message payload" }, "401": { "description": "Invalid signature" } }, "tags": [ "Connectors" ] } }, "/v1/connectors/slack/events": { "post": { "summary": "Slack Events API (url_verification)", "operationId": "slackEvents", "responses": { "200": { "description": "Challenge or ack" } }, "tags": [ "Connectors" ] } }, "/v1/connectors/slack/installations": { "get": { "operationId": "slackConnectorList", "summary": "List", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Connectors" ], "security": [ { "ClerkAuth": [] } ] }, "post": { "operationId": "slackConnectorUpsert", "summary": "Upsert", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Connectors" ], "security": [ { "ClerkAuth": [] } ] } }, "/v1/connectors/slack/status": { "get": { "operationId": "slackConnectorStatus", "summary": "Status", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Connectors" ], "security": [ { "ClerkAuth": [] } ] } }, "/v1/context-engine/analytics": { "get": { "summary": "Context Engine analytics", "operationId": "getContextEngineAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Assemble audit aggregates" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Context engine" ] } }, "/v1/context-engine/assemble": { "post": { "summary": "Assemble AI request context", "operationId": "assembleContextEngine", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Compressed multi-source promptContext" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Context engine" ] } }, "/v1/context-engine/engine": { "get": { "summary": "Context Engine catalog", "operationId": "getContextEngine", "responses": { "200": { "description": "Capabilities and infinite-context honesty notes" } }, "tags": [ "Context engine" ] } }, "/v1/context-engine/monitoring": { "get": { "summary": "Context Engine monitoring snapshot", "operationId": "getContextEngineMonitoring", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Monitoring snapshot" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Context engine" ] } }, "/v1/context-engine/sources": { "get": { "summary": "Context sources catalog", "operationId": "listContextEngineSources", "responses": { "200": { "description": "Assemblable context sources" } }, "tags": [ "Context engine" ] } }, "/v1/context-fabric/engine": { "get": { "summary": "Context Fabric engine (alias of products)", "operationId": "getContextFabricEngine", "responses": { "200": { "description": "Catalog + honesty" } }, "tags": [ "Context fabric" ] } }, "/v1/context-fabric/monitoring": { "get": { "summary": "Context Fabric monitoring", "operationId": "getContextFabricMonitoring", "responses": { "200": { "description": "Counters + honesty" } }, "tags": [ "Context fabric" ] } }, "/v1/context-fabric/overview": { "get": { "summary": "Context Fabric org overview", "operationId": "getContextFabricOverview", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Session + routes + counters" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Context fabric" ] } }, "/v1/context-fabric/products": { "get": { "summary": "Context Fabric capability catalog", "operationId": "listContextFabricProducts", "responses": { "200": { "description": "Context kinds, router routes, honesty (extends Context Runtime)" } }, "tags": [ "Context fabric" ] } }, "/v1/context-fabric/propagate": { "post": { "summary": "Propagate context via Context Runtime assemble", "operationId": "propagateContextFabric", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Assembled context + optional Event Fabric event" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Context fabric" ] } }, "/v1/context-fabric/route": { "post": { "summary": "Plan context routing for selected kinds", "operationId": "planContextFabricRoute", "responses": { "200": { "description": "Router plan + include map" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Context fabric" ] } }, "/v1/context-fabric/routes": { "get": { "summary": "Context Fabric routing table", "operationId": "listContextFabricRoutes", "responses": { "200": { "description": "kind → cloud/runtime handoffs" } }, "tags": [ "Context fabric" ] } }, "/v1/context-fabric/stream": { "get": { "summary": "Context Fabric SSE realtime ticks", "operationId": "streamContextFabric", "responses": { "200": { "description": "text/event-stream ticks (not WebSocket OS)" } }, "tags": [ "Context fabric" ] } }, "/v1/context-runtime/analytics": { "get": { "summary": "Context Runtime analytics", "operationId": "getContextRuntimeAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Aggregates" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Context runtime" ] } }, "/v1/context-runtime/assemble": { "post": { "summary": "Assemble kernel context", "operationId": "assembleContextRuntime", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Assembled promptContext + blocks" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Context runtime" ] } }, "/v1/context-runtime/compress": { "post": { "summary": "Compress context blocks", "operationId": "compressContextRuntime", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Char-budget truncation" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Context runtime" ] } }, "/v1/context-runtime/engine": { "get": { "summary": "Context Runtime catalog", "operationId": "getContextRuntimeEngine", "responses": { "200": { "description": "Kernel context capabilities and honesty" } }, "tags": [ "Context runtime" ] } }, "/v1/context-runtime/monitoring": { "get": { "summary": "Context Runtime monitoring", "operationId": "getContextRuntimeMonitoring", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Monitoring + honesty" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Context runtime" ] } }, "/v1/context-runtime/prioritize": { "post": { "summary": "Prioritize context blocks", "operationId": "prioritizeContextRuntime", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Reordered blocks" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Context runtime" ] } }, "/v1/context-runtime/retrieve": { "post": { "summary": "Retrieve kernel context", "operationId": "retrieveContextRuntime", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Retrieve façade over assemble" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Context runtime" ] } }, "/v1/context-runtime/scopes": { "get": { "summary": "Context Runtime scopes/priorities", "operationId": "listContextRuntimeScopes", "responses": { "200": { "description": "Context kinds and priorities" } }, "tags": [ "Context runtime" ] } }, "/v1/continuous-evaluation/engine": { "get": { "summary": "Continuous Evaluation engine catalog", "operationId": "getContinuousEvaluationEngine", "responses": { "200": { "description": "Engine catalog" } }, "tags": [ "Continuous evaluation" ] } }, "/v1/continuous-evaluation/gate-status": { "get": { "summary": "Continuous Evaluation gate status for promote", "operationId": "getContinuousEvaluationGateStatus", "responses": { "200": { "description": "Gate status" } }, "tags": [ "Continuous evaluation" ] } }, "/v1/continuous-evaluation/gates": { "get": { "summary": "List Continuous Evaluation gates", "operationId": "listContinuousEvaluationGates", "responses": { "200": { "description": "Filtered catalog rows" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Continuous evaluation" ] } }, "/v1/continuous-evaluation/monitoring": { "get": { "summary": "Continuous Evaluation monitoring", "operationId": "getContinuousEvaluationMonitoring", "responses": { "200": { "description": "Monitoring snapshot" } }, "tags": [ "Continuous evaluation" ] } }, "/v1/continuous-evaluation/products": { "get": { "summary": "Continuous Evaluation products alias", "operationId": "listContinuousEvaluationProducts", "responses": { "200": { "description": "Engine catalog" } }, "tags": [ "Continuous evaluation" ] } }, "/v1/continuous-evaluation/query": { "get": { "summary": "Query Continuous Evaluation", "operationId": "queryContinuousEvaluation", "responses": { "200": { "description": "Filtered catalog rows" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Continuous evaluation" ] } }, "/v1/continuous-learning/engine": { "get": { "summary": "Continuous Learning engine catalog", "operationId": "getContinuousLearningEngine", "responses": { "200": { "description": "Engine catalog" } }, "tags": [ "Continuous learning" ] } }, "/v1/continuous-learning/feedback": { "get": { "summary": "List Continuous Learning feedback", "operationId": "listContinuousLearningFeedback", "responses": { "200": { "description": "Filtered catalog rows" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Continuous learning" ] } }, "/v1/continuous-learning/monitoring": { "get": { "summary": "Continuous Learning monitoring", "operationId": "getContinuousLearningMonitoring", "responses": { "200": { "description": "Monitoring snapshot" } }, "tags": [ "Continuous learning" ] } }, "/v1/continuous-learning/products": { "get": { "summary": "Continuous Learning products alias", "operationId": "listContinuousLearningProducts", "responses": { "200": { "description": "Engine catalog" } }, "tags": [ "Continuous learning" ] } }, "/v1/continuous-learning/promote": { "get": { "summary": "Attempt Continuous Learning promote (gated)", "operationId": "promoteContinuousLearning", "responses": { "200": { "description": "Promoted" }, "400": { "description": "Gate failed" } }, "tags": [ "Continuous learning" ] } }, "/v1/continuous-learning/promote-check": { "get": { "summary": "Continuous Learning promote gate check", "operationId": "checkContinuousLearningPromote", "responses": { "200": { "description": "Promote check result" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Continuous learning" ] } }, "/v1/continuous-learning/query": { "get": { "summary": "Query Continuous Learning", "operationId": "queryContinuousLearning", "responses": { "200": { "description": "Filtered catalog rows" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Continuous learning" ] } }, "/v1/control-plane-analytics/engine": { "get": { "summary": "Control Plane Analytics engine", "operationId": "getControlPlaneAnalyticsEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Control plane analytics" ] } }, "/v1/control-plane-analytics/monitoring": { "get": { "summary": "Control Plane Analytics monitoring", "operationId": "getControlPlaneAnalyticsMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Control plane analytics" ] } }, "/v1/control-plane-analytics/products": { "get": { "summary": "Control Plane Analytics products", "operationId": "listControlPlaneAnalyticsProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Control plane analytics" ] } }, "/v1/control-plane-analytics/query": { "get": { "summary": "Query Control Plane Analytics", "operationId": "queryControlPlaneAnalytics", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Control plane analytics" ] } }, "/v1/control-plane-analytics/snapshot": { "get": { "summary": "List Control Plane Analytics rows", "operationId": "listControlPlaneAnalyticsRows", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Control plane analytics" ] } }, "/v1/control-plane-cloud/engine": { "get": { "summary": "Control Plane engine alias", "operationId": "getControlPlaneCloudEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Control plane cloud" ] } }, "/v1/control-plane-cloud/monitoring": { "get": { "summary": "Control Plane monitoring", "operationId": "getControlPlaneCloudMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Control plane cloud" ] } }, "/v1/control-plane-cloud/overview": { "get": { "summary": "Control Plane overview", "operationId": "getControlPlaneCloudOverview", "responses": { "200": { "description": "OK" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Control plane cloud" ], "security": [ { "ClerkAuth": [] } ] } }, "/v1/control-plane-cloud/products": { "get": { "summary": "Control Plane products", "operationId": "listControlPlaneCloudProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Control plane cloud" ] } }, "/v1/control-plane-cloud/routing": { "get": { "summary": "Control Plane routing", "operationId": "getControlPlaneCloudRouting", "responses": { "200": { "description": "OK" } }, "tags": [ "Control plane cloud" ] } }, "/v1/corridor-benchmarks/claims/validate": { "post": { "summary": "Validate superiority claim format", "operationId": "validateCorridorClaim", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Valid claim or missing/banned fields" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Corridor benchmarks" ] } }, "/v1/corridor-benchmarks/comparison-matrix": { "get": { "summary": "Task comparison matrix", "operationId": "getCorridorComparisonMatrix", "responses": { "200": { "description": "Lugemi baseline vs external comparison rules" } }, "tags": [ "Corridor benchmarks" ] } }, "/v1/corridor-benchmarks/engine": { "get": { "summary": "Lugemi Advantage Protocol engine", "operationId": "getCorridorBenchmarksEngine", "responses": { "200": { "description": "Evaluation contract catalog" } }, "tags": [ "Corridor benchmarks" ] } }, "/v1/corridor-benchmarks/integration-cases": { "get": { "summary": "Mandatory integration cases", "operationId": "listCorridorIntegrationCases", "responses": { "200": { "description": "Cases with concrete expected behaviors" } }, "tags": [ "Corridor benchmarks" ] } }, "/v1/corridor-benchmarks/integration-cases/{id}/run": { "post": { "summary": "Run integration harness for one case", "operationId": "runCorridorIntegrationCase", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Pass/fail against expected behavior" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Corridor benchmarks" ] } }, "/v1/corridor-benchmarks/measurements": { "get": { "summary": "Measurement definitions and fairness rules", "operationId": "getCorridorMeasurements", "responses": { "200": { "description": "Critical error, ASR, streaming, economics definitions" } }, "tags": [ "Corridor benchmarks" ] } }, "/v1/corridor-benchmarks/studies": { "get": { "summary": "List preregistered studies", "operationId": "listCorridorStudies", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Studies" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Corridor benchmarks" ] }, "post": { "summary": "Preregister benchmark study", "operationId": "preregisterCorridorStudy", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Preregistered study with frozen set IDs" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Corridor benchmarks" ] } }, "/v1/corridor-benchmarks/studies/{id}/score": { "post": { "summary": "Record immutable held-out score with denominators", "operationId": "scoreCorridorStudy", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Scored study; no invented confidence" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Corridor benchmarks" ] } }, "/v1/cost-optimization/analytics": { "get": { "summary": "Cost analytics", "operationId": "getCostOptimizationAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Utilization aggregates" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Cost optimization" ] } }, "/v1/cost-optimization/budgets": { "get": { "summary": "Get workspace cost budget", "operationId": "getCostOptimizationBudget", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Org/workspace budget" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Cost optimization" ] }, "put": { "summary": "Upsert workspace cost budget", "operationId": "upsertCostOptimizationBudget", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Budget persisted" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Cost optimization" ] } }, "/v1/cost-optimization/ceilings": { "get": { "summary": "Default hard spend ceilings", "operationId": "getCostOptimizationCeilings", "responses": { "200": { "description": "Daily/monthly default caps" } }, "tags": [ "Cost optimization" ] } }, "/v1/cost-optimization/check": { "post": { "summary": "Check spend against hard caps", "operationId": "checkCostOptimizationSpend", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Gate result" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Hard spend ceiling exceeded" } }, "tags": [ "Cost optimization" ] } }, "/v1/cost-optimization/engine": { "get": { "summary": "Cost Optimization Engine catalog", "operationId": "getCostOptimizationEngine", "responses": { "200": { "description": "Ceilings, honesty, and spend-enforcement flags" } }, "tags": [ "Cost optimization" ] } }, "/v1/cost-optimization/gpu": { "get": { "summary": "GPU cost view + scale advice", "operationId": "getCostOptimizationGpu", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "GPU ceilings + workspace spend" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Cost optimization" ] } }, "/v1/cost-optimization/monitoring": { "get": { "summary": "Cost Optimization monitoring", "operationId": "getCostOptimizationMonitoring", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Monitoring + honesty snapshot" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Cost optimization" ] } }, "/v1/cost-optimization/optimize": { "post": { "summary": "Cost-preferring route plan", "operationId": "optimizeCostOptimizationRoute", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Cheapest candidates + spend gate" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Cost optimization" ] } }, "/v1/cost-optimization/predictions": { "get": { "summary": "Spend predictions + spot/reserved plans", "operationId": "getCostOptimizationPredictions", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Linear projection + sandbox plans" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Cost optimization" ] } }, "/v1/cost-optimization/record": { "post": { "summary": "Record spend (enforces caps)", "operationId": "recordCostOptimizationSpend", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Spend recorded" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Hard spend ceiling exceeded" } }, "tags": [ "Cost optimization" ] } }, "/v1/cost-optimization/reports": { "get": { "summary": "Spend reports", "operationId": "getCostOptimizationReports", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Ledger-backed reports" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Cost optimization" ] } }, "/v1/countries": { "get": { "tags": [ "Country packs" ], "summary": "List countries (alias of country-packs)", "description": "Full ISO catalog. Use ?picker=1 for lightweight picker rows; ?region= to filter.", "parameters": [ { "name": "region", "in": "query", "schema": { "type": "string" } }, { "name": "picker", "in": "query", "schema": { "type": "string", "enum": [ "1", "true", "yes" ] } } ], "responses": { "200": { "description": "Country list" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "operationId": "getV1Countries" } }, "/v1/countries/{code}": { "get": { "operationId": "countriesAliasGet", "summary": "Get", "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "includeLocales", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Countries" ] } }, "/v1/countries/engine": { "get": { "operationId": "countriesAliasEngine", "summary": "Engine", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } } }, "tags": [ "Countries" ] } }, "/v1/country-packs": { "get": { "summary": "List country packs", "operationId": "listCountryPacks", "parameters": [ { "name": "region", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Country pack rows" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Country packs" ] } }, "/v1/country-packs/{code}": { "get": { "summary": "Get country pack", "operationId": "getCountryPack", "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "includeLocales", "in": "query", "required": false, "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "Country pack detail" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Country packs" ] } }, "/v1/country-packs/engine": { "get": { "summary": "Country Engine catalog", "operationId": "getCountryEngine", "responses": { "200": { "description": "Country pack capabilities and honesty notes" } }, "tags": [ "Country packs" ] } }, "/v1/coverage": { "get": { "summary": "Public language coverage matrix and golden-eval status", "operationId": "getCoverage", "responses": { "200": { "description": "Focus pairs (EN→sw/yo/am) with golden eval scores when available; honest disclaimer" } }, "tags": [ "Coverage" ] } }, "/v1/creative-media/assets": { "get": { "operationId": "creativeMediaListAssets", "summary": "List assets", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Creative media" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] }, "post": { "operationId": "creativeMediaUpsertAsset", "summary": "Upsert asset", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Creative media" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/creative-media/assets/{id}": { "delete": { "operationId": "creativeMediaRemoveAsset", "summary": "Remove asset", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Creative media" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/creative-media/assets/{id}/content": { "get": { "operationId": "creativeMediaAssetContent", "summary": "Asset content", "responses": { "200": { "description": "Success. The body is written directly by the handler (for example audio bytes or a file download).", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Creative media" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/creative-media/assets/upload": { "post": { "operationId": "creativeMediaUploadAsset", "summary": "Upload asset", "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "properties": {}, "additionalProperties": { "type": "string", "format": "binary" } } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Creative media" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/creative-media/create": { "post": { "operationId": "creativeMediaCreate", "summary": "Create", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Creative media" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/creative-media/engine": { "get": { "operationId": "creativeMediaEngine", "summary": "Engine", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } } }, "tags": [ "Creative media" ] } }, "/v1/creative-media/image": { "post": { "operationId": "creativeMediaImage", "summary": "Image", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Creative media" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/creative-media/music": { "post": { "operationId": "creativeMediaMusic", "summary": "Music", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Creative media" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/creative-media/sfx": { "post": { "operationId": "creativeMediaSfx", "summary": "Sfx", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Creative media" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/creative-media/video-plan": { "post": { "operationId": "creativeMediaVideoPlan", "summary": "Video plan", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Creative media" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/creator-economy/analytics": { "get": { "summary": "Creator Economy analytics", "operationId": "getCreatorEconomyAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Aggregates" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Creator economy" ] } }, "/v1/creator-economy/disputes": { "get": { "summary": "Dispute/chargeback honesty (gaps)", "operationId": "getCreatorEconomyDisputes", "responses": { "200": { "description": "Explicit dispute coverage gaps" } }, "tags": [ "Creator economy" ] } }, "/v1/creator-economy/engine": { "get": { "summary": "Creator Economy engine catalog", "operationId": "getCreatorEconomyEngine", "responses": { "200": { "description": "Creator Economy capabilities, royalty hand-checks, Stripe honesty, tax/dispute gaps" } }, "tags": [ "Creator economy" ] } }, "/v1/creator-economy/invoices": { "get": { "summary": "Invoice-style views over MarketplaceSale", "operationId": "listCreatorEconomyInvoices", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Invoice-style receipts" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Creator economy" ] } }, "/v1/creator-economy/licensing": { "get": { "summary": "Workspace marketplace entitlements", "operationId": "listCreatorEconomyLicensing", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Installed entitlements" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Creator economy" ] } }, "/v1/creator-economy/monitoring": { "get": { "summary": "Creator Economy monitoring", "operationId": "getCreatorEconomyMonitoring", "responses": { "200": { "description": "Capability + hand-check snapshot" } }, "tags": [ "Creator economy" ] } }, "/v1/creator-economy/products": { "get": { "summary": "Creator Economy products (alias of engine)", "operationId": "listCreatorEconomyProducts", "responses": { "200": { "description": "Creator Economy catalog + honesty" } }, "tags": [ "Creator economy" ] } }, "/v1/creator-economy/profiles/creator": { "get": { "summary": "Creator/publisher profile", "operationId": "getCreatorEconomyCreatorProfile", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Creator profile + Connect readiness" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Creator economy" ] } }, "/v1/creator-economy/profiles/organization": { "get": { "summary": "Organization economy profile", "operationId": "getCreatorEconomyOrganizationProfile", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Org buyer/publisher summary" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Creator economy" ] } }, "/v1/creator-economy/profiles/partner": { "get": { "summary": "Partner / Connect readiness", "operationId": "getCreatorEconomyPartnerProfile", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Stripe Connect Express partner status" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Creator economy" ] } }, "/v1/creator-economy/royalty/preview": { "post": { "summary": "Preview royalty split for an amount", "operationId": "previewCreatorEconomyRoyalty", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Fee + publisher net preview" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Creator economy" ] } }, "/v1/creator-economy/royalty/scenarios": { "get": { "summary": "Hand-checkable royalty split scenarios", "operationId": "getCreatorEconomyRoyaltyScenarios", "responses": { "200": { "description": "Scenario table with computed pass/fail" } }, "tags": [ "Creator economy" ] } }, "/v1/creator-economy/sales": { "get": { "summary": "Aggregated marketplace sales for the org", "operationId": "listCreatorEconomySales", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Sale receipts" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Creator economy" ] } }, "/v1/creator-economy/tax": { "get": { "summary": "Tax reporting honesty (gaps)", "operationId": "getCreatorEconomyTax", "responses": { "200": { "description": "Explicit tax coverage gaps" } }, "tags": [ "Creator economy" ] } }, "/v1/cultural-intelligence/engine": { "get": { "summary": "Cultural Intelligence engine catalog", "operationId": "getCulturalIntelligenceEngine", "responses": { "200": { "description": "Cultural Intelligence catalog + honesty" } }, "tags": [ "Cultural intelligence" ] } }, "/v1/cultural-intelligence/entries": { "get": { "summary": "List cultural intelligence entries", "operationId": "listCulturalIntelligenceEntries", "responses": { "200": { "description": "Cultural entries with consent fields" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Cultural intelligence" ] } }, "/v1/cultural-intelligence/monitoring": { "get": { "summary": "Cultural Intelligence monitoring", "operationId": "getCulturalIntelligenceMonitoring", "responses": { "200": { "description": "Monitoring snapshot" } }, "tags": [ "Cultural intelligence" ] } }, "/v1/cultural-intelligence/products": { "get": { "summary": "Cultural Intelligence products", "operationId": "listCulturalIntelligenceProducts", "responses": { "200": { "description": "Cultural Intelligence products" } }, "tags": [ "Cultural intelligence" ] } }, "/v1/data-advantage/contributors": { "get": { "summary": "List contributors", "operationId": "listDataAdvantageContributors", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Contributor contracts" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Data advantage" ] }, "post": { "summary": "Register contributor with permitted purposes", "operationId": "createDataAdvantageContributor", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Contributor created" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Data advantage" ] } }, "/v1/data-advantage/contributors/{id}/withdraw": { "post": { "summary": "Withdraw contributor and track remedy", "operationId": "withdrawDataAdvantageContributor", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Withdrawal and remedy tracking" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Data advantage" ] } }, "/v1/data-advantage/engine": { "get": { "summary": "Lugemi Data Advantage engine", "operationId": "getDataAdvantageEngine", "responses": { "200": { "description": "Data advantage catalog and streams" } }, "tags": [ "Data advantage" ] } }, "/v1/data-advantage/error-loop/sample": { "post": { "summary": "Sample offline error-acquisition loop", "operationId": "dataAdvantageErrorLoopSample", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Balanced and random prevalence samples" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Data advantage" ] } }, "/v1/data-advantage/pipeline": { "get": { "summary": "Ingest-to-release pipeline stages", "operationId": "getDataAdvantagePipeline", "responses": { "200": { "description": "Pipeline and security posture" } }, "tags": [ "Data advantage" ] } }, "/v1/data-advantage/records": { "post": { "summary": "Ingest permissioned corpus record", "operationId": "ingestDataAdvantageRecord", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Record with split and rights metadata" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Data advantage" ] } }, "/v1/data-advantage/records/export-check": { "post": { "summary": "Export-denial check for licenses and withdrawals", "operationId": "dataAdvantageExportCheck", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Per-record allow/deny with reasons" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Data advantage" ] } }, "/v1/data-advantage/releases": { "post": { "summary": "Freeze pilot dataset release when gates pass", "operationId": "freezeDataAdvantageRelease", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Frozen release with split audit" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Data advantage" ] } }, "/v1/data-advantage/streams": { "get": { "summary": "Dataset acquisition streams", "operationId": "listDataAdvantageStreams", "responses": { "200": { "description": "Seven streams for Mix through Grounded" } }, "tags": [ "Data advantage" ] } }, "/v1/data-plane-cloud/engine": { "get": { "summary": "Data Plane engine alias", "operationId": "getDataPlaneCloudEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Data plane cloud" ] } }, "/v1/data-plane-cloud/monitoring": { "get": { "summary": "Data Plane monitoring", "operationId": "getDataPlaneCloudMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Data plane cloud" ] } }, "/v1/data-plane-cloud/overview": { "get": { "summary": "Data Plane overview", "operationId": "getDataPlaneCloudOverview", "responses": { "200": { "description": "OK" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Data plane cloud" ], "security": [ { "ClerkAuth": [] } ] } }, "/v1/data-plane-cloud/products": { "get": { "summary": "Data Plane products", "operationId": "listDataPlaneCloudProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Data plane cloud" ] } }, "/v1/data-plane-cloud/routing": { "get": { "summary": "Data Plane routing", "operationId": "getDataPlaneCloudRouting", "responses": { "200": { "description": "OK" } }, "tags": [ "Data plane cloud" ] } }, "/v1/data-plane-streaming/engine": { "get": { "summary": "Data Plane Streaming engine", "operationId": "getDataPlaneStreamingEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Data plane streaming" ] } }, "/v1/data-plane-streaming/execute": { "get": { "summary": "Execute via Data Plane Streaming", "operationId": "executeDataPlaneStreaming", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Data plane streaming" ] } }, "/v1/data-plane-streaming/monitoring": { "get": { "summary": "Data Plane Streaming monitoring", "operationId": "getDataPlaneStreamingMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Data plane streaming" ] } }, "/v1/data-plane-streaming/products": { "get": { "summary": "Data Plane Streaming products", "operationId": "listDataPlaneStreamingProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Data plane streaming" ] } }, "/v1/data-plane-streaming/query": { "get": { "summary": "Query Data Plane Streaming", "operationId": "queryDataPlaneStreaming", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Data plane streaming" ] } }, "/v1/data-plane-streaming/route": { "get": { "summary": "Route via Data Plane Streaming", "operationId": "routeDataPlaneStreaming", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Data plane streaming" ] } }, "/v1/data-plane-streaming/routes": { "get": { "summary": "Data Plane Streaming routes", "operationId": "listDataPlaneStreamingRoutes", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Data plane streaming" ] } }, "/v1/database-engineering-standards/engine": { "get": { "summary": "Database Engineering Standards engine", "operationId": "getDatabaseEngineeringStandardsEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Database engineering standards" ] } }, "/v1/database-engineering-standards/execute": { "get": { "summary": "Execute via Database Engineering Standards", "operationId": "executeDatabaseEngineeringStandards", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Database engineering standards" ] } }, "/v1/database-engineering-standards/monitoring": { "get": { "summary": "Database Engineering Standards monitoring", "operationId": "getDatabaseEngineeringStandardsMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Database engineering standards" ] } }, "/v1/database-engineering-standards/products": { "get": { "summary": "Database Engineering Standards products", "operationId": "listDatabaseEngineeringStandardsProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Database engineering standards" ] } }, "/v1/database-engineering-standards/query": { "get": { "summary": "Query Database Engineering Standards", "operationId": "queryDatabaseEngineeringStandards", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Database engineering standards" ] } }, "/v1/database-engineering-standards/route": { "get": { "summary": "Route via Database Engineering Standards", "operationId": "routeDatabaseEngineeringStandards", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Database engineering standards" ] } }, "/v1/database-engineering-standards/routes": { "get": { "summary": "Database Engineering Standards routes", "operationId": "listDatabaseEngineeringStandardsRoutes", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Database engineering standards" ] } }, "/v1/dataset-marketplace/analytics": { "get": { "summary": "Dataset marketplace analytics", "operationId": "getDatasetMarketplaceAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Aggregates" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Dataset marketplace" ] } }, "/v1/dataset-marketplace/engine": { "get": { "summary": "Dataset Marketplace engine catalog", "operationId": "getDatasetMarketplaceEngine", "responses": { "200": { "description": "Dataset marketplace capabilities, Stripe honesty, Label Studio / Dataset Cloud denials" } }, "tags": [ "Dataset marketplace" ] } }, "/v1/dataset-marketplace/installs": { "get": { "operationId": "datasetMarketplaceInstalls", "summary": "Installs", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Dataset marketplace" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/dataset-marketplace/listings": { "get": { "summary": "List dataset marketplace listings", "operationId": "listDatasetMarketplaceListings", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Published or mine dataset listings" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Dataset marketplace" ] }, "post": { "summary": "Publish a TM corpus or DatasetAsset as a marketplace listing", "operationId": "publishDatasetMarketplaceListing", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Listing created" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Dataset marketplace" ] } }, "/v1/dataset-marketplace/listings/{id}": { "delete": { "operationId": "datasetMarketplaceUnpublish", "summary": "Unpublish", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Dataset marketplace" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/dataset-marketplace/listings/{id}/install": { "post": { "summary": "Install a dataset listing (TM copy or asset entitlement)", "operationId": "installDatasetMarketplaceListing", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Dataset installed / entitlement granted" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Policy deny" }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Dataset marketplace" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/dataset-marketplace/listings/{id}/reviews": { "get": { "summary": "List dataset listing reviews", "operationId": "listDatasetMarketplaceReviews", "responses": { "200": { "description": "Reviews" }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Dataset marketplace" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] }, "post": { "summary": "Upsert a dataset listing review", "operationId": "reviewDatasetMarketplaceListing", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Review saved" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Dataset marketplace" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/dataset-marketplace/listings/{id}/update": { "post": { "operationId": "datasetMarketplaceUpdate", "summary": "Update", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Dataset marketplace" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/dataset-marketplace/monitoring": { "get": { "summary": "Dataset marketplace monitoring", "operationId": "getDatasetMarketplaceMonitoring", "responses": { "200": { "description": "Capability status snapshot" } }, "tags": [ "Dataset marketplace" ] } }, "/v1/dataset-marketplace/products": { "get": { "summary": "Dataset Marketplace products (alias of engine)", "operationId": "listDatasetMarketplaceProducts", "responses": { "200": { "description": "Dataset marketplace catalog + honesty" } }, "tags": [ "Dataset marketplace" ] } }, "/v1/dataset-marketplace/sales": { "get": { "summary": "Dataset marketplace publisher sales", "operationId": "listDatasetMarketplaceSales", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Sale receipts + fee honesty" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Dataset marketplace" ] } }, "/v1/dataset-pipeline/engine": { "get": { "summary": "Dataset Pipeline engine catalog", "operationId": "getDatasetPipelineEngine", "responses": { "200": { "description": "Engine catalog" } }, "tags": [ "Dataset pipeline" ] } }, "/v1/dataset-pipeline/monitoring": { "get": { "summary": "Dataset Pipeline monitoring", "operationId": "getDatasetPipelineMonitoring", "responses": { "200": { "description": "Monitoring snapshot" } }, "tags": [ "Dataset pipeline" ] } }, "/v1/dataset-pipeline/products": { "get": { "summary": "Dataset Pipeline products alias", "operationId": "listDatasetPipelineProducts", "responses": { "200": { "description": "Engine catalog" } }, "tags": [ "Dataset pipeline" ] } }, "/v1/dataset-pipeline/query": { "get": { "summary": "Query Dataset Pipeline", "operationId": "queryDatasetPipeline", "responses": { "200": { "description": "Filtered catalog rows" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Dataset pipeline" ] } }, "/v1/dataset-pipeline/runs": { "get": { "summary": "List Dataset Pipeline runs", "operationId": "listDatasetPipelineRuns", "responses": { "200": { "description": "Filtered catalog rows" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Dataset pipeline" ] } }, "/v1/datasets": { "get": { "summary": "List dataset assets in the session workspace", "operationId": "listDatasets", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Dataset assets with versions" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Datasets" ] }, "post": { "summary": "Create dataset asset with legal metadata + first file version", "operationId": "createDataset", "security": [ { "ClerkAuth": [] } ], "responses": { "201": { "description": "Created asset" }, "400": { "description": "Missing license/consent or invalid file" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Datasets" ] } }, "/v1/datasets/{id}": { "get": { "summary": "Get a dataset asset", "operationId": "getDataset", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Asset with versions" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Datasets" ] }, "patch": { "summary": "Update dataset legal metadata or status", "operationId": "updateDataset", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Updated" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Datasets" ] }, "delete": { "summary": "Archive dataset and unlink stored files", "operationId": "archiveDataset", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Archived" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Datasets" ] } }, "/v1/datasets/{id}/versions": { "post": { "summary": "Upload a new dataset file version", "operationId": "addDatasetVersion", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "201": { "description": "Version added" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Datasets" ] } }, "/v1/datasets/{id}/versions/{version}/content": { "get": { "summary": "Download dataset version bytes", "operationId": "downloadDatasetVersion", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "version", "in": "path", "required": true, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "File bytes" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Datasets" ] } }, "/v1/datasets/licenses": { "get": { "summary": "List known license tags for dataset intake", "operationId": "listDatasetLicenses", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "License tag enum" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Datasets" ] } }, "/v1/dealbridge/catalog": { "get": { "operationId": "dealBridgeCatalog", "summary": "Catalog", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Dealbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/dealbridge/demo/reset": { "post": { "operationId": "dealBridgeResetDemo", "summary": "Reset demo", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Dealbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/dealbridge/demo/run": { "post": { "operationId": "dealBridgeRunDemo", "summary": "Run demo", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Dealbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/dealbridge/invites/{token}": { "get": { "operationId": "dealBridgePeekInvite", "summary": "Peek invite", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Dealbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "token", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/dealbridge/sessions": { "get": { "operationId": "dealBridgeList", "summary": "List", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Dealbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] }, "post": { "operationId": "dealBridgeCreate", "summary": "Create", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Dealbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/dealbridge/sessions/{id}": { "delete": { "operationId": "dealBridgeRemove", "summary": "Remove", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Dealbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] }, "get": { "operationId": "dealBridgeGet", "summary": "Get", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Dealbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/dealbridge/sessions/{id}/checks": { "post": { "operationId": "dealBridgeSubmitCheck", "summary": "Submit check", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Dealbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/dealbridge/sessions/{id}/confirmations": { "post": { "operationId": "dealBridgeConfirm", "summary": "Confirm", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Dealbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/dealbridge/sessions/{id}/consents": { "post": { "operationId": "dealBridgeConsent", "summary": "Consent", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Dealbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/dealbridge/sessions/{id}/events": { "get": { "operationId": "dealBridgeEvents", "summary": "Events", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Dealbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/dealbridge/sessions/{id}/invites": { "post": { "operationId": "dealBridgeCreateInvite", "summary": "Create invite", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Dealbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/dealbridge/sessions/{id}/join": { "post": { "operationId": "dealBridgeJoin", "summary": "Join", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Dealbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/dealbridge/sessions/{id}/receipt": { "get": { "operationId": "dealBridgeReceipt", "summary": "Receipt", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Dealbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/dealbridge/sessions/{id}/revisions": { "post": { "operationId": "dealBridgeRevise", "summary": "Revise", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Dealbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/dealbridge/sessions/{id}/snapshots": { "post": { "operationId": "dealBridgeProposeSnapshot", "summary": "Propose snapshot", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Dealbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/dealbridge/sessions/{id}/turns": { "post": { "operationId": "dealBridgeCreateTurn", "summary": "Create turn", "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "properties": {}, "additionalProperties": { "type": "string", "format": "binary" } } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Dealbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/dealbridge/sessions/{id}/turns/{turnId}": { "patch": { "operationId": "dealBridgeCorrectTurn", "summary": "Correct turn", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Dealbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "turnId", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/dealbridge/sessions/{id}/turns/uploads": { "post": { "operationId": "dealBridgeUploadAuth", "summary": "Upload auth", "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Dealbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/decision-engine/analytics": { "get": { "summary": "Decision Engine analytics", "operationId": "getDecisionEngineAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Decide audit aggregates" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Decision engine" ] } }, "/v1/decision-engine/decide": { "post": { "summary": "Make a bounded decision", "operationId": "decideDecisionEngine", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Decision + confidence from light rules" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Decision engine" ] } }, "/v1/decision-engine/engine": { "get": { "summary": "AI Decision Engine catalog", "operationId": "getDecisionEngine", "responses": { "200": { "description": "Kinds and BRMS honesty notes" } }, "tags": [ "Decision engine" ] } }, "/v1/decision-engine/kinds": { "get": { "summary": "Decision kinds", "operationId": "listDecisionEngineKinds", "responses": { "200": { "description": "Supported decision kinds" } }, "tags": [ "Decision engine" ] } }, "/v1/decision-engine/monitoring": { "get": { "summary": "Decision Engine monitoring snapshot", "operationId": "getDecisionEngineMonitoring", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Monitoring snapshot" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Decision engine" ] } }, "/v1/demo/speech": { "post": { "operationId": "demoSpeechSpeak", "summary": "Speak", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success. The body is written directly by the handler (for example audio bytes or a file download).", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Demo" ] } }, "/v1/demo/speech/capabilities": { "get": { "operationId": "demoSpeechCapabilities", "summary": "Capabilities", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } } }, "tags": [ "Demo" ] } }, "/v1/detect": { "post": { "summary": "Detect language of text", "operationId": "detectLanguage", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DetectRequest" } } } }, "responses": { "200": { "description": "Detected language", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DetectResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "Detection failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Detect" ] } }, "/v1/developer-experience-platform/devex": { "get": { "summary": "List Developer Experience Platform rows", "operationId": "listDeveloperExperiencePlatformRows", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Developer experience platform" ] } }, "/v1/developer-experience-platform/engine": { "get": { "summary": "Developer Experience Platform engine", "operationId": "getDeveloperExperiencePlatformEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Developer experience platform" ] } }, "/v1/developer-experience-platform/monitoring": { "get": { "summary": "Developer Experience Platform monitoring", "operationId": "getDeveloperExperiencePlatformMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Developer experience platform" ] } }, "/v1/developer-experience-platform/products": { "get": { "summary": "Developer Experience Platform products", "operationId": "listDeveloperExperiencePlatformProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Developer experience platform" ] } }, "/v1/developer-experience-platform/query": { "get": { "summary": "Query Developer Experience Platform", "operationId": "queryDeveloperExperiencePlatform", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Developer experience platform" ] } }, "/v1/developer/overview": { "get": { "operationId": "developerCloudOverview", "summary": "Overview", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Developer" ], "security": [ { "ClerkAuth": [] } ] } }, "/v1/developer/sdk": { "get": { "operationId": "developerCloudSdk", "summary": "SDK", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } } }, "tags": [ "Developer" ] } }, "/v1/dialects": { "get": { "summary": "List dialects", "operationId": "listDialects", "responses": { "200": { "description": "Dialect catalog" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Dialects" ] } }, "/v1/dialects/{code}": { "get": { "operationId": "dialectsGet", "summary": "Get", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Dialects" ], "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/dialects/detect": { "post": { "summary": "Detect dialect cues", "operationId": "detectDialect", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Dialect candidates" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Dialects" ] } }, "/v1/dialects/engine": { "get": { "summary": "Dialect Engine catalog", "operationId": "getDialectEngine", "responses": { "200": { "description": "Dialect capabilities and honesty notes" } }, "tags": [ "Dialects" ] } }, "/v1/dialects/identity": { "get": { "operationId": "dialectsListIdentity", "summary": "List identity", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "dialect", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "country", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Dialects" ] } }, "/v1/dialogue/synthesize": { "post": { "summary": "Multi-speaker dialogue synthesis", "operationId": "synthesizeDialogue", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "turns" ], "properties": { "turns": { "type": "array", "items": { "type": "object", "required": [ "speaker", "text", "voice" ], "properties": { "speaker": { "type": "string" }, "text": { "type": "string" }, "voice": { "type": "string" }, "language": { "type": "string" } } } } } } } } }, "responses": { "200": { "description": "Merged WAV dialogue audio", "content": { "audio/wav": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Dialogue" ] } }, "/v1/docs": { "get": { "operationId": "openApiGetDocs_get", "summary": "Get docs", "responses": { "200": { "description": "Success. The body is written directly by the handler (for example audio bytes or a file download).", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "System" ] } }, "/v1/documents/{id}": { "get": { "summary": "Document metadata", "operationId": "getDocument", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Document metadata" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Documents" ] } }, "/v1/documents/{id}/content": { "get": { "summary": "Download document bytes", "operationId": "downloadDocument", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "File bytes" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Documents" ] } }, "/v1/documents/translate": { "post": { "summary": "Upload DOCX/PDF and enqueue document translation", "operationId": "translateDocument", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "required": [ "file", "source", "target" ], "properties": { "file": { "type": "string", "format": "binary" }, "source": { "type": "string" }, "target": { "type": "string" }, "webhookUrl": { "type": "string" } } } } } }, "responses": { "201": { "description": "document_translate job queued", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Job" } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Documents" ] } }, "/v1/ecosystem-cloud/engine": { "get": { "summary": "Ecosystem Cloud engine (alias of products)", "operationId": "getEcosystemCloudEngine", "responses": { "200": { "description": "Ecosystem catalog + honesty" } }, "tags": [ "Ecosystem cloud" ] } }, "/v1/ecosystem-cloud/monitoring": { "get": { "summary": "Ecosystem Cloud foundation monitoring", "operationId": "getEcosystemCloudMonitoring", "responses": { "200": { "description": "Product status snapshot + honesty" } }, "tags": [ "Ecosystem cloud" ] } }, "/v1/ecosystem-cloud/overview": { "get": { "summary": "Ecosystem Cloud org overview", "operationId": "getEcosystemCloudOverview", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Session usage, deferred marketplaces, real-money safety notes" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Ecosystem cloud" ] } }, "/v1/ecosystem-cloud/products": { "get": { "summary": "Ecosystem Cloud product catalog", "operationId": "listEcosystemCloudProducts", "responses": { "200": { "description": "Marketplace/monetization hub catalog, honesty, Stripe safety, deferred marketplaces" } }, "tags": [ "Ecosystem cloud" ] } }, "/v1/ecosystem-cloud/routing": { "get": { "summary": "Ecosystem Cloud marketplace routing table", "operationId": "getEcosystemCloudRouting", "responses": { "200": { "description": "Static marketplace/monetization route catalog" } }, "tags": [ "Ecosystem cloud" ] } }, "/v1/edge/engine": { "get": { "summary": "Lugemi Edge engine", "operationId": "getEdgeEngine", "responses": { "200": { "description": "Edge catalog" } }, "tags": [ "Edge" ] } }, "/v1/edge/packs": { "get": { "summary": "List edge packs", "operationId": "listEdgePacks", "responses": { "200": { "description": "Signed pack manifests" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Edge" ] } }, "/v1/edge/packs/{packId}": { "get": { "operationId": "edgePack", "summary": "Pack", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Edge" ], "parameters": [ { "name": "packId", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/edge/packs/{packId}/run": { "post": { "summary": "Run offline push-to-talk translation under edge mode", "operationId": "runEdgePack", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "packId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Local or disclosed cloud result" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Edge" ] } }, "/v1/edge/packs/{packId}/verify": { "post": { "summary": "Verify edge pack signature and hashes", "operationId": "verifyEdgePack", "parameters": [ { "name": "packId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Verification result" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Edge" ] } }, "/v1/education-intelligence/engine": { "get": { "summary": "Education Intelligence engine catalog", "operationId": "getEducationIntelligenceEngine", "responses": { "200": { "description": "Education Intelligence catalog + honesty" } }, "tags": [ "Education intelligence" ] } }, "/v1/education-intelligence/monitoring": { "get": { "summary": "Education Intelligence monitoring", "operationId": "getEducationIntelligenceMonitoring", "responses": { "200": { "description": "Monitoring snapshot" } }, "tags": [ "Education intelligence" ] } }, "/v1/education-intelligence/products": { "get": { "summary": "Education Intelligence products", "operationId": "listEducationIntelligenceProducts", "responses": { "200": { "description": "Education Intelligence products" } }, "tags": [ "Education intelligence" ] } }, "/v1/education-intelligence/query": { "get": { "summary": "Query Education Intelligence terms", "operationId": "queryEducationIntelligenceTerms", "responses": { "200": { "description": "Filtered domain terms" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Education intelligence" ] } }, "/v1/education-intelligence/terms": { "get": { "summary": "List Education Intelligence terms", "operationId": "listEducationIntelligenceTerms", "responses": { "200": { "description": "Domain terms" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Education intelligence" ] } }, "/v1/embedding-cloud/analytics": { "get": { "summary": "Embedding Cloud analytics", "operationId": "getEmbeddingCloudAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Token/request aggregates" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Embedding cloud" ] } }, "/v1/embedding-cloud/embed": { "post": { "summary": "Create embeddings (Embedding Cloud)", "operationId": "createEmbeddingCloudEmbed", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "OpenAI-shaped embedding list + modality" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Embedding cloud" ] } }, "/v1/embedding-cloud/engine": { "get": { "summary": "Embedding Cloud engine catalog", "operationId": "getEmbeddingCloudEngine", "responses": { "200": { "description": "Embedding modalities and capabilities" } }, "tags": [ "Embedding cloud" ] } }, "/v1/embedding-cloud/modalities": { "get": { "summary": "Embedding modalities", "operationId": "listEmbeddingCloudModalities", "responses": { "200": { "description": "Modality statuses" } }, "tags": [ "Embedding cloud" ] } }, "/v1/embedding-cloud/models": { "get": { "summary": "Embedding models catalog", "operationId": "listEmbeddingCloudModels", "responses": { "200": { "description": "Available embedding models" } }, "tags": [ "Embedding cloud" ] } }, "/v1/embedding-cloud/monitoring": { "get": { "summary": "Embedding Cloud monitoring snapshot", "operationId": "getEmbeddingCloudMonitoring", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Monitoring snapshot" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Embedding cloud" ] } }, "/v1/embedding-runtime/engine": { "get": { "summary": "Embedding Runtime engine", "operationId": "getEmbeddingRuntimeEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Embedding runtime" ] } }, "/v1/embedding-runtime/execute": { "get": { "summary": "Execute via Embedding Runtime", "operationId": "executeEmbeddingRuntime", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Embedding runtime" ] } }, "/v1/embedding-runtime/monitoring": { "get": { "summary": "Embedding Runtime monitoring", "operationId": "getEmbeddingRuntimeMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Embedding runtime" ] } }, "/v1/embedding-runtime/products": { "get": { "summary": "Embedding Runtime products", "operationId": "listEmbeddingRuntimeProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Embedding runtime" ] } }, "/v1/embedding-runtime/query": { "get": { "summary": "Query Embedding Runtime", "operationId": "queryEmbeddingRuntime", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Embedding runtime" ] } }, "/v1/embedding-runtime/route": { "get": { "summary": "Route via Embedding Runtime", "operationId": "routeEmbeddingRuntime", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Embedding runtime" ] } }, "/v1/embedding-runtime/routes": { "get": { "summary": "Embedding Runtime routes", "operationId": "listEmbeddingRuntimeRoutes", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Embedding runtime" ] } }, "/v1/embeddings": { "post": { "summary": "Create embeddings", "operationId": "createEmbeddings", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "input" ], "properties": { "input": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" }, "minItems": 1 } ] }, "model": { "type": "string", "description": "Optional model override (default text-embedding-3-small)" } } } } } }, "responses": { "200": { "description": "Embedding vectors", "content": { "application/json": { "schema": { "type": "object", "properties": { "object": { "type": "string", "example": "list" }, "data": { "type": "array", "items": { "type": "object", "properties": { "object": { "type": "string" }, "index": { "type": "integer" }, "embedding": { "type": "array", "items": { "type": "number" } } } } }, "model": { "type": "string" }, "provider": { "type": "string" }, "usage": { "type": "object", "properties": { "prompt_tokens": { "type": "integer" }, "total_tokens": { "type": "integer" } } } } } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "OPENAI_API_KEY not configured", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Embeddings" ] } }, "/v1/emotion-voice/engine": { "get": { "summary": "Emotion Voice engine catalog", "operationId": "getEmotionVoiceEngine", "responses": { "200": { "description": "Capabilities and honesty notes" } }, "tags": [ "Emotion voice" ] } }, "/v1/emotion-voice/engine/analytics": { "get": { "operationId": "emotionVoiceAnalytics", "summary": "Analytics", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Emotion voice" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/emotion-voice/profiles": { "get": { "summary": "Emotion and domain voice profiles", "operationId": "listEmotionVoiceProfiles", "responses": { "200": { "description": "Happy/sad/… and domain tones" } }, "tags": [ "Emotion voice" ] } }, "/v1/emotion-voice/stream": { "post": { "summary": "Emotion voice chunk SSE stream", "operationId": "streamEmotionVoice", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "text/event-stream" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Emotion voice" ] } }, "/v1/emotion-voice/synthesize": { "post": { "summary": "Synthesize speech with an emotion/domain profile", "operationId": "synthesizeEmotionVoice", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Raw audio bytes" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Emotion voice" ] } }, "/v1/emotion/analytics": { "get": { "operationId": "emotionIntelligenceAnalytics", "summary": "Analytics", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Emotion" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/emotion/detect": { "post": { "summary": "Detect speech emotion from text or audio", "operationId": "detectEmotion", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Emotion label, confidence, ranked scores" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Emotion" ] } }, "/v1/emotion/engine": { "get": { "summary": "Emotion Intelligence engine catalog", "operationId": "getEmotionEngine", "responses": { "200": { "description": "Emotion labels and capabilities" } }, "tags": [ "Emotion" ] } }, "/v1/emotion/stream": { "post": { "operationId": "emotionIntelligenceStream", "summary": "Stream", "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "properties": {}, "additionalProperties": { "type": "string", "format": "binary" } } } } }, "responses": { "201": { "description": "Success. The body is written directly by the handler (for example audio bytes or a file download).", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Emotion" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/engineering-governance/engine": { "get": { "summary": "Engineering Governance engine", "operationId": "getEngineeringGovernanceEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Engineering governance" ] } }, "/v1/engineering-governance/execute": { "get": { "summary": "Execute via Engineering Governance", "operationId": "executeEngineeringGovernance", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Engineering governance" ] } }, "/v1/engineering-governance/monitoring": { "get": { "summary": "Engineering Governance monitoring", "operationId": "getEngineeringGovernanceMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Engineering governance" ] } }, "/v1/engineering-governance/products": { "get": { "summary": "Engineering Governance products", "operationId": "listEngineeringGovernanceProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Engineering governance" ] } }, "/v1/engineering-governance/query": { "get": { "summary": "Query Engineering Governance", "operationId": "queryEngineeringGovernance", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Engineering governance" ] } }, "/v1/engineering-governance/route": { "get": { "summary": "Route via Engineering Governance", "operationId": "routeEngineeringGovernance", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Engineering governance" ] } }, "/v1/engineering-governance/routes": { "get": { "summary": "Engineering Governance routes", "operationId": "listEngineeringGovernanceRoutes", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Engineering governance" ] } }, "/v1/engineering-quality-platform/engine": { "get": { "summary": "Engineering Quality Platform engine", "operationId": "getEngineeringQualityPlatformEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Engineering quality platform" ] } }, "/v1/engineering-quality-platform/execute": { "get": { "summary": "Execute via Engineering Quality Platform", "operationId": "executeEngineeringQualityPlatform", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Engineering quality platform" ] } }, "/v1/engineering-quality-platform/monitoring": { "get": { "summary": "Engineering Quality Platform monitoring", "operationId": "getEngineeringQualityPlatformMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Engineering quality platform" ] } }, "/v1/engineering-quality-platform/products": { "get": { "summary": "Engineering Quality Platform products", "operationId": "listEngineeringQualityPlatformProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Engineering quality platform" ] } }, "/v1/engineering-quality-platform/query": { "get": { "summary": "Query Engineering Quality Platform", "operationId": "queryEngineeringQualityPlatform", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Engineering quality platform" ] } }, "/v1/engineering-quality-platform/route": { "get": { "summary": "Route via Engineering Quality Platform", "operationId": "routeEngineeringQualityPlatform", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Engineering quality platform" ] } }, "/v1/engineering-quality-platform/routes": { "get": { "summary": "Engineering Quality Platform routes", "operationId": "listEngineeringQualityPlatformRoutes", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Engineering quality platform" ] } }, "/v1/enterprise-engineering-system/engine": { "get": { "summary": "EES engine alias", "operationId": "getEnterpriseEngineeringSystemEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Enterprise engineering system" ] } }, "/v1/enterprise-engineering-system/monitoring": { "get": { "summary": "EES monitoring", "operationId": "getEnterpriseEngineeringSystemMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Enterprise engineering system" ] } }, "/v1/enterprise-engineering-system/overview": { "get": { "summary": "EES overview", "operationId": "getEnterpriseEngineeringSystemOverview", "responses": { "200": { "description": "OK" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Enterprise engineering system" ], "security": [ { "ClerkAuth": [] } ] } }, "/v1/enterprise-engineering-system/products": { "get": { "summary": "EES products", "operationId": "listEnterpriseEngineeringSystemProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Enterprise engineering system" ] } }, "/v1/enterprise-engineering-system/routing": { "get": { "summary": "EES routing", "operationId": "getEnterpriseEngineeringSystemRouting", "responses": { "200": { "description": "OK" } }, "tags": [ "Enterprise engineering system" ] } }, "/v1/enterprise-rag/analytics": { "get": { "summary": "Enterprise RAG analytics", "operationId": "getEnterpriseRagAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Workspace RAG analytics" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Enterprise RAG" ] } }, "/v1/enterprise-rag/chunk": { "post": { "summary": "Preview RAG chunking windows", "operationId": "previewEnterpriseRagChunk", "responses": { "200": { "description": "Chunk preview (not persisted)" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Enterprise RAG" ] } }, "/v1/enterprise-rag/engine": { "get": { "summary": "Enterprise RAG Platform engine catalog", "operationId": "getEnterpriseRagEngine", "responses": { "200": { "description": "RAG capabilities and honesty flags" } }, "tags": [ "Enterprise RAG" ] } }, "/v1/enterprise-rag/monitoring": { "get": { "summary": "Enterprise RAG monitoring", "operationId": "getEnterpriseRagMonitoring", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Honesty + deferred flags" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Enterprise RAG" ] } }, "/v1/enterprise-rag/query": { "post": { "summary": "Grounded Enterprise RAG query", "operationId": "queryEnterpriseRag", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Grounded answer with citations" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Enterprise RAG" ] } }, "/v1/enterprise-rag/retrieve": { "post": { "summary": "Enterprise RAG retrieve with citations", "operationId": "retrieveEnterpriseRag", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Ranked passages + citations + context optimization" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Enterprise RAG" ] } }, "/v1/enterprise-search/analytics": { "get": { "summary": "Enterprise Search analytics", "operationId": "getEnterpriseSearchAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Workspace search counts" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Enterprise search" ] } }, "/v1/enterprise-search/engine": { "get": { "summary": "Enterprise Search engine catalog", "operationId": "getEnterpriseSearchEngine", "responses": { "200": { "description": "Search capabilities and honesty flags" } }, "tags": [ "Enterprise search" ] } }, "/v1/enterprise-search/modes": { "get": { "summary": "Enterprise Search modes", "operationId": "listEnterpriseSearchModes", "responses": { "200": { "description": "keyword / semantic / hybrid" } }, "tags": [ "Enterprise search" ] } }, "/v1/enterprise-search/monitoring": { "get": { "summary": "Enterprise Search monitoring", "operationId": "getEnterpriseSearchMonitoring", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Analytics + honesty + deferred ids" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Enterprise search" ] } }, "/v1/enterprise-search/search": { "post": { "summary": "Search knowledge chunks", "operationId": "enterpriseSearch", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Ranked hits for the authenticated workspace" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Enterprise search" ] } }, "/v1/enterprise-search/suggest": { "get": { "summary": "Search suggestions", "operationId": "enterpriseSearchSuggest", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Filename/tag/collection suggestions" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Enterprise search" ] } }, "/v1/enterprise/overview": { "get": { "operationId": "enterpriseCloudOverview", "summary": "Overview", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Enterprise" ], "security": [ { "ClerkAuth": [] } ] } }, "/v1/enterprise/policies": { "get": { "operationId": "enterpriseCloudPolicies", "summary": "Policies", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Enterprise" ], "security": [ { "ClerkAuth": [] } ] } }, "/v1/eval/run": { "post": { "summary": "Run golden-set eval against the active MT gateway (owner/admin)", "operationId": "runEval", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "mode", "in": "query", "schema": { "type": "string", "enum": [ "fixture", "live", "reference_oracle" ], "default": "fixture" } } ], "responses": { "200": { "description": "Eval snapshot written to eval/results/latest.json" }, "400": { "description": "Live vendor eval is not enabled for this workspace" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Eval" ] } }, "/v1/evaluation-platform/capabilities": { "get": { "summary": "List evaluation capabilities", "operationId": "listEvaluationPlatformCapabilities", "responses": { "200": { "description": "List evaluation capabilities" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Evaluation platform" ] } }, "/v1/evaluation-platform/engine": { "get": { "summary": "Evaluation Platform engine catalog", "operationId": "getEvaluationPlatformEngine", "responses": { "200": { "description": "Evaluation Platform catalog + honesty" } }, "tags": [ "Evaluation platform" ] } }, "/v1/evaluation-platform/monitoring": { "get": { "summary": "Evaluation Platform monitoring", "operationId": "getEvaluationPlatformMonitoring", "responses": { "200": { "description": "Monitoring snapshot" } }, "tags": [ "Evaluation platform" ] } }, "/v1/evaluation-platform/products": { "get": { "summary": "Evaluation Platform products", "operationId": "listEvaluationPlatformProducts", "responses": { "200": { "description": "Evaluation Platform products" } }, "tags": [ "Evaluation platform" ] } }, "/v1/evaluation-platform/query": { "get": { "summary": "Query Evaluation Platform", "operationId": "queryEvaluationPlatform", "responses": { "200": { "description": "Filtered catalog rows" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Evaluation platform" ] } }, "/v1/event-fabric/analytics": { "get": { "summary": "Event Fabric analytics", "operationId": "getEventFabricAnalytics", "responses": { "200": { "description": "Per-topic publish/consume/DLQ counts" } }, "tags": [ "Event fabric" ] } }, "/v1/event-fabric/brokers": { "get": { "summary": "Event Fabric broker catalog", "operationId": "listEventFabricBrokers", "responses": { "200": { "description": "Active Redis Streams + deferred adapters" } }, "tags": [ "Event fabric" ] } }, "/v1/event-fabric/dlq": { "get": { "summary": "List dead-letter events", "operationId": "listEventFabricDlq", "parameters": [ { "name": "topic", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "DLQ events" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Event fabric" ] } }, "/v1/event-fabric/dlq/retry": { "post": { "summary": "Requeue an event from DLQ", "operationId": "retryEventFabricDlq", "responses": { "200": { "description": "Republished event" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Event fabric" ] } }, "/v1/event-fabric/engine": { "get": { "summary": "Event Fabric engine (alias of products)", "operationId": "getEventFabricEngine", "responses": { "200": { "description": "Catalog + honesty" } }, "tags": [ "Event fabric" ] } }, "/v1/event-fabric/events": { "get": { "summary": "Poll / consume CloudEvents from a topic", "operationId": "pollEventFabricEvents", "parameters": [ { "name": "topic", "in": "query", "schema": { "type": "string" } }, { "name": "count", "in": "query", "schema": { "type": "integer" } }, { "name": "eventVersion", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "CloudEvents batch" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Event fabric" ] }, "post": { "summary": "Publish a CloudEvent", "operationId": "publishEventFabricEvent", "responses": { "201": { "description": "Published CloudEvent" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Event fabric" ] } }, "/v1/event-fabric/events/{streamId}/fail": { "post": { "summary": "Mark event failed (retry or DLQ)", "operationId": "failEventFabricEvent", "parameters": [ { "name": "streamId", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "retry or dlq action" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Event fabric" ] } }, "/v1/event-fabric/monitoring": { "get": { "summary": "Event Fabric monitoring", "operationId": "getEventFabricMonitoring", "responses": { "200": { "description": "Backend + counters + honesty" } }, "tags": [ "Event fabric" ] } }, "/v1/event-fabric/overview": { "get": { "summary": "Event Fabric org overview", "operationId": "getEventFabricOverview", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Session + brokers + analytics" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Event fabric" ] } }, "/v1/event-fabric/products": { "get": { "summary": "Event Fabric capability catalog", "operationId": "listEventFabricProducts", "responses": { "200": { "description": "Event bus capabilities, brokers, Redis Streams honesty, deferred Kafka/NATS/Rabbit" } }, "tags": [ "Event fabric" ] } }, "/v1/event-fabric/replay": { "post": { "summary": "Replay events from a stream offset", "operationId": "replayEventFabric", "responses": { "200": { "description": "Replayed CloudEvents" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Event fabric" ] } }, "/v1/event-fabric/snapshots": { "get": { "summary": "Consumer-group cursor snapshots", "operationId": "listEventFabricSnapshots", "responses": { "200": { "description": "Snapshots" } }, "tags": [ "Event fabric" ] } }, "/v1/everyday/artifacts/{id}/audio": { "get": { "operationId": "everydayGetAudio", "summary": "Get audio", "responses": { "200": { "description": "Success. The body is written directly by the handler (for example audio bytes or a file download).", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Everyday" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/everyday/audio": { "post": { "operationId": "everydayAudio", "summary": "Audio", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Everyday" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/everyday/catalog": { "get": { "operationId": "everydayCatalog", "summary": "Catalog", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Everyday" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/everyday/documents/{id}/source-revisions": { "post": { "operationId": "everydayCorrectSource", "summary": "Correct source", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Everyday" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/everyday/replies/{id}/approvals": { "post": { "operationId": "everydayApprove", "summary": "Approve", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Everyday" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/everyday/sessions": { "get": { "operationId": "everydayList", "summary": "List", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Everyday" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] }, "post": { "operationId": "everydayCreateSession", "summary": "Create session", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Everyday" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/everyday/sessions/{id}": { "delete": { "operationId": "everydayDeleteSession", "summary": "Delete session", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Everyday" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] }, "get": { "operationId": "everydayGetSession", "summary": "Get session", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Everyday" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/everyday/sessions/{id}/events": { "get": { "operationId": "everydayEvents", "summary": "Events", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "after", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Everyday" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/everyday/sessions/{id}/replies": { "post": { "operationId": "everydayReply", "summary": "Reply", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Everyday" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/everyday/sessions/{id}/terms": { "post": { "operationId": "everydayTerm", "summary": "Term", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Everyday" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/everyday/sessions/{id}/uploads": { "post": { "operationId": "everydayUpload", "summary": "Upload", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Everyday" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/everyday/sources/{id}/explanations": { "post": { "operationId": "everydayExplain", "summary": "Explain", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Everyday" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/everyday/sources/{id}/questions": { "post": { "operationId": "everydayQuestion", "summary": "Question", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Everyday" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/everyday/sources/{id}/translations": { "post": { "operationId": "everydayTranslate", "summary": "Translate", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Everyday" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/experiment-platform/engine": { "get": { "summary": "Experiment Platform engine catalog", "operationId": "getExperimentPlatformEngine", "responses": { "200": { "description": "Experiment Platform catalog + honesty" } }, "tags": [ "Experiment platform" ] } }, "/v1/experiment-platform/monitoring": { "get": { "summary": "Experiment Platform monitoring", "operationId": "getExperimentPlatformMonitoring", "responses": { "200": { "description": "Monitoring snapshot" } }, "tags": [ "Experiment platform" ] } }, "/v1/experiment-platform/products": { "get": { "summary": "Experiment Platform products", "operationId": "listExperimentPlatformProducts", "responses": { "200": { "description": "Experiment Platform products" } }, "tags": [ "Experiment platform" ] } }, "/v1/experiment-platform/query": { "get": { "summary": "Query Experiment Platform", "operationId": "queryExperimentPlatform", "responses": { "200": { "description": "Filtered catalog rows" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Experiment platform" ] } }, "/v1/experiment-platform/runs": { "get": { "summary": "List experiment runs", "operationId": "listExperimentPlatformRuns", "responses": { "200": { "description": "List experiment runs" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Experiment platform" ] } }, "/v1/explainability-platform/engine": { "get": { "summary": "Explainability Platform engine", "operationId": "getExplainabilityPlatformEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Explainability platform" ] } }, "/v1/explainability-platform/explanations": { "get": { "summary": "List Explainability Platform rows", "operationId": "listExplainabilityPlatformRows", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Explainability platform" ] } }, "/v1/explainability-platform/monitoring": { "get": { "summary": "Explainability Platform monitoring", "operationId": "getExplainabilityPlatformMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Explainability platform" ] } }, "/v1/explainability-platform/products": { "get": { "summary": "Explainability Platform products", "operationId": "listExplainabilityPlatformProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Explainability platform" ] } }, "/v1/explainability-platform/query": { "get": { "summary": "Query Explainability Platform", "operationId": "queryExplainabilityPlatform", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Explainability platform" ] } }, "/v1/feature-flags": { "get": { "summary": "Organization feature flags and entitlements", "operationId": "getFeatureFlags", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Plan-aware flags, overrides, and entitlements" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Feature flags" ] }, "patch": { "summary": "Toggle workspace entitlement overrides", "operationId": "patchFeatureFlags", "security": [ { "ClerkAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "overrides": { "type": "object", "additionalProperties": { "oneOf": [ { "type": "boolean" }, { "type": "null" } ] }, "description": "Plan-included features only; null clears an override" } } } } } }, "responses": { "200": { "description": "Updated flags and entitlements" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Feature requires a higher plan" }, "403": { "description": "Only owners and admins can patch" } }, "tags": [ "Feature flags" ] } }, "/v1/fidelity/clarify": { "post": { "summary": "Associate caller answer with unresolved fidelity span", "operationId": "fidelityClarify", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Clarification resolution" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Fidelity" ] } }, "/v1/fidelity/engine": { "get": { "summary": "Lugemi Fidelity engine", "operationId": "getFidelityEngine", "responses": { "200": { "description": "Fidelity catalog" } }, "tags": [ "Fidelity" ] } }, "/v1/fidelity/verify": { "post": { "summary": "Verify translation meaning ledger", "operationId": "fidelityVerify", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Decision, error spans, clarification" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Fidelity" ] } }, "/v1/financial-intelligence/engine": { "get": { "summary": "Financial Intelligence engine catalog", "operationId": "getFinancialIntelligenceEngine", "responses": { "200": { "description": "Financial Intelligence catalog + honesty" } }, "tags": [ "Financial intelligence" ] } }, "/v1/financial-intelligence/monitoring": { "get": { "summary": "Financial Intelligence monitoring", "operationId": "getFinancialIntelligenceMonitoring", "responses": { "200": { "description": "Monitoring snapshot" } }, "tags": [ "Financial intelligence" ] } }, "/v1/financial-intelligence/products": { "get": { "summary": "Financial Intelligence products", "operationId": "listFinancialIntelligenceProducts", "responses": { "200": { "description": "Financial Intelligence products" } }, "tags": [ "Financial intelligence" ] } }, "/v1/financial-intelligence/query": { "get": { "summary": "Query Financial Intelligence terms", "operationId": "queryFinancialIntelligenceTerms", "responses": { "200": { "description": "Filtered domain terms" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Financial intelligence" ] } }, "/v1/financial-intelligence/terms": { "get": { "summary": "List Financial Intelligence terms", "operationId": "listFinancialIntelligenceTerms", "responses": { "200": { "description": "Domain terms" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Financial intelligence" ] } }, "/v1/finetunes/candidates": { "get": { "summary": "List failed language-pair fine-tune candidates from coverage", "operationId": "listFineTuneCandidates", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Candidates below coverage thresholds" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Finetunes" ] } }, "/v1/finetunes/jobs": { "get": { "summary": "List fine-tune jobs for the organization", "operationId": "listFineTuneJobs", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Jobs" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Finetunes" ] }, "post": { "summary": "Create a fine-tune job from a golden training pack (Pro)", "operationId": "createFineTuneJob", "security": [ { "ClerkAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "sourceLang", "targetLang" ], "properties": { "sourceLang": { "type": "string" }, "targetLang": { "type": "string" }, "launcher": { "type": "string", "enum": [ "manual", "modal" ] }, "baseModel": { "type": "string" } } } } } }, "responses": { "201": { "description": "Created" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Pro plan required" } }, "tags": [ "Finetunes" ] } }, "/v1/finetunes/jobs/{id}/complete": { "post": { "summary": "Attach artifact and optionally promote to model registry (Pro)", "operationId": "completeFineTuneJob", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "artifactKind": { "type": "string", "enum": [ "phrase_map", "http_endpoint" ] }, "artifactUri": { "type": "string" }, "useGoldenPhraseMap": { "type": "boolean" }, "promote": { "type": "boolean" }, "displayName": { "type": "string" } } } } } }, "responses": { "200": { "description": "Completed" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Pro plan required" }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Finetunes" ] } }, "/v1/finetunes/jobs/{id}/launch": { "post": { "summary": "Launch or defer a fine-tune job (Pro)", "operationId": "launchFineTuneJob", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Status updated (running or awaiting_gpu)" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Pro plan required" }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Finetunes" ] } }, "/v1/finetunes/models": { "get": { "summary": "List model registry entries", "operationId": "listFineTuneModels", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Registry" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Finetunes" ] } }, "/v1/finetunes/models/{id}/retire": { "post": { "summary": "Retire a ready fine-tune model (Pro)", "operationId": "retireFineTuneModel", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Retired" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Pro plan required" }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Finetunes" ] } }, "/v1/finops-platform/alerts": { "get": { "summary": "FinOps Platform alerts", "operationId": "listFinopsPlatformAlerts", "responses": { "200": { "description": "OK" } }, "tags": [ "FinOps platform" ] } }, "/v1/finops-platform/budgets": { "get": { "summary": "FinOps Platform budgets", "operationId": "listFinopsPlatformBudgets", "responses": { "200": { "description": "OK" } }, "tags": [ "FinOps platform" ] } }, "/v1/finops-platform/costs": { "get": { "summary": "FinOps Platform costs", "operationId": "listFinopsPlatformCosts", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "FinOps platform" ] } }, "/v1/finops-platform/engine": { "get": { "summary": "FinOps Platform engine", "operationId": "getFinopsPlatformEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "FinOps platform" ] } }, "/v1/finops-platform/monitoring": { "get": { "summary": "FinOps Platform monitoring", "operationId": "getFinopsPlatformMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "FinOps platform" ] } }, "/v1/finops-platform/products": { "get": { "summary": "FinOps Platform products", "operationId": "listFinopsPlatformProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "FinOps platform" ] } }, "/v1/finops-platform/query": { "get": { "summary": "Query FinOps Platform", "operationId": "queryFinopsPlatform", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "FinOps platform" ] } }, "/v1/foundation-model-cloud/engine": { "get": { "summary": "Foundation Model Cloud engine (alias of products)", "operationId": "getFoundationModelCloudEngine", "responses": { "200": { "description": "FMC catalog + honesty" } }, "tags": [ "Foundation model cloud" ] } }, "/v1/foundation-model-cloud/monitoring": { "get": { "summary": "Foundation Model Cloud foundation monitoring", "operationId": "getFoundationModelCloudMonitoring", "responses": { "200": { "description": "Product status snapshot + honesty" } }, "tags": [ "Foundation model cloud" ] } }, "/v1/foundation-model-cloud/overview": { "get": { "summary": "Foundation Model Cloud org overview", "operationId": "getFoundationModelCloudOverview", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Session usage, deferred model families, honesty notes" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Foundation model cloud" ] } }, "/v1/foundation-model-cloud/products": { "get": { "summary": "Foundation Model Cloud product catalog", "operationId": "listFoundationModelCloudProducts", "responses": { "200": { "description": "Model-family catalog, architecture, and honesty (no trained competitive weights)" } }, "tags": [ "Foundation model cloud" ] } }, "/v1/gateway/overview": { "get": { "operationId": "gatewayCloudOverview", "summary": "Overview", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Gateway" ], "security": [ { "ClerkAuth": [] } ] } }, "/v1/gateway/providers": { "get": { "operationId": "gatewayCloudProviders", "summary": "Providers", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } } }, "tags": [ "Gateway" ] } }, "/v1/gitops-platform/engine": { "get": { "summary": "GitOps Platform engine", "operationId": "getGitopsPlatformEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "GitOps platform" ] } }, "/v1/gitops-platform/monitoring": { "get": { "summary": "GitOps Platform monitoring", "operationId": "getGitopsPlatformMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "GitOps platform" ] } }, "/v1/gitops-platform/products": { "get": { "summary": "GitOps Platform products", "operationId": "listGitopsPlatformProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "GitOps platform" ] } }, "/v1/gitops-platform/query": { "get": { "summary": "Query GitOps Platform", "operationId": "queryGitopsPlatform", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "GitOps platform" ] } }, "/v1/gitops-platform/readiness": { "get": { "summary": "List GitOps Platform rows", "operationId": "listGitopsPlatformRows", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "GitOps platform" ] } }, "/v1/global-configuration-platform/configurations": { "get": { "summary": "List Global Configuration Platform rows", "operationId": "listGlobalConfigurationPlatformRows", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Global configuration platform" ] } }, "/v1/global-configuration-platform/engine": { "get": { "summary": "Global Configuration Platform engine", "operationId": "getGlobalConfigurationPlatformEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Global configuration platform" ] } }, "/v1/global-configuration-platform/monitoring": { "get": { "summary": "Global Configuration Platform monitoring", "operationId": "getGlobalConfigurationPlatformMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Global configuration platform" ] } }, "/v1/global-configuration-platform/products": { "get": { "summary": "Global Configuration Platform products", "operationId": "listGlobalConfigurationPlatformProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Global configuration platform" ] } }, "/v1/global-configuration-platform/query": { "get": { "summary": "Query Global Configuration Platform", "operationId": "queryGlobalConfigurationPlatform", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Global configuration platform" ] } }, "/v1/global-deployment-controller/deployments": { "get": { "summary": "Global Deployment Controller deployments", "operationId": "listGlobalDeploymentControllerDeployments", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Global deployment controller" ] } }, "/v1/global-deployment-controller/engine": { "get": { "summary": "Global Deployment Controller engine", "operationId": "getGlobalDeploymentControllerEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Global deployment controller" ] } }, "/v1/global-deployment-controller/monitoring": { "get": { "summary": "Global Deployment Controller monitoring", "operationId": "getGlobalDeploymentControllerMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Global deployment controller" ] } }, "/v1/global-deployment-controller/products": { "get": { "summary": "Global Deployment Controller products", "operationId": "listGlobalDeploymentControllerProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Global deployment controller" ] } }, "/v1/global-deployment-controller/promote": { "post": { "summary": "Promote deployment (production requires authorization)", "operationId": "promoteGlobalDeploymentController", "responses": { "200": { "description": "OK" }, "201": { "description": "Created" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Global deployment controller" ] } }, "/v1/global-deployment-controller/query": { "get": { "summary": "Query Global Deployment Controller", "operationId": "queryGlobalDeploymentController", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Global deployment controller" ] } }, "/v1/global-deployment-controller/rollback": { "get": { "summary": "Global Deployment Controller rollback", "operationId": "listGlobalDeploymentControllerRollbacks", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Global deployment controller" ] } }, "/v1/global-policy-engine/engine": { "get": { "summary": "Global Policy Engine engine", "operationId": "getGlobalPolicyEngineEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Global policy engine" ] } }, "/v1/global-policy-engine/monitoring": { "get": { "summary": "Global Policy Engine monitoring", "operationId": "getGlobalPolicyEngineMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Global policy engine" ] } }, "/v1/global-policy-engine/policies": { "get": { "summary": "List Global Policy Engine rows", "operationId": "listGlobalPolicyEngineRows", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Global policy engine" ] } }, "/v1/global-policy-engine/products": { "get": { "summary": "Global Policy Engine products", "operationId": "listGlobalPolicyEngineProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Global policy engine" ] } }, "/v1/global-policy-engine/query": { "get": { "summary": "Query Global Policy Engine", "operationId": "queryGlobalPolicyEngine", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Global policy engine" ] } }, "/v1/global-routing-controller/engine": { "get": { "summary": "Global Routing Controller engine", "operationId": "getGlobalRoutingControllerEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Global routing controller" ] } }, "/v1/global-routing-controller/monitoring": { "get": { "summary": "Global Routing Controller monitoring", "operationId": "getGlobalRoutingControllerMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Global routing controller" ] } }, "/v1/global-routing-controller/products": { "get": { "summary": "Global Routing Controller products", "operationId": "listGlobalRoutingControllerProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Global routing controller" ] } }, "/v1/global-routing-controller/query": { "get": { "summary": "Query Global Routing Controller", "operationId": "queryGlobalRoutingController", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Global routing controller" ] } }, "/v1/global-routing-controller/routes": { "get": { "summary": "List Global Routing Controller rows", "operationId": "listGlobalRoutingControllerRows", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Global routing controller" ] } }, "/v1/global-scheduler/engine": { "get": { "summary": "Global Scheduler engine", "operationId": "getGlobalSchedulerEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Global scheduler" ] } }, "/v1/global-scheduler/monitoring": { "get": { "summary": "Global Scheduler monitoring", "operationId": "getGlobalSchedulerMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Global scheduler" ] } }, "/v1/global-scheduler/products": { "get": { "summary": "Global Scheduler products", "operationId": "listGlobalSchedulerProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Global scheduler" ] } }, "/v1/global-scheduler/query": { "get": { "summary": "Query Global Scheduler", "operationId": "queryGlobalScheduler", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Global scheduler" ] } }, "/v1/global-scheduler/schedules": { "get": { "summary": "List Global Scheduler rows", "operationId": "listGlobalSchedulerRows", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Global scheduler" ] } }, "/v1/glossary/terms": { "get": { "summary": "List glossary terms", "operationId": "listGlossaryTerms", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "source", "in": "query", "schema": { "type": "string" } }, { "name": "target", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Terms for the workspace" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Glossary" ] }, "post": { "summary": "Create glossary term", "operationId": "createGlossaryTerm", "security": [ { "ClerkAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "sourceLang", "targetLang", "sourceTerm", "targetTerm" ], "properties": { "sourceLang": { "type": "string" }, "targetLang": { "type": "string" }, "sourceTerm": { "type": "string" }, "targetTerm": { "type": "string" }, "caseSensitive": { "type": "boolean" }, "wholeWord": { "type": "boolean" } } } } } }, "responses": { "201": { "description": "Created" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Duplicate" } }, "tags": [ "Glossary" ] } }, "/v1/glossary/terms/{id}": { "delete": { "operationId": "glossaryRemove", "summary": "Remove", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Glossary" ], "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] }, "patch": { "operationId": "glossaryUpdate", "summary": "Update", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Glossary" ], "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/golden-path-platform/engine": { "get": { "summary": "Golden Path Platform engine", "operationId": "getGoldenPathPlatformEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Golden path platform" ] } }, "/v1/golden-path-platform/monitoring": { "get": { "summary": "Golden Path Platform monitoring", "operationId": "getGoldenPathPlatformMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Golden path platform" ] } }, "/v1/golden-path-platform/products": { "get": { "summary": "Golden Path Platform products", "operationId": "listGoldenPathPlatformProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Golden path platform" ] } }, "/v1/golden-path-platform/query": { "get": { "summary": "Query Golden Path Platform", "operationId": "queryGoldenPathPlatform", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Golden path platform" ] } }, "/v1/golden-path-platform/templates": { "get": { "summary": "List Golden Path Platform rows", "operationId": "listGoldenPathPlatformRows", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Golden path platform" ] } }, "/v1/government-intelligence/engine": { "get": { "summary": "Government Intelligence engine catalog", "operationId": "getGovernmentIntelligenceEngine", "responses": { "200": { "description": "Government Intelligence catalog + honesty" } }, "tags": [ "Government intelligence" ] } }, "/v1/government-intelligence/monitoring": { "get": { "summary": "Government Intelligence monitoring", "operationId": "getGovernmentIntelligenceMonitoring", "responses": { "200": { "description": "Monitoring snapshot" } }, "tags": [ "Government intelligence" ] } }, "/v1/government-intelligence/products": { "get": { "summary": "Government Intelligence products", "operationId": "listGovernmentIntelligenceProducts", "responses": { "200": { "description": "Government Intelligence products" } }, "tags": [ "Government intelligence" ] } }, "/v1/government-intelligence/query": { "get": { "summary": "Query Government Intelligence terms", "operationId": "queryGovernmentIntelligenceTerms", "responses": { "200": { "description": "Filtered domain terms" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Government intelligence" ] } }, "/v1/government-intelligence/terms": { "get": { "summary": "List Government Intelligence terms", "operationId": "listGovernmentIntelligenceTerms", "responses": { "200": { "description": "Domain terms" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Government intelligence" ] } }, "/v1/government/attestations": { "get": { "summary": "List government attestations", "operationId": "listGovernmentAttestations", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Attestation registry rows" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Government" ] }, "post": { "summary": "Create government attestation", "operationId": "createGovernmentAttestation", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Created attestation" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Government" ] } }, "/v1/government/audit/export": { "get": { "summary": "Export government audit pack (JSON)", "operationId": "exportGovernmentAudit", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Program, service lines, attestations, protocol pointers" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Government" ] } }, "/v1/government/civic/turn": { "post": { "summary": "Civic citizen turn (disclosed assistant reply)", "operationId": "governmentCivicTurn", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Reply with government disclosure + optional attestation" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Government" ] } }, "/v1/government/engine": { "get": { "summary": "Government Cloud engine catalog", "operationId": "getGovernmentCloudEngine", "responses": { "200": { "description": "Public-sector language access catalog — civic service lines, attestations, audit export. Not FedRAMP certification." } }, "tags": [ "Government" ] } }, "/v1/government/program": { "get": { "summary": "Get government program settings", "operationId": "getGovernmentProgram", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Program + organization residency snapshot" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Government" ] }, "patch": { "summary": "Update government program settings", "operationId": "updateGovernmentProgram", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Updated program" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Government" ] } }, "/v1/government/protocol": { "get": { "summary": "Government Cloud adoption protocol", "operationId": "getGovernmentCloudProtocol", "responses": { "200": { "description": "Residency, program, service line, integrity, attestation checklist" } }, "tags": [ "Government" ] } }, "/v1/government/residency": { "get": { "summary": "Government residency islands + org pin", "operationId": "getGovernmentResidency", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Residency snapshot" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Government" ] } }, "/v1/government/service-lines": { "get": { "summary": "List civic service lines", "operationId": "listGovernmentServiceLines", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Service lines" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Government" ] }, "post": { "summary": "Create civic service line", "operationId": "createGovernmentServiceLine", "security": [ { "ClerkAuth": [] } ], "responses": { "201": { "description": "Created service line" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Government" ] } }, "/v1/government/service-lines/{id}": { "patch": { "summary": "Update civic service line", "operationId": "updateGovernmentServiceLine", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Updated service line" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Government" ] } }, "/v1/gpu-platform/allocations": { "get": { "summary": "List sandbox GPU allocations", "operationId": "listGpuAllocations", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Org/workspace allocations" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "GPU platform" ] }, "post": { "summary": "Create sandbox GPU allocation (ceiling-enforced)", "operationId": "createGpuAllocation", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Logical allocation created" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Hard instance or spend ceiling exceeded" }, "403": { "description": "Provision mode disabled" } }, "tags": [ "GPU platform" ] } }, "/v1/gpu-platform/allocations/{id}/release": { "post": { "summary": "Release sandbox GPU allocation", "operationId": "releaseGpuAllocation", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Released" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "GPU platform" ] } }, "/v1/gpu-platform/allocations/{id}/scale": { "post": { "summary": "Scale allocation toward target (hard-clamped)", "operationId": "scaleGpuAllocation", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Scaled or clamped to ceiling" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Hard ceiling prevents scale" }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "GPU platform" ] } }, "/v1/gpu-platform/analytics": { "get": { "summary": "GPU Platform analytics", "operationId": "getGpuPlatformAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Allocation aggregates" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "GPU platform" ] } }, "/v1/gpu-platform/ceilings": { "get": { "summary": "Hard GPU instance/spend ceilings", "operationId": "getGpuCeilings", "responses": { "200": { "description": "maxInstances + maxSpendUsd + provisionMode" } }, "tags": [ "GPU platform" ] } }, "/v1/gpu-platform/costs": { "get": { "summary": "Estimated GPU costs", "operationId": "getGpuPlatformCosts", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Estimated USD from sandbox rates" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "GPU platform" ] } }, "/v1/gpu-platform/engine": { "get": { "summary": "GPU Platform catalog", "operationId": "getGpuPlatformEngine", "responses": { "200": { "description": "Capabilities, ceilings, and spend-safety honesty" } }, "tags": [ "GPU platform" ] } }, "/v1/gpu-platform/health": { "get": { "summary": "GPU Platform health", "operationId": "getGpuPlatformHealth", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Sandbox health snapshot" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "GPU platform" ] } }, "/v1/gpu-platform/monitoring": { "get": { "summary": "GPU Platform monitoring", "operationId": "getGpuPlatformMonitoring", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Monitoring + spend-safety snapshot" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "GPU platform" ] } }, "/v1/gpu-platform/pools": { "get": { "summary": "Sandbox GPU pools", "operationId": "listGpuPools", "responses": { "200": { "description": "Logical sandbox pool catalog" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "GPU platform" ] } }, "/v1/gpu-platform/vendors": { "get": { "summary": "GPU vendors", "operationId": "listGpuVendors", "responses": { "200": { "description": "NVIDIA/AMD/Intel sandbox vendor tags" } }, "tags": [ "GPU platform" ] } }, "/v1/gpu-runtime/engine": { "get": { "summary": "GPU Runtime engine", "operationId": "getGpuRuntimeEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "GPU runtime" ] } }, "/v1/gpu-runtime/execute": { "get": { "summary": "Execute via GPU Runtime", "operationId": "executeGpuRuntime", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "GPU runtime" ] } }, "/v1/gpu-runtime/monitoring": { "get": { "summary": "GPU Runtime monitoring", "operationId": "getGpuRuntimeMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "GPU runtime" ] } }, "/v1/gpu-runtime/products": { "get": { "summary": "GPU Runtime products", "operationId": "listGpuRuntimeProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "GPU runtime" ] } }, "/v1/gpu-runtime/query": { "get": { "summary": "Query GPU Runtime", "operationId": "queryGpuRuntime", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "GPU runtime" ] } }, "/v1/gpu-runtime/route": { "get": { "summary": "Route via GPU Runtime", "operationId": "routeGpuRuntime", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "GPU runtime" ] } }, "/v1/gpu-runtime/routes": { "get": { "summary": "GPU Runtime routes", "operationId": "listGpuRuntimeRoutes", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "GPU runtime" ] } }, "/v1/grammar/analytics": { "get": { "operationId": "grammarAnalytics", "summary": "Analytics", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Grammar" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/grammar/check": { "post": { "operationId": "grammarCheck", "summary": "Check", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Grammar" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/grammar/correct": { "post": { "operationId": "grammarCorrect", "summary": "Correct", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Grammar" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/grammar/intelligence": { "get": { "operationId": "grammarIntelligence", "summary": "Intelligence", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } } }, "tags": [ "Grammar" ] } }, "/v1/grammar/spell": { "post": { "operationId": "grammarSpell", "summary": "Spell", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Grammar" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/grammar/suggest": { "post": { "operationId": "grammarSuggest", "summary": "Suggest", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Grammar" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/grounded/engine": { "get": { "summary": "Lugemi Grounded engine", "operationId": "getGroundedEngine", "responses": { "200": { "description": "Grounded catalog" } }, "tags": [ "Grounded" ] } }, "/v1/grounded/interpret": { "post": { "summary": "Grounded interpret of selected document region", "operationId": "groundedInterpret", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "document_evidence, speaker_claim, translation, discrepancy flags" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Grounded" ] } }, "/v1/healthcare-intelligence/engine": { "get": { "summary": "Healthcare Intelligence engine catalog", "operationId": "getHealthcareIntelligenceEngine", "responses": { "200": { "description": "Healthcare Intelligence catalog + honesty" } }, "tags": [ "Healthcare intelligence" ] } }, "/v1/healthcare-intelligence/monitoring": { "get": { "summary": "Healthcare Intelligence monitoring", "operationId": "getHealthcareIntelligenceMonitoring", "responses": { "200": { "description": "Monitoring snapshot" } }, "tags": [ "Healthcare intelligence" ] } }, "/v1/healthcare-intelligence/products": { "get": { "summary": "Healthcare Intelligence products", "operationId": "listHealthcareIntelligenceProducts", "responses": { "200": { "description": "Healthcare Intelligence products" } }, "tags": [ "Healthcare intelligence" ] } }, "/v1/healthcare-intelligence/query": { "get": { "summary": "Query Healthcare Intelligence terms", "operationId": "queryHealthcareIntelligenceTerms", "responses": { "200": { "description": "Filtered domain terms" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Healthcare intelligence" ] } }, "/v1/healthcare-intelligence/terms": { "get": { "summary": "List Healthcare Intelligence terms", "operationId": "listHealthcareIntelligenceTerms", "responses": { "200": { "description": "Domain terms" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Healthcare intelligence" ] } }, "/v1/icu/format": { "post": { "operationId": "localizeFormatIcu", "summary": "Format icu", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Icu" ] } }, "/v1/icu/validate": { "post": { "operationId": "localizeValidateIcu", "summary": "Validate icu", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Icu" ] } }, "/v1/identity-federation/engine": { "get": { "summary": "Identity Federation engine", "operationId": "getIdentityFederationEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Identity federation" ] } }, "/v1/identity-federation/federation": { "get": { "summary": "List Identity Federation rows", "operationId": "listIdentityFederationRows", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Identity federation" ] } }, "/v1/identity-federation/monitoring": { "get": { "summary": "Identity Federation monitoring", "operationId": "getIdentityFederationMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Identity federation" ] } }, "/v1/identity-federation/products": { "get": { "summary": "Identity Federation products", "operationId": "listIdentityFederationProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Identity federation" ] } }, "/v1/identity-federation/query": { "get": { "summary": "Query Identity Federation", "operationId": "queryIdentityFederation", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Identity federation" ] } }, "/v1/identity/me": { "get": { "operationId": "identityCloudMe", "summary": "Me", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Identity" ], "security": [ { "ClerkAuth": [] } ] } }, "/v1/identity/overview": { "get": { "operationId": "identityCloudOverview", "summary": "Overview", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Identity" ], "security": [ { "ClerkAuth": [] } ] } }, "/v1/inference-cloud/overview": { "get": { "summary": "Inference Cloud org overview", "operationId": "getInferenceOverview", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Session chat/embeddings usage, products, deferred flags, spend-safety notes" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Inference cloud" ] } }, "/v1/inference-cloud/products": { "get": { "summary": "Inference Cloud product catalog", "operationId": "listInferenceProducts", "responses": { "200": { "description": "Inference products and architecture honesty notes" } }, "tags": [ "Inference cloud" ] } }, "/v1/infrastructure-engineering-standards/engine": { "get": { "summary": "Infrastructure Engineering Standards engine", "operationId": "getInfrastructureEngineeringStandardsEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Infrastructure engineering standards" ] } }, "/v1/infrastructure-engineering-standards/execute": { "get": { "summary": "Execute via Infrastructure Engineering Standards", "operationId": "executeInfrastructureEngineeringStandards", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Infrastructure engineering standards" ] } }, "/v1/infrastructure-engineering-standards/monitoring": { "get": { "summary": "Infrastructure Engineering Standards monitoring", "operationId": "getInfrastructureEngineeringStandardsMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Infrastructure engineering standards" ] } }, "/v1/infrastructure-engineering-standards/products": { "get": { "summary": "Infrastructure Engineering Standards products", "operationId": "listInfrastructureEngineeringStandardsProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Infrastructure engineering standards" ] } }, "/v1/infrastructure-engineering-standards/query": { "get": { "summary": "Query Infrastructure Engineering Standards", "operationId": "queryInfrastructureEngineeringStandards", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Infrastructure engineering standards" ] } }, "/v1/infrastructure-engineering-standards/route": { "get": { "summary": "Route via Infrastructure Engineering Standards", "operationId": "routeInfrastructureEngineeringStandards", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Infrastructure engineering standards" ] } }, "/v1/infrastructure-engineering-standards/routes": { "get": { "summary": "Infrastructure Engineering Standards routes", "operationId": "listInfrastructureEngineeringStandardsRoutes", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Infrastructure engineering standards" ] } }, "/v1/intelligence-analytics/costs": { "get": { "summary": "Estimated Intelligence Cloud costs", "operationId": "getIntelligenceAnalyticsCosts", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Estimated chat/embeddings USD" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Intelligence analytics" ] } }, "/v1/intelligence-analytics/engine": { "get": { "summary": "Intelligence Analytics catalog", "operationId": "getIntelligenceAnalyticsEngine", "responses": { "200": { "description": "Capabilities and Language/Speech/Voice separation honesty" } }, "tags": [ "Intelligence analytics" ] } }, "/v1/intelligence-analytics/latency": { "get": { "summary": "Intelligence latency proxies", "operationId": "getIntelligenceAnalyticsLatency", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "latencyMs from audits when present" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Intelligence analytics" ] } }, "/v1/intelligence-analytics/monitoring": { "get": { "summary": "Intelligence Analytics monitoring snapshot", "operationId": "getIntelligenceAnalyticsMonitoring", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Monitoring snapshot" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Intelligence analytics" ] } }, "/v1/intelligence-analytics/overview": { "get": { "summary": "Intelligence Analytics overview", "operationId": "getIntelligenceAnalyticsOverview", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Usage/surfaces/cost/quality snapshot" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Intelligence analytics" ] } }, "/v1/intelligence-analytics/quality": { "get": { "summary": "Intelligence quality/confidence proxies", "operationId": "getIntelligenceAnalyticsQuality", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Prompt eval scores and decision confidence" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Intelligence analytics" ] } }, "/v1/intelligence-analytics/report": { "get": { "summary": "Bundled Intelligence Analytics report", "operationId": "getIntelligenceAnalyticsReport", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Full JSON report" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Intelligence analytics" ] } }, "/v1/intelligence-analytics/routing": { "get": { "summary": "Model/routing decision aggregates", "operationId": "getIntelligenceAnalyticsRouting", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Decision Engine kind/decision counts" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Intelligence analytics" ] } }, "/v1/intelligence-analytics/surfaces": { "get": { "summary": "Intelligence Cloud surface activity", "operationId": "getIntelligenceAnalyticsSurfaces", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Per-surface audit counts" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Intelligence analytics" ] } }, "/v1/intelligence-analytics/usage": { "get": { "summary": "Intelligence chat/embeddings usage", "operationId": "getIntelligenceAnalyticsUsage", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Chat and embeddings usage_events aggregates" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Intelligence analytics" ] } }, "/v1/intelligence-cloud/overview": { "get": { "summary": "Intelligence Cloud org overview", "operationId": "getIntelligenceOverview", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Session chat/embeddings usage, products, deferred flags, and console links" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Intelligence cloud" ] } }, "/v1/intelligence-cloud/products": { "get": { "summary": "Intelligence Cloud product catalog", "operationId": "listIntelligenceProducts", "responses": { "200": { "description": "Intelligence products and architecture honesty notes" } }, "tags": [ "Intelligence cloud" ] } }, "/v1/intelligent-cache/analytics": { "get": { "summary": "Intelligent Cache analytics", "operationId": "getIntelligentCacheAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Hit/entry aggregates" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Intelligent cache" ] } }, "/v1/intelligent-cache/ceilings": { "get": { "summary": "Cache entry/TTL ceilings", "operationId": "getIntelligentCacheCeilings", "responses": { "200": { "description": "maxEntriesPerWorkspace + defaultTtlSec" } }, "tags": [ "Intelligent cache" ] } }, "/v1/intelligent-cache/engine": { "get": { "summary": "Intelligent Cache catalog", "operationId": "getIntelligentCacheEngine", "responses": { "200": { "description": "Namespaces, ceilings, and honesty flags" } }, "tags": [ "Intelligent cache" ] } }, "/v1/intelligent-cache/entries": { "get": { "summary": "List active cache entries", "operationId": "listIntelligentCacheEntries", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Org/workspace entries (values omitted)" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Intelligent cache" ] } }, "/v1/intelligent-cache/invalidate": { "post": { "summary": "Invalidate cache entries", "operationId": "invalidateIntelligentCache", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Deleted count" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Intelligent cache" ] } }, "/v1/intelligent-cache/lookup": { "post": { "summary": "Lookup cache entry (exact key / normalized hash)", "operationId": "lookupIntelligentCacheEntry", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Hit or miss" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Intelligent cache" ] } }, "/v1/intelligent-cache/monitoring": { "get": { "summary": "Intelligent Cache monitoring", "operationId": "getIntelligentCacheMonitoring", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Monitoring + honesty snapshot" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Intelligent cache" ] } }, "/v1/intelligent-cache/namespaces": { "get": { "summary": "Cache namespaces", "operationId": "listIntelligentCacheNamespaces", "responses": { "200": { "description": "Semantic/translation/embedding/speech/voice/document/prompt/context" } }, "tags": [ "Intelligent cache" ] } }, "/v1/intelligent-cache/put": { "post": { "summary": "Put cache entry", "operationId": "putIntelligentCacheEntry", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Entry stored" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Hard entry ceiling exceeded" } }, "tags": [ "Intelligent cache" ] } }, "/v1/internal-developer-portal/engine": { "get": { "summary": "Internal Developer Portal engine", "operationId": "getInternalDeveloperPortalEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Internal developer portal" ] } }, "/v1/internal-developer-portal/monitoring": { "get": { "summary": "Internal Developer Portal monitoring", "operationId": "getInternalDeveloperPortalMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Internal developer portal" ] } }, "/v1/internal-developer-portal/portal": { "get": { "summary": "List Internal Developer Portal rows", "operationId": "listInternalDeveloperPortalRows", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Internal developer portal" ] } }, "/v1/internal-developer-portal/products": { "get": { "summary": "Internal Developer Portal products", "operationId": "listInternalDeveloperPortalProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Internal developer portal" ] } }, "/v1/internal-developer-portal/query": { "get": { "summary": "Query Internal Developer Portal", "operationId": "queryInternalDeveloperPortal", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Internal developer portal" ] } }, "/v1/interpret": { "post": { "summary": "Live interpreter (STT → MT → TTS)", "operationId": "interpretAudio", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "required": [ "file", "target", "voice" ], "properties": { "file": { "type": "string", "format": "binary" }, "target": { "type": "string", "description": "Target language code" }, "source": { "type": "string", "description": "Source language or \"auto\" (default: STT language / auto)" }, "language": { "type": "string", "description": "Optional STT language hint" }, "voice": { "type": "string", "example": "own:ak-gh-fante-female", "description": "First-party own:* voice. Akan: own:ak-gh-fante-female (Fante/Mfantse), own:ak-gh-female (Asante). Hausa product default: own:ha-gh-male (Ghanaian Zongo)." }, "format": { "type": "string", "enum": [ "mp3", "wav", "opus", "aac", "flac" ] } } } } } }, "responses": { "200": { "description": "Transcript, translation, and synthesized audio", "content": { "application/json": { "schema": { "type": "object", "properties": { "sourceText": { "type": "string" }, "targetText": { "type": "string" }, "source": { "type": "string" }, "target": { "type": "string" }, "durationSeconds": { "type": "number" }, "durationMinutes": { "type": "number" }, "voice": { "type": "string" }, "format": { "type": "string" }, "mimeType": { "type": "string" }, "audioBase64": { "type": "string" }, "skippedMt": { "type": "boolean" }, "providers": { "type": "object", "properties": { "stt": { "type": "string" }, "mt": { "type": "string", "nullable": true }, "tts": { "type": "string" } } } } } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Provider not configured", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Interpret" ] } }, "/v1/jobs": { "get": { "summary": "List recent jobs", "operationId": "listJobs", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "limit", "in": "query", "schema": { "type": "integer", "default": 50, "maximum": 100 } } ], "responses": { "200": { "description": "Jobs for the API key organization", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Job" } } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Jobs" ] }, "post": { "summary": "Create an async job (batch_translate, document_translate, or workflow)", "operationId": "createJob", "security": [ { "ApiKeyAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "type", "input" ], "properties": { "type": { "type": "string", "enum": [ "batch_translate", "document_translate", "workflow" ] }, "input": { "type": "object", "description": "batch_translate: source/target/items; document_translate: documentId/source/target; workflow: steps[] (transcribe|translate|notify) or workflowId" }, "webhookUrl": { "type": "string", "description": "Optional HTTPS endpoint for signed job.succeeded / job.failed events" } } } } } }, "responses": { "201": { "description": "Job queued", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Job" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Jobs" ] } }, "/v1/jobs/{id}": { "get": { "summary": "Get job status and result", "operationId": "getJob", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Job", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Job" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Jobs" ] } }, "/v1/knowledge-analytics/confidence": { "get": { "summary": "Knowledge confidence averages", "operationId": "getKnowledgeAnalyticsConfidence", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Heuristic confidence bands" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge analytics" ] } }, "/v1/knowledge-analytics/engine": { "get": { "summary": "Knowledge Analytics catalog", "operationId": "getKnowledgeAnalyticsEngine", "responses": { "200": { "description": "Capabilities and Language/Speech/Voice/Intelligence separation honesty" } }, "tags": [ "Knowledge analytics" ] } }, "/v1/knowledge-analytics/gaps": { "get": { "summary": "Knowledge gap heuristics", "operationId": "getKnowledgeAnalyticsGaps", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Unchunked/failed/unassigned gaps" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge analytics" ] } }, "/v1/knowledge-analytics/growth": { "get": { "summary": "Knowledge growth metrics", "operationId": "getKnowledgeAnalyticsGrowth", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Document/chunk growth" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge analytics" ] } }, "/v1/knowledge-analytics/monitoring": { "get": { "summary": "Knowledge Analytics monitoring snapshot", "operationId": "getKnowledgeAnalyticsMonitoring", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Monitoring snapshot" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge analytics" ] } }, "/v1/knowledge-analytics/overview": { "get": { "summary": "Knowledge Analytics overview", "operationId": "getKnowledgeAnalyticsOverview", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Growth/usage/quality/search/gaps snapshot" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge analytics" ] } }, "/v1/knowledge-analytics/quality": { "get": { "summary": "Knowledge quality proxies", "operationId": "getKnowledgeAnalyticsQuality", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Ready/failed/chunk coverage" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge analytics" ] } }, "/v1/knowledge-analytics/relationships": { "get": { "summary": "Knowledge relationship counts", "operationId": "getKnowledgeAnalyticsRelationships", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "KG/taxonomy/ontology counts" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge analytics" ] } }, "/v1/knowledge-analytics/report": { "get": { "summary": "Bundled Knowledge Analytics report", "operationId": "getKnowledgeAnalyticsReport", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Full JSON report" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge analytics" ] } }, "/v1/knowledge-analytics/search": { "get": { "summary": "Search success metrics", "operationId": "getKnowledgeAnalyticsSearch", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Enterprise search hit rates" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge analytics" ] } }, "/v1/knowledge-analytics/usage": { "get": { "summary": "Knowledge Cloud surface usage", "operationId": "getKnowledgeAnalyticsUsage", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Per-surface audit counts" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge analytics" ] } }, "/v1/knowledge-apis/analytics": { "get": { "summary": "Knowledge APIs pack analytics", "operationId": "getKnowledgeApisAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Pack analytics" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge APIs" ] } }, "/v1/knowledge-apis/cli": { "get": { "summary": "Knowledge CLI command catalog", "operationId": "getKnowledgeApisCli", "responses": { "200": { "description": "CLI commands" } }, "tags": [ "Knowledge APIs" ] } }, "/v1/knowledge-apis/developer-portal": { "get": { "operationId": "knowledgeApisDeveloperPortal", "summary": "Developer portal", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } } }, "tags": [ "Knowledge APIs" ] } }, "/v1/knowledge-apis/engine": { "get": { "summary": "Enterprise Knowledge APIs pack catalog", "operationId": "getKnowledgeApisEngine", "responses": { "200": { "description": "API pack capabilities and honesty flags" } }, "tags": [ "Knowledge APIs" ] } }, "/v1/knowledge-apis/events": { "get": { "operationId": "knowledgeApisEvents", "summary": "Events", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge APIs" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/knowledge-apis/events/stream": { "get": { "summary": "SSE knowledge audit event tail", "operationId": "streamKnowledgeApisEvents", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "text/event-stream" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge APIs" ] } }, "/v1/knowledge-apis/graphql": { "get": { "summary": "Knowledge Cloud GraphQL query catalog", "operationId": "listKnowledgeApisGraphql", "responses": { "200": { "description": "GraphQL engine queries" } }, "tags": [ "Knowledge APIs" ] } }, "/v1/knowledge-apis/monitoring": { "get": { "summary": "Knowledge APIs pack monitoring", "operationId": "getKnowledgeApisMonitoring", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Honesty + deferred flags" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge APIs" ] } }, "/v1/knowledge-apis/openapi": { "get": { "summary": "Knowledge OpenAPI path index", "operationId": "getKnowledgeApisOpenapi", "responses": { "200": { "description": "OpenAPI pointer + knowledge paths" } }, "tags": [ "Knowledge APIs" ] } }, "/v1/knowledge-apis/sdk": { "get": { "summary": "Knowledge SDK method catalog", "operationId": "getKnowledgeApisSdk", "responses": { "200": { "description": "SDK install + methods" } }, "tags": [ "Knowledge APIs" ] } }, "/v1/knowledge-apis/surfaces": { "get": { "summary": "Knowledge Cloud REST/GraphQL surfaces", "operationId": "listKnowledgeApisSurfaces", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Surface catalog" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge APIs" ] } }, "/v1/knowledge-apis/webhooks": { "get": { "summary": "Knowledge webhook event catalog", "operationId": "getKnowledgeApisWebhooks", "responses": { "200": { "description": "Webhook events + signing" } }, "tags": [ "Knowledge APIs" ] } }, "/v1/knowledge-base/analytics": { "get": { "summary": "Knowledge Base analytics", "operationId": "getKnowledgeBaseAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Workspace document/chunk counts" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge base" ] } }, "/v1/knowledge-base/collections": { "get": { "summary": "Workspace knowledge collections", "operationId": "listKnowledgeBaseCollections", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Collections for the authenticated workspace" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge base" ] } }, "/v1/knowledge-base/content-kinds": { "get": { "summary": "Knowledge Base content kinds", "operationId": "listKnowledgeBaseContentKinds", "responses": { "200": { "description": "Shipped and deferred content kinds" } }, "tags": [ "Knowledge base" ] } }, "/v1/knowledge-base/documents": { "get": { "summary": "List Knowledge Base documents (workspace-scoped)", "operationId": "listKnowledgeBaseDocuments", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Documents filtered by collection/tag/contentKind" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge base" ] } }, "/v1/knowledge-base/documents/{id}": { "get": { "operationId": "knowledgeBaseGet", "summary": "Get", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge base" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/knowledge-base/documents/{id}/revise-meta": { "post": { "operationId": "knowledgeBaseReviseMeta", "summary": "Revise meta", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge base" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/knowledge-base/engine": { "get": { "summary": "Enterprise Knowledge Base engine catalog", "operationId": "getKnowledgeBaseEngine", "responses": { "200": { "description": "EKB capabilities and honesty flags" } }, "tags": [ "Knowledge base" ] } }, "/v1/knowledge-base/monitoring": { "get": { "summary": "Knowledge Base monitoring", "operationId": "getKnowledgeBaseMonitoring", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Analytics + honesty + deferred capability ids" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge base" ] } }, "/v1/knowledge-cloud/overview": { "get": { "summary": "Knowledge Cloud org overview", "operationId": "getKnowledgeOverview", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Session knowledge doc/chunk counts, products, deferred flags, and console links" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge cloud" ] } }, "/v1/knowledge-cloud/products": { "get": { "summary": "Knowledge Cloud product catalog", "operationId": "listKnowledgeProducts", "responses": { "200": { "description": "Knowledge products and architecture honesty notes" } }, "tags": [ "Knowledge cloud" ] } }, "/v1/knowledge-fabric/distribute": { "post": { "summary": "Plan knowledge distribution to same-org workspaces", "operationId": "distributeKnowledgeFabric", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Distribution plan + optional Event Fabric event" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge fabric" ] } }, "/v1/knowledge-fabric/engine": { "get": { "summary": "Knowledge Fabric engine (alias of products)", "operationId": "getKnowledgeFabricEngine", "responses": { "200": { "description": "Catalog + honesty" } }, "tags": [ "Knowledge fabric" ] } }, "/v1/knowledge-fabric/federate": { "post": { "summary": "List knowledge federation handoff targets", "operationId": "federateKnowledgeFabric", "responses": { "200": { "description": "Federation handoff catalog" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge fabric" ] } }, "/v1/knowledge-fabric/monitoring": { "get": { "summary": "Knowledge Fabric monitoring", "operationId": "getKnowledgeFabricMonitoring", "responses": { "200": { "description": "Counters + recent plans + honesty" } }, "tags": [ "Knowledge fabric" ] } }, "/v1/knowledge-fabric/overview": { "get": { "summary": "Knowledge Fabric org overview", "operationId": "getKnowledgeFabricOverview", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Session + routes + peer workspaces" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge fabric" ] } }, "/v1/knowledge-fabric/products": { "get": { "summary": "Knowledge Fabric capability catalog", "operationId": "listKnowledgeFabricProducts", "responses": { "200": { "description": "Knowledge router capabilities, routes, Knowledge Cloud handoff honesty" } }, "tags": [ "Knowledge fabric" ] } }, "/v1/knowledge-fabric/route": { "post": { "summary": "Plan knowledge routing for selected kinds", "operationId": "planKnowledgeFabricRoute", "responses": { "200": { "description": "Router plan" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge fabric" ] } }, "/v1/knowledge-fabric/routes": { "get": { "summary": "Knowledge Fabric routing table", "operationId": "listKnowledgeFabricRoutes", "responses": { "200": { "description": "kind → Knowledge Cloud/Search/RAG handoffs" } }, "tags": [ "Knowledge fabric" ] } }, "/v1/knowledge-fabric/sync": { "post": { "summary": "Plan knowledge sync between same-org workspaces", "operationId": "syncKnowledgeFabric", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Sync cursor/plan + optional Event Fabric event" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge fabric" ] } }, "/v1/knowledge-graph/analytics": { "get": { "summary": "Knowledge Graph analytics", "operationId": "getKnowledgeGraphAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Entity/edge counts" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge graph" ] } }, "/v1/knowledge-graph/domains": { "get": { "summary": "Knowledge Graph domains", "operationId": "listKnowledgeGraphDomains", "responses": { "200": { "description": "General shipped; vertical packs deferred" } }, "tags": [ "Knowledge graph" ] } }, "/v1/knowledge-graph/engine": { "get": { "summary": "Knowledge Graph engine catalog", "operationId": "getKnowledgeGraphEngine", "responses": { "200": { "description": "Capabilities and Neo4j/ontology honesty notes" } }, "tags": [ "Knowledge graph" ] } }, "/v1/knowledge-graph/entities": { "get": { "summary": "List graph entities", "operationId": "listKnowledgeGraphEntities", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Entity list" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge graph" ] }, "post": { "summary": "Create graph entity", "operationId": "createKnowledgeGraphEntity", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Created entity" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge graph" ] } }, "/v1/knowledge-graph/entities/{id}": { "delete": { "operationId": "knowledgeGraphDeleteEntity", "summary": "Delete entity", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge graph" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] }, "get": { "operationId": "knowledgeGraphGetEntity", "summary": "Get entity", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge graph" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/knowledge-graph/entities/{id}/neighborhood": { "get": { "operationId": "knowledgeGraphNeighborhood", "summary": "Neighborhood", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge graph" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/knowledge-graph/monitoring": { "get": { "summary": "Knowledge Graph monitoring snapshot", "operationId": "getKnowledgeGraphMonitoring", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Monitoring snapshot" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge graph" ] } }, "/v1/knowledge-graph/relationships": { "get": { "summary": "List graph relationships", "operationId": "listKnowledgeGraphRelationships", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Edge list" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge graph" ] }, "post": { "summary": "Create graph relationship", "operationId": "createKnowledgeGraphRelationship", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Created edge" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge graph" ] } }, "/v1/knowledge-intelligence/analytics": { "get": { "summary": "Knowledge Intelligence analytics", "operationId": "getKnowledgeIntelligenceAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Analytics snapshot" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge intelligence" ] } }, "/v1/knowledge-intelligence/confidence": { "post": { "summary": "Heuristic knowledge confidence scores", "operationId": "confidenceKnowledgeIntelligence", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Confidence scores" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge intelligence" ] } }, "/v1/knowledge-intelligence/discover": { "post": { "summary": "Discover docs/terms/concepts", "operationId": "discoverKnowledgeIntelligence", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Discovery hits" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge intelligence" ] } }, "/v1/knowledge-intelligence/duplicates": { "post": { "summary": "Detect duplicate knowledge documents", "operationId": "duplicatesKnowledgeIntelligence", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Duplicate pairs" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge intelligence" ] } }, "/v1/knowledge-intelligence/engine": { "get": { "summary": "Knowledge Intelligence engine catalog", "operationId": "getKnowledgeIntelligenceEngine", "responses": { "200": { "description": "Capabilities and honesty flags" } }, "tags": [ "Knowledge intelligence" ] } }, "/v1/knowledge-intelligence/evolution": { "get": { "operationId": "knowledgeIntelligenceEvolution", "summary": "Evolution", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge intelligence" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/knowledge-intelligence/insight": { "get": { "summary": "Knowledge Intelligence insight snapshot", "operationId": "getKnowledgeIntelligenceInsight", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Workspace knowledge insight" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge intelligence" ] } }, "/v1/knowledge-intelligence/link": { "post": { "summary": "Suggest related knowledge documents", "operationId": "linkKnowledgeIntelligence", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Related document links" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge intelligence" ] } }, "/v1/knowledge-intelligence/monitoring": { "get": { "summary": "Knowledge Intelligence monitoring", "operationId": "getKnowledgeIntelligenceMonitoring", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Honesty + deferred flags" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge intelligence" ] } }, "/v1/knowledge-intelligence/recommend": { "post": { "summary": "Recommend knowledge documents", "operationId": "recommendKnowledgeIntelligence", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Ranked recommendations" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge intelligence" ] } }, "/v1/knowledge-intelligence/validate": { "post": { "summary": "Validate knowledge documents", "operationId": "validateKnowledgeIntelligence", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Validation results" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge intelligence" ] } }, "/v1/knowledge-memory/analytics": { "get": { "summary": "Knowledge Memory analytics", "operationId": "getKnowledgeMemoryAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Workspace analytics" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge memory" ] } }, "/v1/knowledge-memory/engine": { "get": { "summary": "Knowledge Memory engine catalog", "operationId": "getKnowledgeMemoryEngine", "responses": { "200": { "description": "Knowledge Memory capabilities and honesty flags" } }, "tags": [ "Knowledge memory" ] } }, "/v1/knowledge-memory/memories": { "get": { "summary": "List knowledge-layer memories", "operationId": "listKnowledgeMemories", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Workspace knowledge memories" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge memory" ] }, "post": { "summary": "Create knowledge-layer memory", "operationId": "createKnowledgeMemory", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Created knowledge memory" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge memory" ] } }, "/v1/knowledge-memory/memories/{id}": { "get": { "operationId": "knowledgeMemoryGet", "summary": "Get", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge memory" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/knowledge-memory/memories/{id}/evolve": { "post": { "operationId": "knowledgeMemoryEvolve", "summary": "Evolve", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge memory" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/knowledge-memory/memories/{id}/versions": { "get": { "operationId": "knowledgeMemoryVersions", "summary": "Versions", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge memory" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/knowledge-memory/monitoring": { "get": { "summary": "Knowledge Memory monitoring", "operationId": "getKnowledgeMemoryMonitoring", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Honesty + deferred flags" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge memory" ] } }, "/v1/knowledge-memory/scopes": { "get": { "summary": "Knowledge Memory scopes", "operationId": "listKnowledgeMemoryScopes", "responses": { "200": { "description": "Scope map onto Memory Cloud" } }, "tags": [ "Knowledge memory" ] } }, "/v1/knowledge-memory/search": { "post": { "summary": "Search knowledge-layer memories", "operationId": "searchKnowledgeMemory", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Matching knowledge memories" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge memory" ] } }, "/v1/knowledge-operating-system/engine": { "get": { "summary": "Knowledge Operating System engine", "operationId": "getKnowledgeOperatingSystemEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Knowledge operating system" ] } }, "/v1/knowledge-operating-system/execute": { "get": { "summary": "Execute via Knowledge Operating System", "operationId": "executeKnowledgeOperatingSystem", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge operating system" ] } }, "/v1/knowledge-operating-system/monitoring": { "get": { "summary": "Knowledge Operating System monitoring", "operationId": "getKnowledgeOperatingSystemMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Knowledge operating system" ] } }, "/v1/knowledge-operating-system/products": { "get": { "summary": "Knowledge Operating System products", "operationId": "listKnowledgeOperatingSystemProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Knowledge operating system" ] } }, "/v1/knowledge-operating-system/query": { "get": { "summary": "Query Knowledge Operating System", "operationId": "queryKnowledgeOperatingSystem", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge operating system" ] } }, "/v1/knowledge-operating-system/route": { "get": { "summary": "Route via Knowledge Operating System", "operationId": "routeKnowledgeOperatingSystem", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge operating system" ] } }, "/v1/knowledge-operating-system/routes": { "get": { "summary": "Knowledge Operating System routes", "operationId": "listKnowledgeOperatingSystemRoutes", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge operating system" ] } }, "/v1/knowledge-runtime/engine": { "get": { "summary": "Knowledge Runtime engine", "operationId": "getKnowledgeRuntimeEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Knowledge runtime" ] } }, "/v1/knowledge-runtime/execute": { "get": { "summary": "Execute via Knowledge Runtime", "operationId": "executeKnowledgeRuntime", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge runtime" ] } }, "/v1/knowledge-runtime/monitoring": { "get": { "summary": "Knowledge Runtime monitoring", "operationId": "getKnowledgeRuntimeMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Knowledge runtime" ] } }, "/v1/knowledge-runtime/products": { "get": { "summary": "Knowledge Runtime products", "operationId": "listKnowledgeRuntimeProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Knowledge runtime" ] } }, "/v1/knowledge-runtime/query": { "get": { "summary": "Query Knowledge Runtime", "operationId": "queryKnowledgeRuntime", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge runtime" ] } }, "/v1/knowledge-runtime/route": { "get": { "summary": "Route via Knowledge Runtime", "operationId": "routeKnowledgeRuntime", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge runtime" ] } }, "/v1/knowledge-runtime/routes": { "get": { "summary": "Knowledge Runtime routes", "operationId": "listKnowledgeRuntimeRoutes", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge runtime" ] } }, "/v1/knowledge/documents": { "get": { "summary": "List knowledge documents", "operationId": "listKnowledgeDocuments", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Workspace knowledge documents" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge" ] }, "post": { "summary": "Upload and embed a knowledge document", "operationId": "uploadKnowledgeDocument", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "required": [ "file" ], "properties": { "file": { "type": "string", "format": "binary" } } } } } }, "responses": { "201": { "description": "Document ingested (status ready or failed)" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Embeddings provider not configured", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge" ] } }, "/v1/knowledge/documents/{id}": { "get": { "summary": "Get knowledge document", "operationId": "getKnowledgeDocument", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Document" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found" } }, "tags": [ "Knowledge" ] }, "delete": { "summary": "Delete knowledge document", "operationId": "deleteKnowledgeDocument", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Deleted" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found" } }, "tags": [ "Knowledge" ] } }, "/v1/knowledge/query": { "post": { "summary": "Query knowledge base (RAG)", "operationId": "queryKnowledge", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "question" ], "properties": { "question": { "type": "string" }, "k": { "type": "integer", "minimum": 1, "maximum": 10 } } } } } }, "responses": { "200": { "description": "Answer with citations", "content": { "application/json": { "schema": { "type": "object", "properties": { "answer": { "type": "string" }, "citations": { "type": "array", "items": { "type": "object", "properties": { "index": { "type": "integer" }, "documentId": { "type": "string" }, "chunkId": { "type": "string" }, "filename": { "type": "string" }, "snippet": { "type": "string" }, "score": { "type": "number" } } } }, "model": { "type": "string", "nullable": true }, "provider": { "type": "string", "nullable": true } } } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Knowledge" ] } }, "/v1/language-assurance/catalog": { "get": { "operationId": "languageAssuranceCatalog", "summary": "Catalog", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Language assurance" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/language-assurance/integrations/voice-studio": { "post": { "operationId": "languageAssuranceVoiceStudio", "summary": "Voice studio", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Language assurance" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/language-assurance/policies": { "post": { "operationId": "languageAssuranceCreatePolicy", "summary": "Create policy", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Language assurance" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/language-assurance/reviews/{assignmentId}/submit": { "post": { "operationId": "languageAssuranceSubmitReview", "summary": "Submit review", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Language assurance" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "assignmentId", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/language-assurance/reviews/queue": { "get": { "operationId": "languageAssuranceReviewQueue", "summary": "Review queue", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Language assurance" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/language-assurance/runs": { "get": { "operationId": "languageAssuranceList", "summary": "List", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Language assurance" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] }, "post": { "operationId": "languageAssuranceCreateRun", "summary": "Create run", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Language assurance" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/language-assurance/runs/{id}": { "get": { "operationId": "languageAssuranceGetRun", "summary": "Get run", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Language assurance" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/language-assurance/runs/{id}/assignments": { "post": { "operationId": "languageAssuranceAssign", "summary": "Assign", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Language assurance" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/language-assurance/runs/{id}/cancel": { "post": { "operationId": "languageAssuranceCancel", "summary": "Cancel", "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Language assurance" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/language-assurance/runs/{id}/release-evidence": { "post": { "operationId": "languageAssuranceRelease", "summary": "Release", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Language assurance" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/language-assurance/runs/{id}/report": { "get": { "operationId": "languageAssuranceReport", "summary": "Report", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "format", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Language assurance" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/language-integrity/engine": { "get": { "summary": "Language Integrity engine catalog", "operationId": "getLanguageIntegrityEngine", "responses": { "200": { "description": "Provenance, watermark, consent, audit, translation review catalog — not deepfake certification" } }, "tags": [ "Language integrity" ] } }, "/v1/language-integrity/protocol": { "get": { "summary": "Government Language Integrity adoption protocol", "operationId": "getLanguageIntegrityProtocol", "responses": { "200": { "description": "Requirements for attested synthetic media and human-reviewed official translations" } }, "tags": [ "Language integrity" ] } }, "/v1/language-integrity/verify": { "post": { "summary": "Verify Lugemi provenance claim (metadata)", "operationId": "verifyLanguageIntegrityClaim", "responses": { "200": { "description": "Verdict + findings for watermark/consent claims. Not universal deepfake detection." }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Language integrity" ] } }, "/v1/language-integrity/verify/workspace": { "post": { "summary": "Verify claim against workspace clone library", "operationId": "verifyLanguageIntegrityWorkspace", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Workspace-bound provenance verify including clone lookup" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Language integrity" ] } }, "/v1/language-intelligence": { "get": { "summary": "Language Intelligence catalog", "operationId": "getLanguageIntelligence", "responses": { "200": { "description": "Language Intelligence capabilities and honesty notes" } }, "tags": [ "Language intelligence" ] } }, "/v1/language-intelligence/analytics": { "get": { "operationId": "languageIntelligenceAnalytics", "summary": "Analytics", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Language intelligence" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/language-intelligence/analyze": { "post": { "summary": "Unified language intelligence analyze", "operationId": "analyzeLanguageIntelligence", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Detect + heuristic signals" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Language intelligence" ] } }, "/v1/language-intelligence/analyze/stream": { "post": { "operationId": "languageIntelligenceAnalyzeStream", "summary": "Analyze stream", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success. The body is written directly by the handler (for example audio bytes or a file download).", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Language intelligence" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/language-intelligence/complexity": { "post": { "operationId": "languageIntelligenceComplexity", "summary": "Complexity", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Language intelligence" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/language-intelligence/emotion": { "post": { "operationId": "languageIntelligenceEmotion", "summary": "Emotion", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Language intelligence" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/language-intelligence/engine": { "get": { "summary": "Language Intelligence engine catalog (alias)", "operationId": "getLanguageIntelligenceEngine", "responses": { "200": { "description": "Same catalog as GET /v1/language-intelligence" } }, "tags": [ "Language intelligence" ] } }, "/v1/language-intelligence/intent": { "post": { "operationId": "languageIntelligenceIntent", "summary": "Intent", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Language intelligence" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/language-intelligence/readability": { "post": { "operationId": "languageIntelligenceReadability", "summary": "Readability", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Language intelligence" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/language-intelligence/sentiment": { "post": { "operationId": "languageIntelligenceSentiment", "summary": "Sentiment", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Language intelligence" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/language-intelligence/speech-confidence": { "post": { "operationId": "languageIntelligenceSpeechConfidence", "summary": "Speech confidence", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Language intelligence" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/language-intelligence/translation-confidence": { "post": { "operationId": "languageIntelligenceTranslationConfidence", "summary": "Translation confidence", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Language intelligence" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/language-kits": { "get": { "summary": "List language kits", "operationId": "listLanguageKits", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Kits" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Language kits" ] }, "post": { "summary": "Create draft language kit", "operationId": "createLanguageKit", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Draft kit" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Language kits" ] } }, "/v1/language-kits/{id}": { "get": { "operationId": "languageKitsGet", "summary": "Get", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Language kits" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/language-kits/{id}/advance": { "post": { "operationId": "languageKitsAdvance", "summary": "Advance", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Language kits" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/language-kits/{id}/coverage": { "get": { "summary": "Language kit task coverage", "operationId": "getLanguageKitCoverage", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "ASR/translation/synthesis statuses" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Language kits" ] } }, "/v1/language-kits/engine": { "get": { "summary": "Lugemi Language Kit engine", "operationId": "getLanguageKitsEngine", "responses": { "200": { "description": "Language Kit catalog" } }, "tags": [ "Language kits" ] } }, "/v1/language-kits/languages": { "get": { "operationId": "languageKitsLanguages", "summary": "Languages", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Language kits" ] } }, "/v1/language/engine": { "get": { "summary": "Language Cloud hub engine catalog", "operationId": "getLanguageCloudEngine", "responses": { "200": { "description": "Language Cloud product map and honesty notes" } }, "tags": [ "Language" ] } }, "/v1/language/overview": { "get": { "summary": "Language Cloud workspace overview", "operationId": "getLanguageOverview", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Workspace language overview" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Language" ] } }, "/v1/language/products": { "get": { "summary": "Language Cloud product catalog", "operationId": "listLanguageProducts", "responses": { "200": { "description": "Language Cloud products" } }, "tags": [ "Language" ] } }, "/v1/languages": { "get": { "summary": "List languages", "operationId": "listLanguages", "responses": { "200": { "description": "Language registry", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Language" } } } } } } } }, "tags": [ "Languages" ] } }, "/v1/languages/{code}": { "get": { "summary": "Get language with family, dialects, accents, and linguistic rules", "operationId": "getLanguage", "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Language detail" }, "404": { "description": "Not in registry" } }, "tags": [ "Languages" ] } }, "/v1/languages/engine": { "get": { "summary": "Language Engine catalog", "operationId": "getLanguageEngine", "responses": { "200": { "description": "Language registry capabilities and honesty notes" } }, "tags": [ "Languages" ] } }, "/v1/learnback/artifacts/{id}/audio": { "get": { "operationId": "learnBackGetAudio", "summary": "Get audio", "responses": { "200": { "description": "Success. The body is written directly by the handler (for example audio bytes or a file download).", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Learnback" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/learnback/attempts/{id}/feedback": { "get": { "operationId": "learnBackFeedback", "summary": "Feedback", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Learnback" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/learnback/attempts/{id}/transcript-revisions": { "post": { "operationId": "learnBackCorrectTranscript", "summary": "Correct transcript", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Learnback" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/learnback/audio": { "post": { "operationId": "learnBackAudio", "summary": "Audio", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Learnback" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/learnback/catalog": { "get": { "operationId": "learnBackCatalog", "summary": "Catalog", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Learnback" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/learnback/phrasebook": { "get": { "operationId": "learnBackPhrasebook", "summary": "Phrasebook", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Learnback" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] }, "post": { "operationId": "learnBackSavePhrase", "summary": "Save phrase", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Learnback" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/learnback/phrasebook/{id}": { "delete": { "operationId": "learnBackDeletePhrase", "summary": "Delete phrase", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Learnback" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] }, "patch": { "operationId": "learnBackUpdatePhrase", "summary": "Update phrase", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Learnback" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/learnback/profile": { "get": { "operationId": "learnBackProfile", "summary": "Profile", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Learnback" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] }, "patch": { "operationId": "learnBackUpdateProfile", "summary": "Update profile", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Learnback" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/learnback/progress": { "get": { "operationId": "learnBackProgress", "summary": "Progress", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Learnback" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/learnback/reminder-preferences": { "patch": { "operationId": "learnBackReminders", "summary": "Reminders", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Learnback" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/learnback/scenarios": { "get": { "operationId": "learnBackScenarios", "summary": "Scenarios", "parameters": [ { "name": "corridorId", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "situation", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Learnback" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/learnback/sessions": { "get": { "operationId": "learnBackListSessions", "summary": "List sessions", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Learnback" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] }, "post": { "operationId": "learnBackCreateSession", "summary": "Create session", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Learnback" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/learnback/sessions/{id}": { "delete": { "operationId": "learnBackDeleteSession", "summary": "Delete session", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Learnback" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] }, "get": { "operationId": "learnBackGetSession", "summary": "Get session", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Learnback" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/learnback/sessions/{id}/attempts": { "post": { "operationId": "learnBackCreateAttempt", "summary": "Create attempt", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Learnback" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/live/engine": { "get": { "summary": "Lugemi Live engine", "operationId": "getLiveEngine", "responses": { "200": { "description": "Live catalog" } }, "tags": [ "Live" ] } }, "/v1/live/sessions": { "post": { "summary": "Create live interpretation session", "operationId": "createLiveSession", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Session negotiated" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Live" ] } }, "/v1/live/sessions/{id}": { "get": { "operationId": "liveGet", "summary": "Get", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Live" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/live/sessions/{id}/ack": { "post": { "summary": "Acknowledge live event for exactly-once resume", "operationId": "liveSessionAck", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Ack recorded" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Live" ] } }, "/v1/live/sessions/{id}/audio": { "post": { "summary": "Ingest live audio chunk or text hint", "operationId": "liveSessionAudio", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Provisional/committed events" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Live" ] } }, "/v1/live/sessions/{id}/events": { "get": { "summary": "SSE event stream for live session", "operationId": "liveSessionEvents", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "text/event-stream" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Live" ] } }, "/v1/live/sessions/{id}/repair": { "post": { "summary": "Emit audible repair for a spoken segment", "operationId": "liveSessionRepair", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Repair events" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Live" ] } }, "/v1/locales": { "get": { "summary": "List locale / cultural packs", "operationId": "listLocales", "responses": { "200": { "description": "Seeded packs (date/number/currency notes, honorifics, do-not-translate)" } }, "tags": [ "Locales" ] } }, "/v1/locales/{code}": { "get": { "summary": "Get locale pack for a language code", "operationId": "getLocale", "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Locale pack" }, "404": { "description": "No pack for code" } }, "tags": [ "Locales" ] } }, "/v1/locales/{code}/examples": { "get": { "summary": "Intl date/number/currency examples for a locale pack", "operationId": "getLocaleExamples", "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Formatted samples" }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Locales" ] } }, "/v1/locales/{code}/layout": { "get": { "operationId": "localesLayout", "summary": "Layout", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Locales" ], "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/locales/engine": { "get": { "summary": "Locale Engine catalog", "operationId": "getLocaleEngine", "responses": { "200": { "description": "Locale pack capabilities and honesty notes" } }, "tags": [ "Locales" ] } }, "/v1/locales/format": { "post": { "operationId": "localesFormat", "summary": "Format", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Locales" ] } }, "/v1/localization": { "get": { "operationId": "localizeLocalizationPlatform", "summary": "Localization platform", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } } }, "tags": [ "Localization" ] } }, "/v1/localize": { "post": { "summary": "Translate a JSON/YAML i18n document", "operationId": "localizeContent", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "source", "target", "content" ], "properties": { "format": { "type": "string", "enum": [ "json", "yaml" ] }, "source": { "type": "string" }, "target": { "type": "string" }, "content": {} } } } } }, "responses": { "200": { "description": "Localized content + serialized file" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Localize" ] } }, "/v1/localize/catalog": { "post": { "operationId": "localizeCatalog", "summary": "Catalog", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Localize" ] } }, "/v1/localize/file": { "post": { "summary": "Translate an uploaded .json/.yaml file", "operationId": "localizeFile", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Localized content + serialized file" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Localize" ] } }, "/v1/localize/qa": { "post": { "operationId": "localizeQa", "summary": "Qa", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Localize" ] } }, "/v1/marketplace/connect/onboard": { "post": { "summary": "Start Stripe Connect Express onboarding", "operationId": "startMarketplaceConnectOnboarding", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Account Link URL" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Connect not configured" } }, "tags": [ "Marketplace" ] } }, "/v1/marketplace/connect/status": { "get": { "summary": "Stripe Connect payout status for the current org", "operationId": "getMarketplaceConnectStatus", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Connect status" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Marketplace" ] } }, "/v1/marketplace/installs": { "get": { "summary": "List marketplace installs for the session workspace", "operationId": "listMarketplaceInstalls", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Installs" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Marketplace" ] } }, "/v1/marketplace/listings": { "get": { "summary": "List published marketplace listings (Pro)", "operationId": "listMarketplaceListings", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "mine", "in": "query", "schema": { "type": "string", "enum": [ "1", "true" ] }, "description": "When set, return listings published by the current org" }, { "name": "kind", "in": "query", "schema": { "type": "string", "enum": [ "glossary", "prompt", "dataset" ] }, "description": "Filter by listing kind" } ], "responses": { "200": { "description": "Listings (glossary, prompt, or dataset)" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Pro plan required" } }, "tags": [ "Marketplace" ] }, "post": { "summary": "Publish a marketplace listing from the workspace (Pro, owner/admin)", "operationId": "publishMarketplaceListing", "security": [ { "ClerkAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "title" ], "properties": { "title": { "type": "string" }, "description": { "type": "string" }, "kind": { "type": "string", "enum": [ "glossary", "prompt", "dataset" ], "default": "glossary", "description": "glossary = terms; prompt = active managed prompts; dataset = approved TM pairs" }, "priceCents": { "type": "integer", "minimum": 0, "description": "0 = free; paid listings require Connect when Stripe is live" }, "currency": { "type": "string", "default": "usd" } } } } } }, "responses": { "201": { "description": "Published listing with frozen snapshot" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Pro plan required" } }, "tags": [ "Marketplace" ] } }, "/v1/marketplace/listings/{id}": { "delete": { "summary": "Unpublish a listing (publisher org only)", "operationId": "unpublishMarketplaceListing", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Unpublished" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Marketplace" ] } }, "/v1/marketplace/listings/{id}/install": { "post": { "summary": "Install a listing into the session workspace (copy-on-install)", "operationId": "installMarketplaceListing", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Install receipt, or { requiresPayment, checkoutUrl } for paid listings when Stripe is configured" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Pro plan required" }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Already installed" } }, "tags": [ "Marketplace" ] } }, "/v1/marketplace/sales": { "get": { "summary": "List marketplace sales for the current org (buyer or publisher)", "operationId": "listMarketplaceSales", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Sales with platform fee" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Marketplace" ] } }, "/v1/mcp": { "get": { "summary": "Lugemi MCP discovery", "operationId": "getMcpDiscovery", "responses": { "200": { "description": "MCP server info, tools, and install transports" } }, "tags": [ "MCP" ] }, "post": { "summary": "Lugemi MCP Streamable HTTP (JSON-RPC)", "operationId": "postMcp", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "JSON-RPC result" }, "202": { "description": "Notification ack" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "MCP" ] } }, "/v1/meetingbridge/catalog": { "get": { "operationId": "meetingBridgeCatalog", "summary": "Catalog", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Meetingbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/meetingbridge/invites/{token}": { "get": { "operationId": "meetingBridgePeekInvite", "summary": "Peek invite", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Meetingbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "token", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/meetingbridge/items/{itemId}/confirmations": { "post": { "operationId": "meetingBridgeConfirm", "summary": "Confirm", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Meetingbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "itemId", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/meetingbridge/items/{itemId}/revisions": { "post": { "operationId": "meetingBridgeReviseItem", "summary": "Revise item", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Meetingbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "itemId", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/meetingbridge/items/{itemId}/sync": { "post": { "operationId": "meetingBridgeSyncItem", "summary": "Sync item", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Meetingbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "itemId", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/meetingbridge/meetings": { "get": { "operationId": "meetingBridgeList", "summary": "List", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Meetingbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] }, "post": { "operationId": "meetingBridgeCreate", "summary": "Create", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Meetingbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/meetingbridge/meetings/{id}": { "get": { "operationId": "meetingBridgeGet", "summary": "Get", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Meetingbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/meetingbridge/meetings/{id}/close": { "post": { "operationId": "meetingBridgeClose", "summary": "Close", "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Meetingbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/meetingbridge/meetings/{id}/conferencing": { "post": { "operationId": "meetingBridgeConferencing", "summary": "Conferencing", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Meetingbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/meetingbridge/meetings/{id}/diagnostics": { "get": { "operationId": "meetingBridgeDiagnostics", "summary": "Diagnostics", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Meetingbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/meetingbridge/meetings/{id}/handoff/dealbridge": { "post": { "operationId": "meetingBridgeHandoffDeal", "summary": "Handoff deal", "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Meetingbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/meetingbridge/meetings/{id}/handoff/voicebridge": { "post": { "operationId": "meetingBridgeHandoffVoice", "summary": "Handoff voice", "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Meetingbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/meetingbridge/meetings/{id}/inbox": { "get": { "operationId": "meetingBridgeInbox", "summary": "Inbox", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Meetingbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/meetingbridge/meetings/{id}/invites": { "post": { "operationId": "meetingBridgeInvite", "summary": "Invite", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Meetingbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/meetingbridge/meetings/{id}/items": { "post": { "operationId": "meetingBridgeProposeItem", "summary": "Propose item", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Meetingbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/meetingbridge/meetings/{id}/join": { "post": { "operationId": "meetingBridgeJoin", "summary": "Join", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Meetingbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/meetingbridge/meetings/{id}/lobby": { "post": { "operationId": "meetingBridgeOpenLobby", "summary": "Open lobby", "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Meetingbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/meetingbridge/meetings/{id}/lobby/mic-check": { "post": { "operationId": "meetingBridgeMicCheck", "summary": "Mic check", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Meetingbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/meetingbridge/meetings/{id}/media/signal": { "post": { "operationId": "meetingBridgeMediaSignal", "summary": "Media signal", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Meetingbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/meetingbridge/meetings/{id}/media/signals/pull": { "post": { "operationId": "meetingBridgeMediaSignalsPull", "summary": "Media signals pull", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Meetingbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/meetingbridge/meetings/{id}/media/token": { "post": { "operationId": "meetingBridgeMediaToken", "summary": "Media token", "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Meetingbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/meetingbridge/meetings/{id}/members/me": { "patch": { "operationId": "meetingBridgePreferences", "summary": "Preferences", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Meetingbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/meetingbridge/meetings/{id}/minutes": { "post": { "operationId": "meetingBridgeMinutes", "summary": "Minutes", "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Meetingbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/meetingbridge/meetings/{id}/start": { "post": { "operationId": "meetingBridgeStart", "summary": "Start", "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Meetingbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/meetingbridge/meetings/{id}/tts": { "post": { "operationId": "meetingBridgeListenTts", "summary": "Listen TTS", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Meetingbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/meetingbridge/meetings/{id}/utterance-corrections": { "post": { "operationId": "meetingBridgeCorrect", "summary": "Correct", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Meetingbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/meetingbridge/meetings/{id}/utterances": { "post": { "operationId": "meetingBridgeUtterance", "summary": "Utterance", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Meetingbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/meetingbridge/minutes/{minutesId}/exports": { "post": { "operationId": "meetingBridgeExportMinutes", "summary": "Export minutes", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Meetingbridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "minutesId", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/meetingbridge/public/broadcast/{token}": { "get": { "operationId": "meetingBridgePublicBroadcast", "summary": "Broadcast", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Meetingbridge" ], "parameters": [ { "name": "token", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/memory-cloud/analytics": { "get": { "summary": "Memory Cloud analytics", "operationId": "getMemoryCloudAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Counts and audit aggregates" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Memory cloud" ] } }, "/v1/memory-cloud/engine": { "get": { "summary": "Memory Cloud engine catalog", "operationId": "getMemoryCloudEngine", "responses": { "200": { "description": "Memory capabilities and GDPR honesty notes" } }, "tags": [ "Memory cloud" ] } }, "/v1/memory-cloud/erase": { "post": { "summary": "GDPR erase memories", "operationId": "eraseMemoryCloud", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Erased memory count" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Memory cloud" ] } }, "/v1/memory-cloud/export": { "post": { "summary": "GDPR export memories", "operationId": "exportMemoryCloud", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Subject/workspace memory export" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Memory cloud" ] } }, "/v1/memory-cloud/memories": { "get": { "summary": "List memory records", "operationId": "listMemoryCloudMemories", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Active memories" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Memory cloud" ] }, "post": { "summary": "Create memory record", "operationId": "createMemoryCloudMemory", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Created memory" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Memory cloud" ] } }, "/v1/memory-cloud/memories/{id}": { "delete": { "operationId": "memoryCloudDeleteOne", "summary": "Delete one", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Memory cloud" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] }, "get": { "operationId": "memoryCloudGet", "summary": "Get", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Memory cloud" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/memory-cloud/memories/{id}/revise": { "post": { "operationId": "memoryCloudRevise", "summary": "Revise", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Memory cloud" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/memory-cloud/monitoring": { "get": { "summary": "Memory Cloud monitoring snapshot", "operationId": "getMemoryCloudMonitoring", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Monitoring snapshot" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Memory cloud" ] } }, "/v1/memory-cloud/scopes": { "get": { "summary": "Memory scopes and kinds", "operationId": "listMemoryCloudScopes", "responses": { "200": { "description": "Supported scopes/kinds" } }, "tags": [ "Memory cloud" ] } }, "/v1/memory-cloud/search": { "post": { "summary": "Search memories", "operationId": "searchMemoryCloud", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Text search hits" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Memory cloud" ] } }, "/v1/memory-fabric/cache": { "get": { "summary": "Memory cache handoff (Intelligent Cache)", "operationId": "getMemoryFabricCache", "responses": { "200": { "description": "Intelligent Cache discovery" } }, "tags": [ "Memory fabric" ] } }, "/v1/memory-fabric/distribute": { "post": { "summary": "Plan memory distribution to same-org workspaces", "operationId": "distributeMemoryFabric", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Distribution plan + optional Event Fabric event" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Memory fabric" ] } }, "/v1/memory-fabric/engine": { "get": { "summary": "Memory Fabric engine (alias of products)", "operationId": "getMemoryFabricEngine", "responses": { "200": { "description": "Catalog + honesty" } }, "tags": [ "Memory fabric" ] } }, "/v1/memory-fabric/federate": { "post": { "summary": "List memory federation handoff targets", "operationId": "federateMemoryFabric", "responses": { "200": { "description": "Federation handoff catalog" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Memory fabric" ] } }, "/v1/memory-fabric/memories": { "get": { "summary": "List memories via Memory Runtime", "operationId": "listMemoryFabricMemories", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Memory list" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Memory fabric" ] } }, "/v1/memory-fabric/monitoring": { "get": { "summary": "Memory Fabric monitoring", "operationId": "getMemoryFabricMonitoring", "responses": { "200": { "description": "Counters + honesty" } }, "tags": [ "Memory fabric" ] } }, "/v1/memory-fabric/overview": { "get": { "summary": "Memory Fabric org overview", "operationId": "getMemoryFabricOverview", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Session + pipelines + counters" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Memory fabric" ] } }, "/v1/memory-fabric/pipeline": { "post": { "summary": "Plan a memory pipeline (ordered Runtime handoffs)", "operationId": "planMemoryFabricPipeline", "responses": { "200": { "description": "Pipeline + routed steps" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Memory fabric" ] } }, "/v1/memory-fabric/products": { "get": { "summary": "Memory Fabric capability catalog", "operationId": "listMemoryFabricProducts", "responses": { "200": { "description": "Memory router capabilities, pipelines, Runtime handoff honesty" } }, "tags": [ "Memory fabric" ] } }, "/v1/memory-fabric/replicate": { "post": { "summary": "Plan same-org memory replication", "operationId": "replicateMemoryFabric", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Replication plan" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Memory fabric" ] } }, "/v1/memory-fabric/route": { "post": { "summary": "Plan memory routing for selected kinds", "operationId": "planMemoryFabricRoute", "responses": { "200": { "description": "Router plan" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Memory fabric" ] } }, "/v1/memory-fabric/routes": { "get": { "summary": "Memory Fabric routing table", "operationId": "listMemoryFabricRoutes", "responses": { "200": { "description": "kind → Runtime/Cloud handoffs" } }, "tags": [ "Memory fabric" ] } }, "/v1/memory-fabric/search": { "post": { "summary": "Search memories via Memory Runtime", "operationId": "searchMemoryFabric", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Search hits" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Memory fabric" ] } }, "/v1/memory-fabric/sync": { "post": { "summary": "Sandbox memory sync via Memory Runtime", "operationId": "syncMemoryFabric", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Sync stamp result" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Memory fabric" ] } }, "/v1/memory-fabric/versions": { "get": { "summary": "Memory Fabric version catalog", "operationId": "listMemoryFabricVersions", "responses": { "200": { "description": "Router/pipeline/sync versions" } }, "tags": [ "Memory fabric" ] } }, "/v1/memory-runtime/analytics": { "get": { "summary": "Memory Runtime analytics", "operationId": "getMemoryRuntimeAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Aggregates" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Memory runtime" ] } }, "/v1/memory-runtime/ceilings": { "get": { "summary": "Memory Runtime entry ceilings", "operationId": "getMemoryRuntimeCeilings", "responses": { "200": { "description": "maxEntriesPerWorkspace" } }, "tags": [ "Memory runtime" ] } }, "/v1/memory-runtime/compress": { "post": { "summary": "Heuristic compress kernel memory", "operationId": "compressMemoryRuntime", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Compressed memory" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Memory runtime" ] } }, "/v1/memory-runtime/engine": { "get": { "summary": "Memory Runtime catalog", "operationId": "getMemoryRuntimeEngine", "responses": { "200": { "description": "Kernel memory capabilities and honesty" } }, "tags": [ "Memory runtime" ] } }, "/v1/memory-runtime/evict": { "post": { "summary": "Evict kernel memories (TTL + ceiling)", "operationId": "evictMemoryRuntime", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Eviction counts" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Memory runtime" ] } }, "/v1/memory-runtime/memories": { "get": { "summary": "List kernel memories", "operationId": "listMemoryRuntimeMemories", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Kernel-layer MemoryRecords" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Memory runtime" ] } }, "/v1/memory-runtime/monitoring": { "get": { "summary": "Memory Runtime monitoring", "operationId": "getMemoryRuntimeMonitoring", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Monitoring + honesty" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Memory runtime" ] } }, "/v1/memory-runtime/put": { "post": { "summary": "Put kernel memory", "operationId": "putMemoryRuntime", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Memory stored" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Hard entry ceiling exceeded" } }, "tags": [ "Memory runtime" ] } }, "/v1/memory-runtime/revise": { "post": { "summary": "Revise kernel memory (version bump)", "operationId": "reviseMemoryRuntime", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Revised memory" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Memory runtime" ] } }, "/v1/memory-runtime/scopes": { "get": { "summary": "Memory Runtime scopes/kinds", "operationId": "listMemoryRuntimeScopes", "responses": { "200": { "description": "Kernel scopes and kinds" } }, "tags": [ "Memory runtime" ] } }, "/v1/memory-runtime/search": { "post": { "summary": "Search kernel memories", "operationId": "searchMemoryRuntime", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Text search results" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Memory runtime" ] } }, "/v1/memory-runtime/snapshots": { "get": { "summary": "List kernel memory snapshots", "operationId": "listMemoryRuntimeSnapshots", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Snapshots" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Memory runtime" ] }, "post": { "summary": "Create kernel memory snapshot", "operationId": "createMemoryRuntimeSnapshot", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Snapshot created" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Memory runtime" ] } }, "/v1/memory-runtime/sync": { "post": { "summary": "Sandbox sync stamp", "operationId": "syncMemoryRuntime", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Sync stamp applied" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Memory runtime" ] } }, "/v1/meta/engine": { "get": { "operationId": "metaEngine", "summary": "Engine", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } } }, "tags": [ "Meta" ] } }, "/v1/meta/platforms": { "get": { "operationId": "metaPlatforms", "summary": "Platforms", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } } }, "tags": [ "Meta" ] } }, "/v1/meta/platforms/{platformId}": { "get": { "operationId": "metaPlatform", "summary": "Platform", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Meta" ], "parameters": [ { "name": "platformId", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/meta/platforms/{platformId}/webhook": { "get": { "operationId": "metaDeferredWebhookGet", "summary": "Deferred webhook get", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Meta" ], "parameters": [ { "name": "platformId", "in": "path", "required": true, "schema": { "type": "string" } } ] }, "post": { "operationId": "metaDeferredWebhookPost", "summary": "Deferred webhook post", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Meta" ], "parameters": [ { "name": "platformId", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/meta/settings": { "get": { "operationId": "metaSettings", "summary": "Settings", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Meta" ], "security": [ { "ClerkAuth": [] } ] }, "patch": { "operationId": "metaUpdateSettings", "summary": "Update settings", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Meta" ], "security": [ { "ClerkAuth": [] } ] } }, "/v1/metrics/translate": { "get": { "summary": "Translate latency percentiles (in-process)", "operationId": "translateLatencyMetrics", "responses": { "200": { "description": "Rolling-window p50/p95/p99 for this API instance" } }, "tags": [ "Metrics" ] } }, "/v1/mix/engine": { "get": { "summary": "Lugemi Mix engine", "operationId": "getMixEngine", "responses": { "200": { "description": "Mix catalog" } }, "tags": [ "Mix" ] } }, "/v1/mix/transcribe-translate": { "post": { "summary": "Mixed-language transcribe and translate", "operationId": "mixTranscribeTranslate", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Spans, transcript, translation, entity alignment" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Mix" ] } }, "/v1/mlops-llmops-cloud/engine": { "get": { "summary": "MLOps & LLMOps Cloud engine (alias of products)", "operationId": "getMlopsLlmopsCloudEngine", "responses": { "200": { "description": "Engine catalog" } }, "tags": [ "MLOps LLMOps cloud" ] } }, "/v1/mlops-llmops-cloud/monitoring": { "get": { "summary": "MLOps & LLMOps Cloud monitoring snapshot", "operationId": "getMlopsLlmopsCloudMonitoring", "responses": { "200": { "description": "Monitoring snapshot" } }, "tags": [ "MLOps LLMOps cloud" ] } }, "/v1/mlops-llmops-cloud/overview": { "get": { "summary": "MLOps & LLMOps Cloud authenticated overview", "operationId": "getMlopsLlmopsCloudOverview", "responses": { "200": { "description": "Overview" }, "401": { "description": "Unauthorized" } }, "tags": [ "MLOps LLMOps cloud" ], "security": [ { "ClerkAuth": [] } ] } }, "/v1/mlops-llmops-cloud/products": { "get": { "summary": "MLOps & LLMOps Cloud product catalog", "operationId": "listMlopsLlmopsCloudProducts", "responses": { "200": { "description": "Product catalog" } }, "tags": [ "MLOps LLMOps cloud" ] } }, "/v1/mlops-llmops-cloud/routing": { "get": { "summary": "MLOps & LLMOps Cloud routing table", "operationId": "getMlopsLlmopsCloudRouting", "responses": { "200": { "description": "Routing table" } }, "tags": [ "MLOps LLMOps cloud" ] } }, "/v1/model-evaluation-platform/engine": { "get": { "summary": "Model Evaluation Platform engine catalog", "operationId": "getModelEvaluationPlatformEngine", "responses": { "200": { "description": "Eval suites, ceilings, coverage link, honesty (no global leaderboard/SOTA)" } }, "tags": [ "Model evaluation platform" ] } }, "/v1/model-evaluation-platform/leaderboard": { "get": { "summary": "Org-scoped evaluation leaderboard", "operationId": "getModelEvaluationLeaderboard", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Local ranks only — not public SOTA board" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model evaluation platform" ] } }, "/v1/model-evaluation-platform/monitoring": { "get": { "summary": "Model Evaluation Platform monitoring", "operationId": "getModelEvaluationPlatformMonitoring", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Run status snapshot + honesty" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model evaluation platform" ] } }, "/v1/model-evaluation-platform/overview": { "get": { "summary": "Model Evaluation Platform org overview", "operationId": "getModelEvaluationPlatformOverview", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Session usage, runs, deferred suites" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model evaluation platform" ] } }, "/v1/model-evaluation-platform/reports": { "get": { "summary": "Evaluation reports aggregate", "operationId": "getModelEvaluationReports", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Run aggregates + coverage snapshot" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model evaluation platform" ] } }, "/v1/model-evaluation-platform/runs": { "get": { "summary": "List evaluation runs", "operationId": "listModelEvaluationRuns", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Org-scoped sandbox/handoff runs" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model evaluation platform" ] }, "post": { "summary": "Create evaluation run", "operationId": "createModelEvaluationRun", "security": [ { "ClerkAuth": [] } ], "responses": { "201": { "description": "Run created (and executed unless execute=false)" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model evaluation platform" ] } }, "/v1/model-evaluation-platform/runs/{id}": { "get": { "operationId": "modelEvaluationPlatformGet", "summary": "Get", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model evaluation platform" ], "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/model-evaluation-platform/runs/{id}/cancel": { "post": { "operationId": "modelEvaluationPlatformCancel", "summary": "Cancel", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model evaluation platform" ], "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/model-evaluation-platform/runs/{id}/execute": { "post": { "operationId": "modelEvaluationPlatformExecute", "summary": "Execute", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model evaluation platform" ], "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/model-evaluation-platform/suites": { "get": { "summary": "Model Evaluation Platform suites", "operationId": "listModelEvaluationSuites", "responses": { "200": { "description": "Translation/bias/safety/latency runnable; MMLU/HumanEval deferred" } }, "tags": [ "Model evaluation platform" ] } }, "/v1/model-marketplace/analytics": { "get": { "summary": "Model marketplace analytics", "operationId": "getModelMarketplaceAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Aggregates" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model marketplace" ] } }, "/v1/model-marketplace/engine": { "get": { "summary": "Model Marketplace engine catalog", "operationId": "getModelMarketplaceEngine", "responses": { "200": { "description": "Model marketplace capabilities, Stripe honesty, public model-hub / weight-hosting denials" } }, "tags": [ "Model marketplace" ] } }, "/v1/model-marketplace/installs": { "get": { "operationId": "modelMarketplaceInstalls", "summary": "Installs", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model marketplace" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/model-marketplace/listings": { "get": { "summary": "List model marketplace listings", "operationId": "listModelMarketplaceListings", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Published or mine model listings" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model marketplace" ] }, "post": { "summary": "Publish a Model Registry card as a marketplace listing", "operationId": "publishModelMarketplaceListing", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Listing created" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model marketplace" ] } }, "/v1/model-marketplace/listings/{id}": { "delete": { "operationId": "modelMarketplaceUnpublish", "summary": "Unpublish", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model marketplace" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/model-marketplace/listings/{id}/install": { "post": { "summary": "Install a model listing license entitlement", "operationId": "installModelMarketplaceListing", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "License entitlement installed" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Policy deny" }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model marketplace" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/model-marketplace/listings/{id}/reviews": { "get": { "summary": "List model listing reviews", "operationId": "listModelMarketplaceReviews", "responses": { "200": { "description": "Reviews" }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model marketplace" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] }, "post": { "summary": "Upsert a model listing review", "operationId": "reviewModelMarketplaceListing", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Review saved" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model marketplace" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/model-marketplace/listings/{id}/update": { "post": { "operationId": "modelMarketplaceUpdate", "summary": "Update", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model marketplace" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/model-marketplace/monitoring": { "get": { "summary": "Model marketplace monitoring", "operationId": "getModelMarketplaceMonitoring", "responses": { "200": { "description": "Capability status snapshot" } }, "tags": [ "Model marketplace" ] } }, "/v1/model-marketplace/products": { "get": { "summary": "Model Marketplace products (alias of engine)", "operationId": "listModelMarketplaceProducts", "responses": { "200": { "description": "Model marketplace catalog + honesty" } }, "tags": [ "Model marketplace" ] } }, "/v1/model-marketplace/sales": { "get": { "summary": "Model marketplace publisher sales", "operationId": "listModelMarketplaceSales", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Sale receipts + fee honesty" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model marketplace" ] } }, "/v1/model-registry/capabilities": { "get": { "summary": "Model Registry capabilities", "operationId": "listModelRegistryCapabilities", "responses": { "200": { "description": "Registry governance capabilities + honesty" } }, "tags": [ "Model registry" ] } }, "/v1/model-registry/cards": { "get": { "summary": "Model cards from registry entries", "operationId": "listModelRegistryCards", "responses": { "200": { "description": "Lightweight cards derived from registry metadata" } }, "tags": [ "Model registry" ] } }, "/v1/model-registry/deployments": { "get": { "summary": "List sandbox deployment plans", "operationId": "listModelRegistryDeployments", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Org-scoped deploy plans" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model registry" ] }, "post": { "summary": "Create sandbox deployment plan", "operationId": "createModelRegistryDeployment", "security": [ { "ClerkAuth": [] } ], "responses": { "201": { "description": "Deploy plan + Model Serving handoff" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model registry" ] } }, "/v1/model-registry/engine": { "get": { "summary": "Model Registry hub engine", "operationId": "getModelRegistryEngine", "responses": { "200": { "description": "Cards/versions/deploy capabilities + live summary (not MLflow/mesh OS)" } }, "tags": [ "Model registry" ] } }, "/v1/model-registry/monitoring": { "get": { "summary": "Model Registry monitoring", "operationId": "getModelRegistryMonitoring", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Version/deploy status snapshot + honesty" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model registry" ] } }, "/v1/model-registry/overview": { "get": { "summary": "Model Registry org overview", "operationId": "getModelRegistryOverview", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Session usage, versions, deployments" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model registry" ] } }, "/v1/model-registry/versions": { "get": { "summary": "List sandbox model versions", "operationId": "listModelRegistryVersions", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Org-scoped sandbox versions" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model registry" ] }, "post": { "summary": "Create sandbox model version", "operationId": "createModelRegistryVersion", "security": [ { "ClerkAuth": [] } ], "responses": { "201": { "description": "Version created" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model registry" ] } }, "/v1/model-registry/versions/{id}/approve": { "post": { "operationId": "modelRegistryApprove", "summary": "Approve", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model registry" ], "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/model-registry/versions/{id}/reject": { "post": { "operationId": "modelRegistryReject", "summary": "Reject", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model registry" ], "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/model-registry/versions/{id}/rollback": { "post": { "operationId": "modelRegistryRollback", "summary": "Rollback", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model registry" ], "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/model-serving/analytics": { "get": { "summary": "Model Serving analytics", "operationId": "getModelServingAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Deployment aggregates" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model serving" ] } }, "/v1/model-serving/ceilings": { "get": { "summary": "Model Serving active-deployment ceilings", "operationId": "getModelServingCeilings", "responses": { "200": { "description": "maxActiveDeployments + mode" } }, "tags": [ "Model serving" ] } }, "/v1/model-serving/deployments": { "get": { "summary": "List sandbox model deployments", "operationId": "listModelServingDeployments", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Org/workspace deployments" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model serving" ] }, "post": { "summary": "Create sandbox model deployment", "operationId": "createModelServingDeployment", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Logical deployment created" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Hard active-deployment ceiling exceeded" }, "403": { "description": "Serving mode disabled" } }, "tags": [ "Model serving" ] } }, "/v1/model-serving/deployments/{id}/promote": { "post": { "summary": "Promote canary/blue-green deployment to active", "operationId": "promoteModelServingDeployment", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Promoted to active@100%" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model serving" ] } }, "/v1/model-serving/deployments/{id}/redeploy": { "post": { "summary": "Deploy a new version with previousVersion pointer", "operationId": "redeployModelServingDeployment", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "201": { "description": "New version created" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model serving" ] } }, "/v1/model-serving/deployments/{id}/release": { "post": { "summary": "Release sandbox model deployment", "operationId": "releaseModelServingDeployment", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Released" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model serving" ] } }, "/v1/model-serving/deployments/{id}/rollback": { "post": { "summary": "Rollback to previous sandbox version", "operationId": "rollbackModelServingDeployment", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Prior version activated" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model serving" ] } }, "/v1/model-serving/deployments/{id}/traffic": { "post": { "summary": "Update sandbox canary traffic percent", "operationId": "setModelServingTraffic", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Traffic percent updated" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model serving" ] } }, "/v1/model-serving/endpoints": { "get": { "summary": "Discoverable Gateway serving endpoints", "operationId": "listModelServingEndpoints", "responses": { "200": { "description": "Gateway API + registry model map" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model serving" ] } }, "/v1/model-serving/engine": { "get": { "summary": "Model Serving catalog", "operationId": "getModelServingEngine", "responses": { "200": { "description": "Capabilities, honesty, and sandbox deployment ceilings" } }, "tags": [ "Model serving" ] } }, "/v1/model-serving/health": { "get": { "summary": "Model Serving health", "operationId": "getModelServingHealth", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Sandbox health snapshot" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model serving" ] } }, "/v1/model-serving/kinds": { "get": { "summary": "Serving model kinds", "operationId": "listModelServingKinds", "responses": { "200": { "description": "LLM/speech/voice/OCR/embedding/vision/reasoning map" } }, "tags": [ "Model serving" ] } }, "/v1/model-serving/modes": { "get": { "summary": "Serving modes", "operationId": "listModelServingModes", "responses": { "200": { "description": "Streaming/batch/realtime/canary/blue-green/rollback/versioning" } }, "tags": [ "Model serving" ] } }, "/v1/model-serving/monitoring": { "get": { "summary": "Model Serving monitoring", "operationId": "getModelServingMonitoring", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Monitoring + honesty snapshot" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model serving" ] } }, "/v1/model-training-platform/engine": { "get": { "summary": "Model Training Platform engine catalog", "operationId": "getModelTrainingPlatformEngine", "responses": { "200": { "description": "Training methods, ceilings, launchers, honesty (no distributed/RLHF lab)" } }, "tags": [ "Model training platform" ] } }, "/v1/model-training-platform/experiments": { "get": { "summary": "List training experiment plans", "operationId": "listModelTrainingExperiments", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Org-scoped sandbox experiments" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model training platform" ] }, "post": { "summary": "Create training experiment plan", "operationId": "createModelTrainingExperiment", "security": [ { "ClerkAuth": [] } ], "responses": { "201": { "description": "Experiment plan created" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model training platform" ] } }, "/v1/model-training-platform/experiments/{id}": { "get": { "operationId": "modelTrainingPlatformGet", "summary": "Get", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model training platform" ], "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/model-training-platform/experiments/{id}/cancel": { "post": { "operationId": "modelTrainingPlatformCancel", "summary": "Cancel", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model training platform" ], "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/model-training-platform/experiments/{id}/checkpoint": { "post": { "operationId": "modelTrainingPlatformCheckpoint", "summary": "Checkpoint", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model training platform" ], "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/model-training-platform/experiments/{id}/launch": { "post": { "operationId": "modelTrainingPlatformLaunch", "summary": "Launch", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model training platform" ], "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/model-training-platform/methods": { "get": { "summary": "Model Training Platform methods", "operationId": "listModelTrainingMethods", "responses": { "200": { "description": "LoRA/instruction launchable; RLHF/DPO deferred" } }, "tags": [ "Model training platform" ] } }, "/v1/model-training-platform/monitoring": { "get": { "summary": "Model Training Platform monitoring", "operationId": "getModelTrainingPlatformMonitoring", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Experiment status snapshot + honesty" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model training platform" ] } }, "/v1/model-training-platform/overview": { "get": { "summary": "Model Training Platform org overview", "operationId": "getModelTrainingPlatformOverview", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Session usage, experiments, deferred methods" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Model training platform" ] } }, "/v1/models": { "get": { "summary": "List model registry entries", "operationId": "listModels", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "feature", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Registry rows" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Models" ] } }, "/v1/models/{idOrSlug}": { "get": { "summary": "Get a model registry entry", "operationId": "getModel", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "idOrSlug", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Entry" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found" } }, "tags": [ "Models" ] } }, "/v1/models/{idOrSlug}/external-url": { "post": { "summary": "Set optional external URL (e.g. W&B) — platform admin", "operationId": "setModelExternalUrl", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "idOrSlug", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Updated" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin required" }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Models" ], "x-lugemi-access": "platform-admin" } }, "/v1/models/{idOrSlug}/status": { "post": { "summary": "Set registry status ready/retired/draft — platform admin", "operationId": "setModelStatus", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "idOrSlug", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Updated" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin required" }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Models" ], "x-lugemi-access": "platform-admin" } }, "/v1/models/baobab-af": { "get": { "summary": "Baobab Afrikaans national model card", "operationId": "getBaobabYoModel_get_3", "responses": { "200": { "description": "South Africa regional Afrikaans (Cape Town / South African) national card: phrase MT, neural speech when the Yoruba stack is live, neural_nmt false, trainingEligible locked" } }, "tags": [ "Models" ] } }, "/v1/models/baobab-am": { "get": { "summary": "Baobab Amharic national model card", "operationId": "getBaobabYoModel_get_2", "responses": { "200": { "description": "Ethiopia regional Amharic (Addis Ababa / Ethiopian) national card: phrase MT, neural speech when the Yoruba stack is live, neural_nmt false, trainingEligible locked" } }, "tags": [ "Models" ] } }, "/v1/models/baobab-ee": { "get": { "summary": "Baobab Ewe national model card", "operationId": "getBaobabEeModel", "responses": { "200": { "description": "Ewe (Anlo) national card: phrase MT, neural speech when the Ewe stack is live, neural_nmt false, trainingEligible locked" } }, "tags": [ "Models" ] } }, "/v1/models/baobab-fante": { "get": { "summary": "Baobab Fante national model card", "operationId": "getBaobabFanteModel", "responses": { "200": { "description": "Fante / Mfantse (Cape Coast) national card: spectral_gate_v2 + Fante pacing; not interchangeable with Asante/Akuapem" } }, "tags": [ "Models" ] } }, "/v1/models/baobab-fil": { "get": { "summary": "Baobab Tagalog national model card", "operationId": "getBaobabFilModel", "responses": { "200": { "description": "Philippines regional Tagalog (Manila / Filipino) national card: phrase MT, neural speech when shared Echo speech is live, neural_nmt false, paired Filipino English en-PH, trainingEligible locked" } }, "tags": [ "Models" ] } }, "/v1/models/baobab-fr-ci": { "get": { "summary": "Baobab Ivorian French national model card", "operationId": "getBaobabFrCiModel", "responses": { "200": { "description": "West Africa regional Ivorian French (Abidjan) national card: phrase MT, neural speech when shared Echo speech is live, neural_nmt false, paired Ghanaian English en-GH, trainingEligible locked. Not interchangeable with France French or Senegalese French." } }, "tags": [ "Models" ] } }, "/v1/models/baobab-fr-sn": { "get": { "summary": "Baobab Senegalese French national model card", "operationId": "getBaobabFrSnModel", "responses": { "200": { "description": "West Africa regional Senegalese French (Dakar) national card: phrase MT, neural speech when shared Echo speech is live, neural_nmt false, paired Ghanaian English en-GH, trainingEligible locked. Not interchangeable with France French or Ivorian French." } }, "tags": [ "Models" ] } }, "/v1/models/baobab-ga": { "get": { "summary": "Baobab Ga national model card", "operationId": "getBaobabGaModel", "responses": { "200": { "description": "Public Accra Ga card (ISO gaa): phrase MT, neural speech when the Ga stack is live, neural_nmt false, research_planned generative slot, trainingEligible locked" } }, "tags": [ "Models" ] } }, "/v1/models/baobab-ha": { "get": { "summary": "Baobab Hausa national model card", "operationId": "getBaobabHaModel", "responses": { "200": { "description": "Ghanaian Hausa (Zongo) national card: phrase MT, neural speech when the Hausa stack is live, neural_nmt false, trainingEligible locked" } }, "tags": [ "Models" ] } }, "/v1/models/baobab-ha-ng": { "get": { "summary": "Baobab Nigeria Hausa (Kano) national model card", "operationId": "getBaobabHaNgModel", "responses": { "200": { "description": "Nigeria regional Hausa (Kano) national card: phrase MT, neural speech when the Hausa stack is live, neural_nmt false, trainingEligible locked — not Ghana Zongo" } }, "tags": [ "Models" ] } }, "/v1/models/baobab-ig": { "get": { "summary": "Baobab Igbo national model card", "operationId": "getBaobabIgModel", "responses": { "200": { "description": "Nigeria regional Igbo (Enugu / Central) national card: phrase MT, neural speech when the Igbo stack is live, neural_nmt false, trainingEligible locked" } }, "tags": [ "Models" ] } }, "/v1/models/baobab-sw": { "get": { "summary": "Baobab Kiswahili national model card", "operationId": "getBaobabYoModel_get", "responses": { "200": { "description": "Kenya regional Kiswahili (Nairobi / Kenyan) national card: phrase MT, neural speech when the Yoruba stack is live, neural_nmt false, trainingEligible locked" } }, "tags": [ "Models" ] } }, "/v1/models/baobab-twi": { "get": { "summary": "Baobab Twi national model card", "operationId": "getBaobabTwiModel", "responses": { "200": { "description": "Public Phase D card: generative LM research_planned (no weights/inference), national tiers, residency honesty, phrase_table_only MT" } }, "tags": [ "Models" ] } }, "/v1/models/baobab-yo": { "get": { "summary": "Baobab Yoruba national model card", "operationId": "getBaobabYoModel", "responses": { "200": { "description": "Nigeria regional Yoruba (Lagos / Oyo) national card: phrase MT, neural speech when the Yoruba stack is live, neural_nmt false, trainingEligible locked" } }, "tags": [ "Models" ] } }, "/v1/models/baobab-zu": { "get": { "summary": "Baobab isiZulu national model card", "operationId": "getBaobabYoModel_get_4", "responses": { "200": { "description": "South Africa regional isiZulu (Durban / South African) national card: phrase MT, neural speech when the Yoruba stack is live, neural_nmt false, trainingEligible locked" } }, "tags": [ "Models" ] } }, "/v1/models/engine": { "get": { "summary": "Models Engine catalog", "operationId": "getModelsEngine", "responses": { "200": { "description": "Models Engine capabilities and honesty notes (not MLflow)" } }, "tags": [ "Models" ] } }, "/v1/models/live": { "get": { "summary": "Public live model matrix per gateway feature", "operationId": "getModelsLive", "responses": { "200": { "description": "Ready vendor + fine-tune entries with configured flags (not MLflow)" } }, "tags": [ "Models" ] } }, "/v1/notifications": { "get": { "operationId": "inboxList", "summary": "List", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Notifications" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/notifications/{id}/read": { "post": { "operationId": "inboxMarkRead", "summary": "Mark read", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Notifications" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/notifications/read-all": { "post": { "operationId": "inboxMarkAll", "summary": "Mark all", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Notifications" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/ocr": { "post": { "summary": "Extract text from an image (OCR)", "operationId": "extractOcr", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "required": [ "file" ], "properties": { "file": { "type": "string", "format": "binary" }, "languageHint": { "type": "string" }, "source": { "type": "string", "description": "Required with target to translate OCR text" }, "target": { "type": "string" } } } } } }, "responses": { "200": { "description": "OCR result", "content": { "application/json": { "schema": { "type": "object", "properties": { "text": { "type": "string" }, "pages": { "type": "integer" }, "provider": { "type": "string" }, "characters": { "type": "integer" }, "translatedText": { "type": "string", "nullable": true }, "translateProvider": { "type": "string", "nullable": true } } } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Vision API key not configured", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "OCR" ] } }, "/v1/onboarding": { "get": { "operationId": "onboardingGet", "summary": "Get", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Onboarding" ], "security": [ { "ClerkAuth": [] } ] }, "post": { "operationId": "onboardingSave", "summary": "Save", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Onboarding" ], "security": [ { "ClerkAuth": [] } ] } }, "/v1/ontology/analytics": { "get": { "operationId": "ontologyPlatformAnalytics", "summary": "Analytics", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Ontology" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/ontology/concepts": { "get": { "summary": "List ontology concepts", "operationId": "listOntologyConcepts", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Workspace-scoped concepts" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Ontology" ] }, "post": { "summary": "Create ontology concept", "operationId": "createOntologyConcept", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Created concept" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Ontology" ] } }, "/v1/ontology/concepts/{id}": { "delete": { "operationId": "ontologyPlatformRemove", "summary": "Remove", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Ontology" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] }, "get": { "operationId": "ontologyPlatformGet", "summary": "Get", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Ontology" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/ontology/concepts/{id}/children": { "get": { "operationId": "ontologyPlatformChildren", "summary": "Children", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Ontology" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/ontology/concepts/{id}/labels": { "post": { "operationId": "ontologyPlatformLabels", "summary": "Labels", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Ontology" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/ontology/domains": { "get": { "summary": "Ontology domains", "operationId": "listOntologyDomains", "responses": { "200": { "description": "General + deferred vertical domain tags" } }, "tags": [ "Ontology" ] } }, "/v1/ontology/engine": { "get": { "summary": "Ontology Platform engine catalog", "operationId": "getOntologyEngine", "responses": { "200": { "description": "Ontology capabilities and honesty flags" } }, "tags": [ "Ontology" ] } }, "/v1/ontology/hierarchies": { "post": { "summary": "Create is_a hierarchy edge", "operationId": "createOntologyHierarchy", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Created hierarchy edge" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Ontology" ] } }, "/v1/ontology/monitoring": { "get": { "operationId": "ontologyPlatformMonitoring", "summary": "Monitoring", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Ontology" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/ontology/synonyms": { "post": { "summary": "Add synonym alias or synonym_of edge", "operationId": "createOntologySynonym", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Updated concept / edge" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Ontology" ] } }, "/v1/open-science-platform/check": { "get": { "summary": "Check open-science release consent gate", "operationId": "checkOpenScienceRelease", "responses": { "200": { "description": "allowed + reason" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Open science platform" ] } }, "/v1/open-science-platform/engine": { "get": { "summary": "Open Science Platform engine catalog", "operationId": "getOpenSciencePlatformEngine", "responses": { "200": { "description": "Open Science Platform catalog + honesty" } }, "tags": [ "Open science platform" ] } }, "/v1/open-science-platform/monitoring": { "get": { "summary": "Open Science Platform monitoring", "operationId": "getOpenSciencePlatformMonitoring", "responses": { "200": { "description": "Monitoring snapshot" } }, "tags": [ "Open science platform" ] } }, "/v1/open-science-platform/products": { "get": { "summary": "Open Science Platform products", "operationId": "listOpenSciencePlatformProducts", "responses": { "200": { "description": "Open Science Platform products" } }, "tags": [ "Open science platform" ] } }, "/v1/open-science-platform/query": { "get": { "summary": "Query Open Science Platform", "operationId": "queryOpenSciencePlatform", "responses": { "200": { "description": "Filtered catalog rows" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Open science platform" ] } }, "/v1/open-science-platform/release": { "get": { "summary": "Attempt open-science release (consent gated)", "operationId": "releaseOpenScienceCandidate", "responses": { "200": { "description": "Released" }, "400": { "description": "Blocked by consent gate" } }, "tags": [ "Open science platform" ] } }, "/v1/open-science-platform/releases": { "get": { "summary": "List open-science release candidates", "operationId": "listOpenSciencePlatformReleases", "responses": { "200": { "description": "List open-science release candidates" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Open science platform" ] } }, "/v1/openapi.json": { "get": { "operationId": "openApiGetOpenApi", "summary": "Get open API", "responses": { "200": { "description": "Success. The body is written directly by the handler (for example audio bytes or a file download).", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "System" ] } }, "/v1/organization": { "delete": { "summary": "Delete organization (cascade; owner only)", "operationId": "deleteOrganization", "security": [ { "ClerkAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "confirmName" ], "properties": { "confirmName": { "type": "string", "description": "Must exactly match the organization name" } } } } } }, "responses": { "200": { "description": "Organization deleted" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Only owners can delete", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Organization" ] } }, "/v1/organization-control/engine": { "get": { "summary": "Organization Control engine", "operationId": "getOrganizationControlEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Organization control" ] } }, "/v1/organization-control/monitoring": { "get": { "summary": "Organization Control monitoring", "operationId": "getOrganizationControlMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Organization control" ] } }, "/v1/organization-control/organizations": { "get": { "summary": "Organization Control organizations", "operationId": "listOrganizationControlOrganizations", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Organization control" ] } }, "/v1/organization-control/products": { "get": { "summary": "Organization Control products", "operationId": "listOrganizationControlProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Organization control" ] } }, "/v1/organization-control/query": { "get": { "summary": "Query Organization Control", "operationId": "queryOrganizationControl", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Organization control" ] } }, "/v1/organization-control/roles": { "get": { "summary": "Organization Control roles", "operationId": "listOrganizationControlRoles", "responses": { "200": { "description": "OK" } }, "tags": [ "Organization control" ] } }, "/v1/organization/branding": { "get": { "operationId": "governanceGetBranding", "summary": "Get branding", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Organization" ], "security": [ { "ClerkAuth": [] } ] }, "patch": { "operationId": "governanceUpdateBranding", "summary": "Update branding", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Organization" ], "security": [ { "ClerkAuth": [] } ] } }, "/v1/organization/data-settings": { "get": { "summary": "Get organization data governance settings", "operationId": "getDataSettings", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Retention and persistence flags" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Organization" ] }, "patch": { "summary": "Update data governance settings", "operationId": "updateDataSettings", "security": [ { "ClerkAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "retentionDays": { "type": "integer", "nullable": true, "minimum": 1, "maximum": 3650 }, "persistSourceText": { "type": "boolean" }, "allowVendorTraining": { "type": "boolean" } } } } } }, "responses": { "200": { "description": "Updated settings" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Forbidden for members", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Organization" ] } }, "/v1/organization/export": { "post": { "summary": "Export current workspace data (JSON)", "operationId": "exportOrganizationWorkspace", "security": [ { "ClerkAuth": [] } ], "responses": { "201": { "description": "Workspace export payload" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Forbidden for members", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Organization" ] } }, "/v1/organization/invites": { "get": { "summary": "List organization invites", "operationId": "listOrganizationInvites", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Recent invites including pending" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Organization" ] }, "post": { "summary": "Invite teammate by email", "operationId": "createOrganizationInvite", "security": [ { "ClerkAuth": [] } ], "description": "Owners and admins invite teammates to share the workspace (owner/admin/member). Branded email sends when Resend is configured; create succeeds without it. Invitee accepts by signing in with the invited email.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "email" ], "properties": { "email": { "type": "string", "format": "email" }, "role": { "type": "string", "enum": [ "owner", "admin", "member" ], "default": "member" } } } } } }, "responses": { "200": { "description": "Invite created" }, "201": { "description": "Invite created" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Forbidden for members" }, "409": { "description": "Already a member or pending invite exists" } }, "tags": [ "Organization" ] } }, "/v1/organization/invites/{id}": { "delete": { "summary": "Revoke a pending organization invite", "operationId": "revokeOrganizationInvite", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Invite revoked" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Invite not found" } }, "tags": [ "Organization" ] } }, "/v1/organization/members": { "get": { "summary": "List organization members", "operationId": "listOrganizationMembers", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Members with role and profile fields" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Organization" ] } }, "/v1/organization/members/{id}": { "patch": { "summary": "Update organization member role", "operationId": "updateOrganizationMemberRole", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "role" ], "properties": { "role": { "type": "string", "enum": [ "owner", "admin", "member" ] } } } } } }, "responses": { "200": { "description": "Updated membership" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Forbidden for members or insufficient role" }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Organization" ] }, "delete": { "summary": "Remove organization member", "operationId": "removeOrganizationMember", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Removed" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Forbidden" }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Organization" ] } }, "/v1/organization/residency": { "get": { "summary": "Get organization data residency pin", "operationId": "getOrganizationResidency", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Pinned region vs current deploy" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Organization" ] }, "patch": { "summary": "Set organization data residency pin (owner only)", "description": "Pinning does not migrate data. A pin that mismatches LUGEMI_REGION yields residency_mismatch on authenticated routes.", "operationId": "setOrganizationResidency", "security": [ { "ClerkAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "dataRegion" ], "properties": { "dataRegion": { "type": "string", "nullable": true, "enum": [ "us", "eu", "af" ], "description": "Residency island code, or null to clear the pin" } } } } } }, "responses": { "200": { "description": "Updated residency" }, "400": { "description": "validation_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "forbidden (non-owner) or residency_mismatch on wrong island", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Organization" ] } }, "/v1/passport/catalog": { "get": { "summary": "Language Passport catalog and model-sync honesty", "operationId": "languagePassportCatalog", "responses": { "200": { "description": "Catalog, entry types, adapters, non-goals" } }, "tags": [ "Passport" ] } }, "/v1/passport/entries": { "post": { "summary": "Create passport entry (awaiting approval unless autoApprove)", "operationId": "createLanguagePassportEntry", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Created" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Passport" ] } }, "/v1/passport/entries/{id}": { "delete": { "operationId": "languagePassportRemoveEntry", "summary": "Remove entry", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Passport" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] }, "get": { "operationId": "languagePassportGetEntry", "summary": "Get entry", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Passport" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/passport/entries/{id}/approvals": { "post": { "summary": "Approve entry revision and sync to workspace models", "operationId": "approveLanguagePassportEntry", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Approved" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Passport" ] } }, "/v1/passport/entries/{id}/revisions": { "post": { "operationId": "languagePassportRevise", "summary": "Revise", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Passport" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/passport/exports": { "post": { "summary": "Export approved entries + preferences with checksum", "operationId": "exportLanguagePassport", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Versioned JSON export" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Passport" ] } }, "/v1/passport/grants": { "post": { "summary": "Create selected-entry share grant (expiring)", "operationId": "createLanguagePassportGrant", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Grant created" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Passport" ] } }, "/v1/passport/grants/{id}": { "delete": { "operationId": "languagePassportRevokeGrant", "summary": "Revoke grant", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Passport" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/passport/history": { "get": { "operationId": "languagePassportHistory", "summary": "History", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Passport" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/passport/import-previews": { "post": { "summary": "Preview untrusted import (no foreign grants; pending until confirm)", "operationId": "previewLanguagePassportImport", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Import preview" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Passport" ] } }, "/v1/passport/imports/{id}/confirm": { "post": { "operationId": "languagePassportConfirmImport", "summary": "Confirm import", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Passport" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/passport/me": { "get": { "summary": "Get or create the caller Language Passport", "operationId": "getLanguagePassport", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "X-Language-Passport-Actor-Id", "in": "header", "required": false, "schema": { "type": "string" }, "description": "Required with API keys (owner user id). Clerk sessions supply userId." } ], "responses": { "200": { "description": "Owner-private passport profile" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Passport" ] }, "delete": { "summary": "Delete passport (tombstone entries + revoke grants)", "operationId": "deleteLanguagePassport", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Deleted" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Passport" ] } }, "/v1/passport/model-sync": { "get": { "operationId": "languagePassportModelSync", "summary": "Model sync", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } } }, "tags": [ "Passport" ] } }, "/v1/passport/preferences": { "patch": { "summary": "Update passport preferences (varieties, voices, pause personalization)", "operationId": "patchLanguagePassportPreferences", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Updated preferences" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Revision conflict" } }, "tags": [ "Passport" ] } }, "/v1/passport/resolutions": { "post": { "summary": "Resolve text against approved passport memory (explainable plan)", "operationId": "resolveLanguagePassport", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Resolution plan" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Passport" ] } }, "/v1/patent-innovation-platform/engine": { "get": { "summary": "Patent & Innovation Platform engine catalog", "operationId": "getPatentInnovationPlatformEngine", "responses": { "200": { "description": "Patent & Innovation Platform catalog + honesty" } }, "tags": [ "Patent innovation platform" ] } }, "/v1/patent-innovation-platform/monitoring": { "get": { "summary": "Patent & Innovation Platform monitoring", "operationId": "getPatentInnovationPlatformMonitoring", "responses": { "200": { "description": "Monitoring snapshot" } }, "tags": [ "Patent innovation platform" ] } }, "/v1/patent-innovation-platform/portfolio": { "get": { "summary": "List IP portfolio items", "operationId": "listPatentInnovationPlatformPortfolio", "responses": { "200": { "description": "List IP portfolio items" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Patent innovation platform" ] } }, "/v1/patent-innovation-platform/products": { "get": { "summary": "Patent & Innovation Platform products", "operationId": "listPatentInnovationPlatformProducts", "responses": { "200": { "description": "Patent & Innovation Platform products" } }, "tags": [ "Patent innovation platform" ] } }, "/v1/patent-innovation-platform/query": { "get": { "summary": "Query Patent & Innovation Platform", "operationId": "queryPatentInnovationPlatform", "responses": { "200": { "description": "Filtered catalog rows" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Patent innovation platform" ] } }, "/v1/pilot-requests": { "post": { "operationId": "pilotRequestsCreate", "summary": "Create", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Pilot requests" ] } }, "/v1/platform-engineering-analytics/engine": { "get": { "summary": "Platform Engineering Analytics engine", "operationId": "getPlatformEngineeringAnalyticsEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Platform engineering analytics" ] } }, "/v1/platform-engineering-analytics/monitoring": { "get": { "summary": "Platform Engineering Analytics monitoring", "operationId": "getPlatformEngineeringAnalyticsMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Platform engineering analytics" ] } }, "/v1/platform-engineering-analytics/products": { "get": { "summary": "Platform Engineering Analytics products", "operationId": "listPlatformEngineeringAnalyticsProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Platform engineering analytics" ] } }, "/v1/platform-engineering-analytics/query": { "get": { "summary": "Query Platform Engineering Analytics", "operationId": "queryPlatformEngineeringAnalytics", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Platform engineering analytics" ] } }, "/v1/platform-engineering-analytics/snapshot": { "get": { "summary": "List Platform Engineering Analytics rows", "operationId": "listPlatformEngineeringAnalyticsRows", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Platform engineering analytics" ] } }, "/v1/platform-engineering-cloud/engine": { "get": { "summary": "Platform Engineering engine alias", "operationId": "getPlatformEngineeringCloudEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Platform engineering cloud" ] } }, "/v1/platform-engineering-cloud/monitoring": { "get": { "summary": "Platform Engineering monitoring", "operationId": "getPlatformEngineeringCloudMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Platform engineering cloud" ] } }, "/v1/platform-engineering-cloud/overview": { "get": { "summary": "Platform Engineering overview", "operationId": "getPlatformEngineeringCloudOverview", "responses": { "200": { "description": "OK" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Platform engineering cloud" ], "security": [ { "ClerkAuth": [] } ] } }, "/v1/platform-engineering-cloud/products": { "get": { "summary": "Platform Engineering products", "operationId": "listPlatformEngineeringCloudProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Platform engineering cloud" ] } }, "/v1/platform-engineering-cloud/routing": { "get": { "summary": "Platform Engineering routing", "operationId": "getPlatformEngineeringCloudRouting", "responses": { "200": { "description": "OK" } }, "tags": [ "Platform engineering cloud" ] } }, "/v1/plugin-marketplace/analytics": { "get": { "summary": "Plugin marketplace analytics", "operationId": "getPluginMarketplaceAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Aggregates" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Plugin marketplace" ] } }, "/v1/plugin-marketplace/engine": { "get": { "summary": "Plugin Marketplace engine catalog", "operationId": "getPluginMarketplaceEngine", "responses": { "200": { "description": "Plugin marketplace capabilities, sandbox/Policy honesty, deferred monetization depth" } }, "tags": [ "Plugin marketplace" ] } }, "/v1/plugin-marketplace/installs": { "get": { "operationId": "pluginMarketplaceInstalls", "summary": "Installs", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Plugin marketplace" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/plugin-marketplace/listings": { "get": { "summary": "List plugin marketplace listings", "operationId": "listPluginMarketplaceListings", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Published or mine plugin listings" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Plugin marketplace" ] }, "post": { "summary": "Publish a Plugin Runtime plugin as a marketplace listing", "operationId": "publishPluginMarketplaceListing", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Listing created" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Plugin marketplace" ] } }, "/v1/plugin-marketplace/listings/{id}": { "delete": { "operationId": "pluginMarketplaceUnpublish", "summary": "Unpublish", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Plugin marketplace" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/plugin-marketplace/listings/{id}/install": { "post": { "summary": "Install a plugin listing into Plugin Runtime (sandboxed)", "operationId": "installPluginMarketplaceListing", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Installed sandboxed plugin" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Policy/sandbox deny" }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Plugin marketplace" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/plugin-marketplace/listings/{id}/reviews": { "get": { "summary": "List plugin listing reviews", "operationId": "listPluginMarketplaceReviews", "responses": { "200": { "description": "Reviews" }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Plugin marketplace" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] }, "post": { "summary": "Upsert a plugin listing review", "operationId": "reviewPluginMarketplaceListing", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Review saved" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Plugin marketplace" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/plugin-marketplace/listings/{id}/run": { "post": { "summary": "Run an installed marketplace plugin (Policy-gated sandbox invoke)", "operationId": "runPluginMarketplaceListing", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Sandbox invoke result" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Policy deny or not installed" }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Plugin marketplace" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/plugin-marketplace/listings/{id}/update": { "post": { "operationId": "pluginMarketplaceUpdate", "summary": "Update", "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Plugin marketplace" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/plugin-marketplace/monitoring": { "get": { "summary": "Plugin marketplace monitoring", "operationId": "getPluginMarketplaceMonitoring", "responses": { "200": { "description": "Capability status snapshot" } }, "tags": [ "Plugin marketplace" ] } }, "/v1/plugin-marketplace/products": { "get": { "summary": "Plugin Marketplace products (alias of engine)", "operationId": "listPluginMarketplaceProducts", "responses": { "200": { "description": "Plugin marketplace catalog + honesty" } }, "tags": [ "Plugin marketplace" ] } }, "/v1/plugin-marketplace/sales": { "get": { "operationId": "pluginMarketplaceSales", "summary": "Sales", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Plugin marketplace" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/plugin-operating-system/engine": { "get": { "summary": "Plugin Operating System engine", "operationId": "getPluginOperatingSystemEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Plugin operating system" ] } }, "/v1/plugin-operating-system/execute": { "get": { "summary": "Execute via Plugin Operating System", "operationId": "executePluginOperatingSystem", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Plugin operating system" ] } }, "/v1/plugin-operating-system/monitoring": { "get": { "summary": "Plugin Operating System monitoring", "operationId": "getPluginOperatingSystemMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Plugin operating system" ] } }, "/v1/plugin-operating-system/products": { "get": { "summary": "Plugin Operating System products", "operationId": "listPluginOperatingSystemProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Plugin operating system" ] } }, "/v1/plugin-operating-system/query": { "get": { "summary": "Query Plugin Operating System", "operationId": "queryPluginOperatingSystem", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Plugin operating system" ] } }, "/v1/plugin-operating-system/route": { "get": { "summary": "Route via Plugin Operating System", "operationId": "routePluginOperatingSystem", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Plugin operating system" ] } }, "/v1/plugin-operating-system/routes": { "get": { "summary": "Plugin Operating System routes", "operationId": "listPluginOperatingSystemRoutes", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Plugin operating system" ] } }, "/v1/plugin-runtime/analytics": { "get": { "summary": "Plugin Runtime analytics", "operationId": "getPluginRuntimeAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Aggregates" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Plugin runtime" ] } }, "/v1/plugin-runtime/engine": { "get": { "summary": "Plugin Runtime catalog", "operationId": "getPluginRuntimeEngine", "responses": { "200": { "description": "Catalog + honesty + ceilings" } }, "tags": [ "Plugin runtime" ] } }, "/v1/plugin-runtime/invoke": { "post": { "summary": "Invoke sandbox plugin", "operationId": "invokePluginRuntime", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Sandbox invoke result" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Plugin runtime" ] } }, "/v1/plugin-runtime/marketplace": { "get": { "summary": "Plugin marketplace counts", "operationId": "getPluginRuntimeMarketplace", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Listing counts" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Plugin runtime" ] } }, "/v1/plugin-runtime/monitoring": { "get": { "summary": "Plugin Runtime monitoring", "operationId": "getPluginRuntimeMonitoring", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Monitoring + safety" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Plugin runtime" ] } }, "/v1/plugin-runtime/permissions": { "get": { "summary": "Plugin Runtime grantable/denied permissions", "operationId": "listPluginRuntimePermissions", "responses": { "200": { "description": "Permission lists" } }, "tags": [ "Plugin runtime" ] } }, "/v1/plugin-runtime/plugins": { "get": { "summary": "List registered plugins", "operationId": "listPluginRuntimePlugins", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Plugins" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Plugin runtime" ] }, "post": { "summary": "Register a sandbox plugin", "operationId": "registerPluginRuntimePlugin", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Registered" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Plugin runtime" ] } }, "/v1/plugin-runtime/plugins/{id}": { "get": { "summary": "Get plugin", "operationId": "getPluginRuntimePlugin", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Plugin" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Plugin runtime" ] } }, "/v1/plugin-runtime/plugins/{id}/lifecycle": { "post": { "summary": "Update plugin lifecycle", "operationId": "lifecyclePluginRuntimePlugin", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Updated" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Plugin runtime" ] } }, "/v1/plugin-runtime/plugins/{id}/version": { "post": { "summary": "Bump plugin version", "operationId": "versionPluginRuntimePlugin", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Versioned" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Plugin runtime" ] } }, "/v1/policy-fabric/assert": { "post": { "summary": "Hard-gate assert (403 on deny)", "operationId": "assertPolicyFabric", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Allowed" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Denied by Policy Fabric hard gate", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Policy fabric" ] } }, "/v1/policy-fabric/distribute": { "post": { "summary": "Plan policy distribution to same-org workspaces (hard-gated)", "operationId": "distributePolicyFabric", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Distribution plan + optional Event Fabric event" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Denied by Policy Fabric hard gate", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Policy fabric" ] } }, "/v1/policy-fabric/engine": { "get": { "summary": "Policy Fabric engine (alias of products)", "operationId": "getPolicyFabricEngine", "responses": { "200": { "description": "Catalog + hard-gate honesty" } }, "tags": [ "Policy fabric" ] } }, "/v1/policy-fabric/evaluate": { "post": { "summary": "Evaluate a policy decision (no throw)", "operationId": "evaluatePolicyFabric", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Decision with hardGate:true" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Policy fabric" ] } }, "/v1/policy-fabric/federate": { "post": { "summary": "List policy federation handoff targets", "operationId": "federatePolicyFabric", "responses": { "200": { "description": "Federation handoff catalog" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Policy fabric" ] } }, "/v1/policy-fabric/monitoring": { "get": { "summary": "Policy Fabric monitoring", "operationId": "getPolicyFabricMonitoring", "responses": { "200": { "description": "Counters + honesty" } }, "tags": [ "Policy fabric" ] } }, "/v1/policy-fabric/overview": { "get": { "summary": "Policy Fabric org overview", "operationId": "getPolicyFabricOverview", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Session + pipelines + counters" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Policy fabric" ] } }, "/v1/policy-fabric/pipeline": { "post": { "summary": "Plan a policy pipeline (ordered handoffs)", "operationId": "planPolicyFabricPipeline", "responses": { "200": { "description": "Pipeline + routed steps" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Policy fabric" ] } }, "/v1/policy-fabric/policies": { "get": { "summary": "List policies via Policy Runtime", "operationId": "listPolicyFabricPolicies", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Policy list" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Policy fabric" ] } }, "/v1/policy-fabric/products": { "get": { "summary": "Policy Fabric capability catalog", "operationId": "listPolicyFabricProducts", "responses": { "200": { "description": "Policy router capabilities, hard-gate honesty, fabric bus list" } }, "tags": [ "Policy fabric" ] } }, "/v1/policy-fabric/route": { "post": { "summary": "Plan policy routing for selected kinds", "operationId": "planPolicyFabricRoute", "responses": { "200": { "description": "Router plan" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Policy fabric" ] } }, "/v1/policy-fabric/routes": { "get": { "summary": "Policy Fabric routing table", "operationId": "listPolicyFabricRoutes", "responses": { "200": { "description": "kind → Runtime/Fabric handoffs" } }, "tags": [ "Policy fabric" ] } }, "/v1/policy-fabric/sync": { "post": { "summary": "Same-org policy catalog sync plan (hard-gated)", "operationId": "syncPolicyFabric", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Sync plan" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Denied by Policy Fabric hard gate", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Policy fabric" ] } }, "/v1/policy-fabric/versions": { "get": { "summary": "Policy Fabric version catalog", "operationId": "listPolicyFabricVersions", "responses": { "200": { "description": "Hard-gate/router/pipeline versions" } }, "tags": [ "Policy fabric" ] } }, "/v1/policy-runtime/analytics": { "get": { "summary": "Policy Runtime analytics", "operationId": "getPolicyRuntimeAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Aggregates" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Policy runtime" ] } }, "/v1/policy-runtime/engine": { "get": { "summary": "Policy Runtime catalog", "operationId": "getPolicyRuntimeEngine", "responses": { "200": { "description": "Catalog + honesty + ceilings" } }, "tags": [ "Policy runtime" ] } }, "/v1/policy-runtime/evaluate": { "post": { "summary": "Evaluate policy hard-gate decision", "operationId": "evaluatePolicyRuntime", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Allow/deny decision (hardGate)" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Policy runtime" ] } }, "/v1/policy-runtime/kinds": { "get": { "summary": "Policy kinds and global denies", "operationId": "listPolicyRuntimeKinds", "responses": { "200": { "description": "Kinds" } }, "tags": [ "Policy runtime" ] } }, "/v1/policy-runtime/monitoring": { "get": { "summary": "Policy Runtime monitoring", "operationId": "getPolicyRuntimeMonitoring", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Monitoring + wiring" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Policy runtime" ] } }, "/v1/policy-runtime/policies": { "get": { "summary": "List workspace policies", "operationId": "listPolicyRuntimePolicies", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Policies" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Policy runtime" ] }, "post": { "summary": "Create workspace policy", "operationId": "createPolicyRuntimePolicy", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Created" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Policy runtime" ] } }, "/v1/policy-runtime/policies/{id}": { "get": { "summary": "Get policy", "operationId": "getPolicyRuntimePolicy", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Policy" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Policy runtime" ] } }, "/v1/policy-runtime/policies/{id}/enabled": { "post": { "summary": "Enable or disable policy", "operationId": "enablePolicyRuntimePolicy", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Updated" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Policy runtime" ] } }, "/v1/portfolio/corridors": { "get": { "summary": "Country-pack language↔English corridors for Verified Interpreter", "operationId": "getPortfolioCorridors", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Search label, language, variety, or country" }, { "name": "country", "in": "query", "required": false, "schema": { "type": "string" }, "description": "ISO country code or country name filter" }, { "name": "region", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Region substring filter" } ], "responses": { "200": { "description": "Full country-pack corridor list (evaluation depth varies; not all corridors are evaluated)" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Portfolio" ] } }, "/v1/portfolio/engine": { "get": { "summary": "Next-model portfolio engine (Verified Interpreter pillars)", "operationId": "getPortfolioEngine", "responses": { "200": { "description": "Pillar catalog and links" } }, "tags": [ "Portfolio" ] } }, "/v1/pragmatics/engine": { "get": { "summary": "Lugemi Pragmatics engine", "operationId": "getPragmaticsEngine", "responses": { "200": { "description": "Pragmatics catalog" } }, "tags": [ "Pragmatics" ] } }, "/v1/pragmatics/translate": { "post": { "summary": "Speech-act preserving translation", "operationId": "pragmaticsTranslate", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Mode, candidates, preserved-act checks" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Pragmatics" ] } }, "/v1/privacy-platform/assets": { "get": { "summary": "Privacy Platform assets", "operationId": "listPrivacyPlatformAssets", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Privacy platform" ] } }, "/v1/privacy-platform/check": { "get": { "summary": "Check Privacy Platform", "operationId": "checkPrivacyPlatform", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Privacy platform" ] } }, "/v1/privacy-platform/consent-check": { "get": { "summary": "Consent check Privacy Platform", "operationId": "consentCheckPrivacyPlatform", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Privacy platform" ] } }, "/v1/privacy-platform/engine": { "get": { "summary": "Privacy Platform engine", "operationId": "getPrivacyPlatformEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Privacy platform" ] } }, "/v1/privacy-platform/monitoring": { "get": { "summary": "Privacy Platform monitoring", "operationId": "getPrivacyPlatformMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Privacy platform" ] } }, "/v1/privacy-platform/products": { "get": { "summary": "Privacy Platform products", "operationId": "listPrivacyPlatformProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Privacy platform" ] } }, "/v1/privacy-platform/query": { "get": { "summary": "Query Privacy Platform", "operationId": "queryPrivacyPlatform", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Privacy platform" ] } }, "/v1/privacy-platform/release": { "get": { "summary": "Release Privacy Platform", "operationId": "releasePrivacyPlatform", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Privacy platform" ] }, "post": { "operationId": "privacyPlatformRelease", "summary": "Release", "parameters": [ { "name": "id", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Privacy platform" ] } }, "/v1/prompt-fabric/distribute": { "post": { "summary": "Plan prompt distribution to same-org workspaces", "operationId": "distributePromptFabric", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Distribution plan + optional Event Fabric event" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompt fabric" ] } }, "/v1/prompt-fabric/engine": { "get": { "summary": "Prompt Fabric engine (alias of products)", "operationId": "getPromptFabricEngine", "responses": { "200": { "description": "Catalog + honesty" } }, "tags": [ "Prompt fabric" ] } }, "/v1/prompt-fabric/monitoring": { "get": { "summary": "Prompt Fabric monitoring", "operationId": "getPromptFabricMonitoring", "responses": { "200": { "description": "Counters + recent plans + honesty" } }, "tags": [ "Prompt fabric" ] } }, "/v1/prompt-fabric/overview": { "get": { "summary": "Prompt Fabric org overview", "operationId": "getPromptFabricOverview", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Session + routes + counters" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompt fabric" ] } }, "/v1/prompt-fabric/policies": { "get": { "summary": "Prompt policy handoff (Policy Runtime)", "operationId": "getPromptFabricPolicies", "responses": { "200": { "description": "Policy Runtime discovery + Policy Fabric deferral" } }, "tags": [ "Prompt fabric" ] } }, "/v1/prompt-fabric/products": { "get": { "summary": "Prompt Fabric capability catalog", "operationId": "listPromptFabricProducts", "responses": { "200": { "description": "Prompt router capabilities, Prompt Runtime handoff, policy honesty" } }, "tags": [ "Prompt fabric" ] } }, "/v1/prompt-fabric/route": { "post": { "summary": "Plan prompt routing for kinds/features", "operationId": "planPromptFabricRoute", "responses": { "200": { "description": "Router plan + optional runtime route" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompt fabric" ] } }, "/v1/prompt-fabric/routes": { "get": { "summary": "Prompt Fabric routing table", "operationId": "listPromptFabricRoutes", "responses": { "200": { "description": "kind → Prompt Runtime / cloud handoffs" } }, "tags": [ "Prompt fabric" ] } }, "/v1/prompt-fabric/sync": { "post": { "summary": "Plan prompt sync between same-org workspaces", "operationId": "syncPromptFabric", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Sync cursor/plan + optional Event Fabric event" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompt fabric" ] } }, "/v1/prompt-fabric/validate": { "post": { "summary": "Validate a prompt via Prompt Runtime", "operationId": "validatePromptFabric", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Validation findings" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompt fabric" ] } }, "/v1/prompt-fabric/versions": { "get": { "summary": "List prompt versions via Prompt Runtime", "operationId": "listPromptFabricVersions", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "key", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Version list" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompt fabric" ] } }, "/v1/prompt-intelligence/analytics": { "get": { "summary": "Prompt Intelligence analytics", "operationId": "getPromptIntelligenceAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Prompt audit aggregates" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompt intelligence" ] } }, "/v1/prompt-intelligence/engine": { "get": { "summary": "Prompt Intelligence catalog", "operationId": "getPromptIntelligenceEngine", "responses": { "200": { "description": "Capabilities and auto-prompt-lab honesty notes" } }, "tags": [ "Prompt intelligence" ] } }, "/v1/prompt-intelligence/evaluate": { "post": { "summary": "Heuristic prompt evaluation", "operationId": "evaluatePromptIntelligence", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Score + findings (not LLM-as-judge)" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompt intelligence" ] } }, "/v1/prompt-intelligence/keys": { "get": { "summary": "Managed prompt keys", "operationId": "listPromptIntelligenceKeys", "responses": { "200": { "description": "chat/rag/voice_faq keys" } }, "tags": [ "Prompt intelligence" ] } }, "/v1/prompt-intelligence/marketplace": { "get": { "summary": "Prompt marketplace listing counts", "operationId": "getPromptIntelligenceMarketplace", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Publisher prompt listing counts" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompt intelligence" ] } }, "/v1/prompt-intelligence/monitoring": { "get": { "summary": "Prompt Intelligence monitoring snapshot", "operationId": "getPromptIntelligenceMonitoring", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Monitoring snapshot" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompt intelligence" ] } }, "/v1/prompt-intelligence/preview": { "post": { "summary": "Preview/resolve a prompt body", "operationId": "previewPromptIntelligence", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Resolved body without LLM call" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompt intelligence" ] } }, "/v1/prompt-intelligence/registry": { "get": { "summary": "Workspace prompt registry", "operationId": "getPromptIntelligenceRegistry", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Active/fallback status per key" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompt intelligence" ] } }, "/v1/prompt-intelligence/security-scan": { "post": { "summary": "Prompt security pattern scan", "operationId": "securityScanPromptIntelligence", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Injection/secret pattern findings" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompt intelligence" ] } }, "/v1/prompt-marketplace/analytics": { "get": { "summary": "Prompt marketplace analytics", "operationId": "getPromptMarketplaceAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Aggregates" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompt marketplace" ] } }, "/v1/prompt-marketplace/engine": { "get": { "summary": "Prompt Marketplace engine catalog", "operationId": "getPromptMarketplaceEngine", "responses": { "200": { "description": "Prompt marketplace capabilities, Stripe honesty, prompt-mesh / auto-prompt research denials" } }, "tags": [ "Prompt marketplace" ] } }, "/v1/prompt-marketplace/installs": { "get": { "operationId": "promptMarketplaceInstalls", "summary": "Installs", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompt marketplace" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/prompt-marketplace/listings": { "get": { "summary": "List prompt marketplace listings", "operationId": "listPromptMarketplaceListings", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Published or mine prompt listings" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompt marketplace" ] }, "post": { "summary": "Publish managed prompts as a marketplace listing", "operationId": "publishPromptMarketplaceListing", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Listing created" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompt marketplace" ] } }, "/v1/prompt-marketplace/listings/{id}": { "delete": { "operationId": "promptMarketplaceUnpublish", "summary": "Unpublish", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompt marketplace" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/prompt-marketplace/listings/{id}/install": { "post": { "summary": "Install a prompt listing into the buyer workspace", "operationId": "installPromptMarketplaceListing", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Prompt versions installed" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Policy deny" }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompt marketplace" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/prompt-marketplace/listings/{id}/reviews": { "get": { "summary": "List prompt listing reviews", "operationId": "listPromptMarketplaceReviews", "responses": { "200": { "description": "Reviews" }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompt marketplace" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] }, "post": { "summary": "Upsert a prompt listing review", "operationId": "reviewPromptMarketplaceListing", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Review saved" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompt marketplace" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/prompt-marketplace/listings/{id}/test": { "post": { "summary": "Dry-run validate a prompt listing snapshot", "operationId": "testPromptMarketplaceListing", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Dry-run test results" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompt marketplace" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/prompt-marketplace/listings/{id}/update": { "post": { "operationId": "promptMarketplaceUpdate", "summary": "Update", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompt marketplace" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/prompt-marketplace/monitoring": { "get": { "summary": "Prompt marketplace monitoring", "operationId": "getPromptMarketplaceMonitoring", "responses": { "200": { "description": "Capability status snapshot" } }, "tags": [ "Prompt marketplace" ] } }, "/v1/prompt-marketplace/products": { "get": { "summary": "Prompt Marketplace products (alias of engine)", "operationId": "listPromptMarketplaceProducts", "responses": { "200": { "description": "Prompt marketplace catalog + honesty" } }, "tags": [ "Prompt marketplace" ] } }, "/v1/prompt-marketplace/sales": { "get": { "summary": "Prompt marketplace publisher sales", "operationId": "listPromptMarketplaceSales", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Sale receipts + fee honesty" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompt marketplace" ] } }, "/v1/prompt-runtime/analytics": { "get": { "summary": "Prompt Runtime analytics", "operationId": "getPromptRuntimeAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Aggregates" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompt runtime" ] } }, "/v1/prompt-runtime/engine": { "get": { "summary": "Prompt Runtime catalog", "operationId": "getPromptRuntimeEngine", "responses": { "200": { "description": "Kernel prompt capabilities and honesty" } }, "tags": [ "Prompt runtime" ] } }, "/v1/prompt-runtime/execute": { "post": { "summary": "Execute prompt (resolve/render/validate)", "operationId": "executePromptRuntime", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Rendered prompt (no LLM call)" }, "400": { "description": "Validation or security failure" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompt runtime" ] } }, "/v1/prompt-runtime/keys": { "get": { "summary": "Prompt Runtime keys", "operationId": "listPromptRuntimeKeys", "responses": { "200": { "description": "Managed prompt keys" } }, "tags": [ "Prompt runtime" ] } }, "/v1/prompt-runtime/monitoring": { "get": { "summary": "Prompt Runtime monitoring", "operationId": "getPromptRuntimeMonitoring", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Monitoring + honesty" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompt runtime" ] } }, "/v1/prompt-runtime/optimize": { "post": { "summary": "Heuristic optimize prompt", "operationId": "optimizePromptRuntime", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Trim/tips stub" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompt runtime" ] } }, "/v1/prompt-runtime/registry": { "get": { "summary": "Prompt Runtime registry façade", "operationId": "getPromptRuntimeRegistry", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Language registry rows" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompt runtime" ] } }, "/v1/prompt-runtime/render": { "post": { "summary": "Render prompt variables", "operationId": "renderPromptRuntime", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Rendered body" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompt runtime" ] } }, "/v1/prompt-runtime/route": { "post": { "summary": "Route feature to prompt key", "operationId": "routePromptRuntime", "responses": { "200": { "description": "Sandbox route result" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompt runtime" ] } }, "/v1/prompt-runtime/routes": { "get": { "summary": "Prompt Runtime feature routes", "operationId": "listPromptRuntimeRoutes", "responses": { "200": { "description": "Sandbox feature→key map" } }, "tags": [ "Prompt runtime" ] } }, "/v1/prompt-runtime/security-scan": { "post": { "summary": "Security-scan prompt", "operationId": "securityScanPromptRuntime", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Pattern scan via Prompt Intelligence" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompt runtime" ] } }, "/v1/prompt-runtime/templates": { "get": { "summary": "Prompt Runtime templates", "operationId": "listPromptRuntimeTemplates", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Templates + variables" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompt runtime" ] } }, "/v1/prompt-runtime/validate": { "post": { "summary": "Validate rendered prompt", "operationId": "validatePromptRuntime", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Heuristic validation" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompt runtime" ] } }, "/v1/prompt-runtime/versions": { "get": { "summary": "Prompt Runtime versions", "operationId": "listPromptRuntimeVersions", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Version list for key" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompt runtime" ] } }, "/v1/promptops-platform/engine": { "get": { "summary": "PromptOps Platform engine catalog", "operationId": "getPromptopsPlatformEngine", "responses": { "200": { "description": "Engine catalog" } }, "tags": [ "PromptOps platform" ] } }, "/v1/promptops-platform/monitoring": { "get": { "summary": "PromptOps Platform monitoring", "operationId": "getPromptopsPlatformMonitoring", "responses": { "200": { "description": "Monitoring snapshot" } }, "tags": [ "PromptOps platform" ] } }, "/v1/promptops-platform/products": { "get": { "summary": "PromptOps Platform products alias", "operationId": "listPromptopsPlatformProducts", "responses": { "200": { "description": "Engine catalog" } }, "tags": [ "PromptOps platform" ] } }, "/v1/promptops-platform/prompts": { "get": { "summary": "List PromptOps Platform prompts", "operationId": "listPromptopsPlatformPrompts", "responses": { "200": { "description": "Filtered catalog rows" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "PromptOps platform" ] } }, "/v1/promptops-platform/query": { "get": { "summary": "Query PromptOps Platform", "operationId": "queryPromptopsPlatform", "responses": { "200": { "description": "Filtered catalog rows" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "PromptOps platform" ] } }, "/v1/prompts": { "get": { "summary": "List managed prompt keys and active versions", "operationId": "listPrompts", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "chat, rag, voice_faq summaries" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompts" ] } }, "/v1/prompts/{key}/activate": { "post": { "summary": "Activate a prompt version (rollback)", "operationId": "activatePromptVersion", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "key", "in": "path", "required": true, "schema": { "type": "string", "enum": [ "chat", "rag", "voice_faq" ] } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "version" ], "properties": { "version": { "type": "integer" } } } } } }, "responses": { "200": { "description": "Activated" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompts" ] } }, "/v1/prompts/{key}/fallback": { "post": { "summary": "Clear active version and use code fallback", "operationId": "restorePromptFallback", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "key", "in": "path", "required": true, "schema": { "type": "string", "enum": [ "chat", "rag", "voice_faq" ] } } ], "responses": { "200": { "description": "Using fallback" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompts" ] } }, "/v1/prompts/{key}/versions": { "get": { "summary": "List versions for a prompt key", "operationId": "listPromptVersions", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "key", "in": "path", "required": true, "schema": { "type": "string", "enum": [ "chat", "rag", "voice_faq" ] } } ], "responses": { "200": { "description": "Version history" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompts" ] }, "post": { "summary": "Create a prompt version (activates by default)", "operationId": "createPromptVersion", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "key", "in": "path", "required": true, "schema": { "type": "string", "enum": [ "chat", "rag", "voice_faq" ] } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "body" ], "properties": { "body": { "type": "string" }, "note": { "type": "string" }, "activate": { "type": "boolean", "default": true } } } } } }, "responses": { "201": { "description": "Created" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Prompts" ] } }, "/v1/pronunciation/analytics": { "get": { "summary": "Pronunciation Intelligence analytics", "operationId": "getPronunciationAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Org audit-derived usage" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Pronunciation" ] } }, "/v1/pronunciation/assess": { "post": { "summary": "Assess pronunciation vs reference", "operationId": "assessPronunciation", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Scores, alignment, coaching" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Pronunciation" ] } }, "/v1/pronunciation/assess/stream": { "post": { "summary": "Stream pronunciation assessment (SSE)", "operationId": "streamPronunciationAssess", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "SSE assessment events" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Pronunciation" ] } }, "/v1/pronunciation/coach": { "post": { "summary": "Accent/pronunciation coaching tips", "operationId": "coachPronunciation", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Coaching tips + scores" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Pronunciation" ] } }, "/v1/pronunciation/engine": { "get": { "summary": "Pronunciation Intelligence engine catalog", "operationId": "getPronunciationEngine", "responses": { "200": { "description": "Assessment capabilities" } }, "tags": [ "Pronunciation" ] } }, "/v1/pronunciation/fluency": { "post": { "summary": "Sentence fluency from audio", "operationId": "pronunciationFluency", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Speaking rate + silence proxies" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Pronunciation" ] } }, "/v1/pronunciation/phonemes": { "post": { "summary": "Approximate phonemes and word stress", "operationId": "pronunciationPhonemes", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Grapheme/dictionary phonemes" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Pronunciation" ] } }, "/v1/pronunciation/score": { "post": { "summary": "Pronunciation scores only", "operationId": "scorePronunciation", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Overall/accuracy/fluency/stress" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Pronunciation" ] } }, "/v1/ragops-platform/engine": { "get": { "summary": "RAGOps Platform engine catalog", "operationId": "getRagopsPlatformEngine", "responses": { "200": { "description": "Engine catalog" } }, "tags": [ "RAGOps platform" ] } }, "/v1/ragops-platform/monitoring": { "get": { "summary": "RAGOps Platform monitoring", "operationId": "getRagopsPlatformMonitoring", "responses": { "200": { "description": "Monitoring snapshot" } }, "tags": [ "RAGOps platform" ] } }, "/v1/ragops-platform/pipelines": { "get": { "summary": "List RAGOps Platform pipelines", "operationId": "listRagopsPlatformPipelines", "responses": { "200": { "description": "Filtered catalog rows" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "RAGOps platform" ] } }, "/v1/ragops-platform/products": { "get": { "summary": "RAGOps Platform products alias", "operationId": "listRagopsPlatformProducts", "responses": { "200": { "description": "Engine catalog" } }, "tags": [ "RAGOps platform" ] } }, "/v1/ragops-platform/query": { "get": { "summary": "Query RAGOps Platform", "operationId": "queryRagopsPlatform", "responses": { "200": { "description": "Filtered catalog rows" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "RAGOps platform" ] } }, "/v1/reasoning-cloud/analytics": { "get": { "summary": "Reasoning Cloud analytics", "operationId": "getReasoningCloudAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Reason audits + chat token proxy" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Reasoning cloud" ] } }, "/v1/reasoning-cloud/engine": { "get": { "summary": "Reasoning Cloud engine catalog", "operationId": "getReasoningCloudEngine", "responses": { "200": { "description": "Strategies and reasoner-kernel honesty notes" } }, "tags": [ "Reasoning cloud" ] } }, "/v1/reasoning-cloud/monitoring": { "get": { "summary": "Reasoning Cloud monitoring snapshot", "operationId": "getReasoningCloudMonitoring", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Monitoring snapshot" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Reasoning cloud" ] } }, "/v1/reasoning-cloud/reason": { "post": { "summary": "Run multi-step reasoning", "operationId": "reasonReasoningCloud", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Steps, answer, optional branches/tools" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Reasoning cloud" ] } }, "/v1/reasoning-cloud/strategies": { "get": { "summary": "Reasoning strategies catalog", "operationId": "listReasoningCloudStrategies", "responses": { "200": { "description": "Prompt strategies + tool catalog" } }, "tags": [ "Reasoning cloud" ] } }, "/v1/reasoning-fabric/cache": { "get": { "summary": "Reasoning cache handoff (Intelligent Cache)", "operationId": "getReasoningFabricCache", "responses": { "200": { "description": "Intelligent Cache discovery" } }, "tags": [ "Reasoning fabric" ] } }, "/v1/reasoning-fabric/distribute": { "post": { "summary": "Plan reasoning distribution to same-org workspaces", "operationId": "distributeReasoningFabric", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Distribution plan + optional Event Fabric event" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Reasoning fabric" ] } }, "/v1/reasoning-fabric/engine": { "get": { "summary": "Reasoning Fabric engine (alias of products)", "operationId": "getReasoningFabricEngine", "responses": { "200": { "description": "Catalog + honesty" } }, "tags": [ "Reasoning fabric" ] } }, "/v1/reasoning-fabric/federate": { "post": { "summary": "List reasoning federation handoff targets", "operationId": "federateReasoningFabric", "responses": { "200": { "description": "Federation handoff catalog" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Reasoning fabric" ] } }, "/v1/reasoning-fabric/history": { "get": { "summary": "Reasoning history via Reasoning Runtime", "operationId": "listReasoningFabricHistory", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "History runs" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Reasoning fabric" ] } }, "/v1/reasoning-fabric/monitoring": { "get": { "summary": "Reasoning Fabric monitoring", "operationId": "getReasoningFabricMonitoring", "responses": { "200": { "description": "Counters + honesty" } }, "tags": [ "Reasoning fabric" ] } }, "/v1/reasoning-fabric/overview": { "get": { "summary": "Reasoning Fabric org overview", "operationId": "getReasoningFabricOverview", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Session + pipelines + counters" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Reasoning fabric" ] } }, "/v1/reasoning-fabric/pipeline": { "post": { "summary": "Plan a reasoning pipeline (ordered Runtime handoffs)", "operationId": "planReasoningFabricPipeline", "responses": { "200": { "description": "Pipeline + routed steps" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Reasoning fabric" ] } }, "/v1/reasoning-fabric/products": { "get": { "summary": "Reasoning Fabric capability catalog", "operationId": "listReasoningFabricProducts", "responses": { "200": { "description": "Reasoning router capabilities, pipelines, Runtime handoff honesty" } }, "tags": [ "Reasoning fabric" ] } }, "/v1/reasoning-fabric/replay/{id}": { "get": { "summary": "Replay a reasoning run via Reasoning Runtime", "operationId": "replayReasoningFabric", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Replayed run" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Reasoning fabric" ] } }, "/v1/reasoning-fabric/route": { "post": { "summary": "Plan reasoning routing for selected kinds", "operationId": "planReasoningFabricRoute", "responses": { "200": { "description": "Router plan" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Reasoning fabric" ] } }, "/v1/reasoning-fabric/routes": { "get": { "summary": "Reasoning Fabric routing table", "operationId": "listReasoningFabricRoutes", "responses": { "200": { "description": "kind → Runtime/Cloud handoffs" } }, "tags": [ "Reasoning fabric" ] } }, "/v1/reasoning-fabric/versions": { "get": { "summary": "Reasoning Fabric version catalog", "operationId": "listReasoningFabricVersions", "responses": { "200": { "description": "Pipeline/router/strategy versions" } }, "tags": [ "Reasoning fabric" ] } }, "/v1/reasoning-runtime/analytics": { "get": { "summary": "Reasoning Runtime analytics", "operationId": "getReasoningRuntimeAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Aggregates" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Reasoning runtime" ] } }, "/v1/reasoning-runtime/confidence": { "post": { "summary": "Confidence score", "operationId": "confidenceReasoningRuntime", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Blended confidence" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Reasoning runtime" ] } }, "/v1/reasoning-runtime/decision-tree": { "post": { "summary": "Sandbox decision tree", "operationId": "decisionTreeReasoningRuntime", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Decision tree façade" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Reasoning runtime" ] } }, "/v1/reasoning-runtime/engine": { "get": { "summary": "Reasoning Runtime catalog", "operationId": "getReasoningRuntimeEngine", "responses": { "200": { "description": "Kernel reasoning capabilities and honesty" } }, "tags": [ "Reasoning runtime" ] } }, "/v1/reasoning-runtime/evaluate": { "post": { "summary": "Self-evaluate answer", "operationId": "evaluateReasoningRuntime", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Heuristic evaluation" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Reasoning runtime" ] } }, "/v1/reasoning-runtime/history": { "get": { "summary": "Reasoning history", "operationId": "listReasoningRuntimeHistory", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Stored runs" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Reasoning runtime" ] } }, "/v1/reasoning-runtime/history/{id}": { "get": { "summary": "Replay reasoning run", "operationId": "replayReasoningRuntime", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Stored run payload" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Reasoning runtime" ] } }, "/v1/reasoning-runtime/monitoring": { "get": { "summary": "Reasoning Runtime monitoring", "operationId": "getReasoningRuntimeMonitoring", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Monitoring + honesty" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Reasoning runtime" ] } }, "/v1/reasoning-runtime/plan": { "post": { "summary": "Plan via Reasoning Runtime", "operationId": "planReasoningRuntime", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Plan steps" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Reasoning runtime" ] } }, "/v1/reasoning-runtime/reason": { "post": { "summary": "Run kernel reasoning", "operationId": "reasonReasoningRuntime", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Reasoned answer + eval/confidence" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Reasoning runtime" ] } }, "/v1/reasoning-runtime/reflect": { "post": { "summary": "Reflect on an answer", "operationId": "reflectReasoningRuntime", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Heuristic critiques" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Reasoning runtime" ] } }, "/v1/reasoning-runtime/select-model": { "post": { "summary": "Select model via AI Router", "operationId": "selectModelReasoningRuntime", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Model selection" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Reasoning runtime" ] } }, "/v1/reasoning-runtime/select-tools": { "post": { "summary": "Select tools (no execution)", "operationId": "selectToolsReasoningRuntime", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Suggested tool ids" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Reasoning runtime" ] } }, "/v1/recommendation-engine/analytics": { "get": { "summary": "Recommendation Engine analytics", "operationId": "getRecommendationEngineAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Recommend audit aggregates" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Recommendation engine" ] } }, "/v1/recommendation-engine/engine": { "get": { "summary": "Recommendation Engine catalog", "operationId": "getRecommendationEngine", "responses": { "200": { "description": "Kinds and retail-recommender honesty notes" } }, "tags": [ "Recommendation engine" ] } }, "/v1/recommendation-engine/kinds": { "get": { "summary": "Recommendable kinds", "operationId": "listRecommendationEngineKinds", "responses": { "200": { "description": "Supported recommendation kinds" } }, "tags": [ "Recommendation engine" ] } }, "/v1/recommendation-engine/monitoring": { "get": { "summary": "Recommendation Engine monitoring snapshot", "operationId": "getRecommendationEngineMonitoring", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Monitoring snapshot" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Recommendation engine" ] } }, "/v1/recommendation-engine/recommend": { "post": { "summary": "Rank recommendations", "operationId": "recommendRecommendationEngine", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Scored items from light rankers" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Recommendation engine" ] } }, "/v1/regional-language-registry/engine": { "get": { "operationId": "regionalLanguageRegistryEngine", "summary": "Engine", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } } }, "tags": [ "Regional language registry" ] } }, "/v1/regional-language-registry/languages": { "get": { "operationId": "regionalLanguageRegistryLanguages", "summary": "Languages", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "region", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Regional language registry" ] } }, "/v1/regional-language-registry/monitoring": { "get": { "operationId": "regionalLanguageRegistryMonitoring", "summary": "Monitoring", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } } }, "tags": [ "Regional language registry" ] } }, "/v1/regional-language-registry/products": { "get": { "operationId": "regionalLanguageRegistryProducts", "summary": "Products", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } } }, "tags": [ "Regional language registry" ] } }, "/v1/regional-language-registry/regions": { "get": { "operationId": "regionalLanguageRegistryRegions", "summary": "Regions", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } } }, "tags": [ "Regional language registry" ] } }, "/v1/regions": { "get": { "summary": "List residency islands (public)", "operationId": "listRegions", "responses": { "200": { "description": "Catalog of US/EU islands; each is a separate deploy + database (not a mesh)" } }, "tags": [ "Regions" ] } }, "/v1/registry": { "get": { "summary": "Enterprise Language Registry overview", "operationId": "registryOverview", "responses": { "200": { "description": "Counts and links" } }, "tags": [ "Registry" ] } }, "/v1/registry/alphabets": { "get": { "summary": "List alphabet writing systems", "operationId": "listAlphabets", "responses": { "200": { "description": "kind=alphabet subset" } }, "tags": [ "Registry" ] } }, "/v1/registry/analytics": { "get": { "summary": "Registry coverage analytics", "operationId": "registryAnalytics", "responses": { "200": { "description": "Counts by tier/family/script/rule kind" } }, "tags": [ "Registry" ] } }, "/v1/registry/families": { "get": { "summary": "List language families", "operationId": "listLanguageFamilies", "responses": { "200": { "description": "Families" } }, "tags": [ "Registry" ] } }, "/v1/registry/families/{code}": { "get": { "operationId": "registryFamily", "summary": "Family", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Registry" ], "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/registry/health": { "get": { "summary": "Registry integrity monitoring", "operationId": "registryHealth", "responses": { "200": { "description": "ok or degraded with issues" } }, "tags": [ "Registry" ] } }, "/v1/registry/rules": { "get": { "summary": "List linguistic rules (pronunciation/grammar/phonetic/morphology)", "operationId": "listLinguisticRules", "parameters": [ { "name": "kind", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "language", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Curated rule catalog" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Registry" ] } }, "/v1/registry/rules/{code}": { "get": { "operationId": "registryRule", "summary": "Rule", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Registry" ], "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/registry/scripts": { "get": { "summary": "List writing systems / scripts", "operationId": "listScripts", "parameters": [ { "name": "kind", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "alphabet", "abjad", "abugida", "syllabary", "logographic", "other" ] } } ], "responses": { "200": { "description": "ISO 15924 writing systems" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Registry" ] } }, "/v1/registry/scripts/{code}": { "get": { "operationId": "registryScript", "summary": "Script", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Registry" ], "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/registry/validate": { "post": { "summary": "Validate registry codes", "operationId": "validateRegistry", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "language": { "type": "string" }, "dialect": { "type": "string" }, "accent": { "type": "string" }, "locale": { "type": "string" }, "script": { "type": "string" }, "family": { "type": "string" }, "rule": { "type": "string" }, "bcp47": { "type": "string" } } } } } }, "responses": { "200": { "description": "Validation result" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Registry" ] } }, "/v1/registry/writing-systems": { "get": { "operationId": "registryWritingSystems", "summary": "Writing systems", "parameters": [ { "name": "kind", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Registry" ] } }, "/v1/registry/writing-systems/{code}": { "get": { "operationId": "registryWritingSystem", "summary": "Writing system", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Registry" ], "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/relay/bookings": { "get": { "operationId": "relayListBookings", "summary": "List bookings", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Relay" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/relay/bookings/{id}": { "get": { "operationId": "relayGetBooking", "summary": "Get booking", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Relay" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/relay/bookings/{id}/cancel": { "post": { "operationId": "relayCancel", "summary": "Cancel", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Relay" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/relay/bookings/{id}/complete": { "post": { "operationId": "relayComplete", "summary": "Complete", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Relay" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/relay/bookings/{id}/context-grants": { "post": { "operationId": "relayContextGrant", "summary": "Context grant", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Relay" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/relay/bookings/{id}/context-grants/{grantId}/revoke": { "post": { "operationId": "relayRevokeGrant", "summary": "Revoke grant", "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Relay" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "grantId", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/relay/bookings/{id}/corrections": { "post": { "operationId": "relaySubmitCorrection", "summary": "Submit correction", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Relay" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/relay/bookings/{id}/corrections/{correctionId}/review": { "post": { "operationId": "relayReviewCorrection", "summary": "Review correction", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Relay" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "correctionId", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/relay/bookings/{id}/disputes": { "post": { "operationId": "relayDispute", "summary": "Dispute", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Relay" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/relay/bookings/{id}/extensions": { "post": { "operationId": "relayApproveExtension", "summary": "Approve extension", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Relay" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/relay/bookings/{id}/feedback": { "post": { "operationId": "relayFeedback", "summary": "Feedback", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Relay" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/relay/bookings/{id}/join": { "post": { "operationId": "relayJoin", "summary": "Join", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Relay" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/relay/bookings/{id}/payments/mark-paid": { "post": { "operationId": "relayMarkPaid", "summary": "Mark paid", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Relay" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/relay/catalog": { "get": { "operationId": "relayCatalog", "summary": "Catalog", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Relay" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/relay/coverage": { "get": { "operationId": "relayCoverage", "summary": "Coverage", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Relay" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/relay/interpreters": { "post": { "operationId": "relayRegisterInterpreter", "summary": "Register interpreter", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Relay" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/relay/interpreters/{id}/review": { "post": { "operationId": "relayReviewInterpreter", "summary": "Review interpreter", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Relay" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/relay/interpreters/{id}/slots": { "post": { "operationId": "relayCreateSlot", "summary": "Create slot", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Relay" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/relay/offers": { "get": { "operationId": "relayListOffers", "summary": "List offers", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Relay" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/relay/offers/{id}/accept": { "post": { "operationId": "relayAcceptOffer", "summary": "Accept offer", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Relay" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/relay/offers/{id}/decline": { "post": { "operationId": "relayDeclineOffer", "summary": "Decline offer", "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Relay" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/relay/ops/overview": { "get": { "operationId": "relayOps", "summary": "Ops", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Relay" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/relay/requests": { "post": { "operationId": "relayCreateRequest", "summary": "Create request", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Relay" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/relay/requests/{id}": { "get": { "operationId": "relayGetRequest", "summary": "Get request", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Relay" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/relay/requests/{id}/quotes/{quoteId}/accept": { "post": { "operationId": "relayAcceptQuote", "summary": "Accept quote", "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Relay" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "quoteId", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/relay/slots": { "get": { "operationId": "relaySlots", "summary": "Slots", "parameters": [ { "name": "corridorId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Relay" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/release-engineering/engine": { "get": { "summary": "Release Engineering engine", "operationId": "getReleaseEngineeringEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Release engineering" ] } }, "/v1/release-engineering/monitoring": { "get": { "summary": "Release Engineering monitoring", "operationId": "getReleaseEngineeringMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Release engineering" ] } }, "/v1/release-engineering/products": { "get": { "summary": "Release Engineering products", "operationId": "listReleaseEngineeringProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Release engineering" ] } }, "/v1/release-engineering/query": { "get": { "summary": "Query Release Engineering", "operationId": "queryReleaseEngineering", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Release engineering" ] } }, "/v1/release-engineering/releases": { "get": { "summary": "List Release Engineering rows", "operationId": "listReleaseEngineeringRows", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Release engineering" ] } }, "/v1/reliability-engineering/engine": { "get": { "summary": "Reliability Engineering engine", "operationId": "getReliabilityEngineeringEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Reliability engineering" ] } }, "/v1/reliability-engineering/monitoring": { "get": { "summary": "Reliability Engineering monitoring", "operationId": "getReliabilityEngineeringMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Reliability engineering" ] } }, "/v1/reliability-engineering/products": { "get": { "summary": "Reliability Engineering products", "operationId": "listReliabilityEngineeringProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Reliability engineering" ] } }, "/v1/reliability-engineering/query": { "get": { "summary": "Query Reliability Engineering", "operationId": "queryReliabilityEngineering", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Reliability engineering" ] } }, "/v1/reliability-engineering/reliability": { "get": { "summary": "List Reliability Engineering rows", "operationId": "listReliabilityEngineeringRows", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Reliability engineering" ] } }, "/v1/repository-standards/engine": { "get": { "summary": "Repository Standards engine", "operationId": "getRepositoryStandardsEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Repository standards" ] } }, "/v1/repository-standards/execute": { "get": { "summary": "Execute via Repository Standards", "operationId": "executeRepositoryStandards", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Repository standards" ] } }, "/v1/repository-standards/monitoring": { "get": { "summary": "Repository Standards monitoring", "operationId": "getRepositoryStandardsMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Repository standards" ] } }, "/v1/repository-standards/products": { "get": { "summary": "Repository Standards products", "operationId": "listRepositoryStandardsProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Repository standards" ] } }, "/v1/repository-standards/query": { "get": { "summary": "Query Repository Standards", "operationId": "queryRepositoryStandards", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Repository standards" ] } }, "/v1/repository-standards/route": { "get": { "summary": "Route via Repository Standards", "operationId": "routeRepositoryStandards", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Repository standards" ] } }, "/v1/repository-standards/routes": { "get": { "summary": "Repository Standards routes", "operationId": "listRepositoryStandardsRoutes", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Repository standards" ] } }, "/v1/research-analytics/engine": { "get": { "summary": "Research Analytics engine catalog", "operationId": "getResearchAnalyticsEngine", "responses": { "200": { "description": "Research Analytics catalog + honesty" } }, "tags": [ "Research analytics" ] } }, "/v1/research-analytics/monitoring": { "get": { "summary": "Research Analytics monitoring", "operationId": "getResearchAnalyticsMonitoring", "responses": { "200": { "description": "Monitoring snapshot" } }, "tags": [ "Research analytics" ] } }, "/v1/research-analytics/products": { "get": { "summary": "Research Analytics products", "operationId": "listResearchAnalyticsProducts", "responses": { "200": { "description": "Research Analytics products" } }, "tags": [ "Research analytics" ] } }, "/v1/research-analytics/query": { "get": { "summary": "Query Research Analytics", "operationId": "queryResearchAnalytics", "responses": { "200": { "description": "Filtered catalog rows" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Research analytics" ] } }, "/v1/research-analytics/snapshot": { "get": { "summary": "Research analytics snapshot", "operationId": "listResearchAnalyticsSnapshot", "responses": { "200": { "description": "Research analytics snapshot" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Research analytics" ] } }, "/v1/research-cloud/engine": { "get": { "summary": "Research Cloud engine catalog", "operationId": "getResearchCloudEngine", "responses": { "200": { "description": "Research Cloud catalog + honesty" } }, "tags": [ "Research cloud" ] } }, "/v1/research-cloud/monitoring": { "get": { "summary": "Research Cloud monitoring", "operationId": "getResearchCloudMonitoring", "responses": { "200": { "description": "Monitoring snapshot" } }, "tags": [ "Research cloud" ] } }, "/v1/research-cloud/overview": { "get": { "summary": "Research Cloud org overview", "operationId": "getResearchCloudOverview", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Session usage + product catalog" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Research cloud" ] } }, "/v1/research-cloud/products": { "get": { "summary": "Research Cloud products", "operationId": "listResearchCloudProducts", "responses": { "200": { "description": "Research Cloud products" } }, "tags": [ "Research cloud" ] } }, "/v1/research-cloud/routing": { "get": { "summary": "Research Cloud routing table", "operationId": "getResearchCloudRouting", "responses": { "200": { "description": "Static routing catalog" } }, "tags": [ "Research cloud" ] } }, "/v1/residency": { "get": { "operationId": "residencyPolicy", "summary": "Policy", "parameters": [ { "name": "format", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success. The body is written directly by the handler (for example audio bytes or a file download).", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Residency" ] } }, "/v1/residency/me": { "get": { "operationId": "residencyMe", "summary": "Me", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Residency" ], "security": [ { "ClerkAuth": [] } ] } }, "/v1/residency/organization": { "get": { "operationId": "residencyGetOrg", "summary": "Get org", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Residency" ], "security": [ { "ClerkAuth": [] } ] }, "patch": { "operationId": "residencyPatchOrg", "summary": "Patch org", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Residency" ], "security": [ { "ClerkAuth": [] } ] } }, "/v1/residency/select": { "get": { "operationId": "residencySelect", "summary": "Select", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "country", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "feature", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Residency" ], "security": [ { "ClerkAuth": [] } ] } }, "/v1/residency/user": { "get": { "operationId": "residencyGetUser", "summary": "Get user", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Residency" ], "security": [ { "ClerkAuth": [] } ] }, "patch": { "operationId": "residencyPatchUser", "summary": "Patch user", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Residency" ], "security": [ { "ClerkAuth": [] } ] } }, "/v1/resource-manager/engine": { "get": { "summary": "Resource Manager engine", "operationId": "getResourceManagerEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Resource manager" ] } }, "/v1/resource-manager/execute": { "get": { "summary": "Execute via Resource Manager", "operationId": "executeResourceManager", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Resource manager" ] } }, "/v1/resource-manager/monitoring": { "get": { "summary": "Resource Manager monitoring", "operationId": "getResourceManagerMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Resource manager" ] } }, "/v1/resource-manager/products": { "get": { "summary": "Resource Manager products", "operationId": "listResourceManagerProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Resource manager" ] } }, "/v1/resource-manager/query": { "get": { "summary": "Query Resource Manager", "operationId": "queryResourceManager", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Resource manager" ] } }, "/v1/resource-manager/route": { "get": { "summary": "Route via Resource Manager", "operationId": "routeResourceManager", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Resource manager" ] } }, "/v1/resource-manager/routes": { "get": { "summary": "Resource Manager routes", "operationId": "listResourceManagerRoutes", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Resource manager" ] } }, "/v1/reviews": { "get": { "summary": "List translation quality reviews", "operationId": "listReviews", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "status", "in": "query", "schema": { "type": "string", "enum": [ "pending", "accepted", "rejected" ] } }, { "name": "needsReview", "in": "query", "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "Reviews" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Reviews" ] } }, "/v1/reviews/{id}/accept": { "post": { "summary": "Accept a review (optionally add to TM)", "operationId": "acceptReview", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Accepted" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Reviews" ] } }, "/v1/reviews/{id}/reject": { "post": { "summary": "Reject a review", "operationId": "rejectReview", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Rejected" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Reviews" ] } }, "/v1/risk-intelligence/engine": { "get": { "summary": "Risk Intelligence engine", "operationId": "getRiskIntelligenceEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Risk intelligence" ] } }, "/v1/risk-intelligence/monitoring": { "get": { "summary": "Risk Intelligence monitoring", "operationId": "getRiskIntelligenceMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Risk intelligence" ] } }, "/v1/risk-intelligence/products": { "get": { "summary": "Risk Intelligence products", "operationId": "listRiskIntelligenceProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Risk intelligence" ] } }, "/v1/risk-intelligence/query": { "get": { "summary": "Query Risk Intelligence", "operationId": "queryRiskIntelligence", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Risk intelligence" ] } }, "/v1/risk-intelligence/scores": { "get": { "summary": "List Risk Intelligence rows", "operationId": "listRiskIntelligenceRows", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Risk intelligence" ] } }, "/v1/runtime-manager/engine": { "get": { "summary": "Runtime Manager engine", "operationId": "getRuntimeManagerEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Runtime manager" ] } }, "/v1/runtime-manager/execute": { "get": { "summary": "Execute via Runtime Manager", "operationId": "executeRuntimeManager", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Runtime manager" ] } }, "/v1/runtime-manager/monitoring": { "get": { "summary": "Runtime Manager monitoring", "operationId": "getRuntimeManagerMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Runtime manager" ] } }, "/v1/runtime-manager/products": { "get": { "summary": "Runtime Manager products", "operationId": "listRuntimeManagerProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Runtime manager" ] } }, "/v1/runtime-manager/query": { "get": { "summary": "Query Runtime Manager", "operationId": "queryRuntimeManager", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Runtime manager" ] } }, "/v1/runtime-manager/route": { "get": { "summary": "Route via Runtime Manager", "operationId": "routeRuntimeManager", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Runtime manager" ] } }, "/v1/runtime-manager/routes": { "get": { "summary": "Runtime Manager routes", "operationId": "listRuntimeManagerRoutes", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Runtime manager" ] } }, "/v1/secrets-certificate-platform/audit": { "get": { "summary": "Secrets & Certificate Platform audit", "operationId": "listSecretsCertificatePlatformAudit", "responses": { "200": { "description": "OK" } }, "tags": [ "Secrets certificate platform" ] } }, "/v1/secrets-certificate-platform/engine": { "get": { "summary": "Secrets & Certificate Platform engine", "operationId": "getSecretsCertificatePlatformEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Secrets certificate platform" ] } }, "/v1/secrets-certificate-platform/metadata": { "get": { "summary": "Secrets & Certificate Platform metadata", "operationId": "listSecretsCertificatePlatformMetadata", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Secrets certificate platform" ] } }, "/v1/secrets-certificate-platform/monitoring": { "get": { "summary": "Secrets & Certificate Platform monitoring", "operationId": "getSecretsCertificatePlatformMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Secrets certificate platform" ] } }, "/v1/secrets-certificate-platform/products": { "get": { "summary": "Secrets & Certificate Platform products", "operationId": "listSecretsCertificatePlatformProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Secrets certificate platform" ] } }, "/v1/secrets-certificate-platform/query": { "get": { "summary": "Query Secrets & Certificate Platform", "operationId": "querySecretsCertificatePlatform", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Secrets certificate platform" ] } }, "/v1/secrets-certificate-platform/secrets": { "get": { "summary": "Secrets & Certificate Platform secrets metadata", "operationId": "listSecretsCertificatePlatformSecrets", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Secrets certificate platform" ] } }, "/v1/service-catalog/engine": { "get": { "summary": "Service Catalog engine", "operationId": "getServiceCatalogEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Service catalog" ] } }, "/v1/service-catalog/monitoring": { "get": { "summary": "Service Catalog monitoring", "operationId": "getServiceCatalogMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Service catalog" ] } }, "/v1/service-catalog/products": { "get": { "summary": "Service Catalog products", "operationId": "listServiceCatalogProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Service catalog" ] } }, "/v1/service-catalog/query": { "get": { "summary": "Query Service Catalog", "operationId": "queryServiceCatalog", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Service catalog" ] } }, "/v1/service-catalog/services": { "get": { "summary": "List Service Catalog rows", "operationId": "listServiceCatalogRows", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Service catalog" ] } }, "/v1/speakers/diarize": { "post": { "summary": "Diarize speakers (gap-based over Whisper segments)", "operationId": "diarizeSpeech", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Speaker turns and labels" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speakers" ] } }, "/v1/speakers/diarize/stream": { "post": { "operationId": "speakerIntelligenceDiarizeStream", "summary": "Diarize stream", "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "properties": {}, "additionalProperties": { "type": "string", "format": "binary" } } } } }, "responses": { "201": { "description": "Success. The body is written directly by the handler (for example audio bytes or a file download).", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speakers" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/speakers/engine": { "get": { "summary": "Speaker Intelligence engine catalog", "operationId": "getSpeakerEngine", "responses": { "200": { "description": "Speaker capabilities and honesty notes" } }, "tags": [ "Speakers" ] } }, "/v1/speakers/history": { "get": { "operationId": "speakerIntelligenceHistory", "summary": "History", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speakers" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/speakers/identify": { "post": { "summary": "Identify speaker (1:N)", "operationId": "identifySpeaker", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Top candidates and decision" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speakers" ] } }, "/v1/speakers/profiles": { "get": { "summary": "List speaker profiles", "operationId": "listSpeakerProfiles", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Workspace speaker profiles" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speakers" ] }, "post": { "summary": "Create speaker profile", "operationId": "createSpeakerProfile", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Created profile" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speakers" ] } }, "/v1/speakers/profiles/{id}": { "get": { "operationId": "speakerIntelligenceGetProfile", "summary": "Get profile", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speakers" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/speakers/profiles/{id}/enroll": { "post": { "operationId": "speakerIntelligenceEnroll", "summary": "Enroll", "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "properties": {}, "additionalProperties": { "type": "string", "format": "binary" } } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speakers" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/speakers/verify": { "post": { "summary": "Verify speaker (1:1)", "operationId": "verifySpeaker", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Match score and decision" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speakers" ] } }, "/v1/speech-analytics/accuracy": { "get": { "operationId": "speechAnalyticsAccuracy", "summary": "Accuracy", "parameters": [ { "name": "to", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speech analytics" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/speech-analytics/costs": { "get": { "operationId": "speechAnalyticsCosts", "summary": "Costs", "parameters": [ { "name": "to", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speech analytics" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/speech-analytics/customers": { "get": { "operationId": "speechAnalyticsCustomers", "summary": "Customers", "parameters": [ { "name": "to", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speech analytics" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/speech-analytics/dialects": { "get": { "operationId": "speechAnalyticsDialects", "summary": "Dialects", "parameters": [ { "name": "to", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speech analytics" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/speech-analytics/engine": { "get": { "summary": "Speech Analytics engine catalog", "operationId": "getSpeechAnalyticsEngine", "responses": { "200": { "description": "Speech analytics capabilities" } }, "tags": [ "Speech analytics" ] } }, "/v1/speech-analytics/errors": { "get": { "operationId": "speechAnalyticsErrors", "summary": "Errors", "parameters": [ { "name": "to", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speech analytics" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/speech-analytics/industries": { "get": { "operationId": "speechAnalyticsIndustries", "summary": "Industries", "parameters": [ { "name": "to", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speech analytics" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/speech-analytics/languages": { "get": { "operationId": "speechAnalyticsLanguages", "summary": "Languages", "parameters": [ { "name": "to", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speech analytics" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/speech-analytics/latency": { "get": { "operationId": "speechAnalyticsLatency", "summary": "Latency", "parameters": [ { "name": "to", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speech analytics" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/speech-analytics/monitoring": { "get": { "summary": "Speech Analytics monitoring snapshot", "operationId": "getSpeechAnalyticsMonitoring", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Monitoring snapshot" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speech analytics" ] } }, "/v1/speech-analytics/overview": { "get": { "summary": "Speech Analytics overview", "operationId": "getSpeechAnalyticsOverview", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Usage + cost snapshot" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speech analytics" ] } }, "/v1/speech-analytics/report": { "get": { "summary": "Bundled Speech Analytics report", "operationId": "getSpeechAnalyticsReport", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Enterprise speech report JSON" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speech analytics" ] } }, "/v1/speech-analytics/usage": { "get": { "summary": "Speech STT/TTS usage", "operationId": "getSpeechAnalyticsUsage", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "STT/TTS usage aggregates" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speech analytics" ] } }, "/v1/speech-embed": { "post": { "summary": "Create a site speech player embed", "operationId": "createSpeechEmbed", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "text", "voice" ], "properties": { "title": { "type": "string" }, "text": { "type": "string" }, "voice": { "type": "string" }, "language": { "type": "string" } } } } } }, "responses": { "200": { "description": "Embed project, player URL, and HTML snippet" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speech embed" ] } }, "/v1/speech-embed/{id}": { "get": { "summary": "Public speech embed project metadata", "operationId": "getSpeechEmbed", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Title, text, voice, language for the player" }, "404": { "description": "Not found" } }, "tags": [ "Speech embed" ] } }, "/v1/speech-embed/{id}/audio": { "post": { "summary": "Synthesize audio for a speech embed", "operationId": "synthesizeSpeechEmbedAudio", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "MP3 audio bytes", "content": { "audio/mpeg": { "schema": { "type": "string", "format": "binary" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speech embed" ] } }, "/v1/speech-review": { "get": { "operationId": "speechReviewList", "summary": "List", "parameters": [ { "name": "locale", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speech review" ], "security": [ { "ClerkAuth": [] } ], "x-lugemi-access": "platform-admin" }, "post": { "operationId": "speechReviewSubmit", "summary": "Submit", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speech review" ], "security": [ { "ClerkAuth": [] } ], "x-lugemi-access": "platform-admin" } }, "/v1/speech-review/approved": { "get": { "operationId": "speechReviewApproved", "summary": "Approved", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Platform admin access required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speech review" ], "security": [ { "ClerkAuth": [] } ], "x-lugemi-access": "platform-admin" } }, "/v1/speech-runtime/engine": { "get": { "summary": "Speech Runtime engine", "operationId": "getSpeechRuntimeEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Speech runtime" ] } }, "/v1/speech-runtime/execute": { "get": { "summary": "Execute via Speech Runtime", "operationId": "executeSpeechRuntime", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speech runtime" ] } }, "/v1/speech-runtime/monitoring": { "get": { "summary": "Speech Runtime monitoring", "operationId": "getSpeechRuntimeMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Speech runtime" ] } }, "/v1/speech-runtime/products": { "get": { "summary": "Speech Runtime products", "operationId": "listSpeechRuntimeProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Speech runtime" ] } }, "/v1/speech-runtime/query": { "get": { "summary": "Query Speech Runtime", "operationId": "querySpeechRuntime", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speech runtime" ] } }, "/v1/speech-runtime/route": { "get": { "summary": "Route via Speech Runtime", "operationId": "routeSpeechRuntime", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speech runtime" ] } }, "/v1/speech-runtime/routes": { "get": { "summary": "Speech Runtime routes", "operationId": "listSpeechRuntimeRoutes", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speech runtime" ] } }, "/v1/speech/capabilities": { "get": { "summary": "Native Speech Engine capability registry", "operationId": "nativeSpeechEngineCapabilities", "tags": [ "Native Speech Engine" ], "responses": { "200": { "description": "Task/variety manifests with verification status, honesty rules, and demo-safe remaps" } } } }, "/v1/speech/diagnose": { "post": { "summary": "Diagnose beep/echo/unintelligible speech payloads", "operationId": "nativeSpeechEngineDiagnose", "tags": [ "Native Speech Engine" ], "responses": { "200": { "description": "Layered diagnosis (weights/payload/codec/capability)" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/speech/engine": { "get": { "summary": "Speech Recognition Engine catalog", "operationId": "getSpeechEngine", "responses": { "200": { "description": "Capabilities, engines, and deployment honesty notes" } }, "tags": [ "Speech" ] } }, "/v1/speech/engine/analytics": { "get": { "operationId": "speechRecognitionAnalytics", "summary": "Analytics", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speech" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/speech/evaluation": { "get": { "summary": "Native review dimensions and fine-tune honesty", "operationId": "nativeSpeechEngineEvaluation", "tags": [ "Native Speech Engine" ], "responses": { "200": { "description": "Native-speaker evaluation plan; fine-tuning never auto-ingests private speech" } } } }, "/v1/speech/overview": { "get": { "summary": "Speech Cloud org overview", "operationId": "getSpeechOverview", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Session usage, products, deferred flags, and console links" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speech" ] } }, "/v1/speech/products": { "get": { "summary": "Speech Cloud product catalog", "operationId": "listSpeechProducts", "responses": { "200": { "description": "Speech products and architecture honesty notes", "content": { "application/json": { "schema": { "type": "object", "properties": { "products": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "status": { "type": "string", "enum": [ "shipped", "partial", "deferred" ] }, "api": { "type": "string", "nullable": true }, "console": { "type": "string", "nullable": true }, "notes": { "type": "string" } } } }, "architecture": { "type": "object" }, "docs": { "type": "string" } } } } } } }, "tags": [ "Speech" ] } }, "/v1/speech/recognitions": { "post": { "summary": "Recognize speech with advisory dialect/accent cues", "operationId": "nativeSpeechEngineRecognize", "tags": [ "Native Speech Engine" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Transcript + optional source-variety clarification (never nationality inference)" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/speech/recognize": { "post": { "summary": "Recognize speech (batch STT with segments)", "operationId": "recognizeSpeech", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "required": [ "file" ], "properties": { "file": { "type": "string", "format": "binary" }, "language": { "type": "string", "description": "Optional ISO-639-1; omit to auto-detect" }, "industryPacks": { "type": "string", "description": "Comma-separated: medical,legal,financial,government" }, "vocabulary": { "type": "string", "description": "Comma-separated custom phrases" } } } } } }, "responses": { "200": { "description": "Transcript with segments, timestamps, confidence" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speech" ] } }, "/v1/speech/speech-translations": { "post": { "summary": "Speech translation corridor (ASR → MT → target TTS)", "operationId": "nativeSpeechEngineSpeechTranslate", "tags": [ "Native Speech Engine" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Source accent is not copied into the target variety by default" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/speech/stream": { "post": { "summary": "Stream speech recognition events (SSE segment stream)", "operationId": "streamSpeechRecognition", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "required": [ "file" ], "properties": { "file": { "type": "string", "format": "binary" }, "language": { "type": "string" }, "industryPacks": { "type": "string" } } } } } }, "responses": { "200": { "description": "text/event-stream with start, segment, done events" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speech" ] } }, "/v1/speech/subtitles": { "post": { "summary": "Generate SRT or WebVTT subtitles from audio", "operationId": "createSpeechSubtitles", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Subtitle file content + metadata" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speech" ] } }, "/v1/speech/syntheses": { "post": { "summary": "Synthesize via Native Speech Engine (verified path)", "operationId": "nativeSpeechEngineSynthesize", "tags": [ "Native Speech Engine" ], "responses": { "200": { "description": "Audio bytes with provenance headers (or JSON when asJson=true)", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/speech/translations": { "post": { "summary": "Meaning-preserving text translation (no fabricated emotion)", "operationId": "nativeSpeechEngineTextTranslate", "tags": [ "Native Speech Engine" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Translated text with provenance" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/speech/vocabulary": { "get": { "operationId": "speechRecognitionListVocabulary", "summary": "List vocabulary", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speech" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] }, "post": { "operationId": "speechRecognitionAddVocabulary", "summary": "Add vocabulary", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speech" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/speech/vocabulary/{id}": { "delete": { "operationId": "speechRecognitionRemoveVocabulary", "summary": "Remove vocabulary", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Speech" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/speech/vocabulary/packs": { "get": { "operationId": "speechRecognitionVocabularyPacks", "summary": "Vocabulary packs", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } } }, "tags": [ "Speech" ] } }, "/v1/streaming-runtime/analytics": { "get": { "summary": "Streaming Runtime analytics", "operationId": "getStreamingRuntimeAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Session aggregates" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Streaming runtime" ] } }, "/v1/streaming-runtime/engine": { "get": { "summary": "Streaming Runtime catalog", "operationId": "getStreamingRuntimeEngine", "responses": { "200": { "description": "Capabilities, transports, and honesty flags" } }, "tags": [ "Streaming runtime" ] } }, "/v1/streaming-runtime/monitoring": { "get": { "summary": "Streaming Runtime monitoring", "operationId": "getStreamingRuntimeMonitoring", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Monitoring + honesty snapshot" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Streaming runtime" ] } }, "/v1/streaming-runtime/sessions": { "get": { "summary": "List sandbox streaming sessions", "operationId": "listStreamingSessions", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Org/workspace sessions" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Streaming runtime" ] }, "post": { "summary": "Create sandbox streaming session", "operationId": "createStreamingSession", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Session created" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Streaming runtime" ] } }, "/v1/streaming-runtime/sessions/{id}/close": { "post": { "summary": "Close sandbox streaming session", "operationId": "closeStreamingSession", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Session closed" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Streaming runtime" ] } }, "/v1/streaming-runtime/stream": { "post": { "summary": "Sandbox SSE chunk stream (or redirect to existing product SSE)", "operationId": "streamStreamingRuntime", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "text/event-stream chunk/redirect/done events" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Streaming runtime" ] } }, "/v1/streaming-runtime/surfaces": { "get": { "summary": "Streaming surfaces", "operationId": "listStreamingRuntimeSurfaces", "responses": { "200": { "description": "Speech/voice/translation/LLM/video/realtime surface map" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Streaming runtime" ] } }, "/v1/streaming-runtime/transports": { "get": { "summary": "Streaming transports", "operationId": "listStreamingRuntimeTransports", "responses": { "200": { "description": "SSE shipped; WebSocket/gRPC deferred" } }, "tags": [ "Streaming runtime" ] } }, "/v1/style/analytics": { "get": { "operationId": "styleAnalytics", "summary": "Analytics", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Style" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/style/detect": { "post": { "operationId": "styleDetect", "summary": "Detect", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Style" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/style/intelligence": { "get": { "operationId": "styleIntelligence", "summary": "Intelligence", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } } }, "tags": [ "Style" ] } }, "/v1/style/profiles": { "get": { "operationId": "styleProfiles", "summary": "Profiles", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } } }, "tags": [ "Style" ] } }, "/v1/style/rewrite": { "post": { "operationId": "styleRewrite", "summary": "Rewrite", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Style" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/style/transfer": { "post": { "operationId": "styleTransfer", "summary": "Transfer", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Style" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/style/transform": { "post": { "operationId": "styleTransform", "summary": "Transform", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Style" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/supply-chain-security/engine": { "get": { "summary": "Supply Chain Security engine", "operationId": "getSupplyChainSecurityEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Supply chain security" ] } }, "/v1/supply-chain-security/findings": { "get": { "summary": "Supply Chain Security findings", "operationId": "listSupplyChainSecurityFindings", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Supply chain security" ] } }, "/v1/supply-chain-security/monitoring": { "get": { "summary": "Supply Chain Security monitoring", "operationId": "getSupplyChainSecurityMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Supply chain security" ] } }, "/v1/supply-chain-security/products": { "get": { "summary": "Supply Chain Security products", "operationId": "listSupplyChainSecurityProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Supply chain security" ] } }, "/v1/supply-chain-security/query": { "get": { "summary": "Query Supply Chain Security", "operationId": "querySupplyChainSecurity", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Supply chain security" ] } }, "/v1/supply-chain-security/scan": { "get": { "summary": "Scan Supply Chain Security", "operationId": "scanSupplyChainSecurity", "responses": { "200": { "description": "OK" } }, "tags": [ "Supply chain security" ] } }, "/v1/swagger": { "get": { "operationId": "openApiGetSwagger_get", "summary": "Get swagger", "responses": { "200": { "description": "Success. The body is written directly by the handler (for example audio bytes or a file download).", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } } }, "tags": [ "System" ] } }, "/v1/synthetic-data-platform/artifacts": { "get": { "summary": "List synthetic artifacts", "operationId": "listSyntheticDataPlatformArtifacts", "responses": { "200": { "description": "List synthetic artifacts" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Synthetic data platform" ] } }, "/v1/synthetic-data-platform/engine": { "get": { "summary": "Synthetic Data Platform engine catalog", "operationId": "getSyntheticDataPlatformEngine", "responses": { "200": { "description": "Synthetic Data Platform catalog + honesty" } }, "tags": [ "Synthetic data platform" ] } }, "/v1/synthetic-data-platform/monitoring": { "get": { "summary": "Synthetic Data Platform monitoring", "operationId": "getSyntheticDataPlatformMonitoring", "responses": { "200": { "description": "Monitoring snapshot" } }, "tags": [ "Synthetic data platform" ] } }, "/v1/synthetic-data-platform/products": { "get": { "summary": "Synthetic Data Platform products", "operationId": "listSyntheticDataPlatformProducts", "responses": { "200": { "description": "Synthetic Data Platform products" } }, "tags": [ "Synthetic data platform" ] } }, "/v1/synthetic-data-platform/query": { "get": { "summary": "Query Synthetic Data Platform", "operationId": "querySyntheticDataPlatform", "responses": { "200": { "description": "Filtered catalog rows" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Synthetic data platform" ] } }, "/v1/taxonomy/analytics": { "get": { "operationId": "taxonomyPlatformAnalytics", "summary": "Analytics", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Taxonomy" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/taxonomy/assign": { "post": { "summary": "Assign taxonomy term to knowledge document", "operationId": "assignTaxonomyTerm", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Assignment created" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Taxonomy" ] } }, "/v1/taxonomy/classify": { "post": { "summary": "Heuristic classify document against taxonomy terms", "operationId": "classifyTaxonomyDocument", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Matched terms (optional apply)" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Taxonomy" ] } }, "/v1/taxonomy/content-types": { "get": { "summary": "Taxonomy content types", "operationId": "listTaxonomyContentTypes", "responses": { "200": { "description": "EKB-aligned content kinds" } }, "tags": [ "Taxonomy" ] } }, "/v1/taxonomy/engine": { "get": { "summary": "Taxonomy Platform engine catalog", "operationId": "getTaxonomyEngine", "responses": { "200": { "description": "Taxonomy capabilities and honesty flags" } }, "tags": [ "Taxonomy" ] } }, "/v1/taxonomy/monitoring": { "get": { "operationId": "taxonomyPlatformMonitoring", "summary": "Monitoring", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Taxonomy" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/taxonomy/terms": { "get": { "summary": "List taxonomy terms", "operationId": "listTaxonomyTerms", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Workspace-scoped terms" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Taxonomy" ] }, "post": { "summary": "Create taxonomy term", "operationId": "createTaxonomyTerm", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Created term" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Taxonomy" ] } }, "/v1/taxonomy/terms/{id}": { "delete": { "operationId": "taxonomyPlatformRemove", "summary": "Remove", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Taxonomy" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] }, "get": { "operationId": "taxonomyPlatformGet", "summary": "Get", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Taxonomy" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/taxonomy/terms/{id}/children": { "get": { "operationId": "taxonomyPlatformChildren", "summary": "Children", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Taxonomy" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/taxonomy/trees": { "get": { "summary": "Taxonomy trees (roots + one child level)", "operationId": "listTaxonomyTrees", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Knowledge trees for workspace" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Taxonomy" ] } }, "/v1/tm": { "get": { "operationId": "tmHubIntelligence", "summary": "Intelligence", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } } }, "tags": [ "TM" ] } }, "/v1/tm/analytics": { "get": { "operationId": "tmHubAnalytics", "summary": "Analytics", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "TM" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/tm/entries": { "get": { "summary": "List translation memory entries", "operationId": "listTmEntries", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Approved TM segments" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "TM" ] }, "post": { "summary": "Upsert approved TM segment", "operationId": "upsertTmEntry", "security": [ { "ClerkAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "sourceLang", "targetLang", "sourceText", "targetText" ], "properties": { "sourceLang": { "type": "string" }, "targetLang": { "type": "string" }, "sourceText": { "type": "string" }, "targetText": { "type": "string" } } } } } }, "responses": { "201": { "description": "Upserted" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "TM" ] } }, "/v1/tm/entries/{id}": { "delete": { "operationId": "tmRemove", "summary": "Remove", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "TM" ], "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/tm/entries/{id}/versions": { "get": { "operationId": "tmVersions", "summary": "Versions", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "TM" ], "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/tm/history": { "get": { "operationId": "tmHubHistory", "summary": "History", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "entryId", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "TM" ], "security": [ { "ClerkAuth": [] } ] } }, "/v1/tm/search": { "post": { "operationId": "tmHubSearch", "summary": "Search", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "TM" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/tm/terminology": { "get": { "operationId": "tmHubTerminology", "summary": "Terminology", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "TM" ], "security": [ { "ClerkAuth": [] } ] } }, "/v1/tourism-heritage-intelligence/engine": { "get": { "summary": "Tourism & Heritage Intelligence engine catalog", "operationId": "getTourismHeritageIntelligenceEngine", "responses": { "200": { "description": "Tourism & Heritage Intelligence catalog + honesty" } }, "tags": [ "Tourism heritage intelligence" ] } }, "/v1/tourism-heritage-intelligence/monitoring": { "get": { "summary": "Tourism & Heritage Intelligence monitoring", "operationId": "getTourismHeritageIntelligenceMonitoring", "responses": { "200": { "description": "Monitoring snapshot" } }, "tags": [ "Tourism heritage intelligence" ] } }, "/v1/tourism-heritage-intelligence/products": { "get": { "summary": "Tourism & Heritage Intelligence products", "operationId": "listTourismHeritageIntelligenceProducts", "responses": { "200": { "description": "Tourism & Heritage Intelligence products" } }, "tags": [ "Tourism heritage intelligence" ] } }, "/v1/tourism-heritage-intelligence/query": { "get": { "summary": "Query Tourism & Heritage Intelligence terms", "operationId": "queryTourismHeritageIntelligenceTerms", "responses": { "200": { "description": "Filtered domain terms" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Tourism heritage intelligence" ] } }, "/v1/tourism-heritage-intelligence/terms": { "get": { "summary": "List Tourism & Heritage Intelligence terms", "operationId": "listTourismHeritageIntelligenceTerms", "responses": { "200": { "description": "Domain terms" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Tourism heritage intelligence" ] } }, "/v1/training-jobs": { "get": { "summary": "List rented-GPU / manual training jobs", "operationId": "listTrainingJobs", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Jobs" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Training jobs" ] }, "post": { "summary": "Create a training job (Pro)", "operationId": "createTrainingJob", "security": [ { "ClerkAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "sourceLang", "targetLang" ], "properties": { "sourceLang": { "type": "string" }, "targetLang": { "type": "string" }, "launcher": { "type": "string", "enum": [ "manual", "modal", "vertex", "fixture" ] }, "baseModel": { "type": "string" }, "datasetAssetId": { "type": "string" } } } } } }, "responses": { "201": { "description": "Created" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Pro required" } }, "tags": [ "Training jobs" ] } }, "/v1/training-jobs/{id}": { "get": { "operationId": "trainingJobsGet", "summary": "Get", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Training jobs" ], "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/training-jobs/{id}/complete": { "post": { "summary": "Attach artifact and optionally promote (Pro)", "operationId": "completeTrainingJob", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Completed" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Training jobs" ] } }, "/v1/training-jobs/{id}/launch": { "post": { "summary": "Launch training on manual/Modal/Vertex/fixture (Pro)", "operationId": "launchTrainingJob", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "running or awaiting_gpu; returns callbackToken once" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Pro required" }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Training jobs" ] } }, "/v1/training-jobs/callback": { "post": { "summary": "Rented-GPU completion callback (token auth)", "operationId": "trainingJobCallback", "responses": { "200": { "description": "Job updated / model promoted" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid callback token" } }, "tags": [ "Training jobs" ] } }, "/v1/training-jobs/launchers": { "get": { "summary": "List training launchers and configuration status", "operationId": "listTrainingLaunchers", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "manual/modal/vertex/fixture configured flags" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Training jobs" ] } }, "/v1/training-pipeline/engine": { "get": { "summary": "Training Pipeline engine catalog", "operationId": "getTrainingPipelineEngine", "responses": { "200": { "description": "Engine catalog" } }, "tags": [ "Training pipeline" ] } }, "/v1/training-pipeline/jobs": { "get": { "summary": "List Training Pipeline jobs", "operationId": "listTrainingPipelineJobs", "responses": { "200": { "description": "Filtered catalog rows" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Training pipeline" ] } }, "/v1/training-pipeline/monitoring": { "get": { "summary": "Training Pipeline monitoring", "operationId": "getTrainingPipelineMonitoring", "responses": { "200": { "description": "Monitoring snapshot" } }, "tags": [ "Training pipeline" ] } }, "/v1/training-pipeline/products": { "get": { "summary": "Training Pipeline products alias", "operationId": "listTrainingPipelineProducts", "responses": { "200": { "description": "Engine catalog" } }, "tags": [ "Training pipeline" ] } }, "/v1/training-pipeline/query": { "get": { "summary": "Query Training Pipeline", "operationId": "queryTrainingPipeline", "responses": { "200": { "description": "Filtered catalog rows" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Training pipeline" ] } }, "/v1/translate": { "post": { "summary": "Translate text", "operationId": "translateText", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TranslateRequest" } } } }, "responses": { "200": { "description": "Translated text", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TranslateResponse" } } } }, "400": { "description": "Validation or unsupported language", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited (Retry-After)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Retry-After": { "schema": { "type": "integer" } }, "X-RateLimit-Limit": { "schema": { "type": "string" } }, "X-RateLimit-Remaining": { "schema": { "type": "string" } } } }, "503": { "description": "Provider or auth not configured", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Translate" ] } }, "/v1/translate/chat": { "post": { "summary": "Translate chat message contents", "operationId": "translateChat", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Translated messages" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Translate" ] } }, "/v1/translate/engine": { "get": { "summary": "Translation engine capability catalog (capability catalog)", "operationId": "translateEngine", "responses": { "200": { "description": "Shipped / partial / deferred capabilities" } }, "tags": [ "Translate" ] } }, "/v1/translate/formats": { "post": { "summary": "Translate HTML, Markdown, XML, CSV, or SRT content", "operationId": "translateFormat", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Format-preserving translation" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Translate" ] } }, "/v1/translate/stream": { "post": { "summary": "Stream translation as SSE chunks", "operationId": "translateStream", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "text/event-stream" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Translate" ] } }, "/v1/translation-runtime/engine": { "get": { "summary": "Translation Runtime engine", "operationId": "getTranslationRuntimeEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Translation runtime" ] } }, "/v1/translation-runtime/execute": { "get": { "summary": "Execute via Translation Runtime", "operationId": "executeTranslationRuntime", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Translation runtime" ] } }, "/v1/translation-runtime/monitoring": { "get": { "summary": "Translation Runtime monitoring", "operationId": "getTranslationRuntimeMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Translation runtime" ] } }, "/v1/translation-runtime/products": { "get": { "summary": "Translation Runtime products", "operationId": "listTranslationRuntimeProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Translation runtime" ] } }, "/v1/translation-runtime/query": { "get": { "summary": "Query Translation Runtime", "operationId": "queryTranslationRuntime", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Translation runtime" ] } }, "/v1/translation-runtime/route": { "get": { "summary": "Route via Translation Runtime", "operationId": "routeTranslationRuntime", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Translation runtime" ] } }, "/v1/translation-runtime/routes": { "get": { "summary": "Translation Runtime routes", "operationId": "listTranslationRuntimeRoutes", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Translation runtime" ] } }, "/v1/trust-analytics/engine": { "get": { "summary": "Trust Analytics engine", "operationId": "getTrustAnalyticsEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Trust analytics" ] } }, "/v1/trust-analytics/monitoring": { "get": { "summary": "Trust Analytics monitoring", "operationId": "getTrustAnalyticsMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Trust analytics" ] } }, "/v1/trust-analytics/products": { "get": { "summary": "Trust Analytics products", "operationId": "listTrustAnalyticsProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Trust analytics" ] } }, "/v1/trust-analytics/query": { "get": { "summary": "Query Trust Analytics", "operationId": "queryTrustAnalytics", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Trust analytics" ] } }, "/v1/trust-analytics/snapshot": { "get": { "summary": "List Trust Analytics rows", "operationId": "listTrustAnalyticsRows", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Trust analytics" ] } }, "/v1/trust-cloud/engine": { "get": { "summary": "Trust Cloud engine alias", "operationId": "getTrustCloudEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Trust cloud" ] } }, "/v1/trust-cloud/monitoring": { "get": { "summary": "Trust Cloud monitoring", "operationId": "getTrustCloudMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Trust cloud" ] } }, "/v1/trust-cloud/overview": { "get": { "summary": "Trust Cloud overview", "operationId": "getTrustCloudOverview", "responses": { "200": { "description": "OK" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Trust cloud" ], "security": [ { "ClerkAuth": [] } ] } }, "/v1/trust-cloud/products": { "get": { "summary": "Trust Cloud products", "operationId": "listTrustCloudProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Trust cloud" ] } }, "/v1/trust-cloud/routing": { "get": { "summary": "Trust Cloud routing", "operationId": "getTrustCloudRouting", "responses": { "200": { "description": "OK" } }, "tags": [ "Trust cloud" ] } }, "/v1/tts/engine": { "get": { "summary": "Neural TTS engine catalog", "operationId": "getNeuralTtsEngine", "responses": { "200": { "description": "Capabilities, engines, and architecture honesty notes" } }, "tags": [ "TTS" ] } }, "/v1/tts/engine/analytics": { "get": { "summary": "Neural TTS usage analytics", "operationId": "getNeuralTtsAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "TTS character usage for the billing period" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "TTS" ] } }, "/v1/tts/stream": { "post": { "summary": "Streaming neural TTS (chunk SSE after synthesis)", "operationId": "streamNeuralTts", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "text", "voice" ], "properties": { "text": { "type": "string" }, "voice": { "type": "string" }, "language": { "type": "string" }, "format": { "type": "string", "enum": [ "mp3", "wav", "opus", "aac", "flac" ] } } } } } }, "responses": { "200": { "description": "text/event-stream with meta/audio/done events" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "TTS" ] } }, "/v1/tts/synthesize": { "post": { "summary": "Batch neural text-to-speech", "operationId": "synthesizeNeuralTts", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "text", "voice" ], "properties": { "text": { "type": "string" }, "voice": { "type": "string" }, "language": { "type": "string" }, "format": { "type": "string", "enum": [ "mp3", "wav", "opus", "aac", "flac" ] } } } } } }, "responses": { "200": { "description": "Raw audio bytes", "content": { "audio/mpeg": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "TTS" ] } }, "/v1/tts/voices": { "get": { "summary": "Enriched Neural TTS voice catalog", "operationId": "listNeuralTtsVoices", "parameters": [ { "name": "gender", "in": "query", "schema": { "type": "string" } }, { "name": "language", "in": "query", "schema": { "type": "string" } }, { "name": "personality", "in": "query", "schema": { "type": "string" } }, { "name": "category", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Voices with gender, personality, dialect/accent tags" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "TTS" ] } }, "/v1/tts/voices/workspace": { "get": { "summary": "Neural TTS voices including approved workspace clones", "operationId": "listNeuralTtsWorkspaceVoices", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Stock + own + approved clone voices" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "TTS" ] } }, "/v1/usage/summary": { "get": { "summary": "Month-to-date usage summary", "operationId": "getUsageSummary", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Usage summary", "content": { "application/json": { "schema": { "type": "object", "properties": { "periodStart": { "type": "string", "format": "date-time" }, "requests": { "type": "integer" }, "characters": { "type": "integer" } } } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Usage" ] } }, "/v1/vaios/engine": { "get": { "summary": "VAIOS engine alias", "operationId": "getVaiosEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "VAIOS" ] } }, "/v1/vaios/monitoring": { "get": { "summary": "VAIOS monitoring", "operationId": "getVaiosMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "VAIOS" ] } }, "/v1/vaios/overview": { "get": { "summary": "VAIOS overview", "operationId": "getVaiosOverview", "responses": { "200": { "description": "OK" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "VAIOS" ], "security": [ { "ClerkAuth": [] } ] } }, "/v1/vaios/products": { "get": { "summary": "VAIOS products", "operationId": "listVaiosProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "VAIOS" ] } }, "/v1/vaios/routing": { "get": { "summary": "VAIOS routing", "operationId": "getVaiosRouting", "responses": { "200": { "description": "OK" } }, "tags": [ "VAIOS" ] } }, "/v1/vector-cloud/analytics": { "get": { "summary": "Vector Cloud analytics", "operationId": "getVectorCloudAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Search audit + inventory aggregates" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Vector cloud" ] } }, "/v1/vector-cloud/collections": { "get": { "summary": "Vector collections inventory", "operationId": "listVectorCloudCollections", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Workspace knowledge collection" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Vector cloud" ] } }, "/v1/vector-cloud/engine": { "get": { "summary": "Vector Cloud engine catalog", "operationId": "getVectorCloudEngine", "responses": { "200": { "description": "Vector capabilities and honesty notes" } }, "tags": [ "Vector cloud" ] } }, "/v1/vector-cloud/indexes": { "get": { "summary": "Vector indexes", "operationId": "listVectorCloudIndexes", "responses": { "200": { "description": "pgvector HNSW index catalog" } }, "tags": [ "Vector cloud" ] } }, "/v1/vector-cloud/monitoring": { "get": { "summary": "Vector Cloud monitoring snapshot", "operationId": "getVectorCloudMonitoring", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Monitoring snapshot" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Vector cloud" ] } }, "/v1/vector-cloud/namespaces": { "get": { "summary": "Vector namespaces", "operationId": "listVectorCloudNamespaces", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Workspace as vector namespace" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Vector cloud" ] } }, "/v1/vector-cloud/search": { "post": { "summary": "Nearest-neighbor vector search", "operationId": "searchVectorCloud", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Ranked cosine hits over knowledge_chunks" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Vector cloud" ] } }, "/v1/vector-cloud/stats": { "get": { "summary": "Vector inventory stats", "operationId": "getVectorCloudStats", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Document/vector counts" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Vector cloud" ] } }, "/v1/vertical-glossaries": { "get": { "summary": "List platform vertical glossary packs", "operationId": "listVerticalGlossaries", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Catalog with preview terms; full terms only after Pro install" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Vertical glossaries" ] } }, "/v1/vertical-glossaries/{id}": { "get": { "summary": "Get a vertical glossary pack", "operationId": "getVerticalGlossary", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Pack detail (full terms if Pro or installed)" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found" } }, "tags": [ "Vertical glossaries" ] } }, "/v1/vertical-glossaries/{id}/install": { "post": { "summary": "Install a vertical glossary pack into the workspace (Pro)", "operationId": "installVerticalGlossary", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Terms copied into workspace glossary" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Pro plan required" }, "403": { "description": "Owner/admin required" }, "404": { "description": "Pack not found" } }, "tags": [ "Vertical glossaries" ] } }, "/v1/vertical-glossaries/installs": { "get": { "summary": "List vertical glossary installs for the workspace", "operationId": "listVerticalGlossaryInstalls", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Install receipts" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Vertical glossaries" ] } }, "/v1/vision-runtime/engine": { "get": { "summary": "Vision Runtime engine", "operationId": "getVisionRuntimeEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Vision runtime" ] } }, "/v1/vision-runtime/execute": { "get": { "summary": "Execute via Vision Runtime", "operationId": "executeVisionRuntime", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Vision runtime" ] } }, "/v1/vision-runtime/monitoring": { "get": { "summary": "Vision Runtime monitoring", "operationId": "getVisionRuntimeMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Vision runtime" ] } }, "/v1/vision-runtime/products": { "get": { "summary": "Vision Runtime products", "operationId": "listVisionRuntimeProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Vision runtime" ] } }, "/v1/vision-runtime/query": { "get": { "summary": "Query Vision Runtime", "operationId": "queryVisionRuntime", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Vision runtime" ] } }, "/v1/vision-runtime/route": { "get": { "summary": "Route via Vision Runtime", "operationId": "routeVisionRuntime", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Vision runtime" ] } }, "/v1/vision-runtime/routes": { "get": { "summary": "Vision Runtime routes", "operationId": "listVisionRuntimeRoutes", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Vision runtime" ] } }, "/v1/voice-analytics/customers": { "get": { "operationId": "voiceAnalyticsCustomers", "summary": "Customers", "parameters": [ { "name": "to", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice analytics" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/voice-analytics/downloads": { "get": { "operationId": "voiceAnalyticsDownloads", "summary": "Downloads", "parameters": [ { "name": "to", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice analytics" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/voice-analytics/engine": { "get": { "summary": "Voice Analytics engine catalog", "operationId": "getVoiceAnalyticsEngine", "responses": { "200": { "description": "Voice analytics capabilities" } }, "tags": [ "Voice analytics" ] } }, "/v1/voice-analytics/languages": { "get": { "operationId": "voiceAnalyticsLanguages", "summary": "Languages", "parameters": [ { "name": "to", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice analytics" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/voice-analytics/latency": { "get": { "operationId": "voiceAnalyticsLatency", "summary": "Latency", "parameters": [ { "name": "to", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice analytics" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/voice-analytics/marketplace": { "get": { "summary": "Voice Marketplace analytics slice", "operationId": "getVoiceAnalyticsMarketplace", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Marketplace aggregates" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice analytics" ] } }, "/v1/voice-analytics/monitoring": { "get": { "summary": "Voice Analytics monitoring snapshot", "operationId": "getVoiceAnalyticsMonitoring", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Monitoring snapshot" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice analytics" ] } }, "/v1/voice-analytics/overview": { "get": { "summary": "Voice Analytics overview", "operationId": "getVoiceAnalyticsOverview", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Usage + revenue snapshot" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice analytics" ] } }, "/v1/voice-analytics/quality": { "get": { "operationId": "voiceAnalyticsQuality", "summary": "Quality", "parameters": [ { "name": "to", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice analytics" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/voice-analytics/report": { "get": { "summary": "Bundled Voice Analytics report", "operationId": "getVoiceAnalyticsReport", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Enterprise voice report JSON" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice analytics" ] } }, "/v1/voice-analytics/revenue": { "get": { "summary": "Voice Marketplace revenue", "operationId": "getVoiceAnalyticsRevenue", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Publisher sale aggregates" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice analytics" ] } }, "/v1/voice-analytics/streaming": { "get": { "operationId": "voiceAnalyticsStreaming", "summary": "Streaming", "parameters": [ { "name": "to", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice analytics" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/voice-analytics/usage": { "get": { "summary": "Voice TTS usage", "operationId": "getVoiceAnalyticsUsage", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "TTS + voice audit aggregates" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice analytics" ] } }, "/v1/voice-analytics/voices": { "get": { "summary": "Voice id frequency + clones", "operationId": "getVoiceAnalyticsVoices", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Voice breakdown" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice analytics" ] } }, "/v1/voice-biometrics/anti-spoof": { "post": { "summary": "Heuristic anti-spoof assessment", "operationId": "antiSpoofVoiceBiometric", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Spoof risk (not NIST PAD)" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice biometrics" ] } }, "/v1/voice-biometrics/authenticate": { "post": { "summary": "Composite voice authentication decision", "operationId": "authenticateVoiceBiometric", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "accept / step_up / reject" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice biometrics" ] } }, "/v1/voice-biometrics/encryption": { "get": { "summary": "Fingerprint encryption-at-rest status", "operationId": "getVoiceBiometricsEncryption", "responses": { "200": { "description": "AES-GCM key configuration status" } }, "tags": [ "Voice biometrics" ] } }, "/v1/voice-biometrics/engine": { "get": { "summary": "Voice Biometrics engine catalog", "operationId": "getVoiceBiometricsEngine", "responses": { "200": { "description": "Capabilities and honesty notes" } }, "tags": [ "Voice biometrics" ] } }, "/v1/voice-biometrics/engine/analytics": { "get": { "operationId": "voiceBiometricsAnalytics", "summary": "Analytics", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice biometrics" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/voice-biometrics/enroll": { "post": { "summary": "Enroll encrypted voice biometric template", "operationId": "enrollVoiceBiometric", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Encrypted enrollment result" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice biometrics" ] } }, "/v1/voice-biometrics/identify": { "post": { "summary": "1:N voice biometric identify", "operationId": "identifyVoiceBiometric", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Identify candidates" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice biometrics" ] } }, "/v1/voice-biometrics/liveness": { "post": { "summary": "Heuristic liveness check", "operationId": "livenessVoiceBiometric", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Liveness result (not certified PAD)" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice biometrics" ] } }, "/v1/voice-biometrics/liveness/challenge": { "get": { "operationId": "voiceBiometricsLivenessChallenge", "summary": "Liveness challenge", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } } }, "tags": [ "Voice biometrics" ] } }, "/v1/voice-biometrics/profiles/{id}": { "delete": { "operationId": "voiceBiometricsDeleteProfile", "summary": "Delete profile", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice biometrics" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voice-biometrics/risk": { "get": { "summary": "Workspace / profile fraud risk score", "operationId": "riskVoiceBiometric", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Heuristic risk" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice biometrics" ] } }, "/v1/voice-biometrics/verify": { "post": { "summary": "1:1 voice biometric verify", "operationId": "verifyVoiceBiometric", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Verify score" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice biometrics" ] } }, "/v1/voice-clones": { "get": { "summary": "List voice clones for the workspace", "operationId": "listVoiceClones", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Clone profiles" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice clones" ] }, "post": { "summary": "Create a voice clone (Pro) with consent + samples; starts pending_review", "operationId": "createVoiceClone", "security": [ { "ClerkAuth": [] } ], "responses": { "201": { "description": "Created pending_review" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "Pro required" } }, "tags": [ "Voice clones" ] } }, "/v1/voice-clones/{id}": { "get": { "summary": "Get a voice clone by id", "operationId": "getVoiceClone", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Clone profile" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice clones" ] } }, "/v1/voice-clones/{id}/disable": { "post": { "summary": "Disable a voice clone (abuse / policy)", "operationId": "disableVoiceClone", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Disabled" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice clones" ] } }, "/v1/voice-clones/{id}/review": { "post": { "summary": "Abuse-review approve/reject (Pro). Approve calls clone provider (or fixture).", "operationId": "reviewVoiceClone", "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Updated" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Clone provider not configured" } }, "tags": [ "Voice clones" ] } }, "/v1/voice-cloning/clones/{id}/license": { "patch": { "operationId": "voiceCloningUpdateLicense", "summary": "Update license", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice cloning" ], "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voice-cloning/clones/{id}/ownership": { "patch": { "operationId": "voiceCloningUpdateOwnership", "summary": "Update ownership", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice cloning" ], "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voice-cloning/clones/{id}/permissions": { "patch": { "operationId": "voiceCloningUpdatePermissions", "summary": "Update permissions", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice cloning" ], "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voice-cloning/clones/{id}/verify-enrollment": { "post": { "operationId": "voiceCloningVerifyEnrollment", "summary": "Verify enrollment", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice cloning" ], "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voice-cloning/consent/policy": { "get": { "summary": "Voice cloning consent policy", "operationId": "getVoiceCloningConsentPolicy", "responses": { "200": { "description": "Required consent/ownership/review rules" } }, "tags": [ "Voice cloning" ] } }, "/v1/voice-cloning/engine": { "get": { "summary": "Voice Cloning engine catalog", "operationId": "getVoiceCloningEngine", "responses": { "200": { "description": "Capabilities, trust gates, architecture notes" } }, "tags": [ "Voice cloning" ] } }, "/v1/voice-cloning/engine/analytics": { "get": { "operationId": "voiceCloningAnalytics", "summary": "Analytics", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice cloning" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/voice-cloning/enroll": { "post": { "summary": "Enroll a voice clone (instant or professional)", "operationId": "enrollVoiceClone", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Clone pending abuse review" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice cloning" ] } }, "/v1/voice-cloning/enroll/stream": { "post": { "summary": "Enroll with SSE progress events", "operationId": "enrollVoiceCloneStream", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "text/event-stream enrollment progress" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice cloning" ] } }, "/v1/voice-cloning/library": { "get": { "summary": "Enterprise voice clone library", "operationId": "listVoiceCloningLibrary", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Workspace clones with governance metadata" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice cloning" ] } }, "/v1/voice-cloud/overview": { "get": { "summary": "Voice Cloud org overview", "operationId": "getVoiceOverview", "security": [ { "ClerkAuth": [] } ], "responses": { "200": { "description": "Session TTS usage, products, deferred flags, and console links" }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice cloud" ] } }, "/v1/voice-cloud/products": { "get": { "summary": "Voice Cloud product catalog", "operationId": "listVoiceProducts", "responses": { "200": { "description": "Voice products and architecture honesty notes", "content": { "application/json": { "schema": { "type": "object", "properties": { "products": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "status": { "type": "string", "enum": [ "shipped", "partial", "deferred" ] }, "api": { "type": "string", "nullable": true }, "console": { "type": "string", "nullable": true }, "notes": { "type": "string" } } } }, "architecture": { "type": "object" }, "docs": { "type": "string" } } } } } } }, "tags": [ "Voice cloud" ] } }, "/v1/voice-data/session/{token}": { "get": { "operationId": "voiceDataSessionSession", "summary": "Session", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice data" ], "parameters": [ { "name": "token", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voice-data/session/{token}/consent": { "post": { "operationId": "voiceDataSessionConsent", "summary": "Consent", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice data" ], "parameters": [ { "name": "token", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voice-data/session/{token}/feedback": { "post": { "operationId": "voiceDataSessionFeedback", "summary": "Feedback", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice data" ], "parameters": [ { "name": "token", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voice-data/session/{token}/recordings": { "post": { "operationId": "voiceDataSessionAddRecording", "summary": "Add recording", "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "properties": {}, "additionalProperties": { "type": "string", "format": "binary" } } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice data" ], "parameters": [ { "name": "token", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voice-data/session/{token}/withdraw": { "post": { "operationId": "voiceDataSessionWithdraw", "summary": "Withdraw", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice data" ], "parameters": [ { "name": "token", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voice-design": { "post": { "summary": "Design a voice from a creative prompt", "operationId": "designVoiceFromPrompt", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "prompt" ], "properties": { "prompt": { "type": "string" }, "language": { "type": "string" }, "gender": { "type": "string" }, "limit": { "type": "integer" } } } } } }, "responses": { "200": { "description": "Ranked Lugemi Echo voice matches for the brief" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice design" ] } }, "/v1/voice-enhancement/echo": { "get": { "summary": "Echo cancellation status (deferred)", "operationId": "getVoiceEnhancementEcho", "responses": { "200": { "description": "Deferred AEC status" } }, "tags": [ "Voice enhancement" ] } }, "/v1/voice-enhancement/engine": { "get": { "summary": "Voice Enhancement engine catalog", "operationId": "getVoiceEnhancementEngine", "responses": { "200": { "description": "Capabilities and honesty notes" } }, "tags": [ "Voice enhancement" ] } }, "/v1/voice-enhancement/engine/analytics": { "get": { "operationId": "voiceEnhancementAnalytics", "summary": "Analytics", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice enhancement" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/voice-enhancement/enhance": { "post": { "summary": "Enhance audio with a cleanup profile", "operationId": "enhanceVoice", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "WAV base64 + before/after metrics" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice enhancement" ] } }, "/v1/voice-enhancement/enhance/stream": { "post": { "summary": "Enhance with SSE progress", "operationId": "streamEnhanceVoice", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "text/event-stream" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice enhancement" ] } }, "/v1/voice-enhancement/profiles": { "get": { "summary": "Voice Enhancement cleanup profiles", "operationId": "listVoiceEnhancementProfiles", "responses": { "200": { "description": "Mic/podcast/meeting/broadcast/restore profiles" } }, "tags": [ "Voice enhancement" ] } }, "/v1/voice-enhancement/upscale": { "post": { "summary": "Linear audio upsample", "operationId": "upscaleVoiceEnhancement", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Upsampled WAV base64" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice enhancement" ] } }, "/v1/voice-language-marketplace/analytics": { "get": { "summary": "Voice/language marketplace analytics", "operationId": "getVoiceLanguageMarketplaceAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Aggregates" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice language marketplace" ] } }, "/v1/voice-language-marketplace/engine": { "get": { "summary": "Voice & Language Marketplace engine catalog", "operationId": "getVoiceLanguageMarketplaceEngine", "responses": { "200": { "description": "Voice/language pack capabilities, Stripe honesty, third-party TTS / celebrity / CDN denials" } }, "tags": [ "Voice language marketplace" ] } }, "/v1/voice-language-marketplace/installs": { "get": { "operationId": "voiceLanguageMarketplaceInstalls", "summary": "Installs", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice language marketplace" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/voice-language-marketplace/listings": { "get": { "summary": "List voice/language marketplace listings", "operationId": "listVoiceLanguageMarketplaceListings", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Published or mine pack listings" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice language marketplace" ] }, "post": { "summary": "Publish a voice/language pack catalog key as a marketplace listing", "operationId": "publishVoiceLanguageMarketplaceListing", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Listing created" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice language marketplace" ] } }, "/v1/voice-language-marketplace/listings/{id}": { "delete": { "operationId": "voiceLanguageMarketplaceUnpublish", "summary": "Unpublish", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice language marketplace" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voice-language-marketplace/listings/{id}/install": { "post": { "summary": "Install a voice/language pack listing entitlement", "operationId": "installVoiceLanguageMarketplaceListing", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Pack entitlement installed" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Policy deny" }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice language marketplace" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voice-language-marketplace/listings/{id}/reviews": { "get": { "summary": "List voice/language listing reviews", "operationId": "listVoiceLanguageMarketplaceReviews", "responses": { "200": { "description": "Reviews" }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice language marketplace" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] }, "post": { "summary": "Upsert a voice/language listing review", "operationId": "reviewVoiceLanguageMarketplaceListing", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Review saved" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice language marketplace" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voice-language-marketplace/listings/{id}/update": { "post": { "operationId": "voiceLanguageMarketplaceUpdate", "summary": "Update", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice language marketplace" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voice-language-marketplace/monitoring": { "get": { "summary": "Voice/language marketplace monitoring", "operationId": "getVoiceLanguageMarketplaceMonitoring", "responses": { "200": { "description": "Capability status snapshot" } }, "tags": [ "Voice language marketplace" ] } }, "/v1/voice-language-marketplace/products": { "get": { "summary": "Voice & Language Marketplace products (alias of engine)", "operationId": "listVoiceLanguageMarketplaceProducts", "responses": { "200": { "description": "Voice/language marketplace catalog + honesty" } }, "tags": [ "Voice language marketplace" ] } }, "/v1/voice-language-marketplace/sales": { "get": { "summary": "Voice/language marketplace publisher sales", "operationId": "listVoiceLanguageMarketplaceSales", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Sale receipts + fee honesty" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice language marketplace" ] } }, "/v1/voice-marketplace/analytics": { "get": { "summary": "Publisher analytics for voice marketplace", "operationId": "voiceMarketplaceAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Aggregates" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice marketplace" ] } }, "/v1/voice-marketplace/engine": { "get": { "summary": "Voice Marketplace engine catalog", "operationId": "getVoiceMarketplaceEngine", "responses": { "200": { "description": "Capabilities and honesty notes" } }, "tags": [ "Voice marketplace" ] } }, "/v1/voice-marketplace/installs": { "get": { "operationId": "voiceMarketplaceInstalls", "summary": "Installs", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice marketplace" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/voice-marketplace/language-packs": { "get": { "summary": "Curated language voice packs", "operationId": "listVoiceMarketplaceLanguagePacks", "responses": { "200": { "description": "own:* language packs" } }, "tags": [ "Voice marketplace" ] } }, "/v1/voice-marketplace/listings": { "get": { "summary": "List voice marketplace listings", "operationId": "listVoiceMarketplaceListings", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Published or mine listings" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice marketplace" ] }, "post": { "summary": "Publish a voice SKU / pack", "operationId": "publishVoiceMarketplaceListing", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Created listing" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice marketplace" ] } }, "/v1/voice-marketplace/listings/{id}": { "delete": { "operationId": "voiceMarketplaceUnpublish", "summary": "Unpublish", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice marketplace" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voice-marketplace/listings/{id}/install": { "post": { "summary": "Install / license a voice listing", "operationId": "installVoiceMarketplaceListing", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "License entitlement" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice marketplace" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voice-marketplace/listings/{id}/reviews": { "get": { "summary": "List reviews for a voice listing", "operationId": "listVoiceMarketplaceReviews", "responses": { "200": { "description": "Reviews" }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice marketplace" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] }, "post": { "summary": "Rate / review a voice listing", "operationId": "reviewVoiceMarketplaceListing", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Review" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice marketplace" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voice-marketplace/sales": { "get": { "operationId": "voiceMarketplaceSales", "summary": "Sales", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice marketplace" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/voice-runtime/engine": { "get": { "summary": "Voice Runtime engine", "operationId": "getVoiceRuntimeEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Voice runtime" ] } }, "/v1/voice-runtime/execute": { "get": { "summary": "Execute via Voice Runtime", "operationId": "executeVoiceRuntime", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice runtime" ] } }, "/v1/voice-runtime/monitoring": { "get": { "summary": "Voice Runtime monitoring", "operationId": "getVoiceRuntimeMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Voice runtime" ] } }, "/v1/voice-runtime/products": { "get": { "summary": "Voice Runtime products", "operationId": "listVoiceRuntimeProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Voice runtime" ] } }, "/v1/voice-runtime/query": { "get": { "summary": "Query Voice Runtime", "operationId": "queryVoiceRuntime", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice runtime" ] } }, "/v1/voice-runtime/route": { "get": { "summary": "Route via Voice Runtime", "operationId": "routeVoiceRuntime", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice runtime" ] } }, "/v1/voice-runtime/routes": { "get": { "summary": "Voice Runtime routes", "operationId": "listVoiceRuntimeRoutes", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice runtime" ] } }, "/v1/voice-studio/compare": { "post": { "summary": "Compare the same text across voices", "operationId": "compareVoiceStudioVoices", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Multi-voice base64 clips" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice studio" ] } }, "/v1/voice-studio/engine": { "get": { "summary": "Voice Studio engine catalog", "operationId": "getVoiceStudioEngine", "responses": { "200": { "description": "Capabilities and honesty notes" } }, "tags": [ "Voice studio" ] } }, "/v1/voice-studio/engine/analytics": { "get": { "operationId": "voiceStudioAnalytics", "summary": "Analytics", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice studio" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/voice-studio/generate": { "post": { "summary": "Generate studio speech", "operationId": "generateVoiceStudio", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Raw audio bytes" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice studio" ] } }, "/v1/voice-studio/library": { "get": { "summary": "Voice Studio library (TTS + clones)", "operationId": "getVoiceStudioLibrary", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Voice catalog" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice studio" ] } }, "/v1/voice-studio/preview": { "post": { "summary": "Preview studio speech (lexicon + SSML lite)", "operationId": "previewVoiceStudio", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Raw audio bytes" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice studio" ] } }, "/v1/voice-studio/profiles": { "get": { "summary": "List Voice Studio voice profiles", "operationId": "listVoiceStudioProfiles", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Profiles" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice studio" ] }, "post": { "summary": "Upsert Voice Studio profile", "operationId": "upsertVoiceStudioProfile", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Profile" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice studio" ] } }, "/v1/voice-studio/profiles/{id}": { "delete": { "operationId": "voiceStudioDeleteProfile", "summary": "Delete profile", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice studio" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voice-studio/projects": { "get": { "summary": "List Voice Studio projects", "operationId": "listVoiceStudioProjects", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Projects" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice studio" ] }, "post": { "summary": "Upsert Voice Studio project", "operationId": "upsertVoiceStudioProject", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Project" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice studio" ] } }, "/v1/voice-studio/projects/{id}": { "delete": { "operationId": "voiceStudioDeleteProject", "summary": "Delete project", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice studio" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voice-studio/pronunciation": { "get": { "summary": "List Voice Studio pronunciation lexicon", "operationId": "listVoiceStudioPronunciation", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Lexemes" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice studio" ] }, "post": { "summary": "Upsert pronunciation lexeme", "operationId": "upsertVoiceStudioPronunciation", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Lexeme" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice studio" ] } }, "/v1/voice-studio/pronunciation/{id}": { "delete": { "operationId": "voiceStudioDeletePronunciation", "summary": "Delete pronunciation", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice studio" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voice-studio/ssml/compile": { "post": { "summary": "Compile SSML lite to plain speak/pause plan", "operationId": "compileVoiceStudioSsml", "responses": { "200": { "description": "Compiled plan" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice studio" ] } }, "/v1/voice-studio/test": { "post": { "summary": "Quick voice test clip", "operationId": "testVoiceStudioVoice", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Raw audio bytes" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice studio" ] } }, "/v1/voice-studio/timeline/render": { "post": { "summary": "Render linear timeline clips", "operationId": "renderVoiceStudioTimeline", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Linear concat + per-clip audio" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice studio" ] } }, "/v1/voice-studio/workspace/assemblies/{id}/approvals": { "post": { "operationId": "studioWorkflowApprove", "summary": "Approve", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice studio" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voice-studio/workspace/assemblies/{id}/audio": { "get": { "operationId": "studioWorkflowAssemblyAudio", "summary": "Assembly audio", "responses": { "200": { "description": "Success. The body is written directly by the handler (for example audio bytes or a file download).", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice studio" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voice-studio/workspace/capabilities": { "get": { "operationId": "studioWorkflowCapabilities", "summary": "Capabilities", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } } }, "tags": [ "Voice studio" ] } }, "/v1/voice-studio/workspace/editions/{id}/assemblies": { "post": { "operationId": "studioWorkflowAssemble", "summary": "Assemble", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice studio" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voice-studio/workspace/editions/{id}/generations": { "post": { "operationId": "studioWorkflowGenerate", "summary": "Generate", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice studio" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voice-studio/workspace/editions/{id}/regenerations": { "post": { "operationId": "studioWorkflowRegenerate", "summary": "Regenerate", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice studio" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voice-studio/workspace/editions/{id}/translations": { "post": { "operationId": "studioWorkflowTranslate", "summary": "Translate", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice studio" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voice-studio/workspace/projects": { "get": { "operationId": "studioWorkflowListProjects", "summary": "List projects", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice studio" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] }, "post": { "operationId": "studioWorkflowCreateProject", "summary": "Create project", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice studio" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/voice-studio/workspace/projects/{id}": { "get": { "operationId": "studioWorkflowGetProject", "summary": "Get project", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice studio" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voice-studio/workspace/projects/{id}/editions": { "post": { "operationId": "studioWorkflowCreateEdition", "summary": "Create edition", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice studio" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voice-studio/workspace/projects/{id}/scripts": { "post": { "operationId": "studioWorkflowImportScript", "summary": "Import script", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice studio" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voice-studio/workspace/pronunciations": { "post": { "operationId": "studioWorkflowUpsertPronunciation", "summary": "Upsert pronunciation", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice studio" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/voice-studio/workspace/releases/{id}/exports": { "post": { "operationId": "studioWorkflowExportRelease", "summary": "Export release", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice studio" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voice-studio/workspace/takes/{id}/audio": { "get": { "operationId": "studioWorkflowTakeAudio", "summary": "Take audio", "responses": { "200": { "description": "Success. The body is written directly by the handler (for example audio bytes or a file download).", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice studio" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voice-studio/workspace/takes/{id}/reviews": { "post": { "operationId": "studioWorkflowReviewTake", "summary": "Review take", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice studio" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voice/agent/languages": { "get": { "summary": "Voice Agent language coverage", "operationId": "voiceAgentLanguages", "security": [], "responses": { "200": { "description": "Per-language TTS quality (neural / espeak / formant) with honesty notes" } }, "tags": [ "Voice" ] } }, "/v1/voice/agent/sessions": { "post": { "summary": "Create a Voice Agent multi-turn session", "operationId": "createVoiceAgentSession", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Session id and TTL" }, "401": { "description": "Unauthorized" } }, "tags": [ "Voice" ] } }, "/v1/voice/agent/sessions/{id}/turn": { "post": { "summary": "Continue a Voice Agent session turn", "operationId": "voiceAgentSessionTurn", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": false, "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/VoiceAgentTurnRequest" } }, "application/json": { "schema": { "$ref": "#/components/schemas/VoiceAgentTurnRequest" } } } }, "responses": { "200": { "description": "Transcript + reply + audio with session history", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VoiceAgentTurnResponse" } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Session expired or missing" } }, "tags": [ "Voice" ] } }, "/v1/voice/agent/turn": { "post": { "summary": "Voice chat agent turn (STT → chat → TTS)", "description": "Builder path for spoken agents. Auth: Bearer API key or session JWT. Accepts multipart audio (or text). Auto-detects spoken language, runs workspace chat persona, optionally translates the reply (translateReplyTo / replyLanguage), and synthesizes TTS with a native catalog voice. Returns transcript, reply text, audioBase64, detected language, and providers.", "operationId": "voiceAgentTurn", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "requestBody": { "required": false, "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/VoiceAgentTurnRequest" } }, "application/json": { "schema": { "$ref": "#/components/schemas/VoiceAgentTurnRequest" } } } }, "responses": { "200": { "description": "Transcript + reply + audio", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VoiceAgentTurnResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice" ] } }, "/v1/voice/audio/{id}": { "get": { "operationId": "voiceAudio", "summary": "Audio", "responses": { "200": { "description": "Success. The body is written directly by the handler (for example audio bytes or a file download).", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voice/calls": { "post": { "summary": "Place an outbound Twilio demo call", "operationId": "createVoiceCall", "security": [ { "ClerkAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "to" ], "properties": { "to": { "type": "string", "description": "E.164 phone number" } } } } } }, "responses": { "201": { "description": "Call queued" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Twilio not configured" } }, "tags": [ "Voice" ] } }, "/v1/voice/engine": { "get": { "summary": "Voice Agent capability catalog", "description": "Public product card for Lugemi Voice Agent: spoken-turn APIs, session routes, and honest TTS quality coverage across the language registry.", "operationId": "voiceAgentEngine", "security": [], "responses": { "200": { "description": "Voice Agent capabilities and languageCoverage summary" } }, "tags": [ "Voice" ] } }, "/v1/voice/simulate": { "post": { "summary": "Simulate a bilingual FAQ voice turn (text or audio)", "description": "Telephony FAQ demo path (workspace `voice_faq` prompt). For general spoken agents prefer POST /v1/voice/agent/turn.", "operationId": "simulateVoiceTurn", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "text": { "type": "string" }, "voice": { "type": "string" }, "emotion": { "type": "string" }, "format": { "type": "string", "enum": [ "mp3", "wav", "opus", "aac", "flac" ] } } } }, "multipart/form-data": { "schema": { "type": "object", "properties": { "file": { "type": "string", "format": "binary" }, "text": { "type": "string" }, "voice": { "type": "string" }, "emotion": { "type": "string" }, "format": { "type": "string", "enum": [ "mp3", "wav", "opus", "aac", "flac" ] } } } } } }, "responses": { "200": { "description": "FAQ reply + audioBase64" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Voice agent disabled or providers missing" } }, "tags": [ "Voice" ] } }, "/v1/voice/status": { "get": { "summary": "Voice FAQ / Twilio configuration status", "operationId": "getVoiceStatus", "security": [], "responses": { "200": { "description": "Config flags and webhook URLs (public probe; no secrets)" } }, "tags": [ "Voice" ] } }, "/v1/voice/turn": { "post": { "summary": "Voice chat agent turn (alias of /v1/voice/agent/turn)", "description": "Same multilingual STT → chat → TTS pipeline as POST /v1/voice/agent/turn. Prefer /agent/turn in new builder integrations.", "operationId": "voiceTurnAlias", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "requestBody": { "required": false, "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/VoiceAgentTurnRequest" } }, "application/json": { "schema": { "$ref": "#/components/schemas/VoiceAgentTurnRequest" } } } }, "responses": { "200": { "description": "Transcript + reply + audio", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VoiceAgentTurnResponse" } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voice" ] } }, "/v1/voice/twilio/inbound": { "post": { "summary": "Twilio inbound webhook (signed) — returns TwiML", "operationId": "twilioVoiceInbound", "responses": { "200": { "description": "TwiML" }, "401": { "description": "Invalid signature" } }, "tags": [ "Voice" ] } }, "/v1/voice/twilio/turn": { "post": { "summary": "Twilio recording callback — STT → FAQ → TTS → TwiML", "operationId": "twilioVoiceTurn", "responses": { "200": { "description": "TwiML" }, "401": { "description": "Invalid signature" } }, "tags": [ "Voice" ] } }, "/v1/voicebridge/catalog": { "get": { "operationId": "voiceBridgeCatalog", "summary": "Catalog", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voicebridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/voicebridge/invites/{token}": { "get": { "operationId": "voiceBridgePeekInvite", "summary": "Peek invite", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voicebridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "token", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voicebridge/messages/{id}/corrections": { "post": { "operationId": "voiceBridgeCorrect", "summary": "Correct", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voicebridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voicebridge/messages/{id}/draft": { "patch": { "operationId": "voiceBridgePatchDraft", "summary": "Patch draft", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voicebridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voicebridge/messages/{id}/publish": { "post": { "operationId": "voiceBridgePublish", "summary": "Publish", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voicebridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voicebridge/revisions/{id}/acknowledgments": { "post": { "operationId": "voiceBridgeAck", "summary": "Ack", "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voicebridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voicebridge/revisions/{id}/playback": { "post": { "operationId": "voiceBridgePlayback", "summary": "Playback", "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voicebridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voicebridge/threads": { "get": { "operationId": "voiceBridgeList", "summary": "List", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voicebridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] }, "post": { "operationId": "voiceBridgeCreate", "summary": "Create", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voicebridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/voicebridge/threads/{id}": { "get": { "operationId": "voiceBridgeGet", "summary": "Get", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voicebridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voicebridge/threads/{id}/deal-drafts": { "post": { "operationId": "voiceBridgeDealDraft", "summary": "Deal draft", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voicebridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voicebridge/threads/{id}/invites": { "post": { "operationId": "voiceBridgeInvite", "summary": "Invite", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voicebridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voicebridge/threads/{id}/join": { "post": { "operationId": "voiceBridgeJoin", "summary": "Join", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voicebridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voicebridge/threads/{id}/members/me": { "patch": { "operationId": "voiceBridgePatchMe", "summary": "Patch me", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voicebridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voicebridge/threads/{id}/messages": { "post": { "operationId": "voiceBridgeCreateMessage", "summary": "Create message", "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "properties": {}, "additionalProperties": { "type": "string", "format": "binary" } } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voicebridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/voicebridge/threads/{id}/uploads": { "post": { "operationId": "voiceBridgeUploads", "summary": "Uploads", "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Voicebridge" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/wake-word/analytics": { "get": { "summary": "Wake Word analytics", "operationId": "getWakeWordAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Org audit-derived usage" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Wake word" ] } }, "/v1/wake-word/detect": { "post": { "summary": "Detect wake words in text or audio", "operationId": "detectWakeWord", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Wake detection hits" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Wake word" ] } }, "/v1/wake-word/detect/stream": { "post": { "summary": "Stream wake detection (SSE)", "operationId": "streamWakeDetect", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "SSE wake events" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Wake word" ] } }, "/v1/wake-word/engine": { "get": { "summary": "Wake Word engine catalog", "operationId": "getWakeWordEngine", "responses": { "200": { "description": "Wake/keyword capabilities" } }, "tags": [ "Wake word" ] } }, "/v1/wake-word/keywords": { "get": { "summary": "List custom wake/keyword/trigger phrases", "operationId": "listWakeKeywords", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Workspace phrases" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Wake word" ] }, "post": { "summary": "Add custom wake/keyword/trigger phrase", "operationId": "addWakeKeyword", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Created phrase" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Wake word" ] } }, "/v1/wake-word/keywords/{id}": { "delete": { "operationId": "wakeWordRemoveKeyword", "summary": "Remove keyword", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Wake word" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/wake-word/spot": { "post": { "summary": "Spot keywords in text or audio", "operationId": "spotWakeKeywords", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Keyword hits" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Wake word" ] } }, "/v1/wake-word/triggers": { "post": { "summary": "Evaluate enterprise trigger phrases", "operationId": "evaluateWakeTriggers", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Fired triggers" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Wake word" ] } }, "/v1/webhooks/signing-secret": { "post": { "operationId": "jobsWebhookSecret", "summary": "Webhook secret", "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Webhooks" ], "security": [ { "ClerkAuth": [] } ] } }, "/v1/whatsapp/engine": { "get": { "operationId": "whatsAppEngine", "summary": "Engine", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } } }, "tags": [ "Whatsapp" ] } }, "/v1/whatsapp/sandbox/inbound": { "post": { "operationId": "whatsAppSandbox", "summary": "Sandbox", "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "properties": {}, "additionalProperties": { "type": "string", "format": "binary" } } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Whatsapp" ], "security": [ { "ClerkAuth": [] } ] } }, "/v1/whatsapp/settings": { "get": { "operationId": "whatsAppSettings", "summary": "Settings", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Whatsapp" ], "security": [ { "ClerkAuth": [] } ] }, "patch": { "operationId": "whatsAppUpdateSettings", "summary": "Update settings", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Whatsapp" ], "security": [ { "ClerkAuth": [] } ] } }, "/v1/whatsapp/threads": { "get": { "operationId": "whatsAppThreads", "summary": "Threads", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Whatsapp" ], "security": [ { "ClerkAuth": [] } ] } }, "/v1/whatsapp/threads/{id}": { "get": { "operationId": "whatsAppThread", "summary": "Thread", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Whatsapp" ], "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/whatsapp/webhook": { "get": { "operationId": "whatsAppVerify", "summary": "Verify", "parameters": [ { "name": "hub.challenge", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "hub.verify_token", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "hub.mode", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success. The body is written directly by the handler (for example audio bytes or a file download).", "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Whatsapp" ] }, "post": { "operationId": "whatsAppWebhook", "summary": "Webhook", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Whatsapp" ] } }, "/v1/workflow-marketplace/analytics": { "get": { "summary": "Workflow marketplace analytics", "operationId": "getWorkflowMarketplaceAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Aggregates" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Workflow marketplace" ] } }, "/v1/workflow-marketplace/engine": { "get": { "summary": "Workflow Marketplace engine catalog", "operationId": "getWorkflowMarketplaceEngine", "responses": { "200": { "description": "Workflow marketplace capabilities, Stripe honesty, sandbox + Policy hard-gate denials" } }, "tags": [ "Workflow marketplace" ] } }, "/v1/workflow-marketplace/installs": { "get": { "operationId": "workflowMarketplaceInstalls", "summary": "Installs", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Workflow marketplace" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ] } }, "/v1/workflow-marketplace/listings": { "get": { "summary": "List workflow marketplace listings", "operationId": "listWorkflowMarketplaceListings", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Published or mine workflow listings" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Workflow marketplace" ] }, "post": { "summary": "Publish a Workflow Runtime definition as a marketplace listing", "operationId": "publishWorkflowMarketplaceListing", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Listing created" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Workflow marketplace" ] } }, "/v1/workflow-marketplace/listings/{id}": { "delete": { "operationId": "workflowMarketplaceUnpublish", "summary": "Unpublish", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Workflow marketplace" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/workflow-marketplace/listings/{id}/install": { "post": { "summary": "Install a workflow listing into Workflow Runtime (sandboxed)", "operationId": "installWorkflowMarketplaceListing", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Sandboxed workflow installed" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Policy deny" }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Workflow marketplace" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/workflow-marketplace/listings/{id}/reviews": { "get": { "summary": "List workflow listing reviews", "operationId": "listWorkflowMarketplaceReviews", "responses": { "200": { "description": "Reviews" }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Workflow marketplace" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] }, "post": { "summary": "Upsert a workflow listing review", "operationId": "reviewWorkflowMarketplaceListing", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Review saved" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Workflow marketplace" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/workflow-marketplace/listings/{id}/run": { "post": { "summary": "Run an installed marketplace workflow (Policy-gated sandbox)", "operationId": "runWorkflowMarketplaceListing", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Sandbox run result (may be denied)" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Not installed or policy deny" }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Workflow marketplace" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/workflow-marketplace/listings/{id}/update": { "post": { "operationId": "workflowMarketplaceUpdate", "summary": "Update", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Workflow marketplace" ], "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/v1/workflow-marketplace/monitoring": { "get": { "summary": "Workflow marketplace monitoring", "operationId": "getWorkflowMarketplaceMonitoring", "responses": { "200": { "description": "Capability status snapshot" } }, "tags": [ "Workflow marketplace" ] } }, "/v1/workflow-marketplace/products": { "get": { "summary": "Workflow Marketplace products (alias of engine)", "operationId": "listWorkflowMarketplaceProducts", "responses": { "200": { "description": "Workflow marketplace catalog + honesty" } }, "tags": [ "Workflow marketplace" ] } }, "/v1/workflow-marketplace/sales": { "get": { "summary": "Workflow marketplace publisher sales", "operationId": "listWorkflowMarketplaceSales", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Sale receipts + fee honesty" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Workflow marketplace" ] } }, "/v1/workflow-operating-system/engine": { "get": { "summary": "Workflow Operating System engine", "operationId": "getWorkflowOperatingSystemEngine", "responses": { "200": { "description": "OK" } }, "tags": [ "Workflow operating system" ] } }, "/v1/workflow-operating-system/execute": { "get": { "summary": "Execute via Workflow Operating System", "operationId": "executeWorkflowOperatingSystem", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Workflow operating system" ] } }, "/v1/workflow-operating-system/monitoring": { "get": { "summary": "Workflow Operating System monitoring", "operationId": "getWorkflowOperatingSystemMonitoring", "responses": { "200": { "description": "OK" } }, "tags": [ "Workflow operating system" ] } }, "/v1/workflow-operating-system/products": { "get": { "summary": "Workflow Operating System products", "operationId": "listWorkflowOperatingSystemProducts", "responses": { "200": { "description": "OK" } }, "tags": [ "Workflow operating system" ] } }, "/v1/workflow-operating-system/query": { "get": { "summary": "Query Workflow Operating System", "operationId": "queryWorkflowOperatingSystem", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Workflow operating system" ] } }, "/v1/workflow-operating-system/route": { "get": { "summary": "Route via Workflow Operating System", "operationId": "routeWorkflowOperatingSystem", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Workflow operating system" ] } }, "/v1/workflow-operating-system/routes": { "get": { "summary": "Workflow Operating System routes", "operationId": "listWorkflowOperatingSystemRoutes", "responses": { "200": { "description": "OK" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Workflow operating system" ] } }, "/v1/workflow-runtime/analytics": { "get": { "summary": "Workflow Runtime analytics", "operationId": "getWorkflowRuntimeAnalytics", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Aggregates" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Workflow runtime" ] } }, "/v1/workflow-runtime/approve": { "post": { "summary": "Record sandbox human approval", "operationId": "approveWorkflowRuntime", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Approval" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Workflow runtime" ] } }, "/v1/workflow-runtime/engine": { "get": { "summary": "Workflow Runtime catalog", "operationId": "getWorkflowRuntimeEngine", "responses": { "200": { "description": "Catalog + honesty + ceilings" } }, "tags": [ "Workflow runtime" ] } }, "/v1/workflow-runtime/monitoring": { "get": { "summary": "Workflow Runtime monitoring", "operationId": "getWorkflowRuntimeMonitoring", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Monitoring + safety" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Workflow runtime" ] } }, "/v1/workflow-runtime/permissions": { "get": { "summary": "Workflow Runtime grantable/denied permissions", "operationId": "listWorkflowRuntimePermissions", "responses": { "200": { "description": "Permission lists" } }, "tags": [ "Workflow runtime" ] } }, "/v1/workflow-runtime/replay": { "post": { "summary": "Replay sandbox workflow run", "operationId": "replayWorkflowRuntime", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Replay" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Workflow runtime" ] } }, "/v1/workflow-runtime/rollback": { "post": { "summary": "Rollback sandbox workflow run", "operationId": "rollbackWorkflowRuntime", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Rolled back" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Workflow runtime" ] } }, "/v1/workflow-runtime/run": { "post": { "summary": "Run sandbox workflow", "operationId": "runWorkflowRuntime", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Sandbox run result" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Workflow runtime" ] } }, "/v1/workflow-runtime/schedule": { "post": { "summary": "Schedule sandbox workflow", "operationId": "scheduleWorkflowRuntime", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Schedule" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Workflow runtime" ] } }, "/v1/workflow-runtime/workflows": { "get": { "summary": "List kernel workflows", "operationId": "listWorkflowRuntimeWorkflows", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Workflows" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Workflow runtime" ] }, "post": { "summary": "Create kernel workflow", "operationId": "createWorkflowRuntimeWorkflow", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "201": { "description": "Created" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Workflow runtime" ] } }, "/v1/workflow-runtime/workflows/{id}": { "get": { "summary": "Get kernel workflow", "operationId": "getWorkflowRuntimeWorkflow", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Workflow" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Workflow runtime" ] } }, "/v1/workflow-runtime/workflows/{id}/lifecycle": { "post": { "summary": "Update workflow lifecycle", "operationId": "lifecycleWorkflowRuntimeWorkflow", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Updated" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Workflow runtime" ] } }, "/v1/workflow-runtime/workflows/{id}/version": { "post": { "summary": "Bump workflow version", "operationId": "versionWorkflowRuntimeWorkflow", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Versioned" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Workflow runtime" ] } }, "/v1/workflows": { "get": { "summary": "List saved workflow definitions", "operationId": "listWorkflows", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "responses": { "200": { "description": "Workflows for the current workspace", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Workflow" } } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Workflows" ] }, "post": { "summary": "Create a workflow definition", "operationId": "createWorkflow", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "name", "steps" ], "properties": { "name": { "type": "string" }, "steps": { "type": "array", "description": "transcribe (documentId), translate (source/target/text), notify (channel/message)" } } } } } }, "responses": { "201": { "description": "Created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Workflow" } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Workflows" ] } }, "/v1/workflows/{id}": { "get": { "summary": "Get a workflow definition", "operationId": "getWorkflow", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Workflow", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Workflow" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Workflows" ] }, "delete": { "summary": "Delete a workflow definition", "operationId": "deleteWorkflow", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Deleted" }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Workflows" ] } }, "/v1/workflows/{id}/run": { "post": { "summary": "Enqueue a workflow job from a saved definition", "operationId": "runWorkflow", "security": [ { "ApiKeyAuth": [] }, { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "webhookUrl": { "type": "string" } } } } } }, "responses": { "201": { "description": "Job queued", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Job" } } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Workflows" ] } }, "/v1/workspaces": { "get": { "operationId": "workspacesList", "summary": "List", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Workspaces" ], "security": [ { "ClerkAuth": [] } ] }, "post": { "operationId": "workspacesCreate", "summary": "Create", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Workspaces" ], "security": [ { "ClerkAuth": [] } ] } }, "/v1/workspaces/{id}": { "get": { "operationId": "workspacesGet", "summary": "Get", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Workspaces" ], "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] }, "patch": { "operationId": "workspacesUpdate", "summary": "Update", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Missing or invalid credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "tags": [ "Workspaces" ], "security": [ { "ClerkAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ] } } }, "tags": [ { "name": "Accents" }, { "name": "Accessline" }, { "name": "Admin · Dealbridge" }, { "name": "Admin · Organizations" }, { "name": "Admin · Pilot requests" }, { "name": "Admin · Plans" }, { "name": "Admin · Status" }, { "name": "Admin · Voice data" }, { "name": "Admin · Workspaces" }, { "name": "African intelligence cloud" }, { "name": "African knowledge graph" }, { "name": "African language registry" }, { "name": "Agent fabric" }, { "name": "Agent marketplace" }, { "name": "Agent operating system" }, { "name": "Agent runtime" }, { "name": "AgentOps platform" }, { "name": "Agents" }, { "name": "Agricultural intelligence" }, { "name": "AI drift detection" }, { "name": "AI engineering standards" }, { "name": "AI fabric" }, { "name": "AI governance platform" }, { "name": "AI kernel" }, { "name": "AI memory operating system" }, { "name": "AI operations dashboard" }, { "name": "AI orchestration" }, { "name": "AI publication platform" }, { "name": "AI router" }, { "name": "AI runtime analytics" }, { "name": "AI safety platform" }, { "name": "AI scheduler" }, { "name": "Align" }, { "name": "Analytics" }, { "name": "API engineering standards" }, { "name": "API keys" }, { "name": "Architecture governance" }, { "name": "Atlas" }, { "name": "Audio" }, { "name": "Audio intelligence" }, { "name": "Audit events" }, { "name": "Baobab" }, { "name": "Batch runtime" }, { "name": "Benchmark platform" }, { "name": "Billing" }, { "name": "Call intelligence" }, { "name": "Call Intelligence" }, { "name": "Chat" }, { "name": "Cloud" }, { "name": "Compliance platform" }, { "name": "Connector marketplace" }, { "name": "Connectors" }, { "name": "Context engine" }, { "name": "Context fabric" }, { "name": "Context runtime" }, { "name": "Continuous evaluation" }, { "name": "Continuous learning" }, { "name": "Control plane analytics" }, { "name": "Control plane cloud" }, { "name": "Corridor benchmarks" }, { "name": "Cost optimization" }, { "name": "Countries" }, { "name": "Country packs" }, { "name": "Coverage" }, { "name": "Creative media" }, { "name": "Creator economy" }, { "name": "Cultural intelligence" }, { "name": "Data advantage" }, { "name": "Data plane cloud" }, { "name": "Data plane streaming" }, { "name": "Database engineering standards" }, { "name": "Dataset marketplace" }, { "name": "Dataset pipeline" }, { "name": "Datasets" }, { "name": "Dealbridge" }, { "name": "Decision engine" }, { "name": "Demo" }, { "name": "Detect" }, { "name": "Developer" }, { "name": "Developer experience platform" }, { "name": "Dialects" }, { "name": "Dialogue" }, { "name": "Documents" }, { "name": "Ecosystem cloud" }, { "name": "Edge" }, { "name": "Education intelligence" }, { "name": "Embedding cloud" }, { "name": "Embedding runtime" }, { "name": "Embeddings" }, { "name": "Emotion" }, { "name": "Emotion voice" }, { "name": "Engineering governance" }, { "name": "Engineering quality platform" }, { "name": "Enterprise" }, { "name": "Enterprise engineering system" }, { "name": "Enterprise RAG" }, { "name": "Enterprise search" }, { "name": "Eval" }, { "name": "Evaluation platform" }, { "name": "Event fabric" }, { "name": "Everyday" }, { "name": "Experiment platform" }, { "name": "Explainability platform" }, { "name": "Feature flags" }, { "name": "Fidelity" }, { "name": "Financial intelligence" }, { "name": "Finetunes" }, { "name": "FinOps platform" }, { "name": "Foundation model cloud" }, { "name": "Gateway" }, { "name": "GitOps platform" }, { "name": "Global configuration platform" }, { "name": "Global deployment controller" }, { "name": "Global policy engine" }, { "name": "Global routing controller" }, { "name": "Global scheduler" }, { "name": "Glossary" }, { "name": "Golden path platform" }, { "name": "Government" }, { "name": "Government intelligence" }, { "name": "GPU platform" }, { "name": "GPU runtime" }, { "name": "Grammar" }, { "name": "Grounded" }, { "name": "Healthcare intelligence" }, { "name": "Icu" }, { "name": "Identity" }, { "name": "Identity federation" }, { "name": "Inference cloud" }, { "name": "Infrastructure engineering standards" }, { "name": "Intelligence analytics" }, { "name": "Intelligence cloud" }, { "name": "Intelligent cache" }, { "name": "Internal developer portal" }, { "name": "Interpret" }, { "name": "Jobs" }, { "name": "Knowledge" }, { "name": "Knowledge analytics" }, { "name": "Knowledge APIs" }, { "name": "Knowledge base" }, { "name": "Knowledge cloud" }, { "name": "Knowledge fabric" }, { "name": "Knowledge graph" }, { "name": "Knowledge intelligence" }, { "name": "Knowledge memory" }, { "name": "Knowledge operating system" }, { "name": "Knowledge runtime" }, { "name": "Language" }, { "name": "Language assurance" }, { "name": "Language integrity" }, { "name": "Language intelligence" }, { "name": "Language kits" }, { "name": "Languages" }, { "name": "Learnback" }, { "name": "Live" }, { "name": "Locales" }, { "name": "Localization" }, { "name": "Localize" }, { "name": "Marketplace" }, { "name": "MCP" }, { "name": "Meetingbridge" }, { "name": "Memory cloud" }, { "name": "Memory fabric" }, { "name": "Memory runtime" }, { "name": "Meta" }, { "name": "Metrics" }, { "name": "Mix" }, { "name": "MLOps LLMOps cloud" }, { "name": "Model evaluation platform" }, { "name": "Model marketplace" }, { "name": "Model registry" }, { "name": "Model serving" }, { "name": "Model training platform" }, { "name": "Models" }, { "name": "Native Speech Engine" }, { "name": "Notifications" }, { "name": "OCR" }, { "name": "Onboarding" }, { "name": "Ontology" }, { "name": "Open science platform" }, { "name": "Organization" }, { "name": "Organization control" }, { "name": "Passport" }, { "name": "Patent innovation platform" }, { "name": "Pilot requests" }, { "name": "Platform engineering analytics" }, { "name": "Platform engineering cloud" }, { "name": "Plugin marketplace" }, { "name": "Plugin operating system" }, { "name": "Plugin runtime" }, { "name": "Policy fabric" }, { "name": "Policy runtime" }, { "name": "Portfolio" }, { "name": "Pragmatics" }, { "name": "Privacy platform" }, { "name": "Prompt fabric" }, { "name": "Prompt intelligence" }, { "name": "Prompt marketplace" }, { "name": "Prompt runtime" }, { "name": "PromptOps platform" }, { "name": "Prompts" }, { "name": "Pronunciation" }, { "name": "RAGOps platform" }, { "name": "Reasoning cloud" }, { "name": "Reasoning fabric" }, { "name": "Reasoning runtime" }, { "name": "Recommendation engine" }, { "name": "Regional language registry" }, { "name": "Regions" }, { "name": "Registry" }, { "name": "Relay" }, { "name": "Release engineering" }, { "name": "Reliability engineering" }, { "name": "Repository standards" }, { "name": "Research analytics" }, { "name": "Research cloud" }, { "name": "Residency" }, { "name": "Resource manager" }, { "name": "Reviews" }, { "name": "Risk intelligence" }, { "name": "Runtime manager" }, { "name": "Secrets certificate platform" }, { "name": "Service catalog" }, { "name": "Speakers" }, { "name": "Speech" }, { "name": "Speech analytics" }, { "name": "Speech embed" }, { "name": "Speech review" }, { "name": "Speech runtime" }, { "name": "Streaming runtime" }, { "name": "Style" }, { "name": "Supply chain security" }, { "name": "Synthetic data platform" }, { "name": "System" }, { "name": "Taxonomy" }, { "name": "TM" }, { "name": "Tourism heritage intelligence" }, { "name": "Training jobs" }, { "name": "Training pipeline" }, { "name": "Translate" }, { "name": "Translation runtime" }, { "name": "Trust analytics" }, { "name": "Trust cloud" }, { "name": "TTS" }, { "name": "Usage" }, { "name": "VAIOS" }, { "name": "Vector cloud" }, { "name": "Vertical glossaries" }, { "name": "Vision runtime" }, { "name": "Voice" }, { "name": "Voice analytics" }, { "name": "Voice biometrics" }, { "name": "Voice clones" }, { "name": "Voice cloning" }, { "name": "Voice cloud" }, { "name": "Voice data" }, { "name": "Voice design" }, { "name": "Voice enhancement" }, { "name": "Voice language marketplace" }, { "name": "Voice marketplace" }, { "name": "Voice runtime" }, { "name": "Voice studio" }, { "name": "Voicebridge" }, { "name": "Wake word" }, { "name": "Webhooks" }, { "name": "Whatsapp" }, { "name": "Workflow marketplace" }, { "name": "Workflow operating system" }, { "name": "Workflow runtime" }, { "name": "Workflows" }, { "name": "Workspaces" } ] }