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

# Bulk update folder labels

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

## Request

- Base URL: `https://blobsrus.omniapp.co/api`
- URL: `https://blobsrus.omniapp.co/api/v1/folders/{folderId}/labels`
- Auth: HTTP bearer

Add and/or remove multiple labels from a folder.

## Path parameters

- `folderId` string, uuid, required

## Query parameters

- `userId` string

## Request body

- object
  - `add` string[]: Label names to add to the folder
  - `remove` string[]: Label names to remove from the folder

## Response `200`

Labels updated successfully

- object
  - `labels` string[]: The updated list of labels on the folder

## Other responses

- `400`: Bad Request. Possible causes: - Empty request - Neither `add` nor `remove` contains any labels - Label appears in both `add` and `remove` arrays - Invalid label name (less than 2 or more than 25 characters) - Unrecognized field in the request body
- `403`: Forbidden. Possible causes: - User does not have permissions on the folder to add labels (Manager or Owner permissions on the folder) - User lacks Organization Admin permissions to modify **Verified** labels - User lacks Organization Admin permissions to modify **Homepage** labels
- `404`: Not Found. Possible causes: - Folder does not exist - Label does not exist. Create the label first with the [Create label API](/api/labels/create-label). - Label in `remove` array does not exist on the folder
- `429`: Too Many Requests - Rate limit exceeded (60 requests/minute)

## Changes

- **2026-11-03** `43290040f88f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/omni/apis/omni-api/changes/v1/folders/:folderId/labels/patch.md)

---

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