{
  "schemaVersion": "create.seachat.ai.docs.capabilities.v1",
  "generatedFrom": "services/seagate/src/routing/capabilities.rs",
  "liveCatalog": "https://seachat.ai/v1/capabilities",
  "capabilities": [
    {
      "id": "platform.docs.delete",
      "method": "DELETE",
      "path": "/v1/docs/{path}",
      "service": "seadb",
      "group": "documents",
      "title": "Delete a document",
      "description": "Delete a document by path.",
      "scopes": [
        "seadb:content:write"
      ],
      "access": "write",
      "stability": "stable",
      "audience": "developer",
      "requiredScopes": [
        "seadb:content:write"
      ],
      "risk": "documents",
      "runtimeSafe": false,
      "inputSchema": {
        "type": "object",
        "properties": {
          "pathParams": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      },
      "examples": [
        {
          "command": [
            "curl",
            "https://seachat.ai/v1/docs/{path}",
            "-H",
            "Authorization: Bearer $SEACHAT_SESSION_TOKEN"
          ],
          "api": {
            "method": "DELETE",
            "pathTemplate": "/v1/docs/{path}"
          }
        }
      ]
    },
    {
      "id": "platform.docs.patch",
      "method": "PATCH",
      "path": "/v1/docs/{path}",
      "service": "seadb",
      "group": "documents",
      "title": "Mutate a document",
      "description": "Mutate a document with op append | edit | sed | patch.",
      "scopes": [
        "seadb:content:write"
      ],
      "access": "write",
      "stability": "stable",
      "audience": "developer",
      "requiredScopes": [
        "seadb:content:write"
      ],
      "risk": "documents",
      "runtimeSafe": false,
      "inputSchema": {
        "type": "object",
        "properties": {
          "pathParams": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          },
          "body": {
            "type": "object",
            "additionalProperties": true
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      },
      "examples": [
        {
          "command": [
            "curl",
            "https://seachat.ai/v1/docs/{path}",
            "-H",
            "Authorization: Bearer $SEACHAT_SESSION_TOKEN"
          ],
          "api": {
            "method": "PATCH",
            "pathTemplate": "/v1/docs/{path}"
          }
        }
      ]
    },
    {
      "id": "platform.docs.read",
      "method": "GET",
      "path": "/v1/docs/{path}",
      "service": "seadb",
      "group": "documents",
      "title": "Read a document or search",
      "description": "Read a markdown/HTML document by path, or search via /v1/docs/_search?q=.",
      "scopes": [
        "seadb:content:read"
      ],
      "access": "read",
      "stability": "stable",
      "audience": "developer",
      "requiredScopes": [
        "seadb:content:read"
      ],
      "risk": "documents",
      "runtimeSafe": false,
      "inputSchema": {
        "type": "object",
        "properties": {
          "pathParams": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      },
      "examples": [
        {
          "command": [
            "curl",
            "https://seachat.ai/v1/docs/{path}",
            "-H",
            "Authorization: Bearer $SEACHAT_SESSION_TOKEN"
          ],
          "api": {
            "method": "GET",
            "pathTemplate": "/v1/docs/{path}"
          }
        }
      ]
    },
    {
      "id": "platform.docs.write",
      "method": "POST",
      "path": "/v1/docs/{path}",
      "service": "seadb",
      "group": "documents",
      "title": "Write a document",
      "description": "Write a document as text/markdown (string) or JSON (object).",
      "scopes": [
        "seadb:content:write"
      ],
      "access": "write",
      "stability": "stable",
      "audience": "developer",
      "requiredScopes": [
        "seadb:content:write"
      ],
      "risk": "documents",
      "runtimeSafe": false,
      "inputSchema": {
        "type": "object",
        "properties": {
          "pathParams": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          },
          "body": {
            "type": "object",
            "additionalProperties": true
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      },
      "examples": [
        {
          "command": [
            "curl",
            "https://seachat.ai/v1/docs/{path}",
            "-H",
            "Authorization: Bearer $SEACHAT_SESSION_TOKEN"
          ],
          "api": {
            "method": "POST",
            "pathTemplate": "/v1/docs/{path}"
          }
        }
      ]
    },
    {
      "id": "platform.files.content",
      "method": "GET",
      "path": "/v1/files/{fileId}/content",
      "service": "seadb",
      "group": "files",
      "title": "Resolve signed artifact content",
      "description": "Stream artifact bytes inline (200) or return a signed redirect (302).",
      "scopes": [
        "seadb:content:read"
      ],
      "access": "read",
      "stability": "stable",
      "audience": "developer",
      "requiredScopes": [
        "seadb:content:read"
      ],
      "risk": "files",
      "runtimeSafe": false,
      "inputSchema": {
        "type": "object",
        "properties": {
          "pathParams": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      },
      "examples": [
        {
          "command": [
            "curl",
            "https://seachat.ai/v1/files/{fileId}/content",
            "-H",
            "Authorization: Bearer $SEACHAT_SESSION_TOKEN"
          ],
          "api": {
            "method": "GET",
            "pathTemplate": "/v1/files/{fileId}/content"
          }
        }
      ]
    },
    {
      "id": "platform.files.delete",
      "method": "DELETE",
      "path": "/v1/files/{fileId}",
      "service": "seadb",
      "group": "files",
      "title": "Delete artifact metadata",
      "description": "Delete artifact metadata by id.",
      "scopes": [
        "seadb:content:write"
      ],
      "access": "write",
      "stability": "stable",
      "audience": "developer",
      "requiredScopes": [
        "seadb:content:write"
      ],
      "risk": "files",
      "runtimeSafe": false,
      "inputSchema": {
        "type": "object",
        "properties": {
          "pathParams": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      },
      "examples": [
        {
          "command": [
            "curl",
            "https://seachat.ai/v1/files/{fileId}",
            "-H",
            "Authorization: Bearer $SEACHAT_SESSION_TOKEN"
          ],
          "api": {
            "method": "DELETE",
            "pathTemplate": "/v1/files/{fileId}"
          }
        }
      ]
    },
    {
      "id": "platform.files.get",
      "method": "GET",
      "path": "/v1/files/{fileId}",
      "service": "seadb",
      "group": "files",
      "title": "Read artifact metadata",
      "description": "Read artifact metadata by id.",
      "scopes": [
        "seadb:content:read"
      ],
      "access": "read",
      "stability": "stable",
      "audience": "developer",
      "requiredScopes": [
        "seadb:content:read"
      ],
      "risk": "files",
      "runtimeSafe": false,
      "inputSchema": {
        "type": "object",
        "properties": {
          "pathParams": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      },
      "examples": [
        {
          "command": [
            "curl",
            "https://seachat.ai/v1/files/{fileId}",
            "-H",
            "Authorization: Bearer $SEACHAT_SESSION_TOKEN"
          ],
          "api": {
            "method": "GET",
            "pathTemplate": "/v1/files/{fileId}"
          }
        }
      ]
    },
    {
      "id": "platform.files.list",
      "method": "GET",
      "path": "/v1/files",
      "service": "seadb",
      "group": "files",
      "title": "List artifacts",
      "description": "List artifact metadata by prefix, kind, artifactType, or label.",
      "scopes": [
        "seadb:content:read"
      ],
      "access": "read",
      "stability": "stable",
      "audience": "developer",
      "requiredScopes": [
        "seadb:content:read"
      ],
      "risk": "files",
      "runtimeSafe": false,
      "inputSchema": {
        "type": "object",
        "properties": {}
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      },
      "examples": [
        {
          "command": [
            "curl",
            "https://seachat.ai/v1/files",
            "-H",
            "Authorization: Bearer $SEACHAT_SESSION_TOKEN"
          ],
          "api": {
            "method": "GET",
            "pathTemplate": "/v1/files"
          }
        }
      ]
    },
    {
      "id": "platform.auth_keys.create",
      "method": "POST",
      "path": "/v1/auth/keys",
      "service": "seagate",
      "group": "auth",
      "title": "Mint an API key",
      "description": "Create a user-scoped API key. The raw token is returned only once.",
      "scopes": [],
      "access": "write",
      "stability": "stable",
      "audience": "developer",
      "requiredScopes": [],
      "risk": "auth",
      "runtimeSafe": false,
      "inputSchema": {
        "type": "object",
        "properties": {
          "body": {
            "type": "object",
            "additionalProperties": true
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      },
      "examples": [
        {
          "command": [
            "curl",
            "https://seachat.ai/v1/auth/keys",
            "-H",
            "Authorization: Bearer $SEACHAT_SESSION_TOKEN"
          ],
          "api": {
            "method": "POST",
            "pathTemplate": "/v1/auth/keys"
          }
        }
      ]
    },
    {
      "id": "platform.auth_keys.list",
      "method": "GET",
      "path": "/v1/auth/keys",
      "service": "seagate",
      "group": "auth",
      "title": "List API keys",
      "description": "List the API keys owned by the current user.",
      "scopes": [],
      "access": "read",
      "stability": "stable",
      "audience": "developer",
      "requiredScopes": [],
      "risk": "auth",
      "runtimeSafe": false,
      "inputSchema": {
        "type": "object",
        "properties": {}
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      },
      "examples": [
        {
          "command": [
            "curl",
            "https://seachat.ai/v1/auth/keys",
            "-H",
            "Authorization: Bearer $SEACHAT_SESSION_TOKEN"
          ],
          "api": {
            "method": "GET",
            "pathTemplate": "/v1/auth/keys"
          }
        }
      ]
    },
    {
      "id": "platform.auth_keys.revoke",
      "method": "DELETE",
      "path": "/v1/auth/keys/{keyId}",
      "service": "seagate",
      "group": "auth",
      "title": "Revoke an API key",
      "description": "Revoke a user-scoped API key by id.",
      "scopes": [],
      "access": "write",
      "stability": "stable",
      "audience": "developer",
      "requiredScopes": [],
      "risk": "auth",
      "runtimeSafe": false,
      "inputSchema": {
        "type": "object",
        "properties": {
          "pathParams": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      },
      "examples": [
        {
          "command": [
            "curl",
            "https://seachat.ai/v1/auth/keys/{keyId}",
            "-H",
            "Authorization: Bearer $SEACHAT_SESSION_TOKEN"
          ],
          "api": {
            "method": "DELETE",
            "pathTemplate": "/v1/auth/keys/{keyId}"
          }
        }
      ]
    },
    {
      "id": "platform.capabilities.list",
      "method": "GET",
      "path": "/v1/capabilities",
      "service": "seagate",
      "group": "auth",
      "title": "Discover capabilities for this key",
      "description": "Return the capability catalog available to the current credential.",
      "scopes": [],
      "access": "read",
      "stability": "stable",
      "audience": "developer",
      "requiredScopes": [],
      "risk": "auth",
      "runtimeSafe": false,
      "inputSchema": {
        "type": "object",
        "properties": {}
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      },
      "examples": [
        {
          "command": [
            "curl",
            "https://seachat.ai/v1/capabilities",
            "-H",
            "Authorization: Bearer $SEACHAT_SESSION_TOKEN"
          ],
          "api": {
            "method": "GET",
            "pathTemplate": "/v1/capabilities"
          }
        }
      ]
    },
    {
      "id": "platform.me.get",
      "method": "GET",
      "path": "/v1/me",
      "service": "seagate",
      "group": "auth",
      "title": "Identity of the current key",
      "description": "Return the identity, actor type, auth method, and scopes for the current API key.",
      "scopes": [],
      "access": "read",
      "stability": "stable",
      "audience": "developer",
      "requiredScopes": [],
      "risk": "auth",
      "runtimeSafe": false,
      "inputSchema": {
        "type": "object",
        "properties": {}
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      },
      "examples": [
        {
          "command": [
            "curl",
            "https://seachat.ai/v1/me",
            "-H",
            "Authorization: Bearer $SEACHAT_SESSION_TOKEN"
          ],
          "api": {
            "method": "GET",
            "pathTemplate": "/v1/me"
          }
        }
      ]
    },
    {
      "id": "platform.downloads.create",
      "method": "POST",
      "path": "/v1/downloads",
      "service": "seagate",
      "group": "files",
      "title": "Create a presigned download URL",
      "description": "Create a signed download URL for an artifact.",
      "scopes": [
        "files:read"
      ],
      "access": "read",
      "stability": "stable",
      "audience": "developer",
      "requiredScopes": [
        "files:read"
      ],
      "risk": "files",
      "runtimeSafe": false,
      "inputSchema": {
        "type": "object",
        "properties": {
          "body": {
            "type": "object",
            "additionalProperties": true
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      },
      "examples": [
        {
          "command": [
            "curl",
            "https://seachat.ai/v1/downloads",
            "-H",
            "Authorization: Bearer $SEACHAT_SESSION_TOKEN"
          ],
          "api": {
            "method": "POST",
            "pathTemplate": "/v1/downloads"
          }
        }
      ]
    },
    {
      "id": "platform.uploads.complete",
      "method": "POST",
      "path": "/v1/uploads/complete",
      "service": "seagate",
      "group": "files",
      "title": "Finalize a presigned upload",
      "description": "Finalize a presigned upload; requires the sha256 of the bytes you PUT.",
      "scopes": [
        "files:write"
      ],
      "access": "write",
      "stability": "stable",
      "audience": "developer",
      "requiredScopes": [
        "files:write"
      ],
      "risk": "files",
      "runtimeSafe": false,
      "inputSchema": {
        "type": "object",
        "properties": {
          "body": {
            "type": "object",
            "additionalProperties": true
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      },
      "examples": [
        {
          "command": [
            "curl",
            "https://seachat.ai/v1/uploads/complete",
            "-H",
            "Authorization: Bearer $SEACHAT_SESSION_TOKEN"
          ],
          "api": {
            "method": "POST",
            "pathTemplate": "/v1/uploads/complete"
          }
        }
      ]
    },
    {
      "id": "platform.uploads.create",
      "method": "POST",
      "path": "/v1/uploads",
      "service": "seagate",
      "group": "files",
      "title": "Create a presigned upload",
      "description": "Create an S3-style presigned upload delegation. PUT the bytes to the signed URL, then complete.",
      "scopes": [
        "files:write"
      ],
      "access": "write",
      "stability": "stable",
      "audience": "developer",
      "requiredScopes": [
        "files:write"
      ],
      "risk": "files",
      "runtimeSafe": false,
      "inputSchema": {
        "type": "object",
        "properties": {
          "body": {
            "type": "object",
            "additionalProperties": true
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      },
      "examples": [
        {
          "command": [
            "curl",
            "https://seachat.ai/v1/uploads",
            "-H",
            "Authorization: Bearer $SEACHAT_SESSION_TOKEN"
          ],
          "api": {
            "method": "POST",
            "pathTemplate": "/v1/uploads"
          }
        }
      ]
    },
    {
      "id": "platform.threads.create",
      "method": "POST",
      "path": "/v1/threads",
      "service": "seaplane",
      "group": "conversation",
      "title": "Create a conversation thread",
      "description": "Create a conversation thread (pure storage; no runtime).",
      "scopes": [
        "seaplane:write"
      ],
      "access": "write",
      "stability": "stable",
      "audience": "developer",
      "requiredScopes": [
        "seaplane:write"
      ],
      "risk": "conversation",
      "runtimeSafe": false,
      "inputSchema": {
        "type": "object",
        "properties": {
          "body": {
            "type": "object",
            "additionalProperties": true
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      },
      "examples": [
        {
          "command": [
            "curl",
            "https://seachat.ai/v1/threads",
            "-H",
            "Authorization: Bearer $SEACHAT_SESSION_TOKEN"
          ],
          "api": {
            "method": "POST",
            "pathTemplate": "/v1/threads"
          }
        }
      ]
    },
    {
      "id": "platform.threads.get",
      "method": "GET",
      "path": "/v1/threads/{threadId}",
      "service": "seaplane",
      "group": "conversation",
      "title": "Read a thread",
      "description": "Read a conversation thread by id.",
      "scopes": [
        "seaplane:read"
      ],
      "access": "read",
      "stability": "stable",
      "audience": "developer",
      "requiredScopes": [
        "seaplane:read"
      ],
      "risk": "conversation",
      "runtimeSafe": false,
      "inputSchema": {
        "type": "object",
        "properties": {
          "pathParams": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      },
      "examples": [
        {
          "command": [
            "curl",
            "https://seachat.ai/v1/threads/{threadId}",
            "-H",
            "Authorization: Bearer $SEACHAT_SESSION_TOKEN"
          ],
          "api": {
            "method": "GET",
            "pathTemplate": "/v1/threads/{threadId}"
          }
        }
      ]
    },
    {
      "id": "platform.threads.list",
      "method": "GET",
      "path": "/v1/threads",
      "service": "seaplane",
      "group": "conversation",
      "title": "List conversation threads",
      "description": "List conversation threads (pure storage).",
      "scopes": [
        "seaplane:read"
      ],
      "access": "read",
      "stability": "stable",
      "audience": "developer",
      "requiredScopes": [
        "seaplane:read"
      ],
      "risk": "conversation",
      "runtimeSafe": false,
      "inputSchema": {
        "type": "object",
        "properties": {}
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      },
      "examples": [
        {
          "command": [
            "curl",
            "https://seachat.ai/v1/threads",
            "-H",
            "Authorization: Bearer $SEACHAT_SESSION_TOKEN"
          ],
          "api": {
            "method": "GET",
            "pathTemplate": "/v1/threads"
          }
        }
      ]
    },
    {
      "id": "platform.threads.messages.create",
      "method": "POST",
      "path": "/v1/threads/{threadId}/messages",
      "service": "seaplane",
      "group": "conversation",
      "title": "Append a message (pure storage)",
      "description": "Append a message to a thread. The facade forces dispatch:false; no runtime, no assistant turn.",
      "scopes": [
        "seaplane:write"
      ],
      "access": "write",
      "stability": "stable",
      "audience": "developer",
      "requiredScopes": [
        "seaplane:write"
      ],
      "risk": "conversation",
      "runtimeSafe": false,
      "inputSchema": {
        "type": "object",
        "properties": {
          "pathParams": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          },
          "body": {
            "type": "object",
            "additionalProperties": true
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      },
      "examples": [
        {
          "command": [
            "curl",
            "https://seachat.ai/v1/threads/{threadId}/messages",
            "-H",
            "Authorization: Bearer $SEACHAT_SESSION_TOKEN"
          ],
          "api": {
            "method": "POST",
            "pathTemplate": "/v1/threads/{threadId}/messages"
          }
        }
      ]
    },
    {
      "id": "platform.threads.messages.list",
      "method": "GET",
      "path": "/v1/threads/{threadId}/messages",
      "service": "seaplane",
      "group": "conversation",
      "title": "List thread messages",
      "description": "List messages in a thread.",
      "scopes": [
        "seaplane:read"
      ],
      "access": "read",
      "stability": "stable",
      "audience": "developer",
      "requiredScopes": [
        "seaplane:read"
      ],
      "risk": "conversation",
      "runtimeSafe": false,
      "inputSchema": {
        "type": "object",
        "properties": {
          "pathParams": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      },
      "examples": [
        {
          "command": [
            "curl",
            "https://seachat.ai/v1/threads/{threadId}/messages",
            "-H",
            "Authorization: Bearer $SEACHAT_SESSION_TOKEN"
          ],
          "api": {
            "method": "GET",
            "pathTemplate": "/v1/threads/{threadId}/messages"
          }
        }
      ]
    },
    {
      "id": "platform.threads.timeline",
      "method": "GET",
      "path": "/v1/threads/{threadId}/timeline",
      "service": "seaplane",
      "group": "conversation",
      "title": "Replay the thread timeline",
      "description": "Replay the append-only timeline of a thread.",
      "scopes": [
        "seaplane:read"
      ],
      "access": "read",
      "stability": "stable",
      "audience": "developer",
      "requiredScopes": [
        "seaplane:read"
      ],
      "risk": "conversation",
      "runtimeSafe": false,
      "inputSchema": {
        "type": "object",
        "properties": {
          "pathParams": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      },
      "examples": [
        {
          "command": [
            "curl",
            "https://seachat.ai/v1/threads/{threadId}/timeline",
            "-H",
            "Authorization: Bearer $SEACHAT_SESSION_TOKEN"
          ],
          "api": {
            "method": "GET",
            "pathTemplate": "/v1/threads/{threadId}/timeline"
          }
        }
      ]
    },
    {
      "id": "platform.chat.completions.create",
      "method": "POST",
      "path": "/v1/chat/completions",
      "service": "searouter",
      "group": "models",
      "title": "Chat completions (OpenAI-compatible)",
      "description": "Create an OpenAI-compatible chat completion. Set stream:true for an SSE stream.",
      "scopes": [
        "model:invoke"
      ],
      "access": "invoke",
      "stability": "stable",
      "audience": "developer",
      "requiredScopes": [
        "model:invoke"
      ],
      "risk": "models",
      "runtimeSafe": false,
      "inputSchema": {
        "type": "object",
        "properties": {
          "body": {
            "type": "object",
            "additionalProperties": true
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      },
      "examples": [
        {
          "command": [
            "curl",
            "https://seachat.ai/v1/chat/completions",
            "-H",
            "Authorization: Bearer $SEACHAT_SESSION_TOKEN"
          ],
          "api": {
            "method": "POST",
            "pathTemplate": "/v1/chat/completions"
          }
        }
      ]
    },
    {
      "id": "platform.models.get",
      "method": "GET",
      "path": "/v1/models/{path}",
      "service": "searouter",
      "group": "models",
      "title": "Model discovery sub-resource",
      "description": "Enumerate deployment-specific model ids for a modality (filter to availability.state live_ok).",
      "scopes": [
        "model:invoke"
      ],
      "access": "read",
      "stability": "stable",
      "audience": "developer",
      "requiredScopes": [
        "model:invoke"
      ],
      "risk": "models",
      "runtimeSafe": false,
      "inputSchema": {
        "type": "object",
        "properties": {
          "pathParams": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      },
      "examples": [
        {
          "command": [
            "curl",
            "https://seachat.ai/v1/models/{path}",
            "-H",
            "Authorization: Bearer $SEACHAT_SESSION_TOKEN"
          ],
          "api": {
            "method": "GET",
            "pathTemplate": "/v1/models/{path}"
          }
        }
      ]
    },
    {
      "id": "platform.models.list",
      "method": "GET",
      "path": "/v1/models",
      "service": "searouter",
      "group": "models",
      "title": "List models",
      "description": "List available model modalities and models.",
      "scopes": [
        "model:invoke"
      ],
      "access": "read",
      "stability": "stable",
      "audience": "developer",
      "requiredScopes": [
        "model:invoke"
      ],
      "risk": "models",
      "runtimeSafe": false,
      "inputSchema": {
        "type": "object",
        "properties": {}
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      },
      "examples": [
        {
          "command": [
            "curl",
            "https://seachat.ai/v1/models",
            "-H",
            "Authorization: Bearer $SEACHAT_SESSION_TOKEN"
          ],
          "api": {
            "method": "GET",
            "pathTemplate": "/v1/models"
          }
        }
      ]
    },
    {
      "id": "platform.responses.create",
      "method": "POST",
      "path": "/v1/responses",
      "service": "searouter",
      "group": "models",
      "title": "Responses API (OpenAI-compatible)",
      "description": "Create an OpenAI-compatible Responses result. Set stream:true for an SSE stream.",
      "scopes": [
        "model:invoke"
      ],
      "access": "invoke",
      "stability": "stable",
      "audience": "developer",
      "requiredScopes": [
        "model:invoke"
      ],
      "risk": "models",
      "runtimeSafe": false,
      "inputSchema": {
        "type": "object",
        "properties": {
          "body": {
            "type": "object",
            "additionalProperties": true
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      },
      "examples": [
        {
          "command": [
            "curl",
            "https://seachat.ai/v1/responses",
            "-H",
            "Authorization: Bearer $SEACHAT_SESSION_TOKEN"
          ],
          "api": {
            "method": "POST",
            "pathTemplate": "/v1/responses"
          }
        }
      ]
    },
    {
      "id": "platform.tasks.cancel",
      "method": "DELETE",
      "path": "/v1/tasks/{taskId}",
      "service": "searouter",
      "group": "models",
      "title": "Cancel an async task",
      "description": "Cancel an in-flight async task.",
      "scopes": [
        "model:invoke"
      ],
      "access": "write",
      "stability": "stable",
      "audience": "developer",
      "requiredScopes": [
        "model:invoke"
      ],
      "risk": "models",
      "runtimeSafe": false,
      "inputSchema": {
        "type": "object",
        "properties": {
          "pathParams": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      },
      "examples": [
        {
          "command": [
            "curl",
            "https://seachat.ai/v1/tasks/{taskId}",
            "-H",
            "Authorization: Bearer $SEACHAT_SESSION_TOKEN"
          ],
          "api": {
            "method": "DELETE",
            "pathTemplate": "/v1/tasks/{taskId}"
          }
        }
      ]
    },
    {
      "id": "platform.tasks.get",
      "method": "GET",
      "path": "/v1/tasks/{taskId}",
      "service": "searouter",
      "group": "models",
      "title": "Poll an async task",
      "description": "Poll an async media/task by id.",
      "scopes": [
        "model:invoke"
      ],
      "access": "read",
      "stability": "stable",
      "audience": "developer",
      "requiredScopes": [
        "model:invoke"
      ],
      "risk": "models",
      "runtimeSafe": false,
      "inputSchema": {
        "type": "object",
        "properties": {
          "pathParams": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      },
      "examples": [
        {
          "command": [
            "curl",
            "https://seachat.ai/v1/tasks/{taskId}",
            "-H",
            "Authorization: Bearer $SEACHAT_SESSION_TOKEN"
          ],
          "api": {
            "method": "GET",
            "pathTemplate": "/v1/tasks/{taskId}"
          }
        }
      ]
    },
    {
      "id": "platform.tasks.result",
      "method": "GET",
      "path": "/v1/tasks/{taskId}/result",
      "service": "searouter",
      "group": "models",
      "title": "Fetch an async task result",
      "description": "Fetch the result of a completed async task.",
      "scopes": [
        "model:invoke"
      ],
      "access": "read",
      "stability": "stable",
      "audience": "developer",
      "requiredScopes": [
        "model:invoke"
      ],
      "risk": "models",
      "runtimeSafe": false,
      "inputSchema": {
        "type": "object",
        "properties": {
          "pathParams": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      },
      "examples": [
        {
          "command": [
            "curl",
            "https://seachat.ai/v1/tasks/{taskId}/result",
            "-H",
            "Authorization: Bearer $SEACHAT_SESSION_TOKEN"
          ],
          "api": {
            "method": "GET",
            "pathTemplate": "/v1/tasks/{taskId}/result"
          }
        }
      ]
    },
    {
      "id": "platform.invoke",
      "method": "POST",
      "path": "/v1/invoke/{path}",
      "service": "searouter",
      "group": "multimodal",
      "title": "Native multimodal invoke",
      "description": "Single entrypoint for embeddings, rerank, and image/audio/video generation. path = {modality}/{model}[/{version}].",
      "scopes": [
        "model:invoke"
      ],
      "access": "invoke",
      "stability": "stable",
      "audience": "developer",
      "requiredScopes": [
        "model:invoke"
      ],
      "risk": "multimodal",
      "runtimeSafe": false,
      "inputSchema": {
        "type": "object",
        "properties": {
          "pathParams": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          },
          "body": {
            "type": "object",
            "additionalProperties": true
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      },
      "examples": [
        {
          "command": [
            "curl",
            "https://seachat.ai/v1/invoke/{path}",
            "-H",
            "Authorization: Bearer $SEACHAT_SESSION_TOKEN"
          ],
          "api": {
            "method": "POST",
            "pathTemplate": "/v1/invoke/{path}"
          }
        }
      ]
    },
    {
      "id": "platform.usage.get",
      "method": "GET",
      "path": "/v1/usage?start={start}&end={end}",
      "service": "searouter",
      "group": "usage",
      "title": "Usage summary",
      "description": "Return usage attribution for the current key. Both start and end are required.",
      "scopes": [
        "usage:read"
      ],
      "access": "read",
      "stability": "stable",
      "audience": "developer",
      "requiredScopes": [
        "usage:read"
      ],
      "risk": "usage",
      "runtimeSafe": false,
      "inputSchema": {
        "type": "object",
        "properties": {
          "pathParams": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      },
      "examples": [
        {
          "command": [
            "curl",
            "https://seachat.ai/v1/usage?start={start}&end={end}",
            "-H",
            "Authorization: Bearer $SEACHAT_SESSION_TOKEN"
          ],
          "api": {
            "method": "GET",
            "pathTemplate": "/v1/usage?start={start}&end={end}"
          }
        }
      ]
    },
    {
      "id": "platform.tools.get",
      "method": "GET",
      "path": "/v1/tools/{pluginId}",
      "service": "seatool",
      "group": "tools",
      "title": "Read a plugin definition",
      "description": "Read a tool plugin definition by id.",
      "scopes": [
        "seatool:read"
      ],
      "access": "read",
      "stability": "stable",
      "audience": "developer",
      "requiredScopes": [
        "seatool:read"
      ],
      "risk": "tools",
      "runtimeSafe": false,
      "inputSchema": {
        "type": "object",
        "properties": {
          "pathParams": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      },
      "examples": [
        {
          "command": [
            "curl",
            "https://seachat.ai/v1/tools/{pluginId}",
            "-H",
            "Authorization: Bearer $SEACHAT_SESSION_TOKEN"
          ],
          "api": {
            "method": "GET",
            "pathTemplate": "/v1/tools/{pluginId}"
          }
        }
      ]
    },
    {
      "id": "platform.tools.invoke",
      "method": "POST",
      "path": "/v1/tools/{pluginId}/{toolName}/invoke",
      "service": "seatool",
      "group": "tools",
      "title": "Invoke a tool",
      "description": "Invoke a tool by plugin id and tool name with a JSON input.",
      "scopes": [
        "tool:invoke"
      ],
      "access": "invoke",
      "stability": "stable",
      "audience": "developer",
      "requiredScopes": [
        "tool:invoke"
      ],
      "risk": "tools",
      "runtimeSafe": false,
      "inputSchema": {
        "type": "object",
        "properties": {
          "pathParams": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          },
          "body": {
            "type": "object",
            "additionalProperties": true
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      },
      "examples": [
        {
          "command": [
            "curl",
            "https://seachat.ai/v1/tools/{pluginId}/{toolName}/invoke",
            "-H",
            "Authorization: Bearer $SEACHAT_SESSION_TOKEN"
          ],
          "api": {
            "method": "POST",
            "pathTemplate": "/v1/tools/{pluginId}/{toolName}/invoke"
          }
        }
      ]
    },
    {
      "id": "platform.tools.list",
      "method": "GET",
      "path": "/v1/tools",
      "service": "seatool",
      "group": "tools",
      "title": "List the tool catalog",
      "description": "List the available tool/plugin catalog.",
      "scopes": [
        "seatool:read"
      ],
      "access": "read",
      "stability": "stable",
      "audience": "developer",
      "requiredScopes": [
        "seatool:read"
      ],
      "risk": "tools",
      "runtimeSafe": false,
      "inputSchema": {
        "type": "object",
        "properties": {}
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      },
      "examples": [
        {
          "command": [
            "curl",
            "https://seachat.ai/v1/tools",
            "-H",
            "Authorization: Bearer $SEACHAT_SESSION_TOKEN"
          ],
          "api": {
            "method": "GET",
            "pathTemplate": "/v1/tools"
          }
        }
      ]
    },
    {
      "id": "platform.tools.publish",
      "method": "POST",
      "path": "/v1/tools",
      "service": "seatool",
      "group": "tools",
      "title": "Publish a tool plugin",
      "description": "Publish or register a tool plugin definition.",
      "scopes": [
        "seatool:write"
      ],
      "access": "write",
      "stability": "stable",
      "audience": "developer",
      "requiredScopes": [
        "seatool:write"
      ],
      "risk": "tools",
      "runtimeSafe": false,
      "inputSchema": {
        "type": "object",
        "properties": {
          "body": {
            "type": "object",
            "additionalProperties": true
          }
        }
      },
      "outputSchema": {
        "type": "object",
        "additionalProperties": true
      },
      "examples": [
        {
          "command": [
            "curl",
            "https://seachat.ai/v1/tools",
            "-H",
            "Authorization: Bearer $SEACHAT_SESSION_TOKEN"
          ],
          "api": {
            "method": "POST",
            "pathTemplate": "/v1/tools"
          }
        }
      ]
    }
  ]
}