Real-Time AgentsAgents API

Get Capabilities

Retrieve all supported ASR, LLM, TTS, and Turn capabilities. Use this endpoint to discover valid provider/model combinations before creating agents.

HTTP Request

$GET https://app.resemble.ai/api/v2/agents/capabilities

Example Request

$curl --request GET "https://app.resemble.ai/api/v2/agents/capabilities" \
>  -H "Authorization: Bearer YOUR_API_TOKEN" \
>  -H "Content-Type: application/json"

Response

1{
2  "success": true,
3  "capabilities": {
4    "asr": [
5      {
6        "provider": "deepgram",
7        "model": "nova-2",
8        "description": "Deepgram Nova-2 ASR model"
9      }
10    ],
11    "llm": [
12      {
13        "provider": "openai",
14        "model": "gpt-4o",
15        "description": "OpenAI GPT-4 Optimized"
16      },
17      {
18        "provider": "anthropic",
19        "model": "claude-3-5-sonnet-20241022",
20        "description": "Anthropic Claude 3.5 Sonnet"
21      }
22    ],
23    "tts": [
24      {
25        "provider": "resemble",
26        "description": "Resemble AI voice synthesis"
27      }
28    ],
29    "turn": [
30      {
31        "mode": "silence",
32        "description": "Silence-based turn detection"
33      }
34    ]
35  }
36}

Response Body

AttributeTypeDescription
successbooleanIndicates if the request was successful
capabilitiesobjectObject containing all capability categories
capabilities.asrarrayAvailable ASR provider/model combinations
capabilities.llmarrayAvailable LLM provider/model combinations
capabilities.ttsarrayAvailable TTS providers
capabilities.turnarrayAvailable turn-taking modes

ASR Capabilities

Each ASR capability object contains:

AttributeTypeDescription
providerstringASR provider name (e.g., “deepgram”)
modelstringModel identifier (e.g., “nova-2”)
descriptionstringHuman-readable description of the capability

LLM Capabilities

Each LLM capability object contains:

AttributeTypeDescription
providerstringLLM provider name (e.g., “openai”, “anthropic”)
modelstringModel identifier (e.g., “gpt-4o”, “claude-3-5-sonnet-20241022”)
descriptionstringHuman-readable description of the capability

TTS Capabilities

Each TTS capability object contains:

AttributeTypeDescription
providerstringTTS provider name (e.g., “resemble”)
descriptionstringHuman-readable description of the capability

Turn Capabilities

Each Turn capability object contains:

AttributeTypeDescription
modestringTurn detection mode (e.g., “silence”)
descriptionstringHuman-readable description of the capability

Usage

Use this endpoint to:

  1. Validate configurations before creating or updating agents
  2. Discover new models as they become available
  3. Build dynamic UIs that show available options
  4. Ensure compatibility between ASR, LLM, and TTS selections

Example Usage

$# Get all capabilities
>curl --request GET "https://app.resemble.ai/api/v2/agents/capabilities" \
>  -H "Authorization: Bearer YOUR_API_TOKEN" \
>  -H "Content-Type: application/json"
>
># Use the response to validate your agent configuration
># before calling the create endpoint