POST /folders - ARGOS Identity

서류 종류별로 아이템을 나눠 담고 싶을 때 폴더를 추가합니다. 프로파일에는 생성 시 기본 폴더가 이미 하나 있습니다.

엔드포인트

POST /v1/profiles/{profileId}/folders

요청

경로 파라미터

파라미터	타입	설명
`profileId`	`string`	폴더를 만들 프로파일 ID (`pf_` 접두사)

요청 본문

필드	타입	필수	설명
`name`	`string`	필수	폴더 이름

curl -X POST "https://client-omni-api.argosidentity.com/v1/profiles/pf_0twd91ioowfr/folders" \
  -H "x-api-key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{ "name": "보조 서류" }'

응답 (201 Created)

{
  "id": "fd_9pq2mklt83bx",
  "profileId": "pf_0twd91ioowfr",
  "name": "보조 서류",
  "isDefault": false,
  "itemsCount": 0,
  "createdAt": "2026-09-09T09:30:12.004Z",
  "updatedAt": "2026-09-09T09:30:12.004Z"
}

응답 필드

필드	타입	설명
`id`	`string`	폴더 ID (`fd_` 접두사)
`profileId`	`string`	상위 프로파일 ID
`name`	`string`	폴더 이름
`isDefault`	`boolean`	기본 폴더 여부. 새로 만든 폴더는 항상 `false`
`itemsCount`	`number`	폴더 안의 아이템 수
`createdAt`	`string`	생성 시각
`updatedAt`	`string`	수정 시각

폴더에 담을 수 있는 아이템 수에는 제한이 없습니다. 다만 프로파일 하나에 올릴 수 있는 누적 용량은 100MB입니다. 폴더는 서류를 종류별로 정리하는 용도로 쓰세요.

에러 코드

상태	코드	설명
404	`OMNI_3005`	프로파일을 찾을 수 없음

공통 에러(400 요청 검증 · 401 인증 · 403 권한 · 500 서버 오류)는 API 개요를 참조하세요.

⌘I