# Journeys

In Audience Studio, a journey represents a timeline of events that can help you motivate a customer’s behavior about your product. After marketers create journey stages, they can further analyze and refine the stages and activate specific stages for campaigns. <br><br> _Journeys is a premium feature. Contact your Customer Success Representative for more information._

## List journeys

 - [GET /entities/journeys](https://td-public.redocly.app/apis/audience_api_v1/journeys/paths/~1entities~1journeys/get.md): List journeys under the specified folder.

## Create journey

 - [POST /entities/journeys](https://td-public.redocly.app/apis/audience_api_v1/journeys/paths/~1entities~1journeys/post.md): Create a journey.

## Retrieve summary of specified journey

 - [GET /entities/journeys/{journeyId}](https://td-public.redocly.app/apis/audience_api_v1/journeys/paths/~1entities~1journeys~1%7Bjourneyid%7D/get.md): Retrieve the summary of a specified journey.

## Update journey entity

 - [PATCH /entities/journeys/{journeyId}](https://td-public.redocly.app/apis/audience_api_v1/journeys/paths/~1entities~1journeys~1%7Bjourneyid%7D/patch.md): Update a journey entity.

## Delete journey entity

 - [DELETE /entities/journeys/{journeyId}](https://td-public.redocly.app/apis/audience_api_v1/journeys/paths/~1entities~1journeys~1%7Bjourneyid%7D/delete.md): Delete a journey entity.

## Update meta field

 - [POST /entities/journeys/{journeyId}/detail](https://td-public.redocly.app/apis/audience_api_v1/journeys/paths/~1entities~1journeys~1%7Bjourneyid%7D~1detail/post.md): Update the meta field of the journey in draft.

## Retrieve a list of available behavior table of specified step

 - [POST /entities/journeys/{journeyId}/available_behaviors_for_step](https://td-public.redocly.app/apis/audience_api_v1/journeys/paths/~1entities~1journeys~1%7Bjourneyid%7D~1available_behaviors_for_step/post.md): Retrieve a list of available behavior table of specified step.

## Retrieve a list of journey activation templates of specified step

 - [POST /entities/journeys/{journeyId}/activation_templates_for_step](https://td-public.redocly.app/apis/audience_api_v1/journeys/paths/~1entities~1journeys~1%7Bjourneyid%7D~1activation_templates_for_step/post.md): Retrieve a list of journey activation templates of specified step.

## Create a duplicate of the specified journey

 - [POST /entities/journeys/duplicate](https://td-public.redocly.app/apis/audience_api_v1/journeys/paths/~1entities~1journeys~1duplicate/post.md): Create a duplicate of the specified journey

## Retrieve journey statistics

 - [GET /entities/journeys/{journeyId}/statistics](https://td-public.redocly.app/apis/audience_api_v1/journeys/paths/~1entities~1journeys~1%7Bjourneyid%7D~1statistics/get.md): Retrieve the specified journey statistics.

## Retrieve the list of conversion sankey chart source data

 - [GET /entities/journeys/{journeyId}/conversion_sankey_charts](https://td-public.redocly.app/apis/audience_api_v1/journeys/paths/~1entities~1journeys~1%7Bjourneyid%7D~1conversion_sankey_charts/get.md): Retrieve the list of conversion sankey chart source data

## Retrieve the list of activation sankey chart source data

 - [GET /entities/journeys/{journeyId}/activation_sankey_charts](https://td-public.redocly.app/apis/audience_api_v1/journeys/paths/~1entities~1journeys~1%7Bjourneyid%7D~1activation_sankey_charts/get.md): Retrieve the list of activation sankey chart source data

## Retrieve list of profiles in journey

 - [GET /entities/journeys/{journeyId}/customers](https://td-public.redocly.app/apis/audience_api_v1/journeys/paths/~1entities~1journeys~1%7Bjourneyid%7D~1customers/get.md): Retrieve a list of profiles in a journey.

## Retrieve list of segment rules available in audience

 - [GET /entities/journeys/segment_rules](https://td-public.redocly.app/apis/audience_api_v1/journeys/paths/~1entities~1journeys~1segment_rules/get.md): Retrieve a list of segment rules available in an audience. It returns the viewable journeys only.

## Retrieve list of journey activations in journey

 - [GET /entities/journeys/{journeyId}/activations](https://td-public.redocly.app/apis/audience_api_v1/journeys/paths/~1entities~1journeys~1%7Bjourneyid%7D~1activations/get.md): Retrieve a list of journey activations for the specified journey.

## Create an activation step in journey

 - [POST /entities/journeys/{journeyId}/activations](https://td-public.redocly.app/apis/audience_api_v1/journeys/paths/~1entities~1journeys~1%7Bjourneyid%7D~1activations/post.md): Create an activation step in a journey.

## Retrieve summary of activation node in journey

 - [GET /entities/journeys/{journeyId}/activations/{journeyActivationStepId}](https://td-public.redocly.app/apis/audience_api_v1/journeys/paths/~1entities~1journeys~1%7Bjourneyid%7D~1activations~1%7Bjourneyactivationstepid%7D/get.md): Retrieve a summary of the activation node in a journey.

## Update the configuration of the activation step in journey

 - [PATCH /entities/journeys/{journeyId}/activations/{journeyActivationStepId}](https://td-public.redocly.app/apis/audience_api_v1/journeys/paths/~1entities~1journeys~1%7Bjourneyid%7D~1activations~1%7Bjourneyactivationstepid%7D/patch.md): Update the configuration of the activation step in journey.

## Pause journey and associated activations schedules.

 - [PATCH /entities/journeys/{journeyId}/pause](https://td-public.redocly.app/apis/audience_api_v1/journeys/paths/~1entities~1journeys~1%7Bjourneyid%7D~1pause/patch.md): Pause journey and associated activations schedules.

## Resume journey and associated activations schedules.

 - [PATCH /entities/journeys/{journeyId}/resume](https://td-public.redocly.app/apis/audience_api_v1/journeys/paths/~1entities~1journeys~1%7Bjourneyid%7D~1resume/patch.md): Resume journey and associated activations schedules.

## Retrieve list of profiles in the journey stage

 - [GET /entities/journeys/{journeyId}/journey_stages/{journeyStageId}/customers](https://td-public.redocly.app/apis/audience_api_v1/journeys/paths/~1entities~1journeys~1%7Bjourneyid%7D~1journey_stages~1%7Bjourneystageid%7D~1customers/get.md): Retrieve a list of profiles in a journey stage.

## Return the journey bundle information

 - [GET /entities/journey_bundles/{journeyBundleId}](https://td-public.redocly.app/apis/audience_api_v1/journeys/paths/~1entities~1journey_bundles~1%7Bjourneybundleid%7D/get.md): Return the journey bundle information which contains the list of journey versions

## Update the metadata of the journey bundle

 - [PATCH /entities/journey_bundles/{journeyBundleId}](https://td-public.redocly.app/apis/audience_api_v1/journeys/paths/~1entities~1journey_bundles~1%7Bjourneybundleid%7D/patch.md): Update the editable journey bundle information. The following fields are editable with this API.
  - name
  - description
  - latestJourneyId
To update the latest journey, the following validation checks the validity of the operation.
  - The journey must exist and belong to this journey bundle
  - The journey must be launched
The case when launching new journey as the latest is treated by the POST journey endpoint with the 
journeyBundleId.


## Delete the journey bundle

 - [DELETE /entities/journey_bundles/{journeyBundleId}](https://td-public.redocly.app/apis/audience_api_v1/journeys/paths/~1entities~1journey_bundles~1%7Bjourneybundleid%7D/delete.md): Delete the journey bundle

## Returns the latest journey in the bundle

 - [GET /entities/journey_bundles/{journeyBundleId}/latest](https://td-public.redocly.app/apis/audience_api_v1/journeys/paths/~1entities~1journey_bundles~1%7Bjourneybundleid%7D~1latest/get.md): Returns the latest journey in the bundle

## Return the list of statistics of jouney under the bundle

 - [GET /entities/journey_bundles/{journeyBundleId}/statistics](https://td-public.redocly.app/apis/audience_api_v1/journeys/paths/~1entities~1journey_bundles~1%7Bjourneybundleid%7D~1statistics/get.md): Return the statistics under the journey bundle.

## Return the list of conversion sankey charts of journey under the bundle

 - [GET /entities/journey_bundles/{journeyBundleId}/conversion_sankey_charts](https://td-public.redocly.app/apis/audience_api_v1/journeys/paths/~1entities~1journey_bundles~1%7Bjourneybundleid%7D~1conversion_sankey_charts/get.md): Return the list of conversion sankey charts of journey under the bundle

## Return the list of activation sankey charts of journey under the bundle

 - [GET /entities/journey_bundles/{journeyBundleId}/activation_sankey_charts](https://td-public.redocly.app/apis/audience_api_v1/journeys/paths/~1entities~1journey_bundles~1%7Bjourneybundleid%7D~1activation_sankey_charts/get.md): Return the list of activation sankey charts of journey under the bundle

## Returns the list of activations associated with the journey bundle

 - [GET /entities/journey_bundles/{journeyBundleId}/activations](https://td-public.redocly.app/apis/audience_api_v1/journeys/paths/~1entities~1journey_bundles~1%7Bjourneybundleid%7D~1activations/get.md): Returns the list of activations associated with the journey bundle

## Create the new journey under the bundle with copying the latest journey

 - [POST /entities/journey_bundles/{journeyBundleId}/journeys](https://td-public.redocly.app/apis/audience_api_v1/journeys/paths/~1entities~1journey_bundles~1%7Bjourneybundleid%7D~1journeys/post.md): Return the journey bundle information which contains the list of journey versions

## Validate the journey can be appended to the bundle

 - [GET /entities/journey_bundles/{journeyBundleId}/journeys_appendable](https://td-public.redocly.app/apis/audience_api_v1/journeys/paths/~1entities~1journey_bundles~1%7Bjourneybundleid%7D~1journeys_appendable/get.md): Validate the journey can be appended to the bundle