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

Fetch the full configuration, active masking policy, proxy URL, and 24-hour and 7-day usage statistics for a single agent by its ULID.

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.

Hide agent object fields

id · string · required

Agent ID in agt_* ULID format.

name · string · required

Display name, unique per account.

upstream · string · required

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

tokenization · string · required

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

policy_name · string · required

Name of the active masking policy.

policy_version · number · required

Version number of the active policy.

policy_yaml · string · required

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

proxy_url · string · required

OpenAI-compatible proxy URL for this agent.

webhook_url · string · required

Vapi assistant-request webhook URL for this agent.

created_at · string · required

ISO 8601 UTC creation timestamp.

stats · object · required

Rolling usage statistics for this agent.

Show stats fields

session_count_24h · number

Sessions processed in the last 24 hours.

session_count_7d · number

Sessions processed in the last 7 days.

redaction_count_24h · number

Total PHI detections redacted in the last 24 hours.

p50_latency_ms · number

Median added latency in milliseconds over the last 24 hours.

p95_latency_ms · number

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

Example

curl

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