| 용도 | 엔드포인트 |
|---|---|
| 프로파일의 폴더 목록 | GET /v1/profiles/{profileId}/folders |
| 폴더 단건(아이템 포함) | GET /v1/folders/{folderId} |
폴더 목록 조회
GET /v1/profiles/{profileId}/folders
쿼리 파라미터
| 파라미터 | 타입 | 기본값 | 설명 |
|---|---|---|---|
search | string | 폴더 이름 부분 검색 | |
sort | string | createdAt | name · createdAt · updatedAt |
order | string | desc | asc · desc |
cursor | string | 이전 응답의 nextCursor | |
limit | number | 10 | 페이지당 항목 수(최대 100) |
curl "https://client-omni-api.argosidentity.com/v1/profiles/pf_0twd91ioowfr/folders?sort=createdAt&order=asc" \
-H "x-api-key: your-api-key-here"
응답
{
"count": 2,
"nextCursor": null,
"items": [
{
"id": "fd_dvh8axwowi4v",
"profileId": "pf_0twd91ioowfr",
"name": "default",
"isDefault": true,
"itemsCount": 3,
"createdAt": "2026-09-09T09:02:47.118Z",
"updatedAt": "2026-09-09T09:05:41.330Z"
},
{
"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"
}
]
}
| 필드 | 타입 | 설명 |
|---|---|---|
count | number | 이번 응답에 담긴 항목 수 |
nextCursor | string | null | 다음 페이지 커서. null이면 마지막 페이지 |
items[].id | string | 폴더 ID (fd_ 접두사) |
items[].profileId | string | 상위 프로파일 ID |
items[].name | string | 폴더 이름 |
items[].isDefault | boolean | 프로파일 생성 시 자동 생성된 기본 폴더 여부 |
items[].itemsCount | number | 폴더 안의 아이템 수 |
items[].createdAt | string | 생성 시각 |
items[].updatedAt | string | 수정 시각 |
폴더 단건 조회
GET /v1/folders/{folderId}
items 배열이 추가됩니다.
curl "https://client-omni-api.argosidentity.com/v1/folders/fd_dvh8axwowi4v" \
-H "x-api-key: your-api-key-here"
응답
{
"id": "fd_dvh8axwowi4v",
"profileId": "pf_0twd91ioowfr",
"name": "default",
"isDefault": true,
"itemsCount": 3,
"items": [
{
"id": "item_ieoravdq3jp3",
"type": "text",
"name": "사업자등록증",
"contentType": "text/plain",
"sizeBytes": 538,
"createdAt": "2026-09-09T09:05:31.412Z"
}
],
"createdAt": "2026-09-09T09:02:47.118Z",
"updatedAt": "2026-09-09T09:05:41.330Z"
}
| 필드 | 타입 | 설명 |
|---|---|---|
items[].id | string | 아이템 ID (item_ 접두사) |
items[].type | string | file · text · json |
items[].name | string | 아이템 이름 |
items[].contentType | string | null | MIME 타입 |
items[].sizeBytes | number | null | 크기(바이트) |
items[].createdAt | string | 생성 시각 |
에러 코드
| 상태 | 코드 | 설명 |
|---|---|---|
| 404 | OMNI_3005 | 프로파일을 찾을 수 없음(목록 조회) |
| 404 | OMNI_3009 | 폴더를 찾을 수 없음(단건 조회) |