---
title: "Update a journey's status (activate/pause)"
method: PUT
path: "/v2/journeys/{journey_id}/status"
tags: ["journeys-v2"]
---

# Update a journey's status (activate/pause)

`PUT /v2/journeys/{journey_id}/status`

## Request

- Base URL: `https://api.tracklysms.com/api`
- URL: `https://api.tracklysms.com/api/v2/journeys/{journey_id}/status`
- Auth: API key in header `X-Api-Key`

## Request body

- JourneyStatusRequest
  - `status` 'draft' | 'active' | 'paused' | 'archived', required

## Response `200`

Journey status updated

- JourneySummaryResponse
  - `journey` WelcomeJourneySummary
    - `completedCount` integer: Completed enrollments
    - `createdAt` string, nullable: Creation timestamp
    - `enrolledCount` integer: Active enrollments
    - `id` string: Journey ID
    - `name` string: Journey name
    - `pauseReason` string, nullable: Reason for an automatic pause, when present
    - `priority` integer: Journey routing priority
    - `status` string: Journey status
    - `stepCount` integer: Number of steps
    - `triggerSummary` string: Enrollment trigger summary
    - `updatedAt` string, nullable: Last update timestamp
  - `message` string
  - `success` boolean

## Other responses

- `400`: Invalid request
- `401`: Authentication error
- `403`: Insufficient authority
- `404`: Journey not found
- `409`: Journey write conflict or unknown outcome
- `500`: Unexpected error
- `503`: API key send policy unavailable

---

[API](https://skmtc.dev/tracklysms/apis/trackly-sms-api.md) · [All operations](https://skmtc.dev/tracklysms/apis/trackly-sms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tracklysms/apis/trackly-sms-api/revisions/ac1ad22cb2a9?raw)