Trace

Get Trace config for an agent (or the org default)

Returns the per-agent Trace config (spec §5.1). Pass agent_id to read a specific agent's config; omit it for the org-wide default a new agent inherits. When nothing has been configured yet, returns the safe default (enabled:false, mode:warn, fail_open:true). Requires the trace:configure scope.

get/v1/trace/config

Request

  • Base URL: https://api.pyai.com
  • URL: https://api.pyai.com/v1/trace/config
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Query parameters

agent_idstring

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

Response

Trace config

objectstring
agent_idstring nullable
enabledboolean
mode'warn' | 'modify' | 'block' | 'human_handoff'
etagstring

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

updated_atinteger

Unix ms.

Example response

{
  "object": "trace.config"
}

Changes

No recorded changes to this operation across all 1 revision of this API.