> ## Documentation Index
> Fetch the complete documentation index at: https://developers.argosidentity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PATCH /folders/:folderId

> Update a folder's name.

## Endpoint

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

## Request

```bash theme={null}
curl -X PATCH "http://client-omni-api.argosidentity.com/v1/folders/{folderId}" \
  -H "x-api-key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "ID Documents"
  }'
```

### Request Body

<ResponseField name="name" type="string" required>
  New folder name
</ResponseField>

## Response

```json theme={null}
{
  "id": "fld_xyz789",
  "profileId": "pf_a1b2c3d4",
  "name": "ID Documents",
  "isDefault": false,
  "itemsCount": 3,
  "createdAt": "2026-03-15T10:30:00Z",
  "updatedAt": "2026-03-15T11:00:00Z"
}
```

<Warning>
  The **default** folder cannot be renamed or deleted.
</Warning>

### Error Codes

| Status | Code                           | Description                      |
| ------ | ------------------------------ | -------------------------------- |
| 400    | `CANNOT_MODIFY_DEFAULT_FOLDER` | Default folder cannot be renamed |
| 404    | `FOLDER_NOT_FOUND`             | Folder not found                 |