{ "openapi": "3.1.0", "info": { "title": "SeaChat Public Developer API", "version": "2026-06-28", "description": "Public SeaChat gateway API surface generated for docs.seachat.ai." }, "servers": [ { "url": "https://seachat.ai" } ], "paths": { "/v1/docs/{path}": { "delete": { "operationId": "platform_docs_delete", "tags": [ "seadb", "documents" ], "summary": "Delete a document", "description": "Delete a document by path.", "parameters": [ { "name": "path", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ], "x-capability-id": "platform.docs.delete", "x-required-scopes": [ "seadb:content:write" ], "x-runtime-safe": false, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid credentials" }, "403": { "description": "Credential lacks one of the required scopes" } } }, "patch": { "operationId": "platform_docs_patch", "tags": [ "seadb", "documents" ], "summary": "Mutate a document", "description": "Mutate a document with op append | edit | sed | patch.", "parameters": [ { "name": "path", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ], "x-capability-id": "platform.docs.patch", "x-required-scopes": [ "seadb:content:write" ], "x-runtime-safe": false, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid credentials" }, "403": { "description": "Credential lacks one of the required scopes" } } }, "get": { "operationId": "platform_docs_read", "tags": [ "seadb", "documents" ], "summary": "Read a document or search", "description": "Read a markdown/HTML document by path, or search via /v1/docs/_search?q=.", "parameters": [ { "name": "path", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ], "x-capability-id": "platform.docs.read", "x-required-scopes": [ "seadb:content:read" ], "x-runtime-safe": false, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid credentials" }, "403": { "description": "Credential lacks one of the required scopes" } } }, "post": { "operationId": "platform_docs_write", "tags": [ "seadb", "documents" ], "summary": "Write a document", "description": "Write a document as text/markdown (string) or JSON (object).", "parameters": [ { "name": "path", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ], "x-capability-id": "platform.docs.write", "x-required-scopes": [ "seadb:content:write" ], "x-runtime-safe": false, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid credentials" }, "403": { "description": "Credential lacks one of the required scopes" } } } }, "/v1/files/{fileId}/content": { "get": { "operationId": "platform_files_content", "tags": [ "seadb", "files" ], "summary": "Resolve signed artifact content", "description": "Stream artifact bytes inline (200) or return a signed redirect (302).", "parameters": [ { "name": "fileId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ], "x-capability-id": "platform.files.content", "x-required-scopes": [ "seadb:content:read" ], "x-runtime-safe": false, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid credentials" }, "403": { "description": "Credential lacks one of the required scopes" } } } }, "/v1/files/{fileId}": { "delete": { "operationId": "platform_files_delete", "tags": [ "seadb", "files" ], "summary": "Delete artifact metadata", "description": "Delete artifact metadata by id.", "parameters": [ { "name": "fileId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ], "x-capability-id": "platform.files.delete", "x-required-scopes": [ "seadb:content:write" ], "x-runtime-safe": false, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid credentials" }, "403": { "description": "Credential lacks one of the required scopes" } } }, "get": { "operationId": "platform_files_get", "tags": [ "seadb", "files" ], "summary": "Read artifact metadata", "description": "Read artifact metadata by id.", "parameters": [ { "name": "fileId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ], "x-capability-id": "platform.files.get", "x-required-scopes": [ "seadb:content:read" ], "x-runtime-safe": false, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid credentials" }, "403": { "description": "Credential lacks one of the required scopes" } } } }, "/v1/files": { "get": { "operationId": "platform_files_list", "tags": [ "seadb", "files" ], "summary": "List artifacts", "description": "List artifact metadata by prefix, kind, artifactType, or label.", "parameters": [], "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ], "x-capability-id": "platform.files.list", "x-required-scopes": [ "seadb:content:read" ], "x-runtime-safe": false, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid credentials" }, "403": { "description": "Credential lacks one of the required scopes" } } } }, "/v1/auth/keys": { "post": { "operationId": "platform_auth_keys_create", "tags": [ "seagate", "auth" ], "summary": "Mint an API key", "description": "Create a user-scoped API key. The raw token is returned only once.", "parameters": [], "security": [], "x-capability-id": "platform.auth_keys.create", "x-required-scopes": [], "x-runtime-safe": false, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid credentials" }, "403": { "description": "Credential lacks one of the required scopes" } } }, "get": { "operationId": "platform_auth_keys_list", "tags": [ "seagate", "auth" ], "summary": "List API keys", "description": "List the API keys owned by the current user.", "parameters": [], "security": [], "x-capability-id": "platform.auth_keys.list", "x-required-scopes": [], "x-runtime-safe": false, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid credentials" }, "403": { "description": "Credential lacks one of the required scopes" } } } }, "/v1/auth/keys/{keyId}": { "delete": { "operationId": "platform_auth_keys_revoke", "tags": [ "seagate", "auth" ], "summary": "Revoke an API key", "description": "Revoke a user-scoped API key by id.", "parameters": [ { "name": "keyId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [], "x-capability-id": "platform.auth_keys.revoke", "x-required-scopes": [], "x-runtime-safe": false, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid credentials" }, "403": { "description": "Credential lacks one of the required scopes" } } } }, "/v1/capabilities": { "get": { "operationId": "platform_capabilities_list", "tags": [ "seagate", "auth" ], "summary": "Discover capabilities for this key", "description": "Return the capability catalog available to the current credential.", "parameters": [], "security": [], "x-capability-id": "platform.capabilities.list", "x-required-scopes": [], "x-runtime-safe": false, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid credentials" }, "403": { "description": "Credential lacks one of the required scopes" } } } }, "/v1/me": { "get": { "operationId": "platform_me_get", "tags": [ "seagate", "auth" ], "summary": "Identity of the current key", "description": "Return the identity, actor type, auth method, and scopes for the current API key.", "parameters": [], "security": [], "x-capability-id": "platform.me.get", "x-required-scopes": [], "x-runtime-safe": false, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid credentials" }, "403": { "description": "Credential lacks one of the required scopes" } } } }, "/v1/downloads": { "post": { "operationId": "platform_downloads_create", "tags": [ "seagate", "files" ], "summary": "Create a presigned download URL", "description": "Create a signed download URL for an artifact.", "parameters": [], "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ], "x-capability-id": "platform.downloads.create", "x-required-scopes": [ "files:read" ], "x-runtime-safe": false, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid credentials" }, "403": { "description": "Credential lacks one of the required scopes" } } } }, "/v1/uploads/complete": { "post": { "operationId": "platform_uploads_complete", "tags": [ "seagate", "files" ], "summary": "Finalize a presigned upload", "description": "Finalize a presigned upload; requires the sha256 of the bytes you PUT.", "parameters": [], "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ], "x-capability-id": "platform.uploads.complete", "x-required-scopes": [ "files:write" ], "x-runtime-safe": false, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid credentials" }, "403": { "description": "Credential lacks one of the required scopes" } } } }, "/v1/uploads": { "post": { "operationId": "platform_uploads_create", "tags": [ "seagate", "files" ], "summary": "Create a presigned upload", "description": "Create an S3-style presigned upload delegation. PUT the bytes to the signed URL, then complete.", "parameters": [], "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ], "x-capability-id": "platform.uploads.create", "x-required-scopes": [ "files:write" ], "x-runtime-safe": false, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid credentials" }, "403": { "description": "Credential lacks one of the required scopes" } } } }, "/v1/threads": { "post": { "operationId": "platform_threads_create", "tags": [ "seaplane", "conversation" ], "summary": "Create a conversation thread", "description": "Create a conversation thread (pure storage; no runtime).", "parameters": [], "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ], "x-capability-id": "platform.threads.create", "x-required-scopes": [ "seaplane:write" ], "x-runtime-safe": false, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid credentials" }, "403": { "description": "Credential lacks one of the required scopes" } } }, "get": { "operationId": "platform_threads_list", "tags": [ "seaplane", "conversation" ], "summary": "List conversation threads", "description": "List conversation threads (pure storage).", "parameters": [], "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ], "x-capability-id": "platform.threads.list", "x-required-scopes": [ "seaplane:read" ], "x-runtime-safe": false, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid credentials" }, "403": { "description": "Credential lacks one of the required scopes" } } } }, "/v1/threads/{threadId}": { "get": { "operationId": "platform_threads_get", "tags": [ "seaplane", "conversation" ], "summary": "Read a thread", "description": "Read a conversation thread by id.", "parameters": [ { "name": "threadId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ], "x-capability-id": "platform.threads.get", "x-required-scopes": [ "seaplane:read" ], "x-runtime-safe": false, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid credentials" }, "403": { "description": "Credential lacks one of the required scopes" } } } }, "/v1/threads/{threadId}/messages": { "post": { "operationId": "platform_threads_messages_create", "tags": [ "seaplane", "conversation" ], "summary": "Append a message (pure storage)", "description": "Append a message to a thread. The facade forces dispatch:false; no runtime, no assistant turn.", "parameters": [ { "name": "threadId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ], "x-capability-id": "platform.threads.messages.create", "x-required-scopes": [ "seaplane:write" ], "x-runtime-safe": false, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid credentials" }, "403": { "description": "Credential lacks one of the required scopes" } } }, "get": { "operationId": "platform_threads_messages_list", "tags": [ "seaplane", "conversation" ], "summary": "List thread messages", "description": "List messages in a thread.", "parameters": [ { "name": "threadId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ], "x-capability-id": "platform.threads.messages.list", "x-required-scopes": [ "seaplane:read" ], "x-runtime-safe": false, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid credentials" }, "403": { "description": "Credential lacks one of the required scopes" } } } }, "/v1/threads/{threadId}/timeline": { "get": { "operationId": "platform_threads_timeline", "tags": [ "seaplane", "conversation" ], "summary": "Replay the thread timeline", "description": "Replay the append-only timeline of a thread.", "parameters": [ { "name": "threadId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ], "x-capability-id": "platform.threads.timeline", "x-required-scopes": [ "seaplane:read" ], "x-runtime-safe": false, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid credentials" }, "403": { "description": "Credential lacks one of the required scopes" } } } }, "/v1/chat/completions": { "post": { "operationId": "platform_chat_completions_create", "tags": [ "searouter", "models" ], "summary": "Chat completions (OpenAI-compatible)", "description": "Create an OpenAI-compatible chat completion. Set stream:true for an SSE stream.", "parameters": [], "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ], "x-capability-id": "platform.chat.completions.create", "x-required-scopes": [ "model:invoke" ], "x-runtime-safe": false, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid credentials" }, "403": { "description": "Credential lacks one of the required scopes" } } } }, "/v1/models/{path}": { "get": { "operationId": "platform_models_get", "tags": [ "searouter", "models" ], "summary": "Model discovery sub-resource", "description": "Enumerate deployment-specific model ids for a modality (filter to availability.state live_ok).", "parameters": [ { "name": "path", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ], "x-capability-id": "platform.models.get", "x-required-scopes": [ "model:invoke" ], "x-runtime-safe": false, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid credentials" }, "403": { "description": "Credential lacks one of the required scopes" } } } }, "/v1/models": { "get": { "operationId": "platform_models_list", "tags": [ "searouter", "models" ], "summary": "List models", "description": "List available model modalities and models.", "parameters": [], "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ], "x-capability-id": "platform.models.list", "x-required-scopes": [ "model:invoke" ], "x-runtime-safe": false, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid credentials" }, "403": { "description": "Credential lacks one of the required scopes" } } } }, "/v1/responses": { "post": { "operationId": "platform_responses_create", "tags": [ "searouter", "models" ], "summary": "Responses API (OpenAI-compatible)", "description": "Create an OpenAI-compatible Responses result. Set stream:true for an SSE stream.", "parameters": [], "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ], "x-capability-id": "platform.responses.create", "x-required-scopes": [ "model:invoke" ], "x-runtime-safe": false, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid credentials" }, "403": { "description": "Credential lacks one of the required scopes" } } } }, "/v1/tasks/{taskId}": { "delete": { "operationId": "platform_tasks_cancel", "tags": [ "searouter", "models" ], "summary": "Cancel an async task", "description": "Cancel an in-flight async task.", "parameters": [ { "name": "taskId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ], "x-capability-id": "platform.tasks.cancel", "x-required-scopes": [ "model:invoke" ], "x-runtime-safe": false, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid credentials" }, "403": { "description": "Credential lacks one of the required scopes" } } }, "get": { "operationId": "platform_tasks_get", "tags": [ "searouter", "models" ], "summary": "Poll an async task", "description": "Poll an async media/task by id.", "parameters": [ { "name": "taskId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ], "x-capability-id": "platform.tasks.get", "x-required-scopes": [ "model:invoke" ], "x-runtime-safe": false, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid credentials" }, "403": { "description": "Credential lacks one of the required scopes" } } } }, "/v1/tasks/{taskId}/result": { "get": { "operationId": "platform_tasks_result", "tags": [ "searouter", "models" ], "summary": "Fetch an async task result", "description": "Fetch the result of a completed async task.", "parameters": [ { "name": "taskId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ], "x-capability-id": "platform.tasks.result", "x-required-scopes": [ "model:invoke" ], "x-runtime-safe": false, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid credentials" }, "403": { "description": "Credential lacks one of the required scopes" } } } }, "/v1/invoke/{path}": { "post": { "operationId": "platform_invoke", "tags": [ "searouter", "multimodal" ], "summary": "Native multimodal invoke", "description": "Single entrypoint for embeddings, rerank, and image/audio/video generation. path = {modality}/{model}[/{version}].", "parameters": [ { "name": "path", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ], "x-capability-id": "platform.invoke", "x-required-scopes": [ "model:invoke" ], "x-runtime-safe": false, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid credentials" }, "403": { "description": "Credential lacks one of the required scopes" } } } }, "/v1/usage": { "get": { "operationId": "platform_usage_get", "tags": [ "searouter", "usage" ], "summary": "Usage summary", "description": "Return usage attribution for the current key. Both start and end are required.", "parameters": [ { "name": "start", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "end", "in": "query", "required": false, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ], "x-capability-id": "platform.usage.get", "x-required-scopes": [ "usage:read" ], "x-runtime-safe": false, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid credentials" }, "403": { "description": "Credential lacks one of the required scopes" } } } }, "/v1/tools/{pluginId}": { "get": { "operationId": "platform_tools_get", "tags": [ "seatool", "tools" ], "summary": "Read a plugin definition", "description": "Read a tool plugin definition by id.", "parameters": [ { "name": "pluginId", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ], "x-capability-id": "platform.tools.get", "x-required-scopes": [ "seatool:read" ], "x-runtime-safe": false, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid credentials" }, "403": { "description": "Credential lacks one of the required scopes" } } } }, "/v1/tools/{pluginId}/{toolName}/invoke": { "post": { "operationId": "platform_tools_invoke", "tags": [ "seatool", "tools" ], "summary": "Invoke a tool", "description": "Invoke a tool by plugin id and tool name with a JSON input.", "parameters": [ { "name": "pluginId", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "toolName", "in": "path", "required": true, "schema": { "type": "string" } } ], "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ], "x-capability-id": "platform.tools.invoke", "x-required-scopes": [ "tool:invoke" ], "x-runtime-safe": false, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid credentials" }, "403": { "description": "Credential lacks one of the required scopes" } } } }, "/v1/tools": { "get": { "operationId": "platform_tools_list", "tags": [ "seatool", "tools" ], "summary": "List the tool catalog", "description": "List the available tool/plugin catalog.", "parameters": [], "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ], "x-capability-id": "platform.tools.list", "x-required-scopes": [ "seatool:read" ], "x-runtime-safe": false, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid credentials" }, "403": { "description": "Credential lacks one of the required scopes" } } }, "post": { "operationId": "platform_tools_publish", "tags": [ "seatool", "tools" ], "summary": "Publish a tool plugin", "description": "Publish or register a tool plugin definition.", "parameters": [], "security": [ { "bearerAuth": [] }, { "apiKeyAuth": [] } ], "x-capability-id": "platform.tools.publish", "x-required-scopes": [ "seatool:write" ], "x-runtime-safe": false, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "401": { "description": "Missing or invalid credentials" }, "403": { "description": "Credential lacks one of the required scopes" } } } } }, "components": { "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer" }, "apiKeyAuth": { "type": "apiKey", "in": "header", "name": "x-api-key" } } } }