← API reference
Mutation / surfaces

upsertJourney

Create a journey or overwrite its open draft. PERSONAL is self-service; TEAM/INSTANCE require journey:write.

Arguments

The journey document plus its scope and team assignments. The definition's id (the handle) selects the journey to edit, or creates one if no journey in the tenant carries that handle.

Returns JourneyPayload!

Explore in a view

Journeys and Workspaces
View exact SDL
"""
Create a journey or overwrite its open draft. PERSONAL is self-service; TEAM/INSTANCE require journey:write.
"""
upsertJourney(
  """
  The journey document plus its scope and team assignments. The definition's `id` (the handle) selects the journey to edit, or creates one if no journey in the tenant carries that handle.
  """
  input: UpsertJourneyInput!
): JourneyPayload! @topic(names: ["surfaces"])

Schema reference describes the API contract. Actual access is checked by the platform for every operation.