---
title: "Bulk trigger manual workflows on issues"
method: POST
path: "/issues/bulk-workflow"
tags: ["Issues"]
---

# Bulk trigger manual workflows on issues

`POST /issues/bulk-workflow`

## Request

- Base URL: `https://public.escape.tech/v3`
- URL: `https://public.escape.tech/v3/issues/bulk-workflow`
- Auth: API key in header `X-ESCAPE-API-KEY`

Trigger one or more manual workflows on every issue matching a filter predicate. For example, export all issues on a given asset to Jira. A non-empty `where` or `all: true` is required. Set `dryRun` to preview the matching issue IDs without triggering anything. Requests matching more than 10,000 issues are rejected: narrow the filter.

## Request body

- object
  - `workflowIds` string[], required: The manual workflow IDs to trigger on the matching issues
  - `where` object: Filter predicate. Required unless `all` is true.
    - `ids` string[]: Filter by specific issue IDs
    - `assetIds` string[]: Filter by asset IDs
    - `severities` string[]: Filter by severities
    - `profileIds` string[]: Filter by profile IDs
    - `tagIds` string[]: Filter by tag IDs
    - `scannerKinds` string[]: Filter by scanner kinds
  - `all` boolean: Set to true to target every issue. Mutually exclusive with a non-empty `where`.
  - `dryRun` boolean: Return the matching issue IDs and count without triggering any workflow

## Response `200`

OK

- object
  - `ids` string[], required: IDs of the targeted issues
  - `count` integer, required: Number of targeted issues in `ids`
  - `dryRun` boolean, required: Whether this was a preview with no workflow triggered
  - `workflows` object[], required: Unique workflows triggered across every batch
    - `id` string, uuid, required: The triggered workflow ID
    - `name` string, required: The triggered workflow name

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/escape/apis/escape-public-api.md) - [All operations](https://skmtc.dev/escape/apis/escape-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/escape/apis/escape-public-api/revisions/2eab35df40c7?raw)