List agent traces
Use when: caller wants to browse recorded agent runs (traces), optionally filtered to one agent gate, a status, or a session label
Paginated list of traces — one row per bounded agent run. A trace groups every span of the run (LLM generations, tool executions, nested sub-agents). Filter by gateId, status (active, completed, incomplete, error), or sessionLabel (the caller-supplied conversation id).
Authorizations
Verlon API key (newly minted keys are prefixed sk-vrln-; legacy verlon_* and layer_* keys from prior prefix migrations continue to validate). Generated from the dashboard under Settings → API Keys, or via verlon key create in the CLI.
Query Parameters
active, completed, incomplete, error 5001 <= x <= 200x >= 0Response
Paginated trace list.

