메인 콘텐츠로 건너뛰기

엔드포인트

PATCH /v1/folders/{folderId}

요청

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

요청 본문

name
string
필수
새 폴더 이름

응답

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

에러 코드

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