---
title: "Api Workflow Runs Bulk Create"
method: POST
path: "/api/workflow-runs/bulk/"
tags: ["platformApi"]
---

# Api Workflow Runs Bulk Create

`POST /api/workflow-runs/bulk/`

Bulk dispatch workflow runs from log references. Returns immediately with dispatch counts (async).

## Headers

- `Authorization` string, required

## Request body

- WorkflowRunBulkCreateRequest — Bulk dispatch workflow runs from log references. POST /api/workflow-runs/bulk/ Follows the same source_items contract as AnnotationItemBulkCreateSerializer.
  - `workflow_id` string, required — Workflow ID (or versioned ID 'workflow_id:version') to execute.
  - `source_items` object[], required — List of source items (same contract as annotation-items/bulk).
  - `event_type` string, nullable
  - `is_persistency_enabled` boolean — When True, eval results are persisted as EvalResult records.

## Response `202`

- WorkflowRunBulkResponse — Response for POST /api/workflow-runs/bulk/. Extends the canonical bulk envelope with the async-dispatch extras that run_bulk_async_dispatch attaches (dispatched, total_requested) plus the resolved workflow_version_id.
  - `success_count` integer, required
  - `error_count` integer, required
  - `errors` BulkItemError[], required
    - `index` integer, required
    - `error` string, required
  - `dispatched` integer, required — Number of runs dispatched (== success_count).
  - `total_requested` integer, required — Number of source items requested.
  - `workflow_version_id` string — Resolved workflow version id the runs were dispatched for.

---

[API](https://skmtc.net/keywordsai/apis/api-reference.md) · [All operations](https://skmtc.net/keywordsai/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/keywordsai/api-reference/versions/c26d550029f8/schema)