Skip to main content
POST
Restore an agent revision
Makes revision number’s spec current again. History is never rewritten: the restored spec becomes the agent’s next revision, with the message Restored from vN and restored_from set to N. Later sessions run it, except those pinned to another revision with name:N. Restoring a spec equal to the current one changes nothing. The restored spec is checked like an update: the environments, skills, and subagents it names must still exist and be visible to you. Returns the restored agent object, with its new revision in the ETag header.

Headers

string
The ETag of the revision you based this rollback on, for example "5". If the agent has moved past it, the restore fails with 412. Omit it, or send *, to restore regardless.

Path parameters

string
required
The agent’s name (e.g. my-research-bot or myorg/web-helper). Slash-containing names are supported.
integer
required
The revision to restore. See List revisions.

Examples

Response

Errors