> ## 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

> 폴더의 이름을 업데이트합니다.

## 엔드포인트

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

## 요청

```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"
  }'
```

### 요청 본문

<ResponseField name="name" type="string" required>
  새 폴더 이름
</ResponseField>

## 응답

```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>
  **기본** 폴더는 이름을 변경하거나 삭제할 수 없습니다.
</Warning>

### 에러 코드

| 상태  | 코드                             | 설명                  |
| --- | ------------------------------ | ------------------- |
| 400 | `CANNOT_MODIFY_DEFAULT_FOLDER` | 기본 폴더는 이름을 변경할 수 없음 |
| 404 | `FOLDER_NOT_FOUND`             | 폴더를 찾을 수 없음         |