Skip to main content

Restore an archived config as a new version

POST 
/api/v1/agents/:agent_id/versions/:version/restore

Copies the named version's configuration onto the agent as a new version rather than rewinding the counter, so history stays append-only and the versions in between remain retrievable. Restoring the config the agent already holds is a no-op and creates no version.

The restored config fully replaces the current one: a field the archived version did not set is cleared, not merged. Restore re-validates the config, so a tool, provider, or guardrail deleted since the snapshot was taken fails the request instead of writing a broken agent.

Request​

Responses​

The agent, at its new version