Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.masker.dev/llms.txt

Use this file to discover all available pages before exploring further.

Returns all agents associated with your account, ordered by creation time (newest first). Use this endpoint to enumerate agents, check their status, or retrieve the proxy and webhook URLs you need to configure your voice platform. Supports cursor-based pagination for accounts with many agents.

​
Endpoint

GET /api/v1/agents
Requires masker_session authentication.

​
Query parameters

​
limit
number
default:"25"
Maximum number of agents to return. Accepted range: 1–100.
​
cursor
string
Pagination cursor from a previous response’s next_cursor field. Omit to start from the first page.
​
name_contains
string
Case-insensitive substring filter on agent name. Returns only agents whose name includes the given string.

​
Response fields

​
data
object[]
required
Array of agent objects.
​
next_cursor
string | null
required
Cursor for the next page of results. Pass this as the cursor query parameter on the next request. null when you have reached the last page.

​
Example

curl -H "Cookie: masker_session=ey..." \
  "https://masker-voice.fly.dev/api/v1/agents?limit=50"
Response
{
  "data": [
    {
      "id": "agt_01HYZ...",
      "name": "appointment-bot-prod",
      "upstream": "openai:gpt-4o-mini",
      "tokenization": "vault-deterministic",
      "policy_name": "healthcare-default",
      "policy_version": 1,
      "proxy_url": "https://masker-voice.fly.dev/proxy/agt_01HYZ.../v1/chat/completions",
      "webhook_url": "https://masker-voice.fly.dev/vapi/webhook/agt_01HYZ...",
      "created_at": "2026-04-15T10:22:11Z",
      "session_count_24h": 247
    }
  ],
  "next_cursor": null
}

​
Errors

StatusCodeMeaning
401unauthenticatedMissing or invalid masker_session cookie
422validation_failedBad query parameter value