Skip to main content
List a workflow’s snapshots — the automatic version history. Snapshots are an immutable, content-addressed capture of the whole workflow graph, auto-created before every node edit and at run start. They form the undo log: find the snapshot from just before a bad change, then inspect it with clay workflows snapshots get or roll back with clay workflows snapshots restore. 
clay workflows snapshots list <workflowId>

​
Arguments

ArgumentDescription
workflowIdWorkflow id, e.g. wf_abc123. Required.

​
Output

Results are returned newest-first, so data[0] is the most recent snapshot. 
{
  "data": [
    {
      "id": "snap_xyz",
      "hash": "a1b2c3d4",
      "createdAt": "2026-06-01T12:00:00Z",
      "nodeCount": 8,
      "edgeCount": 7
    }
  ]
}
FieldTypeDescription
data[].idstringSnapshot id. Pass to snapshots get or snapshots restore.
data[].hashstringContent-addressed hash of the captured graph.
data[].createdAtstringWhen the snapshot was taken.
data[].nodeCountnumberNumber of nodes in the captured graph.
data[].edgeCountnumberNumber of edges in the captured graph.

​
Errors

CodeExitNotes
validation_error2workflowId argument is required.
not_found6No workflow with that id.
auth_forbidden3The API key lacks permission for this command.

​
Examples

clay workflows snapshots list wf_abc123
clay workflows snapshots list wf_abc123 | jq -r '.data[0].id'
clay workflows snapshots list wf_abc123 | jq '.data | length'