PATCH /v1/folders/{folderId}
Partially update a folder with a JSON request body.
PATCH /v1/folders/{folderId} updates an existing folder.
Authentication
Send an organization API key in x-api-key or
Authorization: Bearer <key>.
Path Parameters
| Name | Type | Description |
|---|---|---|
folderId | string (uuid) | UUID of the folder to update. |
Request Body
Send a JSON object containing at least one of the following fields.
| Name | Type | Description |
|---|---|---|
name | string | Folder name, from 1 to 100 characters. |
description | string or null | Description, up to 500 characters. Send null to clear it. |
teamIds | array of strings | Teams allowed to access the folder. |
Example
curl -X PATCH "https://api.blueputto.com/v1/folders/FOLDER_ID" \
-H "x-api-key: YOUR_API_KEY" \
-H "content-type: application/json" \
-d '{"name":"Signed conservation reports"}'Success Response
200 OK
{
"data": {}
}Error Responses
400 Bad Request401 Unauthorized404 Not Found429 Too Many Requests