---
title: "listJourneyRevisions"
method: GET
path: "/v1/journey/configuration/{id}/revisions"
tags: ["Journeys"]
---

# listJourneyRevisions

`GET /v1/journey/configuration/{id}/revisions`

## Request

- Base URL: `https://journey-config.sls.epilot.io`
- URL: `https://journey-config.sls.epilot.io/v1/journey/configuration/{id}/revisions`
- Auth: HTTP bearer

Lists the journey's revision history, newest first. Metadata only, no configuration payload. `is_published` says whether a revision is the published version right now, which is a different question from `published_at`, which records the last time it was published.

Only available for organizations with journey versioning enabled; returns `404` otherwise.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

Revision history

- JourneyRevisionList
  - `results` JourneyRevisionSummary[], required
    - `revision_id` string, required: Opaque identifier of the revision. Moves on every save.
    - `created_at` string, date-time, required
    - `created_by` string: User id of the author. Absent for revisions recorded from writes without a user, e.g. blueprint installs.
    - `name` string: Set at publish time only, so present if and only if this revision has been published at least once.
    - `description` string
    - `published_at` string, date-time: The last time this revision was published. Not the same question as `is_published`: a revision that was the published version yesterday still carries a `published_at`.
    - `is_published` boolean, required: Whether this revision is the published version right now.
    - `mapping_config_version` number: Version of the entity-mapping config stored alongside this revision.
  - `next_cursor` string: Opaque cursor to pass back as `cursor` to fetch the next page. Absent when the client has reached the end of the history.

## Other responses

- `400`: Invalid query parameters
- `403`: No permission to edit the journey
- `404`: Journey versioning not enabled for the organization, or journey not found

## Changes

- **2026-09-10** `23fd289cd5d8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/epilot/apis/journey-api/changes/v1/journey/configuration/:id/revisions/get.md)

---

[API](https://skmtc.dev/epilot/apis/journey-api.md) - [All operations](https://skmtc.dev/epilot/apis/journey-api/llms.txt) - [OpenAPI document](https://skmtc.dev/epilot/apis/journey-api/revisions/2f11eabb1f37?raw)