POST /interaction/v1/interactions/pause/{definitionID}

Pause a journey that’s currently running by specifying its ID. To pause a journey by specifying its external key, use /interaction/v1/interactions/pause/key:{definitionKey} instead.

This operation only applies to standard journeys. To pause a transactional send journey, use the messaging/v1/email/definitions/{definitionKey} endpoint to set the value of the status property to inactive.

To use this endpoint to pause journeys, you must have the Automation | Journeys | Activate/Stop/Pause/Resume/Send/ScheduleActivate scope.

Name	Type	Description
`definitionID`	string	Required. The ID of the journey to pause.

Name	Type	Description
`versionNumber`	integer	The version number of the journey to pause. If the value of the `allVersions` parameter is `false`, this parameter is required.
`allVersions`	boolean	Use this parameter to specify whether to pause all versions of the journey. If the value of this parameter is `false`, you must specify a value for `versionNumber`. The default value is `false`.

The request body can contain a JSON object that contains any of the values in this table.

Name	Type	Description
`ExtendWaitEndDates`	boolean	Use this parameter to specify whether to extend the wait periods for Wait by Duration activities while the journey is paused. This parameter applies only to Wait By Duration wait types. If the value is `true`, the wait end date is extended by the number of days specified by `PausedDays`. The default value is `false`.
`GuardrailAction`	string	The action to take after the number of days specified by the `PausedDays` property. Possible values: `stop`–Stop the journey when the number of paused days elapses. `resume`–Resume the journey when the number of paused days elapses. `none`–Do nothing when the number of paused days elapses. The default value is `none`.
`PausedDays`	integer	The number of days to pause the journey. The default value is `14`.
`RetainContactInjectionWhileJourneyPaused`	boolean	Use this parameter to specify how new contacts are handled while the journey is paused. If the value is `true`, new contacts are added to a queue and processed when the journey resumes. If the value is `false`, new contacts are ignored. The default value is `false`.