# Journeys

Guide contacts through timely, event-driven customer journeys.

10 operations in the Journeys resource group.

## Operations

- [List journeys](/reference/journeys/get-journeys.md) - GET `/journeys` - Returns customer journeys that can react to contact events and conversation moments.
- [Create journey](/reference/journeys/create-journey.md) - POST `/journeys` - Creates a journey draft. Publish and activate it before contacts can enter.
- [Get journey](/reference/journeys/get-journey.md) - GET `/journeys/{id}` - Returns a journey draft, its status, and the active version when one is running.
- [Update journey](/reference/journeys/update-journey.md) - PATCH `/journeys/{id}` - Updates a journey draft. Publish again to snapshot changes for activation.
- [Delete journey](/reference/journeys/delete-journey.md) - DELETE `/journeys/{id}` - Deletes a journey. Active journeys must be paused first.
- [Publish journey](/reference/journeys/publish-journey.md) - POST `/journeys/{id}/publish` - Validates and snapshots the current draft definition as an immutable version.
- [Activate journey](/reference/journeys/activate-journey.md) - POST `/journeys/{id}/activate` - Activates a journey to start processing events. Requires published version.
- [Pause journey](/reference/journeys/pause-journey.md) - POST `/journeys/{id}/pause` - Pauses an active journey. Running instances continue to completion.
- [List journey versions](/reference/journeys/get-journey-versions.md) - GET `/journeys/{id}/versions`
- [Get journey version](/reference/journeys/get-journey-version.md) - GET `/journeys/versions/{versionId}`

## Schemas

- [ProblemDetails](/reference/schemas/problem-details.md) - object - RFC 9457 Problem Details response with a stable Flownally error code.
- [FieldViolation](/reference/schemas/field-violation.md) - object
- [Window](/reference/schemas/messaging-window.md) - object - Tells a client whether the current actor can send in this conversation right now.
- [Response](/reference/schemas/journeys-response.md) - object
- [Journey](/reference/schemas/journey.md) - object - Event-driven workflow that moves contacts through follow-up steps.
- [JourneyStatus](/reference/schemas/journey-status.md) - enum
- [WorkflowDefinition](/reference/schemas/workflow-definition.md) - object
- [WorkflowNode](/reference/schemas/workflow-node.md) - object
- [StartWorkflowNode](/reference/schemas/start-workflow-node.md) - object
- [StartNodeData](/reference/schemas/start-node-data.md) - object - Journey start block settings. The backend persists these as journey triggerConfig and entryMode.
- [TriggerConfig](/reference/schemas/trigger-config.md) - object
- [EntryMode](/reference/schemas/entry-mode.md) - enum - Controls how contacts can re-enter the journey
- [WebhookWorkflowNode](/reference/schemas/webhook-workflow-node.md) - object
- [WebhookNodeData](/reference/schemas/webhook-node-data.md) - object
- [GenericWorkflowNode](/reference/schemas/generic-workflow-node.md) - object
- [GenericNodeData](/reference/schemas/generic-node-data.md) - object - Node-specific data for journey nodes without a dedicated public schema yet.
- [WorkflowEdge](/reference/schemas/workflow-edge.md) - WorkflowEdge
- [WorkflowEdge](/reference/schemas/workflow-edge2.md) - object
- [JourneyVersion](/reference/schemas/journey-version.md) - object
- [CreateJourneyRequest](/reference/schemas/create-journey-request.md) - object - Journey draft to create.
- [UpdateJourneyRequest](/reference/schemas/update-journey-request.md) - object - Journey draft fields to update.
- [JourneyVersionsResponse](/reference/schemas/journey-versions-response.md) - object