Lifecycle

The lifecycle endpoints move a journey between states. Pass the journey’s Journey ID as uuid in the request body. The call returns the updated journey object.

A journey is always in one of these states:

Status	Meaning
`STATUS_DRAFT`	Being edited. Does not process users.
`STATUS_RUNNING`	Active, processing users.
`STATUS_PAUSED`	Temporarily halted, can be resumed.
`STATUS_FINISHED`	Stopped, no longer processing users. Can be paused to resume editing, or archived.
`STATUS_ARCHIVED`	Archived for storage. Terminal — cannot be reactivated through these endpoints.

Endpoints

All lifecycle calls use the same request body: Journey ID passed as uuid. They differ only in the path:

Action	Method & path	Resulting state
Start	`POST /api/v3/journeygateway/start`	`STATUS_RUNNING`
Pause	`POST /api/v3/journeygateway/pause`	`STATUS_PAUSED`
Finish	`POST /api/v3/journeygateway/finish`	`STATUS_FINISHED`
Archive	`POST /api/v3/journeygateway/archive`	`STATUS_ARCHIVED`

Valid transitions

From	To	Via
`STATUS_DRAFT`	`STATUS_RUNNING`	Start
`STATUS_RUNNING`	`STATUS_PAUSED`	Pause
`STATUS_PAUSED`	`STATUS_RUNNING`	Start
`STATUS_RUNNING`	`STATUS_FINISHED`	Finish
`STATUS_PAUSED`	`STATUS_FINISHED`	Finish
`STATUS_FINISHED`	`STATUS_PAUSED`	Pause
`STATUS_FINISHED`	`STATUS_ARCHIVED`	Archive

Archiving is the only step in this table that cannot be reversed through the lifecycle endpoints.

Request

Field	Required	Type	Description
`uuid`	Yes	string	Journey ID of the journey to transition.

{ "uuid": "11111111-2222-3333-4444-555555555555" }

The API validates the current state before transitioning — see the table above. For example, starting an archived journey returns an error, since archiving has no reverse transition.

Request examples

Start a journey

curl -X POST https://journey-api.svc-nue.pushwoosh.com/api/v3/journeygateway/start \
  -H "Authorization: Api YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "uuid": "11111111-2222-3333-4444-555555555555" }'

Pause a journey

curl -X POST https://journey-api.svc-nue.pushwoosh.com/api/v3/journeygateway/pause \
  -H "Authorization: Api YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "uuid": "11111111-2222-3333-4444-555555555555" }'

Response

Returns the updated journey object: info, points, and comments. The info.status field reflects the new state.

Response example

{
  "info": {
    "uuid": "11111111-2222-3333-4444-555555555555",
    "title": "Welcome series",
    "status": "STATUS_RUNNING",
    "created_at": "2026-05-01T09:00:00Z",
    "updated_at": "2026-06-17T12:00:00Z",
    "params": { "application_code": "XXXXX-XXXXX" },
    "campaign_type": "TriggerBased"
  },
  "points": [],
  "comments": []
}