← API reference
Mutation / surfaces

validateJourneyDefinition

Validate a journey definition through the full two-tier pipeline (Tier-1 SurfaceKit + Tier-2 live-schema GraphQL) WITHOUT persisting it. Returns the full diagnostic list. Requires journey:write. Returns success:false with an explanatory diagnostic when the live schema is unavailable — unlike write mutations, this mutation never silently skips Tier-2.

Arguments

definitionString!

Journey definition JSON document to validate.

Returns ValidateSurfacePayload!

Scalar fields at a glance

successBoolean!
↗ View the complete ValidateSurfacePayload type

Explore in a view

Journeys and Workspaces
View exact SDL
"""
Validate a journey definition through the full two-tier pipeline (Tier-1 SurfaceKit + Tier-2 live-schema GraphQL) WITHOUT persisting it. Returns the full diagnostic list. Requires journey:write. Returns success:false with an explanatory diagnostic when the live schema is unavailable — unlike write mutations, this mutation never silently skips Tier-2.
"""
validateJourneyDefinition(
  """Journey definition JSON document to validate."""
  definition: String!
): ValidateSurfacePayload! @topic(names: ["surfaces"])

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