Skip to main content
POST
Restore a workflow version

Authorizations

Authorization
string
header
required

API key issued from Settings → API Keys. Pass as Authorization: Bearer <key>.

Path Parameters

id
string
required

Workflow id, agent id, or typed alias like workflows.slug / agents.slug

versionId
string
required

Version id from GET /automations/{id}/versions (a workflow history id).

Body

application/json

Optional JSON body. Send {} when no message is needed. Restore always creates a new untagged current snapshot; it does not retag the source version.

message
string

Optional restore commit message. Defaults to a timestamped restore note.

Response

New current version created from the restored snapshot.

id
string
required
automationId
string
required
version
string | null
required
sourceRef
string | null
isCurrent
boolean
createdAt