{ "openapi": "3.0.0", "paths": { "/api/v1/usage/summary": { "get": { "operationId": "UsageController_summary", "parameters": [], "responses": { "200": { "description": "" } }, "tags": [ "usage" ] } }, "/api/v1/auth/login": { "post": { "operationId": "AuthController_login", "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "email": { "type": "string", "maxLength": 254, "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, "password": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "email", "password" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "" } }, "tags": [ "auth" ] } }, "/api/v1/auth/register": { "post": { "operationId": "AuthController_register", "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "email": { "type": "string", "maxLength": 254, "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, "password": { "type": "string", "minLength": 10, "maxLength": 200 }, "displayName": { "type": "string", "maxLength": 80 }, "workspaceName": { "type": "string", "minLength": 2, "maxLength": 80 } }, "required": [ "email", "password" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "" } }, "tags": [ "auth" ] } }, "/api/v1/auth/logout": { "post": { "operationId": "AuthController_logout", "parameters": [], "responses": { "204": { "description": "" } }, "tags": [ "auth" ] } }, "/api/v1/me": { "get": { "operationId": "AuthController_me", "parameters": [], "responses": { "200": { "description": "" } }, "tags": [ "auth" ] } }, "/api/v1/tenants/current": { "get": { "operationId": "TenantsController_current", "parameters": [], "responses": { "200": { "description": "" } }, "tags": [ "tenants" ] } }, "/api/v1/me/profile": { "patch": { "operationId": "AccountController_profile", "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "displayName": { "anyOf": [ { "type": "string", "maxLength": 80 }, { "type": "null" } ] }, "preferredName": { "anyOf": [ { "type": "string", "maxLength": 60 }, { "type": "null" } ] } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "" } }, "tags": [ "account" ] } }, "/api/v1/me/preferences": { "patch": { "operationId": "AccountController_preferences", "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "theme": { "type": "string", "enum": [ "system", "light", "dark" ] }, "language": { "type": "string", "enum": [ "en", "id" ] }, "memoryEnabled": { "type": "boolean" }, "memoryAutoLearn": { "type": "boolean" }, "notificationsEnabled": { "type": "boolean" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "" } }, "tags": [ "account" ] } }, "/api/v1/me/memories": { "get": { "operationId": "AccountController_memories", "parameters": [], "responses": { "200": { "description": "" } }, "tags": [ "account" ] }, "post": { "operationId": "AccountController_remember", "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "content": { "type": "string", "minLength": 1, "maxLength": 500 } }, "required": [ "content" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "" } }, "tags": [ "account" ] }, "delete": { "operationId": "AccountController_forgetAll", "parameters": [], "responses": { "200": { "description": "" } }, "tags": [ "account" ] } }, "/api/v1/me/memories/{memoryId}": { "delete": { "operationId": "AccountController_forget", "parameters": [ { "name": "memoryId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "account" ] } }, "/api/v1/me/secrets": { "get": { "operationId": "AccountController_secrets", "parameters": [], "responses": { "200": { "description": "" } }, "tags": [ "account" ] }, "post": { "operationId": "AccountController_addSecret", "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "maxLength": 80 }, "loginUrl": { "type": "string", "maxLength": 2000, "format": "uri" }, "username": { "type": "string", "minLength": 1, "maxLength": 320 }, "password": { "type": "string", "minLength": 1, "maxLength": 1000 } }, "required": [ "loginUrl", "username", "password" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "" } }, "tags": [ "account" ] } }, "/api/v1/me/secrets/{secretId}": { "delete": { "operationId": "AccountController_deleteSecret", "parameters": [ { "name": "secretId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "account" ] } }, "/api/v1/me/secrets/{secretId}/reveal": { "post": { "operationId": "AccountController_reveal", "parameters": [ { "name": "secretId", "required": true, "in": "path", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "password": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "password" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "" } }, "tags": [ "account" ] } }, "/api/v1/me/export": { "get": { "operationId": "AccountController_exportData", "parameters": [], "responses": { "200": { "description": "" } }, "tags": [ "account" ] } }, "/api/v1/me/delete-account": { "post": { "operationId": "AccountController_deleteAccount", "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "password": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "password" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "" } }, "tags": [ "account" ] } }, "/api/v1/desktop-sessions": { "get": { "operationId": "DesktopsController_all", "parameters": [], "responses": { "200": { "description": "" } }, "tags": [ "desktops" ] } }, "/api/v1/bots/{botId}/desktop-sessions": { "get": { "operationId": "DesktopsController_list", "parameters": [ { "name": "botId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "desktops" ] }, "post": { "operationId": "DesktopsController_start", "parameters": [ { "name": "botId", "required": true, "in": "path", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "task": { "type": "string", "maxLength": 2000 } }, "additionalProperties": false } } } }, "responses": { "201": { "description": "" } }, "tags": [ "desktops" ] } }, "/api/v1/desktop-sessions/{sessionId}": { "get": { "operationId": "DesktopsController_detail", "parameters": [ { "name": "sessionId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "desktops" ] } }, "/api/v1/desktop-sessions/{sessionId}/stop": { "post": { "operationId": "DesktopsController_stop", "parameters": [ { "name": "sessionId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "201": { "description": "" } }, "tags": [ "desktops" ] } }, "/api/v1/bots": { "get": { "operationId": "BotsController_list", "parameters": [], "responses": { "200": { "description": "" } }, "tags": [ "bots" ] }, "post": { "operationId": "BotsController_create", "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 80 }, "description": { "type": "string", "maxLength": 500 }, "avatar": { "type": "string", "maxLength": 16 }, "character": { "type": "object", "properties": { "outfit": { "type": "string", "enum": [ "default", "casual", "pro", "cool", "female" ] }, "hat": { "type": "string", "pattern": "^#[0-9a-fA-F]{6}$" }, "accessory": { "type": "string", "enum": [ "none", "glasses", "sunglasses" ] } }, "required": [ "outfit" ], "additionalProperties": false }, "defaultMode": { "type": "string", "enum": [ "nalar", "patih", "cendikia" ] }, "instructions": { "type": "string", "maxLength": 8000 }, "ownComputerAccess": { "type": "boolean" }, "ttsVoice": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 40 }, { "type": "null" } ] }, "realtimeVoice": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 40 }, { "type": "null" } ] } }, "required": [ "name" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "" } }, "tags": [ "bots" ] } }, "/api/v1/bots/archived": { "get": { "operationId": "BotsController_archived", "parameters": [], "responses": { "200": { "description": "" } }, "tags": [ "bots" ] } }, "/api/v1/bots/{botId}": { "get": { "operationId": "BotsController_get", "parameters": [ { "name": "botId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "bots" ] }, "patch": { "operationId": "BotsController_update", "parameters": [ { "name": "botId", "required": true, "in": "path", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 80 }, "description": { "type": "string", "maxLength": 500 }, "avatar": { "type": "string", "maxLength": 16 }, "character": { "type": "object", "properties": { "outfit": { "type": "string", "enum": [ "default", "casual", "pro", "cool", "female" ] }, "hat": { "type": "string", "pattern": "^#[0-9a-fA-F]{6}$" }, "accessory": { "type": "string", "enum": [ "none", "glasses", "sunglasses" ] } }, "required": [ "outfit" ], "additionalProperties": false }, "defaultMode": { "type": "string", "enum": [ "nalar", "patih", "cendikia" ] }, "instructions": { "type": "string", "maxLength": 8000 }, "ownComputerAccess": { "type": "boolean" }, "ttsVoice": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 40 }, { "type": "null" } ] }, "realtimeVoice": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 40 }, { "type": "null" } ] } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "" } }, "tags": [ "bots" ] }, "delete": { "operationId": "BotsController_archive", "parameters": [ { "name": "botId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "bots" ] } }, "/api/v1/bots/{botId}/activity": { "get": { "operationId": "BotsController_activity", "parameters": [ { "name": "botId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "bots" ] } }, "/api/v1/bots/{botId}/restore": { "post": { "operationId": "BotsController_restore", "parameters": [ { "name": "botId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "201": { "description": "" } }, "tags": [ "bots" ] } }, "/api/v1/bots/{botId}/permanent": { "delete": { "operationId": "BotsController_destroy", "parameters": [ { "name": "botId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "bots" ] } }, "/api/v1/agent-runs": { "post": { "operationId": "AgentsController_create", "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "conversationId": { "type": "string" }, "botId": { "type": "string" }, "message": { "type": "string", "minLength": 1, "maxLength": 20000 }, "mode": { "type": "string", "enum": [ "nalar", "patih", "cendikia" ] }, "attachmentIds": { "maxItems": 5, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 64 } }, "mentions": { "maxItems": 10, "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "connector", "plugin", "mini_program" ] }, "ref": { "type": "string", "minLength": 1, "maxLength": 120 }, "name": { "type": "string", "minLength": 1, "maxLength": 120 } }, "required": [ "type", "ref", "name" ], "additionalProperties": false } } }, "required": [ "message" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "" } }, "tags": [ "agent-runs" ] }, "get": { "operationId": "AgentsController_list", "parameters": [ { "name": "botId", "required": true, "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "agent-runs" ] } }, "/api/v1/agent-runs/{runId}": { "get": { "operationId": "AgentsController_get", "parameters": [ { "name": "runId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "agent-runs" ] } }, "/api/v1/agent-runs/{runId}/cancel": { "post": { "operationId": "AgentsController_cancel", "parameters": [ { "name": "runId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "201": { "description": "" } }, "tags": [ "agent-runs" ] } }, "/api/v1/agent-runs/{runId}/tool-executions": { "get": { "operationId": "AgentsController_toolExecutions", "parameters": [ { "name": "runId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "agent-runs" ] } }, "/api/v1/agent-runs/{runId}/events": { "get": { "operationId": "AgentsController_stream", "parameters": [ { "name": "runId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "agent-runs" ] } }, "/api/v1/chats": { "get": { "operationId": "AgentsController_chats", "parameters": [], "responses": { "200": { "description": "" } }, "tags": [ "agent-runs" ] } }, "/api/v1/chats/thread": { "get": { "operationId": "AgentsController_chatThread", "parameters": [ { "name": "botId", "required": true, "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "agent-runs" ] } }, "/api/v1/chats/thread/messages": { "delete": { "operationId": "AgentsController_clearChat", "parameters": [ { "name": "botId", "required": true, "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "agent-runs" ] } }, "/api/v1/conversations": { "get": { "operationId": "AgentsController_conversations", "parameters": [ { "name": "botId", "required": true, "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "agent-runs" ] } }, "/api/v1/conversations/{conversationId}": { "get": { "operationId": "AgentsController_conversation", "parameters": [ { "name": "conversationId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "agent-runs" ] }, "patch": { "operationId": "AgentsController_rename", "parameters": [ { "name": "conversationId", "required": true, "in": "path", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1, "maxLength": 120 } }, "required": [ "title" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "" } }, "tags": [ "agent-runs" ] }, "delete": { "operationId": "AgentsController_removeConversation", "parameters": [ { "name": "conversationId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "agent-runs" ] } }, "/api/v1/conversations/{conversationId}/messages": { "get": { "operationId": "AgentsController_messages", "parameters": [ { "name": "conversationId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "agent-runs" ] } }, "/api/v1/approvals/pending": { "get": { "operationId": "AgentsController_pending", "parameters": [], "responses": { "200": { "description": "" } }, "tags": [ "agent-runs" ] } }, "/api/v1/approvals/{approvalId}/decision": { "post": { "operationId": "AgentsController_decide", "parameters": [ { "name": "approvalId", "required": true, "in": "path", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "decision": { "type": "string", "enum": [ "approve", "reject" ] } }, "required": [ "decision" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "" } }, "tags": [ "agent-runs" ] } }, "/api/v1/attachments": { "post": { "operationId": "AttachmentsController_upload", "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 200 }, "mediaType": { "type": "string", "maxLength": 100 }, "data": { "type": "string", "minLength": 1, "maxLength": 13981018 } }, "required": [ "name", "mediaType", "data" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "" } }, "tags": [ "attachments" ] } }, "/api/v1/attachments/{id}/content": { "get": { "operationId": "AttachmentsController_content", "parameters": [ { "name": "id", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "attachments" ] } }, "/api/v1/attachments/{id}": { "delete": { "operationId": "AttachmentsController_remove", "parameters": [ { "name": "id", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "attachments" ] } }, "/api/v1/ai-features": { "get": { "operationId": "AiMediaController_features", "parameters": [], "responses": { "200": { "description": "" } }, "tags": [ "ai-media" ] } }, "/api/v1/speech": { "post": { "operationId": "AiMediaController_speech", "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "text": { "type": "string", "minLength": 1, "maxLength": 4096 }, "botId": { "type": "string", "minLength": 1, "maxLength": 64 } }, "required": [ "text" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "" } }, "tags": [ "ai-media" ] } }, "/api/v1/transcriptions": { "post": { "operationId": "AiMediaController_transcribe", "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "audio": { "type": "string", "minLength": 1, "maxLength": 34952538 }, "mediaType": { "type": "string", "pattern": "^audio\\/[a-z0-9.+-]+(;.*)?$" } }, "required": [ "audio", "mediaType" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "" } }, "tags": [ "ai-media" ] } }, "/api/v1/bots/{botId}/realtime-sessions": { "post": { "operationId": "AiMediaController_realtime", "parameters": [ { "name": "botId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "201": { "description": "" } }, "tags": [ "ai-media" ] } }, "/api/v1/bots/{botId}/realtime-calls": { "post": { "operationId": "AiMediaController_relayCall", "parameters": [ { "name": "botId", "required": true, "in": "path", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "sdp": { "type": "string", "minLength": 10, "maxLength": 100000 } }, "required": [ "sdp" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "" } }, "tags": [ "ai-media" ] } }, "/api/v1/realtime-calls/{callId}/end": { "post": { "operationId": "AiMediaController_endCall", "parameters": [ { "name": "callId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "ai-media" ] } }, "/api/v1/conversations/{conversationId}/generations": { "post": { "operationId": "AiMediaController_generate", "parameters": [ { "name": "conversationId", "required": true, "in": "path", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "image", "video" ] }, "prompt": { "type": "string", "minLength": 1, "maxLength": 4000 } }, "required": [ "kind", "prompt" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "" } }, "tags": [ "ai-media" ] }, "get": { "operationId": "AiMediaController_generations", "parameters": [ { "name": "conversationId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "ai-media" ] } }, "/api/v1/integrations/catalog": { "get": { "operationId": "IntegrationsController_catalog[0]", "parameters": [ { "name": "q", "required": true, "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "integrations" ] } }, "/api/v1/connector-providers": { "get": { "operationId": "IntegrationsController_catalog[1]", "parameters": [ { "name": "q", "required": true, "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "integrations" ] } }, "/api/v1/integrations/connections": { "get": { "operationId": "IntegrationsController_list[0]", "parameters": [], "responses": { "200": { "description": "" } }, "tags": [ "integrations" ] } }, "/api/v1/connector-connections": { "get": { "operationId": "IntegrationsController_list[1]", "parameters": [], "responses": { "200": { "description": "" } }, "tags": [ "integrations" ] } }, "/api/v1/integrations/{toolkitSlug}/connect": { "post": { "operationId": "IntegrationsController_connect", "parameters": [ { "name": "toolkitSlug", "required": true, "in": "path", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "default": {}, "type": "object", "properties": { "credentials": { "type": "object", "propertyNames": { "type": "string", "maxLength": 100 }, "additionalProperties": { "type": "string", "maxLength": 4000 } }, "label": { "type": "string", "maxLength": 80 }, "returnTo": { "type": "string", "maxLength": 300, "pattern": "^\\/(?!\\/)[A-Za-z0-9/_\\-.~%?=&]*$" } }, "additionalProperties": false } } } }, "responses": { "201": { "description": "" } }, "tags": [ "integrations" ] } }, "/api/v1/integrations/connections/{connectionId}": { "patch": { "operationId": "IntegrationsController_updateConnection[0]", "parameters": [ { "name": "connectionId", "required": true, "in": "path", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "displayLabel": { "type": "string", "minLength": 1, "maxLength": 80 }, "isDefault": { "type": "boolean", "const": true } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "" } }, "tags": [ "integrations" ] }, "get": { "operationId": "IntegrationsController_get[0]", "parameters": [ { "name": "connectionId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "integrations" ] }, "delete": { "operationId": "IntegrationsController_revoke[0]", "parameters": [ { "name": "connectionId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "integrations" ] } }, "/api/v1/connector-connections/{connectionId}": { "patch": { "operationId": "IntegrationsController_updateConnection[1]", "parameters": [ { "name": "connectionId", "required": true, "in": "path", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "displayLabel": { "type": "string", "minLength": 1, "maxLength": 80 }, "isDefault": { "type": "boolean", "const": true } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "" } }, "tags": [ "integrations" ] }, "get": { "operationId": "IntegrationsController_get[1]", "parameters": [ { "name": "connectionId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "integrations" ] }, "delete": { "operationId": "IntegrationsController_revoke[1]", "parameters": [ { "name": "connectionId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "integrations" ] } }, "/api/v1/integrations/callback/verify": { "get": { "operationId": "IntegrationsController_verify", "parameters": [], "responses": { "200": { "description": "" } }, "tags": [ "integrations" ] } }, "/api/v1/integrations/connections/{connectionId}/sync": { "post": { "operationId": "IntegrationsController_sync[0]", "parameters": [ { "name": "connectionId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "201": { "description": "" } }, "tags": [ "integrations" ] } }, "/api/v1/connector-connections/{connectionId}/test": { "post": { "operationId": "IntegrationsController_sync[1]", "parameters": [ { "name": "connectionId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "201": { "description": "" } }, "tags": [ "integrations" ] } }, "/api/v1/connector-connections/{connectionId}/bots": { "put": { "operationId": "IntegrationsController_grant", "parameters": [ { "name": "connectionId", "required": true, "in": "path", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "botId": { "type": "string", "minLength": 1 } }, "required": [ "botId" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "" } }, "tags": [ "integrations" ] } }, "/api/v1/connector-connections/{connectionId}/bots/{botId}": { "delete": { "operationId": "IntegrationsController_ungrant", "parameters": [ { "name": "connectionId", "required": true, "in": "path", "schema": { "type": "string" } }, { "name": "botId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "integrations" ] } }, "/api/v1/integrations/tools/search": { "get": { "operationId": "IntegrationsController_search", "parameters": [], "responses": { "200": { "description": "" } }, "tags": [ "integrations" ] } }, "/api/v1/integrations/tools/{toolSlug}/execute": { "post": { "operationId": "IntegrationsController_execute", "parameters": [ { "name": "toolSlug", "required": true, "in": "path", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "arguments": { "default": {}, "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} }, "approvalId": { "type": "string" }, "idempotencyKey": { "type": "string", "minLength": 8, "maxLength": 200 } }, "required": [ "arguments" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "" } }, "tags": [ "integrations" ] } }, "/api/v1/integrations/policies": { "get": { "operationId": "IntegrationsController_policies", "parameters": [], "responses": { "200": { "description": "" } }, "tags": [ "integrations" ] } }, "/api/v1/integrations/policies/{toolkitSlug}": { "put": { "operationId": "IntegrationsController_setPolicy", "parameters": [ { "name": "toolkitSlug", "required": true, "in": "path", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "authConfigId": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ] }, "toolkitVersion": { "anyOf": [ { "type": "string", "maxLength": 50 }, { "type": "null" } ] }, "allowedTools": { "maxItems": 500, "type": "array", "items": { "type": "string", "maxLength": 100 } }, "deniedTools": { "maxItems": 2000, "type": "array", "items": { "type": "string", "maxLength": 100 } }, "autoRunTools": { "maxItems": 2000, "type": "array", "items": { "type": "string", "maxLength": 100 } }, "askTools": { "maxItems": 2000, "type": "array", "items": { "type": "string", "maxLength": 100 } }, "writeRequiresApproval": { "type": "boolean" } }, "required": [ "enabled" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "" } }, "tags": [ "integrations" ] } }, "/api/v1/skills": { "get": { "operationId": "SkillsController_list", "parameters": [], "responses": { "200": { "description": "" } }, "tags": [ "skills" ] } }, "/api/v1/bots/{botId}/skills/new": { "post": { "operationId": "SkillsController_createForBot", "parameters": [ { "name": "botId", "required": true, "in": "path", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 80 }, "description": { "type": "string", "maxLength": 500 }, "instructions": { "type": "string", "minLength": 1, "maxLength": 20000 } }, "required": [ "name", "instructions" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "" } }, "tags": [ "skills" ] } }, "/api/v1/skills/{skillId}/revise": { "post": { "operationId": "SkillsController_revise", "parameters": [ { "name": "skillId", "required": true, "in": "path", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 80 }, "description": { "type": "string", "maxLength": 500 }, "instructions": { "type": "string", "minLength": 1, "maxLength": 20000 } }, "required": [ "instructions" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "" } }, "tags": [ "skills" ] } }, "/api/v1/skills/{skillId}/sharing": { "patch": { "operationId": "SkillsController_setSharing", "parameters": [ { "name": "skillId", "required": true, "in": "path", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "shared": { "type": "boolean" } }, "required": [ "shared" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "" } }, "tags": [ "skills" ] } }, "/api/v1/skills/{skillId}": { "get": { "operationId": "SkillsController_get", "parameters": [ { "name": "skillId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "skills" ] }, "patch": { "operationId": "SkillsController_setStatus", "parameters": [ { "name": "skillId", "required": true, "in": "path", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "published", "disabled" ] } }, "required": [ "status" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "" } }, "tags": [ "skills" ] } }, "/api/v1/skills/{skillId}/versions": { "post": { "operationId": "SkillsController_addVersion", "parameters": [ { "name": "skillId", "required": true, "in": "path", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "version": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+(-[0-9A-Za-z.-]+)?$" }, "instructions": { "type": "string", "minLength": 1, "maxLength": 20000 }, "inputSchema": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} }, "outputSchema": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} }, "requiredCapabilities": { "default": [], "maxItems": 20, "type": "array", "items": { "type": "string" } }, "compatibility": { "type": "string", "maxLength": 50 } }, "required": [ "version", "instructions", "requiredCapabilities" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "" } }, "tags": [ "skills" ] } }, "/api/v1/skills/{skillId}/versions/{versionId}/publish": { "post": { "operationId": "SkillsController_publish", "parameters": [ { "name": "skillId", "required": true, "in": "path", "schema": { "type": "string" } }, { "name": "versionId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "201": { "description": "" } }, "tags": [ "skills" ] } }, "/api/v1/bots/{botId}/skills": { "get": { "operationId": "SkillsController_botSkills", "parameters": [ { "name": "botId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "skills" ] }, "post": { "operationId": "SkillsController_assign", "parameters": [ { "name": "botId", "required": true, "in": "path", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "skillVersionId": { "type": "string", "minLength": 1 } }, "required": [ "skillVersionId" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "" } }, "tags": [ "skills" ] } }, "/api/v1/bots/{botId}/skills/{assignmentId}": { "delete": { "operationId": "SkillsController_unassign", "parameters": [ { "name": "botId", "required": true, "in": "path", "schema": { "type": "string" } }, { "name": "assignmentId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "skills" ] } }, "/api/v1/documents": { "get": { "operationId": "DocumentsController_list", "parameters": [ { "name": "q", "required": true, "in": "query", "schema": { "type": "string" } }, { "name": "folderId", "required": true, "in": "query", "schema": { "type": "string" } }, { "name": "botId", "required": true, "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "documents" ] }, "post": { "operationId": "DocumentsController_create", "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1, "maxLength": 200 }, "folderId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "content": { "anyOf": [ { "type": "object", "properties": { "format": { "type": "string", "const": "blocks/v1" }, "blocks": { "maxItems": 5000, "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "type": { "type": "string", "const": "heading" }, "level": { "type": "integer", "minimum": 1, "maximum": 3 }, "text": { "type": "string", "maxLength": 20000 } }, "required": [ "type", "level", "text" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "paragraph" }, "text": { "type": "string", "maxLength": 20000 } }, "required": [ "type", "text" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "bullet_list" }, "items": { "maxItems": 500, "type": "array", "items": { "type": "string", "maxLength": 20000 } } }, "required": [ "type", "items" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "numbered_list" }, "items": { "maxItems": 500, "type": "array", "items": { "type": "string", "maxLength": 20000 } } }, "required": [ "type", "items" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "checklist" }, "items": { "maxItems": 500, "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string", "maxLength": 20000 }, "checked": { "type": "boolean" } }, "required": [ "text", "checked" ], "additionalProperties": false } } }, "required": [ "type", "items" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "table" }, "rows": { "maxItems": 500, "type": "array", "items": { "maxItems": 30, "type": "array", "items": { "type": "string", "maxLength": 2000 } } } }, "required": [ "type", "rows" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "code" }, "language": { "type": "string", "maxLength": 30 }, "text": { "type": "string", "maxLength": 100000 } }, "required": [ "type", "text" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "quote" }, "text": { "type": "string", "maxLength": 20000 } }, "required": [ "type", "text" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "link" }, "text": { "type": "string", "maxLength": 20000 }, "href": { "type": "string", "maxLength": 2000 } }, "required": [ "type", "text", "href" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "divider" } }, "required": [ "type" ], "additionalProperties": false } ] } } }, "required": [ "format", "blocks" ], "additionalProperties": false }, { "type": "object", "properties": { "format": { "type": "string", "const": "markdown/v1" }, "markdown": { "type": "string", "maxLength": 500000 } }, "required": [ "format", "markdown" ], "additionalProperties": false } ] }, "markdown": { "type": "string", "maxLength": 500000 } }, "required": [ "title" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "" } }, "tags": [ "documents" ] } }, "/api/v1/documents/{documentId}": { "get": { "operationId": "DocumentsController_get", "parameters": [ { "name": "documentId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "documents" ] }, "patch": { "operationId": "DocumentsController_save", "parameters": [ { "name": "documentId", "required": true, "in": "path", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1, "maxLength": 200 }, "content": { "anyOf": [ { "type": "object", "properties": { "format": { "type": "string", "const": "blocks/v1" }, "blocks": { "maxItems": 5000, "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "type": { "type": "string", "const": "heading" }, "level": { "type": "integer", "minimum": 1, "maximum": 3 }, "text": { "type": "string", "maxLength": 20000 } }, "required": [ "type", "level", "text" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "paragraph" }, "text": { "type": "string", "maxLength": 20000 } }, "required": [ "type", "text" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "bullet_list" }, "items": { "maxItems": 500, "type": "array", "items": { "type": "string", "maxLength": 20000 } } }, "required": [ "type", "items" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "numbered_list" }, "items": { "maxItems": 500, "type": "array", "items": { "type": "string", "maxLength": 20000 } } }, "required": [ "type", "items" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "checklist" }, "items": { "maxItems": 500, "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string", "maxLength": 20000 }, "checked": { "type": "boolean" } }, "required": [ "text", "checked" ], "additionalProperties": false } } }, "required": [ "type", "items" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "table" }, "rows": { "maxItems": 500, "type": "array", "items": { "maxItems": 30, "type": "array", "items": { "type": "string", "maxLength": 2000 } } } }, "required": [ "type", "rows" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "code" }, "language": { "type": "string", "maxLength": 30 }, "text": { "type": "string", "maxLength": 100000 } }, "required": [ "type", "text" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "quote" }, "text": { "type": "string", "maxLength": 20000 } }, "required": [ "type", "text" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "link" }, "text": { "type": "string", "maxLength": 20000 }, "href": { "type": "string", "maxLength": 2000 } }, "required": [ "type", "text", "href" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "divider" } }, "required": [ "type" ], "additionalProperties": false } ] } } }, "required": [ "format", "blocks" ], "additionalProperties": false }, { "type": "object", "properties": { "format": { "type": "string", "const": "markdown/v1" }, "markdown": { "type": "string", "maxLength": 500000 } }, "required": [ "format", "markdown" ], "additionalProperties": false } ] }, "markdown": { "type": "string", "maxLength": 500000 }, "folderId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "baseVersion": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "proposal": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "outcome": { "type": "string", "enum": [ "accepted", "partial" ] } }, "required": [ "id", "outcome" ], "additionalProperties": false } }, "required": [ "baseVersion" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "" } }, "tags": [ "documents" ] }, "delete": { "operationId": "DocumentsController_remove", "parameters": [ { "name": "documentId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "documents" ] } }, "/api/v1/documents/{documentId}/backlinks": { "get": { "operationId": "DocumentsController_backlinks", "parameters": [ { "name": "documentId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "documents" ] } }, "/api/v1/documents/{documentId}/agent-thread": { "get": { "operationId": "DocumentsController_agentThread", "parameters": [ { "name": "documentId", "required": true, "in": "path", "schema": { "type": "string" } }, { "name": "botId", "required": true, "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "documents" ] } }, "/api/v1/documents/{documentId}/proposals": { "get": { "operationId": "DocumentsController_proposals", "parameters": [ { "name": "documentId", "required": true, "in": "path", "schema": { "type": "string" } }, { "name": "status", "required": true, "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "documents" ] } }, "/api/v1/document-proposals/{proposalId}/reject": { "post": { "operationId": "DocumentsController_rejectProposal", "parameters": [ { "name": "proposalId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "201": { "description": "" } }, "tags": [ "documents" ] } }, "/api/v1/documents/{documentId}/duplicate": { "post": { "operationId": "DocumentsController_duplicate", "parameters": [ { "name": "documentId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "201": { "description": "" } }, "tags": [ "documents" ] } }, "/api/v1/documents/{documentId}/versions": { "get": { "operationId": "DocumentsController_versions", "parameters": [ { "name": "documentId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "documents" ] } }, "/api/v1/documents/{documentId}/versions/{version}": { "get": { "operationId": "DocumentsController_version", "parameters": [ { "name": "documentId", "required": true, "in": "path", "schema": { "type": "string" } }, { "name": "version", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "documents" ] } }, "/api/v1/documents/{documentId}/versions/{version}/restore": { "post": { "operationId": "DocumentsController_restore", "parameters": [ { "name": "documentId", "required": true, "in": "path", "schema": { "type": "string" } }, { "name": "version", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "201": { "description": "" } }, "tags": [ "documents" ] } }, "/api/v1/documents/{documentId}/export": { "get": { "operationId": "DocumentsController_export", "parameters": [ { "name": "documentId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "documents" ] } }, "/api/v1/document-folders": { "get": { "operationId": "DocumentsController_folders", "parameters": [], "responses": { "200": { "description": "" } }, "tags": [ "documents" ] }, "post": { "operationId": "DocumentsController_createFolder", "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 100 }, "parentId": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "name" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "" } }, "tags": [ "documents" ] } }, "/api/v1/schedules": { "get": { "operationId": "SchedulesController_list", "parameters": [ { "name": "botId", "required": true, "in": "query", "schema": { "type": "string" } }, { "name": "enabled", "required": true, "in": "query", "schema": { "type": "string" } }, { "name": "scope", "required": true, "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "schedules" ] } }, "/api/v1/schedules/calendar": { "get": { "operationId": "SchedulesController_calendar", "parameters": [ { "name": "from", "required": true, "in": "query", "schema": { "type": "string" } }, { "name": "to", "required": true, "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "schedules" ] } }, "/api/v1/bots/{botId}/schedules": { "get": { "operationId": "SchedulesController_botSchedules", "parameters": [ { "name": "botId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "schedules" ] }, "post": { "operationId": "SchedulesController_create", "parameters": [ { "name": "botId", "required": true, "in": "path", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 120 }, "description": { "type": "string", "maxLength": 1000 }, "taskInput": { "type": "string", "minLength": 1, "maxLength": 10000 }, "scheduleType": { "type": "string", "enum": [ "once", "interval", "cron" ] }, "scheduleValue": { "type": "string", "minLength": 1, "maxLength": 100 }, "timezone": { "type": "string", "minLength": 1, "maxLength": 64 }, "enabled": { "default": true, "type": "boolean" }, "misfirePolicy": { "default": "run_once", "type": "string", "enum": [ "run_once", "skip" ] }, "timeoutSeconds": { "default": 300, "type": "integer", "minimum": 30, "maximum": 3600 }, "maxRetries": { "default": 0, "type": "integer", "minimum": 0, "maximum": 5 }, "approvalPolicy": { "default": "require", "type": "string", "enum": [ "require", "deny" ] }, "mode": { "default": "patih", "type": "string", "enum": [ "nalar", "patih", "cendikia" ] } }, "required": [ "name", "taskInput", "scheduleType", "scheduleValue", "timezone", "enabled", "misfirePolicy", "timeoutSeconds", "maxRetries", "approvalPolicy", "mode" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "" } }, "tags": [ "schedules" ] } }, "/api/v1/schedules/{scheduleId}": { "get": { "operationId": "SchedulesController_get", "parameters": [ { "name": "scheduleId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "schedules" ] }, "patch": { "operationId": "SchedulesController_update", "parameters": [ { "name": "scheduleId", "required": true, "in": "path", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 120 }, "description": { "type": "string", "maxLength": 1000 }, "taskInput": { "type": "string", "minLength": 1, "maxLength": 10000 }, "scheduleType": { "type": "string", "enum": [ "once", "interval", "cron" ] }, "scheduleValue": { "type": "string", "minLength": 1, "maxLength": 100 }, "timezone": { "type": "string", "minLength": 1, "maxLength": 64 }, "enabled": { "default": true, "type": "boolean" }, "misfirePolicy": { "default": "run_once", "type": "string", "enum": [ "run_once", "skip" ] }, "timeoutSeconds": { "default": 300, "type": "integer", "minimum": 30, "maximum": 3600 }, "maxRetries": { "default": 0, "type": "integer", "minimum": 0, "maximum": 5 }, "approvalPolicy": { "default": "require", "type": "string", "enum": [ "require", "deny" ] }, "mode": { "default": "patih", "type": "string", "enum": [ "nalar", "patih", "cendikia" ] } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "" } }, "tags": [ "schedules" ] }, "delete": { "operationId": "SchedulesController_remove", "parameters": [ { "name": "scheduleId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "schedules" ] } }, "/api/v1/schedules/{scheduleId}/pause": { "post": { "operationId": "SchedulesController_pause", "parameters": [ { "name": "scheduleId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "201": { "description": "" } }, "tags": [ "schedules" ] } }, "/api/v1/schedules/{scheduleId}/resume": { "post": { "operationId": "SchedulesController_resume", "parameters": [ { "name": "scheduleId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "201": { "description": "" } }, "tags": [ "schedules" ] } }, "/api/v1/schedules/{scheduleId}/run-now": { "post": { "operationId": "SchedulesController_runNow", "parameters": [ { "name": "scheduleId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "201": { "description": "" } }, "tags": [ "schedules" ] } }, "/api/v1/schedules/{scheduleId}/duplicate": { "post": { "operationId": "SchedulesController_duplicate", "parameters": [ { "name": "scheduleId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "201": { "description": "" } }, "tags": [ "schedules" ] } }, "/api/v1/scheduled-runs": { "get": { "operationId": "SchedulesController_runs", "parameters": [ { "name": "scheduleId", "required": true, "in": "query", "schema": { "type": "string" } }, { "name": "status", "required": true, "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "schedules" ] } }, "/api/v1/scheduled-runs/{runId}": { "get": { "operationId": "SchedulesController_run", "parameters": [ { "name": "runId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "schedules" ] } }, "/api/v1/scheduled-runs/{runId}/retry": { "post": { "operationId": "SchedulesController_retry", "parameters": [ { "name": "runId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "201": { "description": "" } }, "tags": [ "schedules" ] } }, "/api/v1/plugins": { "get": { "operationId": "PluginsController_catalog", "parameters": [ { "name": "q", "required": true, "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "plugins" ] } }, "/api/v1/plugin-installations": { "get": { "operationId": "PluginsController_installations", "parameters": [], "responses": { "200": { "description": "" } }, "tags": [ "plugins" ] }, "post": { "operationId": "PluginsController_install", "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "pluginId": { "type": "string", "minLength": 1 }, "versionId": { "type": "string" }, "acceptedPermissions": { "type": "array", "items": { "type": "string" } } }, "required": [ "pluginId", "acceptedPermissions" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "" } }, "tags": [ "plugins" ] } }, "/api/v1/plugin-installations/{installationId}": { "patch": { "operationId": "PluginsController_configure", "parameters": [ { "name": "installationId", "required": true, "in": "path", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "settings": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 500 }, { "type": "number" }, { "type": "boolean" } ] } }, "versionId": { "type": "string" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "" } }, "tags": [ "plugins" ] }, "delete": { "operationId": "PluginsController_uninstall", "parameters": [ { "name": "installationId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "plugins" ] } }, "/api/v1/contributor/platform": { "get": { "operationId": "ContributorController_platform", "parameters": [], "responses": { "200": { "description": "" } }, "tags": [ "contributor" ] } }, "/api/v1/contributor/mini-programs": { "get": { "operationId": "ContributorController_list", "parameters": [], "responses": { "200": { "description": "" } }, "tags": [ "contributor" ] }, "post": { "operationId": "ContributorController_create", "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "slug": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]{1,40}$" }, "name": { "type": "string", "minLength": 1, "maxLength": 60 }, "description": { "type": "string", "maxLength": 500 } }, "required": [ "slug", "name" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "" } }, "tags": [ "contributor" ] } }, "/api/v1/contributor/mini-programs/{programId}": { "get": { "operationId": "ContributorController_get", "parameters": [ { "name": "programId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "contributor" ] }, "patch": { "operationId": "ContributorController_update", "parameters": [ { "name": "programId", "required": true, "in": "path", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 60 }, "description": { "type": "string", "maxLength": 500 }, "draftManifest": {}, "draftSource": { "type": "object", "propertyNames": { "type": "string", "maxLength": 200, "pattern": "^[a-zA-Z0-9_-][a-zA-Z0-9_./-]*\\.(tsx|ts|jsx|js|css|json)$" }, "additionalProperties": { "type": "string", "maxLength": 200000 } } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "" } }, "tags": [ "contributor" ] } }, "/api/v1/contributor/mini-programs/{programId}/validate": { "post": { "operationId": "ContributorController_validate", "parameters": [ { "name": "programId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "201": { "description": "" } }, "tags": [ "contributor" ] } }, "/api/v1/contributor/mini-programs/{programId}/builds": { "post": { "operationId": "ContributorController_build", "parameters": [ { "name": "programId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "201": { "description": "" } }, "tags": [ "contributor" ] }, "get": { "operationId": "ContributorController_listBuilds", "parameters": [ { "name": "programId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "contributor" ] } }, "/api/v1/contributor/builds/{buildId}": { "get": { "operationId": "ContributorController_getBuild", "parameters": [ { "name": "buildId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "contributor" ] } }, "/api/v1/contributor/mini-programs/{programId}/versions": { "get": { "operationId": "ContributorController_versions", "parameters": [ { "name": "programId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "contributor" ] } }, "/api/v1/contributor/mini-programs/{programId}/submissions": { "post": { "operationId": "ContributorController_submit", "parameters": [ { "name": "programId", "required": true, "in": "path", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "versionId": { "type": "string", "minLength": 1 } }, "required": [ "versionId" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "" } }, "tags": [ "contributor" ] } }, "/api/v1/contributor/mini-programs/{programId}/versions/{versionId}/artifact": { "get": { "operationId": "ContributorController_previewArtifact", "parameters": [ { "name": "programId", "required": true, "in": "path", "schema": { "type": "string" } }, { "name": "versionId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "contributor" ] } }, "/api/v1/mini-programs": { "get": { "operationId": "MiniProgramRuntimeController_catalog", "parameters": [], "responses": { "200": { "description": "" } }, "tags": [ "mini-programs" ] } }, "/api/v1/mini-program-installations": { "post": { "operationId": "MiniProgramRuntimeController_install", "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "miniProgramId": { "type": "string", "minLength": 1 }, "acceptedPermissions": { "maxItems": 20, "type": "array", "items": { "type": "string" } } }, "required": [ "miniProgramId", "acceptedPermissions" ], "additionalProperties": false } } } }, "responses": { "201": { "description": "" } }, "tags": [ "mini-programs" ] } }, "/api/v1/mini-program-installations/{installationId}": { "delete": { "operationId": "MiniProgramRuntimeController_uninstall", "parameters": [ { "name": "installationId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "mini-programs" ] } }, "/api/v1/mini-programs/{slug}": { "get": { "operationId": "MiniProgramRuntimeController_detail", "parameters": [ { "name": "slug", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "mini-programs" ] } }, "/api/v1/mini-programs/{programId}/runtime-sessions": { "post": { "operationId": "MiniProgramRuntimeController_start", "parameters": [ { "name": "programId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "201": { "description": "" } }, "tags": [ "mini-programs" ] } }, "/api/v1/runtime-sessions/{sessionId}/artifact": { "get": { "operationId": "MiniProgramRuntimeController_artifact", "parameters": [ { "name": "sessionId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "mini-programs" ] } }, "/api/v1/runtime-sessions/{sessionId}/capabilities/{capability}": { "post": { "operationId": "MiniProgramRuntimeController_capability", "parameters": [ { "name": "sessionId", "required": true, "in": "path", "schema": { "type": "string" } }, { "name": "capability", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "201": { "description": "" } }, "tags": [ "mini-programs" ] } }, "/api/v1/runtime-sessions/{sessionId}": { "delete": { "operationId": "MiniProgramRuntimeController_end", "parameters": [ { "name": "sessionId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "mini-programs" ] } }, "/api/v1/catalog/discovery": { "get": { "operationId": "CatalogController_discovery", "parameters": [], "responses": { "200": { "description": "" } }, "tags": [ "catalog" ] } }, "/api/v1/catalog/collections": { "get": { "operationId": "CatalogController_collections", "parameters": [], "responses": { "200": { "description": "" } }, "tags": [ "catalog" ] } }, "/api/v1/catalog/collections/{slug}": { "get": { "operationId": "CatalogController_collection", "parameters": [ { "name": "slug", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "catalog" ] } }, "/api/v1/catalog/counts": { "get": { "operationId": "CatalogController_counts", "parameters": [], "responses": { "200": { "description": "" } }, "tags": [ "catalog" ] } }, "/api/v1/catalog/connectors/{slug}": { "get": { "operationId": "CatalogController_connector", "parameters": [ { "name": "slug", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "catalog" ] } }, "/api/v1/catalog/connectors/{slug}/enable": { "post": { "operationId": "CatalogController_enableConnector", "parameters": [ { "name": "slug", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "201": { "description": "" } }, "tags": [ "catalog" ] } }, "/api/v1/catalog/skills/{id}": { "get": { "operationId": "CatalogController_skill", "parameters": [ { "name": "id", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "catalog" ] } }, "/api/v1/catalog/plugins/{id}": { "get": { "operationId": "CatalogController_plugin", "parameters": [ { "name": "id", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "catalog" ] } }, "/api/v1/catalog/mini-programs/{slug}": { "get": { "operationId": "CatalogController_miniProgram", "parameters": [ { "name": "slug", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "" } }, "tags": [ "catalog" ] } }, "/api/v1/catalog/skills": { "get": { "operationId": "CatalogController_skills", "parameters": [], "responses": { "200": { "description": "" } }, "tags": [ "catalog" ] } }, "/api/v1/catalog/plugins": { "get": { "operationId": "CatalogController_plugins", "parameters": [], "responses": { "200": { "description": "" } }, "tags": [ "catalog" ] } }, "/api/v1/catalog/connectors": { "get": { "operationId": "CatalogController_connectors", "parameters": [], "responses": { "200": { "description": "" } }, "tags": [ "catalog" ] } }, "/api/v1/catalog/mini-programs": { "get": { "operationId": "CatalogController_miniPrograms", "parameters": [], "responses": { "200": { "description": "" } }, "tags": [ "catalog" ] } }, "/api/v1/health/live": { "get": { "operationId": "HealthController_live", "parameters": [], "responses": { "200": { "description": "" } }, "tags": [ "health" ] } }, "/api/v1/health/ready": { "get": { "operationId": "HealthController_ready", "parameters": [], "responses": { "200": { "description": "" } }, "tags": [ "health" ] } } }, "info": { "title": "Lex Platform API", "description": "The Lexcetha API behind the Lexcetha app and the contributor platform. Errors use { error: { code, message, requestId } }.", "version": "1.0.0", "contact": {} }, "tags": [], "servers": [ { "url": "https://api.lexcetha.com", "description": "Production" } ], "components": { "securitySchemes": { "cookie": { "type": "apiKey", "in": "cookie", "name": "lex_session" } }, "schemas": {} } }