Skip to main content
GET
/
v1
/
trace
/
config
Get Trace config for an agent (or the org default)
curl --request GET \
  --url https://api.pyai.com/v1/trace/config \
  --header 'Authorization: Bearer <token>'
{
  "object": "trace.config",
  "agent_id": "<string>",
  "enabled": true,
  "etag": "<string>",
  "updated_at": 123,
  "config": {
    "agent_id": "<string>",
    "enabled": false,
    "channels": [
      "voice"
    ],
    "rule_packs": {},
    "guardrails": {
      "mode": "warn",
      "block_pii": {
        "patterns": []
      },
      "mandatory_disclosures": [
        {
          "text": "<string>",
          "required_within_seconds": 123
        }
      ],
      "blocked_phrases": [
        "<string>"
      ],
      "fail_open": true,
      "inline_timeout_ms": 10
    }
  }
}

Authorizations

​
Authorization
string
header
required

Use Authorization: Bearer pyai_live_... (or pyai_test_...).

Query Parameters

​
agent_id
string

Agent to read config for; omit for the org default.

Response

Trace config

​
object
string
Example:

"trace.config"

​
agent_id
string | null
​
enabled
boolean
​
mode
enum<string>
Available options:
warn,
modify,
block,
human_handoff
​
etag
string

Content hash the models-side gate pins (version-pinned, ETag-cached pull).

​
updated_at
integer

Unix ms.

​
config
object

Per-agent Trace config (spec §5.1). May be wrapped as { agent_id, config } or sent raw.