GET /profiles - ARGOS Identity

이 페이지는 프로파일 조회 엔드포인트 3개를 다룹니다.

용도	엔드포인트
워크플로우의 프로파일 목록	`GET /v1/workflows/{workflowId}/profiles`
프로파일 단건	`GET /v1/profiles/{profileId}`
아이템 처리 상태	`GET /v1/profiles/{profileId}/items/status`

프로파일 목록 조회

GET /v1/workflows/{workflowId}/profiles

쿼리 파라미터

파라미터	타입	기본값	설명
`search`	`string`		프로파일 이름 부분 검색
`sort`	`string`	`createdAt`	`name` · `createdAt` · `lastAnalysisAt`
`order`	`string`	`desc`	`asc` · `desc`
`cursor`	`string`		이전 응답의 `nextCursor`
`limit`	`number`	10	페이지당 항목 수(최대 100)

curl "https://client-omni-api.argosidentity.com/v1/workflows/wf_knsb7si44x27/profiles?sort=createdAt&order=desc&limit=20" \
  -H "x-api-key: your-api-key-here"

응답

{
  "count": 1,
  "nextCursor": null,
  "items": [
    {
      "id": "pf_0twd91ioowfr",
      "workflowId": "wf_knsb7si44x27",
      "name": "예시 프로파일",
      "description": "문서 검증 예시용 프로파일",
      "metadata": { "vendor_id": "VND-2026-0142" },
      "itemsCount": 3,
      "foldersCount": 1,
      "lastAnalysisAt": "2026-09-09T09:11:04.220Z",
      "createdAt": "2026-09-09T09:02:47.118Z",
      "updatedAt": "2026-09-09T09:11:04.220Z"
    }
  ]
}

필드	타입	설명
`count`	`number`	이번 응답에 담긴 항목 수
`nextCursor`	`string \| null`	다음 페이지 커서. `null`이면 마지막 페이지
`items[].id`	`string`	프로파일 ID (`pf_` 접두사)
`items[].workflowId`	`string`	상위 워크플로우 ID
`items[].name`	`string`	프로파일 이름
`items[].description`	`string \| null`	설명
`items[].metadata`	`object \| null`	사용자 정의 메타데이터
`items[].itemsCount`	`number`	모든 폴더의 아이템 합계
`items[].foldersCount`	`number`	폴더 수
`items[].lastAnalysisAt`	`string \| null`	마지막 분석 시각. 분석 이력이 없으면 `null`
`items[].createdAt`	`string`	생성 시각
`items[].updatedAt`	`string`	수정 시각

페이지네이션 규칙은 API 개요를 참조하세요.

프로파일 단건 조회

GET /v1/profiles/{profileId}

curl "https://client-omni-api.argosidentity.com/v1/profiles/pf_0twd91ioowfr" \
  -H "x-api-key: your-api-key-here"

응답

목록 항목과 달리 foldersCount 대신 folders 배열이 들어갑니다.

{
  "id": "pf_0twd91ioowfr",
  "workflowId": "wf_knsb7si44x27",
  "name": "예시 프로파일",
  "description": "문서 검증 예시용 프로파일",
  "metadata": { "vendor_id": "VND-2026-0142" },
  "itemsCount": 3,
  "lastAnalysisAt": "2026-09-09T09:11:04.220Z",
  "folders": [
    {
      "id": "fd_dvh8axwowi4v",
      "name": "default",
      "isDefault": true,
      "itemsCount": 3,
      "createdAt": "2026-09-09T09:02:47.118Z"
    }
  ],
  "recentAnalyses": [
    {
      "id": "analysis_lghgsxkorvoc",
      "status": "completed",
      "verificationStatus": "verified",
      "createdAt": "2026-09-09T09:11:04.220Z"
    }
  ],
  "createdAt": "2026-09-09T09:02:47.118Z",
  "updatedAt": "2026-09-09T09:11:04.220Z"
}

필드	타입	설명
`folders[].id`	`string`	폴더 ID (`fd_` 접두사)
`folders[].name`	`string`	폴더 이름
`folders[].isDefault`	`boolean`	프로파일 생성 시 자동 생성된 기본 폴더 여부
`folders[].itemsCount`	`number`	폴더 안의 아이템 수
`folders[].createdAt`	`string`	생성 시각
`recentAnalyses`	`object[]`	최근 분석 결과(최대 5건). 없으면 빈 배열
`recentAnalyses[].id`	`string`	분석 ID (`analysis_` 접두사)
`recentAnalyses[].status`	`string`	`pending` · `processing` · `completed` · `failed`
`recentAnalyses[].verificationStatus`	`string \| null`	`verified` · `pending_review` · `rejected`. 미완료·실패면 `null`
`recentAnalyses[].createdAt`	`string`	분석 생성 시각

나머지 필드는 목록 응답과 같습니다. 전체 결과는 분석 목록 조회를 사용하세요.

아이템 상태 조회

GET /v1/profiles/{profileId}/items/status

프로파일에 속한 모든 아이템의 처리 상태를 한 번에 반환합니다. 분석 실행 전 준비 상태를 확인하는 용도입니다.

curl "https://client-omni-api.argosidentity.com/v1/profiles/pf_0twd91ioowfr/items/status" \
  -H "x-api-key: your-api-key-here"

응답

{
  "profileId": "pf_0twd91ioowfr",
  "isRagReady": true,
  "summary": { "total": 3, "pending": 0, "active": 3, "failed": 0 },
  "items": [
    {
      "id": "item_ieoravdq3jp3",
      "name": "사업자등록증",
      "type": "text",
      "status": "ACTIVE",
      "processedAt": "2026-09-09T09:05:38.902Z"
    }
  ]
}

필드	타입	설명
`profileId`	`string`	프로파일 ID
`isRagReady`	`boolean`	모든 아이템이 `ACTIVE`이면 `true`. 분석 실행 가능 여부
`summary.total`	`number`	전체 아이템 수
`summary.pending`	`number`	`PENDING` 상태 수
`summary.active`	`number`	`ACTIVE` 상태 수
`summary.failed`	`number`	`FAILED` 상태 수
`items[].id`	`string`	아이템 ID
`items[].name`	`string`	아이템 이름
`items[].type`	`string`	`file` · `text` · `json`
`items[].status`	`string`	`PENDING` · `ACTIVE` · `FAILED`
`items[].processedAt`	`string \| null`	처리 완료 시각. `PENDING`이면 `null`

아이템 등록 후 이 엔드포인트를 1초 간격으로 폴링해 isRagReady가 true가 되면 분석을 실행하세요. summary.failed가 0이 아니면 해당 아이템을 삭제하고 다시 등록해야 합니다.

에러 코드

상태	코드	설명
404	`OMNI_3003`	워크플로우를 찾을 수 없음(목록 조회)
404	`OMNI_3005`	프로파일을 찾을 수 없음(단건·아이템 상태 조회)

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

​프로파일 목록 조회

​쿼리 파라미터

​응답

​프로파일 단건 조회

​응답

​아이템 상태 조회

​응답

​에러 코드

프로파일 목록 조회

쿼리 파라미터

응답

프로파일 단건 조회

응답

아이템 상태 조회

응답

에러 코드