---
title: "patchUpdateJourney"
method: PATCH
path: "/v1/journey/configuration"
tags: ["Journeys"]
---

# patchUpdateJourney

`PATCH /v1/journey/configuration`

Update a Journey (partially / patch). Support for nested properties updates (e.g. "property[0].name").

## Request body

- PatchUpdateJourneyRequest — Patch request to update a journey (journey id is required) Support for nested properties (e.g. steps[0].uischema.elements[0].products) is supported.
  - `journeyId` string, uuid, required
  - `__lastModifiedAt` string, nullable — If passed with value of null, the API won't modify the lastModifiedAt field on updating the journey

## Response `200`

Success

- JourneyResponse
  - `createdJourney` Journey
    - `journeyId` string
    - `organizationId` string, required
    - `brandId` string
    - `name` string, required
    - `steps` object[], required
      - `showStepName` boolean, nullable
      - `title` string, nullable
      - `subTitle` string, nullable
      - `showStepSubtitle` boolean, nullable
      - `showStepper` boolean, nullable
      - `showStepperLabels` boolean, nullable
      - `hideNextButton` boolean, nullable
      - `name` string, required
      - `stepId` string
      - `schema` unknown, required
      - `uischema` unknown, required
      - `maxWidth` 'small' | 'medium' | 'large' | 'extra large'
    - `design` object
      - `logoUrl` string, nullable
      - `theme` object
      - `designTokens` object
    - `rules` object[]
      - `type` 'inject' | 'injectWithKey', required
      - `sourceType` 'journey' | 'step' | 'block', required
      - `source` string, required
      - `target` string, required
    - `logics` object[]
      - `autoGeneratedId` string
      - `conditions` string[], required
      - `actions` string[], required
    - `logicsV4` object
    - `contextSchema` object[]
      - `id` string, uuid — Unique identifier for the context schema item
      - `type` string, required — Type of the parameter. It could be either an entity slug, or a text
      - `paramKey` string, required — Expected key to be received in the context
      - `isRequired` boolean — Indicates if a value is expected to be provided
      - `shouldLoadEntity` boolean — If type is not text, we can instruct the journey to fetch the entity id we receive as value
      - `description` string, nullable — Human-readable note describing the parameter's purpose. Free text; may contain newlines.
    - `journey_type` string — Journey Template
    - `protected` boolean — If true, journey is displayed in read-only mode
    - `protectedEditable` string[] — Whitelist of paths that remain editable when the journey is protected. Supports wildcard patterns (e.g. steps/*/blocks/**).
    - `settings` object
      - `embedOptions` object
        - `mode` 'full-screen' | 'inline'
        - `lang` 'de' | 'en' | 'fr'
        - `width` string
        - `topBar` boolean
        - `scrollToTop` boolean
        - `button` object
          - `text` string, nullable
          - `align` 'left' | 'center' | 'right'
      - `safeModeAutomation` boolean
      - `canary` boolean — DEPRECATED - This API will return hardcoded value of false. Please note that this field is internal to epilot and should not be used by external clients. If you wish to get the canary flag, please use the /v1/journey/{id}/settings API.
      - `designId` string, required
      - `templateId` string, nullable
      - `entityId` string, nullable
      - `mappingsAutomationId` string
      - `targetedCustomer` string
      - `description` string, nullable
      - `organizationSettings` object, nullable
      - `publicToken` string, nullable
      - `runtimeEntities` string[]
      - `filePurposes` string[]
      - `entityTags` string[]
      - `addressSuggestionsFileUrl` string, nullable — @deprecated Use addressSuggestionsFileId instead
      - `addressSuggestionsFileId` string, nullable
      - `addressSuggestionsCountryCode` string, nullable — Country code for address format (e.g. DE, AT, CH, LU)
      - `addressSuggestionsEnableAutoComplete` boolean — Whether address auto-complete is enabled
      - `addressSuggestionsSource` string[] — Sources for address auto-complete (e.g. deutschePostService, customAddressesFile)
      - `addressSuggestionsEnableFreeText` boolean — Whether free text input is allowed when auto-complete is on
      - `useNewDesign` boolean — This property is deprecated and will be removed in a future version
      - `useAustrianLabels` boolean — If true, some journey input labels are in Austrian format
      - `enableDarkMode` boolean — If true, the journey shows an icon to toggle dark mode
      - `accessMode` 'PUBLIC' | 'PRIVATE'
      - `isPublished` boolean
      - `status` string
      - `isActive` boolean
      - `savingProgress` object
        - `mode` 'auto' | 'local' | 'remote' | 'none'
        - `supportedRevision` number
      - `thirdPartyCookies` boolean — If false, third-party cookies are disabled to comply with GDPR regulations without asking for consent.
    - `validationRules` ValidationRuleRef — References to validation rules organized by blocks and fields. Maps block IDs to either rule IDs (for block-level rules) or rule references (for field-level rules).
    - `_manifest` string[] — Manifest/Blueprint ID used to create/update the entity
    - `createdBy` string
    - `updatedBy` string, nullable
    - `__lastModifiedAt` string, nullable — If passed with value of null, the API won't modify the lastModifiedAt field on updating the journey
    - `createdAt` string, required
    - `lastModifiedAt` string, required
    - `deletedAt` string
    - `version` number, required
    - `revisions` number, required
    - `featureFlags` object

## Other responses

- `400` — Validation failed (when validation mode is STRICT)
- `404` — Journey or associated entity not found

---

[API](https://skmtc.net/epilot/apis/journey-api.md) · [All operations](https://skmtc.net/epilot/apis/journey-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/epilot/journey-api/versions/515acb1f892e/schema)