Rollback flow to version

POST

https://api.talkif.ai/api/v1/flows/:flowId/rollback/:version

POST

/api/v1/flows/:flowId/rollback/:version

curl -X POST https://api.talkif.ai/api/v1/flows/flowId/rollback/version \
     -H "Authorization: Bearer <token>"

{
  "flow": {
    "accountId": "550e8400-e29b-41d4-a716-446655440000",
    "analysisOverride": "use_account_default",
    "connectedPhones": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "phoneNumber": "+15551234567",
        "friendlyName": "Main Office Line"
      }
    ],
    "createdAt": "2026-01-15T10:30:00Z",
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Appointment Reminder",
    "recordingOverride": "use_account_default",
    "status": "DRAFT",
    "tags": [
      "healthcare",
      "scheduling"
    ],
    "updatedAt": "2026-01-20T14:00:00Z",
    "version": "1.2.0",
    "versions": [
      {
        "publishedAt": "2026-01-15T10:30:00Z",
        "version": "1.2.0",
        "notes": "string"
      }
    ],
    "voicemailEnabled": true,
    "analysisInstructions": "string",
    "definition": null,
    "description": "Automated appointment reminder calls",
    "layout": {},
    "maxCallDuration": null,
    "publishedAt": "2024-01-15T09:30:00Z",
    "userIdle": null,
    "voicemailMessage": "string",
    "voicemailMessagePrompt": "string",
    "voicemailResponseDelaySecs": 2
  },
  "newVersion": "1.3.0",
  "rolledBackFrom": "1.2.0"
}

POST /api/v1/flows/:flowId/rollback/:version

Authentication

AuthorizationBearer

Pass a JWT access token or an API key (prefixed with tif_live_) as a Bearer token.

Path parameters

flowIdstringRequiredformat: "uuid"

Flow ID

versionstringRequired

Version to rollback to

Response

Rollback result

flowobject

Flow detail after rollback has been applied

newVersionstring

New version assigned after rollback (auto-incremented patch)

rolledBackFromstring

Version that was rolled back from

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

429

Too Many Requests Error

500

Internal Server Error