← API reference
CANONICAL TYPE REFERENCE

JourneyVersion

One immutable-once-published snapshot of a journey definition. The authoring history returned by listJourneyVersions.

TypeID of this version (prefix jnv, e.g. "jnv_01K…").

TypeID of the journey this version belongs to (prefix jny).

Monotonic version number within the journey, starting at 1. A new draft takes the next number; re-saving an open draft overwrites it in place, so numbers are not consumed per edit.

DRAFT before publication and never served to runners; PUBLISHED once publishJourney promotes it, after which it is immutable. Several DRAFT versions may be open at once — editing amends the newest editable draft, while createJourneyVersion mints a fixed source snapshot — and publishing promotes the one it names, leaving the rest open.

definitionString!

Compiled Journey JSON for the Surfaces runtime.

sourceXMLString

Exact authoring XML, available only to authors. On a Journey, the newest open draft takes precedence over the published version.

sourceString

XML source envelope, available only to authors.

ISO-8601 timestamp of when this version was first opened as a draft; publishing does not change it.

View exact SDL
"""
One immutable-once-published snapshot of a journey definition. The authoring history returned by `listJourneyVersions`.
"""
type JourneyVersion @iac_resource(name: "journey_version") @iac_replace(strategy: CREATE_BEFORE_DESTROY) @iac_guide(ref: "journey-authoring-guide") @iac_ops(create: "createJourneyVersionFromSource", read: "getJourneyVersion", delete: "deleteJourneyVersionIfExists") {
  """TypeID of this version (prefix `jnv`, e.g. "jnv_01K…")."""
  id: JourneyVersionID! @iac_identity(assignedBy: SERVER) @iac_computed
  """TypeID of the journey this version belongs to (prefix `jny`)."""
  journeyId: JourneyID! @iac_ref(resource: "journey", onTargetDelete: CASCADE) @iac_forcesReplace
  """
  Monotonic version number within the journey, starting at 1. A new draft takes the next number; re-saving an open draft overwrites it in place, so numbers are not consumed per edit.
  """
  version: Int! @iac_computed
  """
  DRAFT before publication and never served to runners; PUBLISHED once `publishJourney` promotes it, after which it is immutable. Several DRAFT versions may be open at once — editing amends the newest editable draft, while `createJourneyVersion` mints a fixed source snapshot — and publishing promotes the one it names, leaving the rest open.
  """
  status: JourneyStatus! @iac_computed
  """Compiled Journey JSON for the Surfaces runtime."""
  definition: String! @iac_computed
  """
  Exact authoring XML, available only to authors. On a Journey, the newest open draft takes precedence over the published version.
  """
  sourceXML: String @iac_forcesReplace @iac_artifact(language: XML, validators: ["journey-source"])
  """XML source envelope, available only to authors."""
  source: String @iac_computed
  """
  ISO-8601 timestamp of when this version was first opened as a draft; publishing does not change it.
  """
  createdAt: ISO8601! @iac_computed
}

One stable address across all schema views. Follow a field’s type to explore connections between domains.