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 complete details for a single agent, including the active masking policy, upstream configuration, proxy and webhook URLs, and rolling usage statistics. Use this endpoint to inspect an agent’s current configuration or retrieve its proxy URL programmatically.

​
Endpoint

GET /api/v1/agents/{agent_id}
Requires masker_session authentication.

​
Path parameters

​
agent_id
string
required
The agent’s ID in agt_* ULID format, e.g. agt_01HYZ....

​
Response fields

​
agent
object
required
Full agent object.

​
Example

curl -H "Cookie: masker_session=ey..." \
  https://masker-voice.fly.dev/api/v1/agents/agt_01HYZ...
Response
{
  "agent": {
    "id": "agt_01HYZ...",
    "name": "appointment-bot-prod",
    "upstream": "openai:gpt-4o-mini",
    "tokenization": "vault-deterministic",
    "policy_name": "healthcare-default",
    "policy_version": 1,
    "policy_yaml": "name: healthcare-default\nversion: 1\n...",
    "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",
    "stats": {
      "session_count_24h": 247,
      "session_count_7d": 1834,
      "redaction_count_24h": 1289,
      "p50_latency_ms": 412,
      "p95_latency_ms": 891
    }
  }
}

​
Errors

StatusCodeMeaning
401unauthenticatedMissing or invalid masker_session cookie
404agent_not_foundNo agent with this ID exists in your account