Capabilities API

View as Markdown Open in ChatGPT Open in Claude

Discovery endpoints that tell you which models, tools, and knowledge bases exist in your workspace — so you can pass valid IDs to the Agents API. All require an admin key and return the { "data": ... } envelope.

Results are workspace-specific: only models and toolkits you’ve connected appear here.

Combined discovery

GET/capabilitiesAdmin key

Returns everything in one call.


curl https://tmmate.ai/api/v1/capabilities \
  -H "Authorization: Bearer $TEAMMATE_API_KEY"


{ "data": { "models": [ /* … */ ], "tools": [ /* … */ ], "knowledgeBases": [ /* … */ ], "embedding": { /* … */ } } }

List models

GET/capabilities/modelsAdmin key

Only models under connected providers are returned. Use id as model.model and provider as model.provider when creating an agent.


{
  "data": [
    {
      "id": "anthropic/claude-sonnet-4.6",
      "name": "Claude Sonnet 4.6",
      "provider": "ANTHROPIC",
      "providerConnected": true,
      "hasReasoning": true,
      "description": "Balanced model for everyday work"
    }
  ]
}

Field	Type	Notes
`id`	string	Pass as `model.model`.
`name`	string	Display name.
`provider`	enum	Pass as `model.provider` (uppercase).
`providerConnected`	boolean	Always `true` here (disconnected providers are filtered out).
`hasReasoning`	boolean	Whether the model supports extended reasoning.
`description`	string

List tools

GET/capabilities/toolsAdmin key

Each entry is a discriminated union on kind — system (built-in tools) or composio (connected app toolkits).


{
  "data": [
    { "kind": "system", "id": "web_search", "name": "Web Search", "description": "Search the web", "toolkitId": null, "inputSchema": { "type": "object" } },
    { "kind": "composio", "appId": "gmail", "name": "Gmail", "description": "Google Mail", "logo": "https://…", "connectionId": "c3d4…UUID",
      "actions": [ { "id": "GMAIL_SEND_EMAIL", "name": "Send email", "description": "…", "inputSchema": { "type": "object" } } ] }
  ]
}

Use these to build capabilities.tools on an agent: system → { kind: "system", id }; composio → { kind: "composio", appId, actions: [<action id>] }.

List knowledge bases

GET/capabilities/knowledge-basesAdmin key

A lightweight list for attaching to agents. Full management is the Knowledge bases API.


{ "data": [ { "id": "b2f1…UUID", "title": "Support FAQ", "description": "Help-center articles", "type": "knowledge" } ] }

Use id in an agent’s capabilities.knowledgeBases.

Embedding model

GET/capabilities/embeddingAdmin key

The embedding model used for knowledge-base search and RAG (fixed per deployment).


{ "data": { "model": "openai/text-embedding-3-small", "dimensions": 1536, "maxQueryTokens": 8191 } }