GET /agents/{id} — retrieve a single agent's config

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

string

required

The agent’s ID in agt_* ULID format, e.g. agt_01HYZ....

Response fields

object

required

Full agent object.

Hide agent object fields

string

required

Agent ID in agt_* ULID format.

string

required

Display name, unique per account.

string

required

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

string

required

Active tokenization scheme: vault-deterministic or reversible-aead.

string

required

Name of the active masking policy.

number

required

Version number of the active policy.

string

required

Full YAML text of the active masking policy at the current version.

string

required

OpenAI-compatible proxy URL for this agent.

string

required

Vapi assistant-request webhook URL for this agent.

string

required

ISO 8601 UTC creation timestamp.

object

required

Rolling usage statistics for this agent.

Show stats fields

number

Sessions processed in the last 24 hours.

number

Sessions processed in the last 7 days.

number

Total PHI detections redacted in the last 24 hours.

number

Median added latency in milliseconds over the last 24 hours.

number

95th-percentile added latency in milliseconds over the last 24 hours.

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

Status	Code	Meaning
`401`	`unauthenticated`	Missing or invalid `masker_session` cookie
`404`	`agent_not_found`	No agent with this ID exists in your account

Overview

Agents

Sessions

Proxy & Webhooks

GET /agents/{id} — retrieve a single agent's config

Endpoint

Path parameters

Response fields

Example

Errors

​Endpoint

​Path parameters

​Response fields

​Example

​Errors

Endpoint

Path parameters

Response fields

Example

Errors