PATCH /profiles/:profileId - ARGOS Identity

보낸 필드만 바뀝니다. 폴더와 아이템은 영향을 받지 않습니다.

엔드포인트

PATCH /v1/profiles/{profileId}

요청

경로 파라미터

파라미터	타입	설명
`profileId`	`string`	수정할 프로파일 ID (`pf_` 접두사)

요청 본문

필드	타입	설명
`name`	`string`	프로파일 이름
`description`	`string`	설명
`metadata`	`object`	사용자 정의 메타데이터. 병합이 아니라 전체 교체됩니다

curl -X PATCH "https://client-omni-api.argosidentity.com/v1/profiles/pf_0twd91ioowfr" \
  -H "x-api-key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "예시 프로파일 (재심사)",
    "metadata": { "vendor_id": "VND-2026-0142", "review_round": "2" }
  }'

metadata를 보내면 기존 객체 전체가 대체됩니다. 키 하나만 바꾸려면 기존 값을 모두 포함해 보내세요.

응답 (200 OK)

{
  "id": "pf_0twd91ioowfr",
  "workflowId": "wf_knsb7si44x27",
  "name": "예시 프로파일 (재심사)",
  "description": "문서 검증 예시용 프로파일",
  "metadata": { "vendor_id": "VND-2026-0142", "review_round": "2" },
  "itemsCount": 3,
  "foldersCount": 1,
  "lastAnalysisAt": "2026-09-09T09:11:04.220Z",
  "createdAt": "2026-09-09T09:02:47.118Z",
  "updatedAt": "2026-09-09T09:24:10.551Z"
}

응답 모양은 프로파일 목록 조회의 items[] 항목과 같습니다. 단건 조회와 달리 folders · recentAnalyses 배열은 들어 있지 않습니다.

에러 코드

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

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

⌘I