GET /agents — list all Masker agents in your account

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

number

default:"25"

Maximum number of agents to return. Accepted range: 1–100.

string

Pagination cursor from a previous response’s next_cursor field. Omit to start from the first page.

string

Case-insensitive substring filter on agent name. Returns only agents whose name includes the given string.

Response fields

object[]

required

Array of agent objects.

Show agent object fields

string

required

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

string

required

Display name, unique per account.

string

required

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

string

required

Tokenization scheme: vault-deterministic or reversible-aead.

string

required

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

number

required

Version number of the active policy.

string

required

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

string

required

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

string

required

ISO 8601 UTC timestamp of when the agent was created.

number

required

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

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

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

Overview

Agents

Sessions

Proxy & Webhooks

GET /agents — list all Masker agents in your account

Endpoint

Query parameters

Response fields

Example

Errors

​Endpoint

​Query parameters

​Response fields

​Example

​Errors

Endpoint

Query parameters

Response fields

Example

Errors