Go back to a version

POST

workflows

{id}

revert

curl -X POST "https://api.nedzo.ai/v1/workflows/123e4567-e89b-12d3-a456-426614174000/revert" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "version": 2 }'

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "workspaceId": "223e4567-e89b-12d3-a456-426614174000",
  "name": "Welcome text",
  "isPublished": false,
  "isActive": true,
  "version": 4,
  "publishedAt": "2026-10-11T09:00:00Z",
  "createdAt": "2026-10-01T09:00:00Z",
  "updatedAt": "2026-10-12T09:00:00Z",
  "nodes": [
    { "id": "start", "type": "contactCreated", "parentId": null, "pathId": null, "config": {}, "position": { "x": 0, "y": 0 } },
    { "id": "text", "type": "sendSms", "parentId": "start", "pathId": null, "config": { "phoneNumberId": "323e4567-e89b-12d3-a456-426614174000", "message": "Hi {{firstName}}!" }, "position": { "x": 0, "y": 120 } }
  ]
}

This endpoint is for the VIP plan only. Other plans get a 403. See Plan access.

Put back the steps of an older version. This saves a new version and unpublishes the workflow. Check it and publish it again. The API cannot bring back a step that turns DND off. If the old version has such a step, we answer 400: “This workflow has a step that turns DND off. Remove that step in the dashboard first.” Pick another version. To see the version numbers, list the versions.

Path Parameters

string

required

The workflow’s id.

Body

integer

required

The version number to go back to.

curl -X POST "https://api.nedzo.ai/v1/workflows/123e4567-e89b-12d3-a456-426614174000/revert" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "version": 2 }'

It answers with the workflow, the same as Get a workflow.

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "workspaceId": "223e4567-e89b-12d3-a456-426614174000",
  "name": "Welcome text",
  "isPublished": false,
  "isActive": true,
  "version": 4,
  "publishedAt": "2026-10-11T09:00:00Z",
  "createdAt": "2026-10-01T09:00:00Z",
  "updatedAt": "2026-10-12T09:00:00Z",
  "nodes": [
    { "id": "start", "type": "contactCreated", "parentId": null, "pathId": null, "config": {}, "position": { "x": 0, "y": 0 } },
    { "id": "text", "type": "sendSms", "parentId": "start", "pathId": null, "config": { "phoneNumberId": "323e4567-e89b-12d3-a456-426614174000", "message": "Hi {{firstName}}!" }, "position": { "x": 0, "y": 120 } }
  ]
}

Errors

Status	When
`400`	The workflow id is not a valid UUID, `version` is missing or below 1, or the version has a step that turns DND off.
`402`	The account has no plan, or its subscription is not active.
`403`	Your plan is not VIP, or workflows are not on your plan.
`404`	No workflow has this id, it is not in this key’s scope, or the version does not exist.
`502`	We could not check your plan. Nothing changed. Try again.

curl -X POST "https://api.nedzo.ai/v1/workflows/123e4567-e89b-12d3-a456-426614174000/revert" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "version": 2 }'

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "workspaceId": "223e4567-e89b-12d3-a456-426614174000",
  "name": "Welcome text",
  "isPublished": false,
  "isActive": true,
  "version": 4,
  "publishedAt": "2026-10-11T09:00:00Z",
  "createdAt": "2026-10-01T09:00:00Z",
  "updatedAt": "2026-10-12T09:00:00Z",
  "nodes": [
    { "id": "start", "type": "contactCreated", "parentId": null, "pathId": null, "config": {}, "position": { "x": 0, "y": 0 } },
    { "id": "text", "type": "sendSms", "parentId": "start", "pathId": null, "config": { "phoneNumberId": "323e4567-e89b-12d3-a456-426614174000", "message": "Hi {{firstName}}!" }, "position": { "x": 0, "y": 120 } }
  ]
}

API Reference

Workspaces

Agents

Phone Numbers

Contacts

Knowledge

Templates

Campaigns

Workflows

Conversations

Go back to a version

Path Parameters

Body

Errors