Read an agent's newest-first config change trail
Return a derived, newest-first trail of an agent’s governed-configuration changes, diffed from its immutable prompt-version ledger (agent_prompt_versions). Use it before promoting or rolling back a version to see exactly which governed fields (system prompt, model, temperature, tools, knowledge bases, guardrails) moved — each entry carries the changed field list and before/after values. Pass field to narrow the page to one governed field and cursor to keyset-paginate on the version numbers; the page returns at most limit (default 50, max 200) entries.
Authorizations
Dashboard JWT token from Clerk
Headers
Sandbox opt-in for Clerk-session-authenticated requests. Set to true to route the call through the test-mode pipeline: no real provider delivery, no credits deducted, response meta.test_mode: true. Ignored for live API keys (dv_live_sk_*) — server-to-server clients must use a test-prefixed key (dv_test_sk_*) to exercise sandbox. Test-prefixed keys unconditionally enable sandbox regardless of this header.
true, false Path Parameters
Identifier of the agent whose change trail to read.