---
title: "Set Workflow Labels"
method: PATCH
path: "/workflow/workflows/labels"
tags: ["workflows"]
---

# Set Workflow Labels

`PATCH /workflow/workflows/labels`

## Request

- Base URL: `https://api.anyreach.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.anyreach.ai/workflow/workflows/labels`
- Auth: HTTP bearer

Set, add, remove or clear labels on up to 500 workflows at once.

`updated` counts the workflows whose labels actually changed.

## Headers

- `x-anyreach-org` string, nullable: Organization ID for user PATs (pat_ prefix tokens)

## Request body

- BulkLabelsRequest
  - `ids` string[], required
  - `set` object
  - `add` object
  - `remove` object
  - `clear` string[]

## Response `200`

Successful Response

- BulkLabelsResponse
  - `updated` integer, required

## Other responses

- `404`: Not found
- `422`: Validation Error

---

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