---
title: "Favorite folder"
method: PUT
path: "/v1/folders/{folderId}/favorite"
tags: ["Folder favorites"]
---

# Favorite folder

`PUT /v1/folders/{folderId}/favorite`

## Request

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

Add a folder to a user's favorites. Permissions are not checked; note that favoriting a folder using this endpoint does not grant access.

Successful requests will return `204` regardless of whether the folder is newly favorited or already in the user's favorites.

## Path parameters

- `folderId` string, uuid, required

## Query parameters

- `userId` string, uuid

## Response `204`

Folder favorited successfully. No response body.

This response is returned whether the folder was newly favorited or already in favorites.

## Other responses

- `400`: Bad Request. Possible causes: - `folderId` is not a valid UUID - `userId` is not a valid UUID
- `403`: Forbidden. Possible causes: - Personal Access Token attempted to act on behalf of another user. PATs cannot use the `userId` parameter.
- `404`: Not Found. Possible causes: - Folder does not exist in the organization - Specified `userId` not found
- `405`: Method Not Allowed - Invalid HTTP method for this endpoint
- `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/favorite/put.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)