PUT /interaction/v1/interactions
Updates a journey version. To call this resource, assign your API Integration the Automation | Interactions | Read scope.
JSON Parameters
| Name | Type | Description | |
|---|---|---|---|
| key | string | Required | The user-defined Key for the journey to update |
| name | string | Required | The name of this journey |
| workflowApiVersion | number | Required | The Journey Spec version to use for this journey. Possible values: 0.5, 1.0. |
| version | number | Required | The version of this journey |
| id | string | The GUID (UUID) to be used while referencing this journey. | |
| modifiedDate | string | This field must match the current Database value from Marketing Cloud or the request will be rejected. You are not actually updating this field; it is used in mapping to the correct version of this journey | |
| description | string | A description of this journey | |
| goals | array | The goal for this particular journey. Expressed as an object of type ContactDecision from the Journey Spec. | |
| triggers | array | The trigger for this particular journey. Expressed as an object of type ContactEvent from the Journey Spec. | |
| activities | array | The activities which compose this particular journey. Expressed as objects of types supported by the Journey Spec |
Usage
Example Request
This request updates the journey version specified by the versionNumber Query Parameter.
This example represents the minimum required parameters to update the journey version, as prescribed by the Journey Spec. To understand how to leverage the full capability of updating journeys via the API, the Journey Spec documentation provides a comprehensive list of all available parameters.
These JSON parameters are always provided by Journey Builder and can never be updated:
- id
- lastPublishedDate
- createdDate
- modifiedDate, used in the request body, but only for mapping
- definitionId
- status
Although the modifiedDate may not be updated, you are required to pass current value that matches the database record. This prevents simultaneous writes that would overwrite other users' changes.
Example Successfully Update Journey Response
Example Error Messages