> ## Documentation Index
> Fetch the complete documentation index at: https://developers.argosidentity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# POST /analyses/:profileId/analyze

> 프로필의 아이템에 대해 AI 기반 분석을 실행합니다. 비동기로 실행되며 분석 ID를 즉시 반환합니다.

## Endpoint

```
POST /v1/analyses/{profileId}/analyze
```

## 요청

```bash theme={null}
curl -X POST "http://client-omni-api.argosidentity.com/v1/analyses/{profileId}/analyze" \
  -H "x-api-key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "targetItems": [
      { "itemId": "item_abc123" },
      { "itemId": "item_def456" }
    ]
  }'
```

## 요청 본문

<ResponseField name="targetItems" type="array" required>
  분석에 포함할 아이템 배열입니다. 최소 하나 이상의 아이템을 포함해야 합니다.
</ResponseField>

<ResponseField name="targetItems[].itemId" type="string" required>
  분석에 포함할 아이템 ID (`item_` 접두사). 해당 아이템은 지정된 프로필에 속해야 하며 `ACTIVE` 상태여야 합니다.
</ResponseField>

***

## 응답 (202 Accepted)

```json theme={null}
{
  "id": "analysis_xyz789"
}
```

<ResponseField name="id" type="string" required>
  분석 고유 ID (`analysis_` 접두사). 이 ID를 [GET /analyses/:analysisId](/ko/omni/api-reference/get-analysis)에서 사용하여 분석 상태를 확인하고 결과를 조회할 수 있습니다.
</ResponseField>

***

## 주요 참고사항

<Note>
  분석은 **비동기**로 실행됩니다. 엔드포인트는 분석 ID를 즉시 반환합니다. [GET /v1/analyses/:analysisId](/ko/omni/api-reference/get-analysis)를 사용하여 상태를 폴링하고 완료 후 결과를 조회하세요.
</Note>

<Warning>
  프로필당 최대 **5개의 분석**이 보관됩니다. 이 한도를 초과하면 가장 오래된 분석이 자동으로 삭제되어 새 분석을 위한 공간을 확보합니다.
</Warning>

* 모든 대상 아이템은 `ACTIVE` 상태여야 합니다. 다른 상태의 아이템은 거부됩니다.
* 프로필당 **한 번에 하나의 분석만 실행**할 수 있습니다. 분석이 진행 중인 상태에서 두 번째 분석을 시작하려고 하면 `409` 에러가 반환됩니다.

***

## 에러 코드

| Status | Code                   | 설명                                     |
| ------ | ---------------------- | -------------------------------------- |
| 400    | `INVALID_ITEM_IDS`     | 하나 이상의 아이템이 존재하지 않거나 지정된 프로필에 속하지 않습니다 |
| 404    | `PROFILE_NOT_FOUND`    | 지정된 프로필을 찾을 수 없습니다                     |
| 409    | `ANALYSIS_IN_PROGRESS` | 해당 프로필에서 이미 분석이 진행 중입니다                |