GET /agents — list all Masker agents in your account

Retrieve a cursor-paginated list of every agent in your account, including proxy URLs, webhook URLs, tokenization scheme, and 24-hour session counts.

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.

Show agent object fields

id · string · required

Agent ID in agt_* ULID format, e.g. agt_01HYZ....

name · string · required

Display name, unique per account.

upstream · string · required

Configured upstream LLM provider and model, e.g. openai:gpt-4o-mini.

tokenization · string · required

Tokenization scheme: vault-deterministic or reversible-aead.

policy_name · string · required

Name of the active masking policy, e.g. healthcare-default.

policy_version · number · required

Version number of the active policy.

proxy_url · string · required

Full URL of the agent’s OpenAI-compatible proxy endpoint. Put this in your voice platform’s custom LLM URL field.

webhook_url · string · required

Full URL of the agent’s Vapi assistant-request webhook endpoint.

created_at · string · required

ISO 8601 UTC timestamp of when the agent was created.

session_count_24h · number · required

Number of sessions processed by this agent in the last 24 hours.

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

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

Status	Code	Meaning
401	unauthenticated	Missing or invalid masker_session cookie
422	validation_failed	Bad query parameter value