# Journeys

Guide contacts through timely, event-driven customer journeys.

10 operations in the Journeys resource group.

## Operations

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

## Schemas

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