# Restore an archived config as a new version

> 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…

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

<ParamsDetails
  {...require("./restore-agent-version.ParamsDetails.json")}
>

<RequestSchema
  {...require("./restore-agent-version.RequestSchema.json")}
>

<StatusCodes
  {...require("./restore-agent-version.StatusCodes.json")}
>