Trace

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.

put/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

Request body

agent_idstring

Agent to configure; omit for the org-wide default.

enabledboolean
channelsstring[]
rule_packsobject

Map of pack_id → { enabled, version }, e.g. { tcpa: { enabled: true } }.

Response

Stored 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.