---
title: "Trigger Workflow"
method: POST
path: "/api/v1/workflow/{workflow_id}/trigger"
tags: ["Workflow"]
---

# Trigger Workflow

`POST /api/v1/workflow/{workflow_id}/trigger`

Run the workflow against the given trigger payload.

Executes synchronously until the workflow either:
  - reaches an `end` node (status=done),
  - returns a wait directive (status=waiting; Celery resumes later — 5c),
  - or errors (status=failed).

## Path parameters

- `workflow_id` string, uuid, required

## Request body

- IWorkflowRunTrigger — Body for manual /workflow/{id}/trigger endpoint.
  - `trigger_payload` object

## Response `202`

Successful Response

- IPostResponseBaseIWorkflowRunRead
  - `message` string, nullable
  - `meta` union
    - object
    - unknown
  - `data` IWorkflowRunRead
    - `workflow_id` string, uuid, required
    - `workflow_version` integer
    - `trigger_payload` object
    - `context` object
    - `current_node_id` string, nullable
    - `status` 'running' | 'waiting' | 'done' | 'failed' | 'cancelled'
    - `started_at` string, date-time, nullable
    - `finished_at` string, date-time, nullable
    - `error` string, nullable
    - `id` string, uuid, required
    - `created_at` string, date-time, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/insighto/apis/ragify.md) · [All operations](https://skmtc.dev/insighto/apis/ragify/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/insighto/ragify/revisions/cdca56191be9/schema)