메인 콘텐츠로 건너뛰기

​
프로필 목록 조회

GET /v1/workflows/{workflowId}/profiles

​
요청

curl -X GET "http://client-omni-api.argosidentity.com/v1/workflows/{workflowId}/profiles?sort=createdAt&order=desc&limit=20" \
  -H "x-api-key: your-api-key-here"

​
쿼리 파라미터

파라미터타입기본값설명
searchstring프로필 이름으로 검색
sortstringcreatedAt정렬 필드: name, createdAt, lastAnalysisAt
orderstringdesc정렬 순서: asc, desc
cursorstring이전 응답의 페이지네이션 커서
limitnumber10페이지당 항목 수 (최대 100)

​
응답

{
  "count": 10,
  "nextCursor": "dXNlcjpVMDYxTkZUVDI",
  "items": [
    {
      "id": "pf_a1b2c3d4",
      "workflowId": "wf_7a3f9c2e",
      "name": "Acme Corp - KYB Verification",
      "description": "KYB verification for Acme Corp",
      "metadata": {
        "region": "KR",
        "riskProfile": "standard"
      },
      "itemsCount": 3,
      "foldersCount": 1,
      "lastAnalysisAt": "2026-03-15T10:30:00Z",
      "createdAt": "2026-03-15T10:00:00Z",
      "updatedAt": "2026-03-15T10:30:00Z"
    }
  ]
}
​
count
number
필수
현재 응답의 총 항목 수
​
nextCursor
string | null
필수
다음 페이지 커서 (더 이상 결과가 없으면 null)
​
items[].id
string
필수
프로필 ID
​
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
마지막 분석 시간 (ISO 8601)
​
items[].createdAt
string
필수
생성 시간 (ISO 8601)
​
items[].updatedAt
string
필수
마지막 업데이트 시간 (ISO 8601)
일관된 결과를 위해 커서 기반 페이지네이션을 사용하세요. 응답의 nextCursor 값을 다음 요청의 cursor 파라미터로 전달하세요.

​
프로필 ID로 조회

GET /v1/profiles/{profileId}

​
요청

curl -X GET "http://client-omni-api.argosidentity.com/v1/profiles/{profileId}" \
  -H "x-api-key: your-api-key-here"

​
응답

{
  "id": "pf_a1b2c3d4",
  "workflowId": "wf_7a3f9c2e",
  "name": "Acme Corp - KYB Verification",
  "description": "KYB verification for Acme Corp",
  "metadata": {
    "region": "KR",
    "riskProfile": "standard"
  },
  "itemsCount": 3,
  "lastAnalysisAt": "2026-03-15T10:30:00Z",
  "folders": [
    {
      "id": "fld_default001",
      "name": "default",
      "isDefault": true,
      "itemsCount": 2,
      "createdAt": "2026-03-15T10:00:00Z"
    }
  ],
  "createdAt": "2026-03-15T10:00:00Z",
  "updatedAt": "2026-03-15T10:30:00Z"
}

​
에러 코드

상태코드설명
404PROFILE_NOT_FOUND프로필을 찾을 수 없음

​
아이템 상태 조회

GET /v1/profiles/{profileId}/items/status
프로필 내 모든 폴더의 아이템 처리 상태 요약을 반환합니다. 
curl -X GET "http://client-omni-api.argosidentity.com/v1/profiles/{profileId}/items/status" \
  -H "x-api-key: your-api-key-here"

{
  "profileId": "pf_a1b2c3d4",
  "summary": {
    "total": 3,
    "pending": 0,
    "active": 3,
    "failed": 0
  },
  "isRagReady": true,
  "items": [
    {
      "id": "item_abc123",
      "name": "business_registration.pdf",
      "type": "file",
      "status": "ACTIVE",
      "processedAt": "2026-03-15T10:02:00Z"
    }
  ]
}
​
profileId
string
필수
프로필 ID
​
summary.total
number
필수
총 아이템 수
​
summary.pending
number
필수
PENDING 상태의 아이템 수
​
summary.active
number
필수
ACTIVE 상태의 아이템 수
​
summary.failed
number
필수
FAILED 상태의 아이템 수
​
isRagReady
boolean
필수
모든 아이템이 ACTIVE 상태일 때 true (분석 준비 완료)
분석을 시작하기 전에 이 엔드포인트를 1초 간격으로 폴링하여 isRagReady가 true가 될 때까지 확인하세요.