Skip to main content
GET
Get Trace config for an agent (or the org default)

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.