Skip to main content
PUT
Update Journey Status
Changes the journey status, clears the pause reason, and updates holds on active enrollments. Draft and paused statuses hold active enrollments; active and archived statuses release existing holds. An archived journey sends nothing, and its released enrollments exit permanently as they come due; a later status change does not restore them. Draft and paused hold the enrollments before the new status is stored, while active and archived store the status before releasing them, so a request that fails partway can only delay sends, never leave a stopped journey still sending. Declares the journeys.write scope. Authenticate with X-Api-Key; see Authentication. Activation follows the API key requirements. Restricted keys retain the three stop statuses. Extra body fields are ignored by this endpoint.

Parameters

string
required
Journey ID returned by create or list. Use a valid journey ID; malformed IDs currently return an unexpected error.
string
required
One of draft, active, paused, or archived.
Activation requires a nonempty steps array and a start step, and rechecks referenced double opt-in configurations. Invalid status or activation requirements return 400; missing or foreign journeys return 404.

Response

The compact journey object contains id, name, priority, triggerSummary, stepCount, enrolledCount, completedCount, status, pauseReason, createdAt, and updatedAt. It omits the account ID, trigger definition, and steps. Use Get Journey for the full definition.
For activation errors and ambiguous outcomes, follow the write retry rules.