---
title: "Trigger on-demand journey workflow execution"
method: POST
path: "/entities/journeys/{journeyId}/run"
tags: ["Journeys"]
---

# Trigger on-demand journey workflow execution

`POST /entities/journeys/{journeyId}/run`

Triggers the journey workflow to execute immediately using the most recent completed Parent Segment output data. Does not initiate a Parent Segment refresh. Returns 409 Conflict if a PS refresh or journey workflow is already in progress. Returns 422 if the journey is not eligible for on-demand execution (e.g., not active, belongs to Priority Group).

## Path parameters

- `journeyId` string, required

## Response `200`

Journey workflow execution has been triggered

- PartialJourneyYamlJourneyOnDemandExecutionJsonApiResponse
  - `data` PartialJourneyYamlJourneyExecutionJsonApiResource, required
    - `id` string, required — workflowAttemptId is used as id
    - `type` 'execution-journey', required
    - `attributes` object, required
      - `workflowId` string, required
      - `workflowSessionId` string, required
      - `createdAt` string, date-time, required
      - `finishedAt` string, date-time, nullable, required
      - `status` 'success' | 'canceled' | 'error' | 'canceling' | 'blocked' | 'queued' | 'running', required
      - `journeyId` string

## Other responses

- `403` — non-JSON:API formatted error for insufficient permission to access a resource
- `404` — Journey not found
- `409` — Conflict - Parent Segment refresh or journey workflow is already in progress
- `422` — Journey is not eligible for on-demand execution

---

[API](https://skmtc.net/treasure/apis/cdp-api.md) · [All operations](https://skmtc.net/treasure/apis/cdp-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/treasure/cdp-api/revisions/24caa8eb809b/schema)