Set Trace config for an agent (or the org default)
Upsert the per-agent Trace config (spec §5.1). The body is the §5.1 object (optionally
wrapped as { agent_id, config }). Modes: warn (log only, never blocks) · modify
(redact PII / inject disclosures) · block · human_handoff. Always fail-open; the
deterministic inline gate runs models-side, the platform only distributes config.
Returns the stored config with its content ETag (the models-side pull pins this).
Requires the trace:configure scope.
Authorizations
Use Authorization: Bearer pyai_live_... (or pyai_test_...).
Body
Per-agent Trace config (spec §5.1). May be wrapped as { agent_id, config } or sent raw.
Agent to configure; omit for the org-wide default.
voice, text Map of pack_id → { enabled, version }, e.g. { tcpa: { enabled: true } }.
Inline guardrails compiled into a synthesized rule pack (spec §5.1).
Response
Stored config
"trace.config"
warn, modify, block, human_handoff Content hash the models-side gate pins (version-pinned, ETag-cached pull).
Unix ms.
Per-agent Trace config (spec §5.1). May be wrapped as { agent_id, config } or sent raw.