{ "openapi": "3.0.3", "info": { "title": "Overlay Web API", "version": "1.0.0", "description": "Generated from the overlay-web route boundary registry. This first-pass reference documents stable route inventory and request shapes." }, "servers": [ { "url": "https://getoverlay.io", "description": "Hosted Overlay web app" }, { "url": "http://localhost:3000", "description": "Local development web app" } ], "tags": [ { "name": "Administration" }, { "name": "Automations" }, { "name": "Billing" }, { "name": "Bootstrap" }, { "name": "Chat" }, { "name": "Conversations" }, { "name": "Discovery" }, { "name": "Files" }, { "name": "Integrations" }, { "name": "Knowledge" }, { "name": "MCP Servers" }, { "name": "Media" }, { "name": "Memory" }, { "name": "Model Providers" }, { "name": "Models" }, { "name": "Notes" }, { "name": "Onboarding" }, { "name": "Outputs" }, { "name": "Projects" }, { "name": "Settings" }, { "name": "Skills" }, { "name": "Tools" }, { "name": "Webhooks" } ], "paths": { "/api/v1/admin/audit": { "get": { "operationId": "getAdminAudit", "summary": "List audit events", "tags": [ "Administration" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "parameters": [ { "name": "action", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "actorUserId", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "before", "in": "query", "required": false, "schema": { "type": "integer" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "resourceType", "in": "query", "required": false, "schema": { "type": "string" } } ] } }, "/api/v1/admin/principals": { "delete": { "operationId": "deleteAdminPrincipals", "summary": "Revoke an administrative principal", "tags": [ "Administration" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "userId": { "type": "string", "minLength": 1 } }, "required": [ "userId" ], "additionalProperties": false } } } } }, "get": { "operationId": "getAdminPrincipals", "summary": "List administrative principals", "tags": [ "Administration" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "postAdminPrincipals", "summary": "Grant an administrative principal", "tags": [ "Administration" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "userId": { "type": "string", "minLength": 1 }, "role": { "type": "string", "enum": [ "admin", "auditor", "billing_admin", "support" ] }, "reason": { "type": "string" } }, "required": [ "userId", "role" ], "additionalProperties": false } } } } } }, "/api/v1/admin/usage": { "get": { "operationId": "getAdminUsage", "summary": "List administrative usage", "tags": [ "Administration" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "parameters": [ { "name": "userId", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 } } ] }, "post": { "operationId": "postAdminUsage", "summary": "Adjust an administrative budget", "tags": [ "Administration" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "userId": { "type": "string", "minLength": 1 }, "amountCents": { "type": "integer" } }, "required": [ "userId", "amountCents" ], "additionalProperties": false } } } } } }, "/api/v1/automations": { "delete": { "operationId": "deleteAutomations", "summary": "Delete an automation", "tags": [ "Automations" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "parameters": [ { "name": "accessToken", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "userId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "automationId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "automationId": { "type": "string", "minLength": 1 } }, "additionalProperties": false } } } } }, "get": { "operationId": "getAutomations", "summary": "List automations", "tags": [ "Automations" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "createdAt", "updatedAt", "name" ], "default": "updatedAt" } }, { "name": "order", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ], "default": "desc" } }, { "name": "automationId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "projectId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "includeDeleted", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "true", "false", "1", "0" ] } }, { "name": "runs", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "true", "false", "1", "0" ] } } ] }, "patch": { "operationId": "patchAutomations", "summary": "Update an automation", "tags": [ "Automations" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "name": { "type": "string", "minLength": 1, "maxLength": 200 }, "prompt": { "type": "string" }, "schedule": {}, "projectId": { "type": "string" }, "automationId": { "type": "string", "minLength": 1 } }, "required": [ "automationId" ], "additionalProperties": true } } } } }, "post": { "operationId": "postAutomations", "summary": "Create an automation", "tags": [ "Automations" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "name": { "type": "string", "minLength": 1, "maxLength": 200 }, "prompt": { "type": "string" }, "schedule": {}, "projectId": { "type": "string" } }, "additionalProperties": true } } } } } }, "/api/v1/automations/run": { "post": { "operationId": "postAutomationsRun", "summary": "Run an automation", "tags": [ "Automations" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "runId": { "type": "string", "minLength": 1 } }, "required": [ "runId" ], "additionalProperties": true } } } } } }, "/api/v1/automations/test": { "post": { "operationId": "postAutomationsTest", "summary": "Test an automation draft", "tags": [ "Automations" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "prompt": { "type": "string" }, "automationId": { "type": "string" } }, "additionalProperties": true } } } } } }, "/api/v1/bootstrap": { "get": { "operationId": "getBootstrap", "summary": "Load signed-in app bootstrap state", "tags": [ "Bootstrap" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/api/v1/browser-task": { "post": { "operationId": "postBrowserTask", "summary": "Start a browser task", "tags": [ "Tools" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "task": { "type": "string" } }, "additionalProperties": true } } } } } }, "/api/v1/capabilities": { "get": { "operationId": "getCapabilities", "summary": "Read web capabilities", "tags": [ "Bootstrap" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/api/v1/chat-suggestions": { "get": { "operationId": "getChatSuggestions", "summary": "List chat starter suggestions", "tags": [ "Chat" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/api/v1/conversations": { "delete": { "operationId": "deleteConversations", "summary": "Delete a conversation", "tags": [ "Conversations" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "parameters": [ { "name": "accessToken", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "userId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "conversationId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "conversationId": { "type": "string", "minLength": 1 } }, "additionalProperties": false } } } } }, "get": { "operationId": "getConversations", "summary": "List or read conversations", "tags": [ "Conversations" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "createdAt", "updatedAt", "name" ], "default": "updatedAt" } }, { "name": "order", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ], "default": "desc" } }, { "name": "conversationId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "messages", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "true", "false", "1", "0" ] } }, { "name": "projectId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "updatedSince", "in": "query", "required": false, "schema": { "type": "string", "pattern": "^\\d+$" } }, { "name": "includeDeleted", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "true", "false", "1", "0" ] } }, { "name": "beforeCreatedAt", "in": "query", "required": false, "schema": { "type": "string", "pattern": "^\\d+$" } }, { "name": "compactToolPayloads", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "true", "false", "1", "0" ] } } ] }, "patch": { "operationId": "patchConversations", "summary": "Update a conversation", "tags": [ "Conversations" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "title": { "type": "string", "minLength": 1, "maxLength": 200 }, "projectId": { "type": "string", "nullable": true }, "askModelIds": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160 }, "maxItems": 4 }, "actModelId": { "type": "string" }, "lastMode": { "type": "string", "enum": [ "ask", "act" ] }, "clientId": { "type": "string" }, "conversationId": { "type": "string", "minLength": 1 } }, "required": [ "conversationId" ], "additionalProperties": false } } } } }, "post": { "operationId": "postConversations", "summary": "Create a conversation", "tags": [ "Conversations" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "title": { "type": "string", "minLength": 1, "maxLength": 200 }, "projectId": { "type": "string" }, "askModelIds": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160 }, "maxItems": 4 }, "actModelId": { "type": "string" }, "lastMode": { "type": "string", "enum": [ "ask", "act" ] }, "clientId": { "type": "string" } }, "additionalProperties": false } } } } } }, "/api/v1/conversations/act": { "post": { "operationId": "postConversationsAct", "summary": "Run an Act turn", "tags": [ "Conversations" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "conversationId": { "type": "string" }, "conversationClientId": { "type": "string", "minLength": 1 }, "projectId": { "type": "string" }, "askModelIds": { "type": "array", "items": { "type": "string" } }, "messages": { "type": "array", "items": {} }, "prompt": { "type": "string" }, "systemPrompt": { "type": "string" }, "turnId": { "type": "string" }, "modelId": { "type": "string", "minLength": 1, "maxLength": 160 }, "indexedFileNames": { "type": "array", "items": { "type": "string" } }, "indexedAttachments": {}, "attachmentNames": { "type": "array", "items": { "type": "string" } }, "replyContextForModel": { "type": "string" }, "historyBaseModelId": { "type": "string" }, "mode": { "type": "string", "enum": [ "chat", "automate" ] }, "automationMode": { "type": "boolean" }, "automationExecution": { "type": "boolean" }, "automationId": { "type": "string" }, "mediaToolIntent": { "type": "string", "enum": [ "image", "video" ], "nullable": true }, "requestedToolIds": {}, "memoryEnabled": { "type": "boolean" }, "actAbortTimeoutMs": { "type": "number", "exclusiveMinimum": true, "minimum": 0 }, "streamPersistenceMode": { "type": "string", "enum": [ "cloudflare-mirror", "direct" ] }, "mentions": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string" }, "id": { "type": "string" }, "name": { "type": "string" }, "fileIds": { "type": "array", "items": { "type": "string" } } }, "required": [ "type", "id", "name" ], "additionalProperties": false } }, "multiModelSlotIndex": { "type": "integer", "minimum": 0 }, "multiModelTotal": { "type": "integer", "minimum": 1 } }, "additionalProperties": true } } } } } }, "/api/v1/conversations/act/extension-plan": { "post": { "operationId": "postConversationsActExtensionPlan", "summary": "Plan extension actions for an Act turn", "tags": [ "Conversations" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "conversationId": { "type": "string" }, "conversationClientId": { "type": "string", "minLength": 1 }, "projectId": { "type": "string" }, "askModelIds": { "type": "array", "items": { "type": "string" } }, "messages": { "type": "array", "items": {} }, "prompt": { "type": "string" }, "systemPrompt": { "type": "string" }, "turnId": { "type": "string" }, "modelId": { "type": "string", "minLength": 1, "maxLength": 160 }, "indexedFileNames": { "type": "array", "items": { "type": "string" } }, "indexedAttachments": {}, "attachmentNames": { "type": "array", "items": { "type": "string" } }, "replyContextForModel": { "type": "string" }, "historyBaseModelId": { "type": "string" }, "mode": { "type": "string", "enum": [ "chat", "automate" ] }, "automationMode": { "type": "boolean" }, "automationExecution": { "type": "boolean" }, "automationId": { "type": "string" }, "mediaToolIntent": { "type": "string", "enum": [ "image", "video" ], "nullable": true }, "requestedToolIds": {}, "memoryEnabled": { "type": "boolean" }, "actAbortTimeoutMs": { "type": "number", "exclusiveMinimum": true, "minimum": 0 }, "streamPersistenceMode": { "type": "string", "enum": [ "cloudflare-mirror", "direct" ] }, "mentions": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string" }, "id": { "type": "string" }, "name": { "type": "string" }, "fileIds": { "type": "array", "items": { "type": "string" } } }, "required": [ "type", "id", "name" ], "additionalProperties": false } }, "multiModelSlotIndex": { "type": "integer", "minimum": 0 }, "multiModelTotal": { "type": "integer", "minimum": 1 } }, "additionalProperties": true } } } } } }, "/api/v1/conversations/events": { "get": { "operationId": "getConversationsEvents", "summary": "Wait for durable conversation changes after a cursor", "tags": [ "Conversations" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "parameters": [ { "name": "after", "in": "query", "required": false, "schema": { "type": "string", "pattern": "^\\d+$" } } ] } }, "/api/v1/conversations/message": { "delete": { "operationId": "deleteConversationsMessage", "summary": "Delete a conversation message", "tags": [ "Conversations" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "conversationId": { "type": "string", "minLength": 1 }, "messageId": { "type": "string", "minLength": 1 }, "turnId": { "type": "string", "minLength": 1 } }, "required": [ "conversationId" ], "additionalProperties": true } } } } }, "post": { "operationId": "postConversationsMessage", "summary": "Add a conversation message", "tags": [ "Conversations" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "conversationId": { "type": "string", "minLength": 1 }, "content": { "type": "string" }, "role": { "type": "string" }, "message": {} }, "required": [ "conversationId" ], "additionalProperties": true } } } } } }, "/api/v1/conversations/share": { "patch": { "operationId": "patchConversationsShare", "summary": "Update conversation sharing", "tags": [ "Conversations" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "conversationId": { "type": "string", "minLength": 1 }, "visibility": { "type": "string", "enum": [ "private", "public" ] } }, "required": [ "conversationId" ], "additionalProperties": true } } } } } }, "/api/v1/conversations/stop": { "post": { "operationId": "postConversationsStop", "summary": "Stop a running conversation turn", "tags": [ "Conversations" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "conversationId": { "type": "string", "minLength": 1 }, "messageId": { "type": "string", "minLength": 1 }, "partialContent": { "type": "string" }, "partialParts": { "type": "array", "items": { "type": "object", "additionalProperties": {} } } }, "required": [ "conversationId" ], "additionalProperties": true } } } } } }, "/api/v1/conversations/stream-auth": { "post": { "operationId": "postConversationsStreamAuth", "summary": "Create a stream auth token", "tags": [ "Conversations" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "conversationId": { "type": "string", "minLength": 1 } }, "additionalProperties": true } } } } } }, "/api/v1/daytona/run": { "post": { "operationId": "postDaytonaRun", "summary": "Run code in a Daytona sandbox", "tags": [ "Tools" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "code": { "type": "string" }, "command": { "type": "string" } }, "additionalProperties": true } } } } } }, "/api/v1/discovery": { "get": { "operationId": "getDiscovery", "summary": "Public Overlay Server discovery metadata", "tags": [ "Discovery" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "description": "Unauthenticated desktop/server discovery: API versions, capabilities, native auth paths, and minimum desktop version. No secrets." } }, "/api/v1/files": { "delete": { "operationId": "deleteFiles", "summary": "Delete a file", "tags": [ "Files" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "parameters": [ { "name": "accessToken", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "userId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "fileId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "fileId": { "type": "string", "minLength": 1 } }, "additionalProperties": false } } } } }, "get": { "operationId": "getFiles", "summary": "List or read files", "tags": [ "Files" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "createdAt", "updatedAt", "name" ], "default": "updatedAt" } }, { "name": "order", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ], "default": "desc" } }, { "name": "fileId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "projectId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "kind", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "parentId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "conversationId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "outputType", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "summary", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "true", "false", "1", "0" ] } } ] }, "patch": { "operationId": "patchFiles", "summary": "Update a file", "tags": [ "Files" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "name": { "type": "string", "minLength": 1 }, "mimeType": { "type": "string" }, "sizeBytes": { "type": "number", "minimum": 0 }, "projectId": { "type": "string", "nullable": true }, "parentId": { "type": "string", "nullable": true }, "conversationId": { "type": "string" }, "kind": { "type": "string" }, "fileId": { "type": "string", "minLength": 1 } }, "required": [ "fileId" ], "additionalProperties": true } } } } }, "post": { "operationId": "postFiles", "summary": "Create a file", "tags": [ "Files" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "name": { "type": "string", "minLength": 1 }, "mimeType": { "type": "string" }, "sizeBytes": { "type": "number", "minimum": 0 }, "projectId": { "type": "string", "nullable": true }, "parentId": { "type": "string", "nullable": true }, "conversationId": { "type": "string" }, "kind": { "type": "string" } }, "additionalProperties": true } } } } } }, "/api/v1/files/{fileId}/content": { "get": { "operationId": "getFilesFileIdContent", "summary": "Download file content", "tags": [ "Files" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "parameters": [ { "name": "fileId", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/api/v1/files/ingest-document": { "post": { "operationId": "postFilesIngestDocument", "summary": "Ingest an uploaded document", "tags": [ "Files" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "additionalProperties": true, "description": "Multipart form data. Field-level schemas are validated server-side." } } } } } }, "/api/v1/files/presign": { "get": { "operationId": "getFilesPresign", "summary": "Presign file access", "tags": [ "Files" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "parameters": [ { "name": "name", "in": "query", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "mimeType", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "sizeBytes", "in": "query", "required": false, "schema": { "type": "string", "pattern": "^\\d+$" } } ] } }, "/api/v1/files/search-text": { "post": { "operationId": "postFilesSearchText", "summary": "Search file text", "tags": [ "Files" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "query": { "type": "string", "minLength": 1 }, "fileId": { "type": "string" } }, "additionalProperties": true } } } } } }, "/api/v1/files/share": { "patch": { "operationId": "patchFilesShare", "summary": "Update file sharing", "tags": [ "Files" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "fileId": { "type": "string", "minLength": 1 }, "visibility": { "type": "string", "enum": [ "private", "public" ] } }, "required": [ "fileId" ], "additionalProperties": true } } } } } }, "/api/v1/files/upload-url": { "post": { "operationId": "postFilesUploadUrl", "summary": "Create an upload URL", "tags": [ "Files" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "sizeBytes": { "type": "number", "minimum": 0 }, "name": { "type": "string", "minLength": 1 }, "mimeType": { "type": "string", "minLength": 1 } }, "required": [ "sizeBytes", "name", "mimeType" ], "additionalProperties": false } } } } } }, "/api/v1/generate-image": { "post": { "operationId": "postGenerateImage", "summary": "Generate an image", "tags": [ "Media" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "prompt": { "type": "string", "minLength": 1 }, "modelId": { "type": "string", "minLength": 1 }, "aspectRatio": { "type": "string", "minLength": 1, "maxLength": 20 }, "conversationId": { "type": "string", "minLength": 1 }, "turnId": { "type": "string", "minLength": 1 }, "imageUrl": { "type": "string", "minLength": 1 }, "temporaryChat": { "type": "boolean" } }, "additionalProperties": true } } } } } }, "/api/v1/generate-tab-group-label": { "post": { "operationId": "postGenerateTabGroupLabel", "summary": "Generate a tab group label", "tags": [ "Tools" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "tabs": { "type": "array", "items": {} } }, "additionalProperties": true } } } } } }, "/api/v1/generate-title": { "post": { "operationId": "postGenerateTitle", "summary": "Generate a conversation title", "tags": [ "Chat" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "conversationId": { "type": "string" }, "messages": { "type": "array", "items": {} }, "prompt": { "type": "string" } }, "additionalProperties": true } } } } } }, "/api/v1/generate-video": { "post": { "operationId": "postGenerateVideo", "summary": "Generate a video", "tags": [ "Media" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "prompt": { "type": "string", "minLength": 1 }, "modelId": { "type": "string", "minLength": 1 }, "aspectRatio": { "type": "string", "minLength": 1, "maxLength": 20 }, "conversationId": { "type": "string", "minLength": 1 }, "turnId": { "type": "string", "minLength": 1 }, "imageUrl": { "type": "string", "minLength": 1, "nullable": true }, "temporaryChat": { "type": "boolean" }, "duration": { "type": "number", "exclusiveMinimum": true, "minimum": 0 }, "videoSubMode": { "type": "string", "enum": [ "text-to-video", "image-to-video", "reference-to-video", "motion-control", "video-editing" ] } }, "additionalProperties": true } } } } } }, "/api/v1/integrations": { "get": { "operationId": "getIntegrations", "summary": "List integrations", "tags": [ "Integrations" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "createdAt", "updatedAt", "name" ], "default": "updatedAt" } }, { "name": "order", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ], "default": "desc" } }, { "name": "action", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" } } ] }, "post": { "operationId": "postIntegrations", "summary": "Connect an integration", "tags": [ "Integrations" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "providerKey": { "type": "string" }, "toolkit": { "type": "string" }, "slug": { "type": "string" }, "redirectUrl": { "type": "string", "format": "uri" } }, "additionalProperties": true } } } } } }, "/api/v1/knowledge/search": { "post": { "operationId": "postKnowledgeSearch", "summary": "Search knowledge", "tags": [ "Knowledge" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "query": { "type": "string", "minLength": 1 }, "projectId": { "type": "string" }, "limit": { "type": "integer", "exclusiveMinimum": true, "minimum": 0 } }, "additionalProperties": true } } } } } }, "/api/v1/mcps": { "delete": { "operationId": "deleteMcps", "summary": "Delete an MCP server", "tags": [ "MCP Servers" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "parameters": [ { "name": "accessToken", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "userId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "skillId", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "mcpServerId", "in": "query", "required": false, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "skillId": { "type": "string" }, "mcpServerId": { "type": "string" } }, "additionalProperties": false } } } } }, "get": { "operationId": "getMcps", "summary": "List MCP servers", "tags": [ "MCP Servers" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "createdAt", "updatedAt", "name" ], "default": "updatedAt" } }, { "name": "order", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ], "default": "desc" } }, { "name": "projectId", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "skillId", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "mcpServerId", "in": "query", "required": false, "schema": { "type": "string" } } ] }, "patch": { "operationId": "patchMcps", "summary": "Update an MCP server", "tags": [ "MCP Servers" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "name": { "type": "string" }, "projectId": { "type": "string" } }, "additionalProperties": true } } } } }, "post": { "operationId": "postMcps", "summary": "Create an MCP server", "tags": [ "MCP Servers" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "name": { "type": "string" }, "projectId": { "type": "string" } }, "additionalProperties": true } } } } } }, "/api/v1/mcps/oauth": { "delete": { "operationId": "deleteMcpsOauth", "summary": "Disconnect OAuth for an MCP server", "tags": [ "MCP Servers" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "parameters": [ { "name": "mcpServerId", "in": "query", "required": true, "schema": { "type": "string", "minLength": 1 } } ] }, "post": { "operationId": "postMcpsOauth", "summary": "Start an OAuth authorization for an MCP server", "tags": [ "MCP Servers" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "mcpServerId": { "type": "string", "minLength": 1 }, "returnTo": { "type": "string" }, "scope": { "type": "string" }, "surface": { "type": "string", "enum": [ "web", "desktop" ] } }, "required": [ "mcpServerId" ], "additionalProperties": true } } } } } }, "/api/v1/mcps/test": { "post": { "operationId": "postMcpsTest", "summary": "Test an MCP server", "tags": [ "MCP Servers" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "mcpServerId": { "type": "string" } }, "additionalProperties": true } } } } } }, "/api/v1/memory": { "delete": { "operationId": "deleteMemory", "summary": "Delete a memory", "tags": [ "Memory" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "parameters": [ { "name": "accessToken", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "userId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "memoryId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "memoryId": { "type": "string", "minLength": 1 } }, "additionalProperties": false } } } } }, "get": { "operationId": "getMemory", "summary": "List memories", "tags": [ "Memory" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "createdAt", "updatedAt", "name" ], "default": "updatedAt" } }, { "name": "order", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ], "default": "desc" } }, { "name": "memoryId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "raw", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "true", "false", "1", "0" ] } }, { "name": "updatedSince", "in": "query", "required": false, "schema": { "type": "string", "pattern": "^\\d+$" } }, { "name": "includeDeleted", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "true", "false", "1", "0" ] } }, { "name": "projectId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "conversationId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "noteId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } } ] }, "patch": { "operationId": "patchMemory", "summary": "Update a memory", "tags": [ "Memory" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "content": { "type": "string", "minLength": 1 }, "type": { "type": "string" }, "source": {}, "memoryId": { "type": "string", "minLength": 1 } }, "required": [ "memoryId" ], "additionalProperties": true } } } } }, "post": { "operationId": "postMemory", "summary": "Create a memory", "tags": [ "Memory" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "content": { "type": "string", "minLength": 1 }, "type": { "type": "string" }, "source": {} }, "additionalProperties": true } } } } } }, "/api/v1/model-catalog": { "get": { "operationId": "getModelCatalog", "summary": "Read the model catalog", "tags": [ "Models" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "description": "Pass refresh=1 to force a gateway catalog refresh.", "parameters": [ { "name": "refresh", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "1" ] } } ] } }, "/api/v1/notebook-agent": { "post": { "operationId": "postNotebookAgent", "summary": "Run the notebook agent", "tags": [ "Notes" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "noteId": { "type": "string" }, "prompt": { "type": "string" } }, "additionalProperties": true } } } } } }, "/api/v1/notes": { "delete": { "operationId": "deleteNotes", "summary": "Delete a note", "tags": [ "Notes" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "parameters": [ { "name": "accessToken", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "userId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "noteId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "noteId": { "type": "string", "minLength": 1 } }, "additionalProperties": false } } } } }, "get": { "operationId": "getNotes", "summary": "List notes", "tags": [ "Notes" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "createdAt", "updatedAt", "name" ], "default": "updatedAt" } }, { "name": "order", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ], "default": "desc" } }, { "name": "noteId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "projectId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "includeDeleted", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "true", "false", "1", "0" ] } } ] }, "patch": { "operationId": "patchNotes", "summary": "Update a note", "tags": [ "Notes" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "title": { "type": "string", "maxLength": 200 }, "content": { "type": "string" }, "projectId": { "type": "string" }, "noteId": { "type": "string", "minLength": 1 } }, "required": [ "noteId" ], "additionalProperties": false } } } } }, "post": { "operationId": "postNotes", "summary": "Create a note", "tags": [ "Notes" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "title": { "type": "string", "maxLength": 200 }, "content": { "type": "string" }, "projectId": { "type": "string" } }, "additionalProperties": false } } } } } }, "/api/v1/onboarding/complete": { "post": { "operationId": "postOnboardingComplete", "summary": "Complete onboarding", "tags": [ "Onboarding" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 } }, "additionalProperties": true } } } } } }, "/api/v1/onboarding/reset": { "post": { "operationId": "postOnboardingReset", "summary": "Reset onboarding", "tags": [ "Onboarding" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 } }, "additionalProperties": true } } } } } }, "/api/v1/onboarding/status": { "get": { "operationId": "getOnboardingStatus", "summary": "Read onboarding status", "tags": [ "Onboarding" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/api/v1/outputs": { "delete": { "operationId": "deleteOutputs", "summary": "Delete an output", "tags": [ "Outputs" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "parameters": [ { "name": "accessToken", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "userId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "outputId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "outputId": { "type": "string", "minLength": 1 } }, "additionalProperties": false } } } } }, "get": { "operationId": "getOutputs", "summary": "List outputs", "tags": [ "Outputs" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "createdAt", "updatedAt", "name" ], "default": "updatedAt" } }, { "name": "order", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ], "default": "desc" } }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "conversationId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } } ] } }, "/api/v1/outputs/{outputId}/content": { "get": { "operationId": "getOutputsOutputIdContent", "summary": "Download output content", "tags": [ "Outputs" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "parameters": [ { "name": "outputId", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/api/v1/projects": { "delete": { "operationId": "deleteProjects", "summary": "Delete a project", "tags": [ "Projects" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "parameters": [ { "name": "accessToken", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "userId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "projectId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "projectId": { "type": "string", "minLength": 1 } }, "additionalProperties": false } } } } }, "get": { "operationId": "getProjects", "summary": "List projects", "tags": [ "Projects" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "createdAt", "updatedAt", "name" ], "default": "updatedAt" } }, { "name": "order", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ], "default": "desc" } }, { "name": "projectId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "updatedSince", "in": "query", "required": false, "schema": { "type": "string", "pattern": "^\\d+$" } }, { "name": "includeDeleted", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "true", "false", "1", "0" ] } } ] }, "patch": { "operationId": "patchProjects", "summary": "Update a project", "tags": [ "Projects" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "name": { "type": "string", "minLength": 1, "maxLength": 200 }, "parentId": { "type": "string", "minLength": 1, "nullable": true }, "instructions": { "type": "string" }, "clientId": { "type": "string" }, "description": { "type": "string" }, "color": { "type": "string" }, "projectId": { "type": "string", "minLength": 1 } }, "required": [ "projectId" ], "additionalProperties": true } } } } }, "post": { "operationId": "postProjects", "summary": "Create a project", "tags": [ "Projects" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "name": { "type": "string", "minLength": 1, "maxLength": 200 }, "parentId": { "type": "string", "minLength": 1, "nullable": true }, "instructions": { "type": "string" }, "clientId": { "type": "string" }, "description": { "type": "string" }, "color": { "type": "string" } }, "additionalProperties": true } } } } } }, "/api/v1/providers/connections": { "delete": { "operationId": "deleteProvidersConnections", "summary": "Delete a model provider connection", "tags": [ "Model Providers" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "parameters": [ { "name": "connectionId", "in": "query", "required": true, "schema": { "type": "string", "minLength": 1 } } ] }, "get": { "operationId": "getProvidersConnections", "summary": "List model provider connections", "tags": [ "Model Providers" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "patch": { "operationId": "patchProvidersConnections", "summary": "Update a model provider connection", "tags": [ "Model Providers" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "connectionId": { "type": "string" }, "providerId": { "type": "string" }, "endpoint": { "type": "string", "format": "uri" }, "displayName": { "type": "string" }, "apiKey": { "type": "string" }, "enabledModelIds": { "type": "array", "items": { "type": "string" } }, "status": { "type": "string", "enum": [ "active", "error", "untested" ] } }, "additionalProperties": true } } } } }, "post": { "operationId": "postProvidersConnections", "summary": "Create a model provider connection", "tags": [ "Model Providers" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "connectionId": { "type": "string" }, "providerId": { "type": "string" }, "endpoint": { "type": "string", "format": "uri" }, "displayName": { "type": "string" }, "apiKey": { "type": "string" }, "enabledModelIds": { "type": "array", "items": { "type": "string" } }, "status": { "type": "string", "enum": [ "active", "error", "untested" ] } }, "additionalProperties": true } } } } } }, "/api/v1/providers/connections/test": { "post": { "operationId": "postProvidersConnectionsTest", "summary": "Test a model provider connection and discover models", "tags": [ "Model Providers" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "connectionId": { "type": "string" }, "providerId": { "type": "string" }, "endpoint": { "type": "string", "format": "uri" }, "apiKey": { "type": "string" } }, "additionalProperties": false } } } } } }, "/api/v1/settings": { "get": { "operationId": "getSettings", "summary": "Read settings", "tags": [ "Settings" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "patch": { "operationId": "patchSettings", "summary": "Update settings", "tags": [ "Settings" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "theme": { "type": "string", "enum": [ "light", "dark" ] }, "lightThemePreset": { "type": "string" }, "darkThemePreset": { "type": "string" }, "autoContinue": { "type": "boolean" }, "defaultChatMode": { "type": "string", "enum": [ "ask", "act" ] }, "modelPreference": { "type": "string", "enum": [ "same-for-each-chat", "different-for-each-chat" ] }, "defaultAskModelIds": { "type": "array", "items": { "type": "string" } }, "defaultActModelId": { "type": "string" }, "defaultImageModelId": { "type": "string" }, "defaultVideoModelId": { "type": "string" }, "defaultImageAspectRatio": { "type": "string" }, "defaultVideoAspectRatio": { "type": "string" }, "sendWithEnter": { "type": "boolean" }, "attachFilesToKnowledgeByDefault": { "type": "boolean" }, "onlyAllowZdrModels": { "type": "boolean" }, "dismissedZdrWarningGlobally": { "type": "boolean" }, "dismissedZdrWarningModelIds": { "type": "array", "items": { "type": "string" } }, "chatStreamingMode": { "type": "string", "enum": [ "token", "chunk" ] } }, "additionalProperties": true } } } } } }, "/api/v1/skills": { "delete": { "operationId": "deleteSkills", "summary": "Delete a skill", "tags": [ "Skills" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "parameters": [ { "name": "accessToken", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "userId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "skillId", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "mcpServerId", "in": "query", "required": false, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "skillId": { "type": "string" }, "mcpServerId": { "type": "string" } }, "additionalProperties": false } } } } }, "get": { "operationId": "getSkills", "summary": "List skills", "tags": [ "Skills" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "parameters": [ { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "createdAt", "updatedAt", "name" ], "default": "updatedAt" } }, { "name": "order", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ], "default": "desc" } }, { "name": "projectId", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "skillId", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "mcpServerId", "in": "query", "required": false, "schema": { "type": "string" } } ] }, "patch": { "operationId": "patchSkills", "summary": "Update a skill", "tags": [ "Skills" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "name": { "type": "string" }, "projectId": { "type": "string" } }, "additionalProperties": true } } } } }, "post": { "operationId": "postSkills", "summary": "Create a skill", "tags": [ "Skills" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "name": { "type": "string" }, "projectId": { "type": "string" } }, "additionalProperties": true } } } } } }, "/api/v1/subscription": { "get": { "operationId": "getSubscription", "summary": "Read subscription state", "tags": [ "Billing" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/api/v1/subscription/settings": { "get": { "operationId": "getSubscriptionSettings", "summary": "Read billing settings", "tags": [ "Billing" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "postSubscriptionSettings", "summary": "Update billing settings", "tags": [ "Billing" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "autoTopUpEnabled": { "type": "boolean" }, "confirmation": { "type": "string", "enum": [ "UPDATE_BILLING_SETTINGS" ] }, "grantOffSessionConsent": { "type": "boolean" }, "topUpAmountCents": { "type": "number" }, "autoTopUpAmountCents": { "type": "number" } }, "required": [ "autoTopUpEnabled", "confirmation" ], "additionalProperties": true } } } } } }, "/api/v1/transcribe": { "post": { "operationId": "postTranscribe", "summary": "Transcribe audio", "tags": [ "Media" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "additionalProperties": true, "description": "Multipart form data. Field-level schemas are validated server-side." } } } } } }, "/api/v1/webhooks": { "delete": { "operationId": "deleteWebhooks", "summary": "Delete a webhook subscription", "tags": [ "Webhooks" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "parameters": [ { "name": "accessToken", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "userId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "subscriptionId", "in": "query", "required": true, "schema": { "type": "string", "minLength": 1 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "subscriptionId": { "type": "string", "minLength": 1 } }, "required": [ "subscriptionId" ], "additionalProperties": false } } } } }, "get": { "operationId": "getWebhooks", "summary": "List webhook subscriptions", "tags": [ "Webhooks" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "parameters": [ { "name": "accessToken", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "userId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } } ] }, "patch": { "operationId": "patchWebhooks", "summary": "Update a webhook subscription", "tags": [ "Webhooks" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 }, "subscriptionId": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" }, "events": { "type": "array", "items": { "type": "string", "enum": [ "chat.completed", "chat.failed", "automation.finished", "automation.failed" ] }, "minItems": 1 }, "description": { "type": "string", "maxLength": 500 }, "enabled": { "type": "boolean" } }, "required": [ "subscriptionId" ], "additionalProperties": true } } } } }, "post": { "operationId": "postWebhooks", "summary": "Create a webhook subscription", "tags": [ "Webhooks" ], "security": [ { "browserSession": [] }, { "bearerAuth": [] } ], "responses": { "200": { "description": "Successful response. Stable response schemas are documented in workflow guides when available.", "content": { "application/json": { "schema": { "description": "Response shape is route-specific and may be backed by @overlay/app-core contracts." } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Missing or invalid authentication.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Unexpected server error.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string", "format": "uri" }, "events": { "type": "array", "items": { "type": "string", "enum": [ "chat.completed", "chat.failed", "automation.finished", "automation.failed" ] }, "minItems": 1 }, "description": { "type": "string", "maxLength": 500 }, "enabled": { "type": "boolean", "default": true }, "accessToken": { "type": "string", "minLength": 1 }, "userId": { "type": "string", "minLength": 1 } }, "required": [ "url", "events" ], "additionalProperties": true } } } } } } }, "components": { "securitySchemes": { "browserSession": { "type": "apiKey", "in": "cookie", "name": "overlay_session", "description": "Signed httpOnly browser session cookie." }, "bearerAuth": { "type": "http", "scheme": "bearer", "description": "WorkOS bearer access token for native or service clients." } }, "schemas": { "ErrorResponse": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } }, "additionalProperties": true } } } }