Samva
DashboardAPI
ChannelsPlatformMailboxesDevelopersEmail templatesIntegrationsAPI Reference
Journeys

Replace a journey draft (Preview)

Preview · Available to selected organizations. Replaces the draft definition and returns the journey with a new revision.

PUT
/v1/journeys/{id}/draft

Replaces the draft definition and returns the journey with a new revision. The request names the revision it read; a stale revision returns 409. Published versions and the runs on them do not change.

Authorization

apiKey
x-api-key<token>

In: header

Path Parameters

id*string
Match^jrny_[0-9a-hjkmnp-tv-z]{16,24}$

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

revision*string
Length1 <= length
definition*

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PUT "https://example.com/v1/journeys/string/draft" \  -H "Content-Type: application/json" \  -d '{    "revision": "string",    "definition": {      "trigger": {        "type": "event",        "eventName": "string"      },      "rootNodeId": "string",      "nodes": {        "property1": {          "type": "send_email",          "config": {            "template": "string"          },          "next": [            {              "nodeId": "string"            }          ]        },        "property2": {          "type": "send_email",          "config": {            "template": "string"          },          "next": [            {              "nodeId": "string"            }          ]        }      }    }  }'
{  "id": "string",  "name": "string",  "status": "draft",  "revision": "string",  "draft": {    "trigger": {      "type": "event",      "eventName": "string"    },    "rootNodeId": "string",    "nodes": {      "property1": {        "type": "send_email",        "config": {          "template": "string",          "senderId": "string",          "templateData": {            "property1": "string",            "property2": "string"          }        },        "next": [          {            "nodeId": "string"          }        ]      },      "property2": {        "type": "send_email",        "config": {          "template": "string",          "senderId": "string",          "templateData": {            "property1": "string",            "property2": "string"          }        },        "next": [          {            "nodeId": "string"          }        ]      }    },    "goal": {      "eventName": "string"    },    "reentry": true  },  "publishedVersion": -9007199254740991,  "publishedAt": "string",  "createdAt": "string",  "updatedAt": "string"}

Related documentation

Delete a journey (Preview)

Preview · Available to selected organizations. Deletes a journey that was never published or is archived, with its versions and runs. An active or paused journey returns 409; archive it first.

Resume a journey (Preview)

Preview · Available to selected organizations. Resumes enrollment and continues the runs the pause held. Requires a plan that includes journeys.