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.

note: 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.

Required Permission Scope

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

URL Parameters

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

Query Parameters

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`.

JSON Parameters

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: <ul><li>`stop`–Stop the journey when the number of paused days elapses.</li><li>`resume`–Resume the journey when the number of paused days elapses.</li><li>`none`–Do nothing when the number of paused days elapses.</li></ul>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`.

Example Request

Host: https://YOUR_SUBDOMAIN.rest.marketingcloudapis.com
POST  /interaction/v1/interactions/pause/YOUR_JOURNEY_ID?versionNumber=4
Content-Type: application/json
Authorization: Bearer YOUR_ACCESS_TOKEN

{
    "ExtendWaitEndDates":false,
    "PausedDays":30,
    "ProcessWaitUntilEvents":true,
    "GuardrailAction":"Resume",
    "RetainContactInjectionWhileJourneyPaused":true
}

Response: No Errors

HTTP/1.1 202 Accepted
{
    "status": "Accepted"
}

Response: Missing Version Number

HTTP/1.1 400
{
    "message": "AllVersions=true or VersionNumber required.",
    "errorcode": 10005,
    "documentation": ""
}

Response: Invalid Id

HTTP/1.1 400
{
    "message": "Must provide a valid ID or Key parameter",
    "errorcode": 10005,
    "documentation": ""
}

Response: No Journey That Can Be Paused Matches the Id

HTTP/1.1 400
{
    "message": "An interaction must be in published or unpublished status to be paused.",
    "errorcode": 10000,
    "documentation": ""
}

Response: Runtime Error

HTTP/1.1 400
{
    "message": "{{{ERROR_OPEN_SUPPORT_CASE}}}",
    "errorcode": 30000,
    "documentation": ""
}

Response: Empty or Incorrect Authorization Token

HTTP/1.1 401
{
    "documentation": "https://developer.salesforce.com/docs/atlas.en-us.mc-apis.meta/mc-apis/error-handling.htm",
    "errorcode": 0,
    "message": "Not Authorized"
}