---
title: "Bulk update document labels"
method: PATCH
path: "/api/v1/documents/{identifier}/labels"
tags: ["Documents"]
---

# Bulk update document labels

`PATCH /api/v1/documents/{identifier}/labels`

## Path parameters

- `identifier` string, required — Document identifier (either document ID or identifier slug)

## Query parameters

- `userId` string, uuid — Target user membership ID (for org-scoped API keys)

## Request body

- DocumentsBulkUpdateLabelsBody
  - `add` string[] — Labels to add
  - `remove` string[] — Labels to remove

## Response `200`

Labels updated successfully

- DocumentsBulkUpdateLabelsResponse
  - `labels` string[], required — Updated list of labels on the document

## Other responses

- `400` — Invalid request - at least one label must be specified, or an unrecognized field was sent
- `401` — Authentication required
- `403` — Permission denied
- `404` — Document not found

---

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