Publish flow | Talkif Docs

{
  "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
  },
  "version": "1.2.0",
  "changeSummary": null,
  "transformationSummary": {
    "agentsTransformed": [
      "main_agent_1",
      "support_agent"
    ],
    "originalNodeCount": 8,
    "servicesExtracted": [
      "openai_llm",
      "elevenlabs_tts",
      "deepgram_stt"
    ],
    "transformedNodeCount": 3
  },
  "warnings": [
    {
      "code": "invalid_format",
      "field": "email",
      "message": "Email format is invalid"
    }
  ]
}

POST /api/v1/flows/:flowId/publish

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

Request

This endpoint expects an object.

expectedVersionstring or nullOptional

Expected current version for optimistic locking (rejects with 409 if stale)

notesstring or nullOptional

Changelog notes describing what changed in this version (max 1000 characters)

versionstring or nullOptional

Explicit version override in X.Y.Z format (auto-increments patch if omitted)

Response

Flow published

flowobject

Flow detail after publishing

versionstring

Newly published version string

changeSummaryobject or nullOptional

Top-level change summary stored in flow_versions.change_summary

transformationSummaryobject or nullOptional

Transformation summary for publish response

warningslist of objects or nullOptional

Non-fatal validation warnings that did not block publishing

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