---
title: "Bulk update folder labels"
method: PATCH
path: "/api/v1/folders/{folderId}/labels"
tags: ["Folders"]
---

# Bulk update folder labels

`PATCH /api/v1/folders/{folderId}/labels`

Add and remove labels on a folder in a single atomic operation. Labels must already exist in the organization - create them with POST /api/v1/labels.

## Path parameters

- `folderId` string, uuid, required — Unique identifier for the folder

## Query parameters

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

## Request body

- FoldersBulkUpdateLabelsBody
  - `add` string[] — Label names to add to the folder
  - `remove` string[] — Label names to remove from the folder

## Response `200`

Labels updated successfully

- FoldersBulkUpdateLabelsResponse
  - `labels` string[], required — The folder's labels after the update

## Other responses

- `400` — Invalid request - no labels specified, the same label in both add and remove, or an unrecognized field
- `401` — Authentication required
- `403` — Permission denied - label management, or verified/homepage label permissions
- `404` — Folder not found, label not found in the organization, or label not applied to the folder

---

[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)