> ## 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 온고잉 모니터링 레코드 생성

> 승인된 제출에 대한 새로운 온고잉 모니터링 레코드를 등록합니다. 요청당 최대 25개의 레코드를 등록할 수 있습니다.

<Info>
  유효한 fullName과 birthDate 필드를 가진 승인된 제출만 온고잉 모니터링에 등록할 수 있습니다.
</Info>

## 엔드포인트

```bash theme={null}
POST /submission/aml/monitor/{worklistId}
```

## 기본 URL

<Tabs>
  <Tab title="프로덕션">
    ```bash theme={null}
    https://rest-api.argosidentity.com/v3/submission/aml/monitor
    ```
  </Tab>

  <Tab title="개발">
    ```bash theme={null}
    https://test-api.argosidentity.com/dev/submission/aml/monitor
    ```
  </Tab>
</Tabs>

## 인증

요청 헤더에 API 키를 포함하세요:

<ParamField header="x-api-key" type="string" required>
  인증을 위한 API 키
</ParamField>

## 경로 매개변수

<ParamField path="worklistId" type="string" required>
  레코드가 등록될 활성 워크리스트의 ID
</ParamField>

## 요청 본문

<ParamField body="submissionIds" type="array" required>
  온고잉 모니터링에 등록할 제출 ID 배열 (1-25개 제출)
</ParamField>

<ParamField body="admin" type="string" required>
  요청을 하는 관리자의 이메일 주소 (프로젝트의 관리자 목록에 등록되어 있어야 함)
</ParamField>

## 요청 예시

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST 'https://rest-api.argosidentity.com/v3/submission/aml/monitor/{worklistId}' \
    -H 'Content-Type: application/json' \
    -H 'x-api-key: {yourAPIKey}' \
    -d '{
      "submissionIds": [
        "SUBMISSION_ID_00A",
        "SUBMISSION_ID_01B",
        "SUBMISSION_ID_02C"
      ],
      "admin": "admin@company.com"
    }'
  ```
</RequestExample>

## 응답

### 성공 응답

<ResponseExample>
  ```json 성공 theme={null}
  {
    "success": true,
    "successCount": 2,
    "failedCount": 1,
    "successResults": [
      {
        "submissionId": "SUBMISSION_ID_00A",
        "recordIds": [
          "RECORD_ID_00A"
        ],
        "status": "success"
      },
      {
        "submissionId": "SUBMISSION_ID_01B",
        "recordIds": [
          "RECORD_ID_01B"
        ],
        "status": "success"
      }
    ],
    "failedResults": [
      {
        "submissionId": "SUBMISSION_ID_02C",
        "recordIds": [],
        "status": "failed",
        "error": "This submission is not approved: SUBMISSION_ID_02C"
      }
    ]
  }
  ```
</ResponseExample>

### 응답 필드

<ResponseField name="success" type="boolean" required>
  배치 작업의 전체 성공 상태
</ResponseField>

<ResponseField name="successCount" type="number" required>
  성공적으로 처리된 제출 수
</ResponseField>

<ResponseField name="failedCount" type="number" required>
  처리에 실패한 제출 수
</ResponseField>

<ResponseField name="successResults" type="array" required>
  성공적으로 처리된 제출 배열

  <Expandable title="성공 결과 속성">
    <ResponseField name="submissionId" type="string" required>
      성공적으로 처리된 제출 ID
    </ResponseField>

    <ResponseField name="recordIds" type="array" required>
      제출에 대해 생성된 레코드 ID 배열
    </ResponseField>

    <ResponseField name="status" type="string" required>
      처리 상태 (이 배열의 경우 항상 "success")
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="failedResults" type="array" required>
  처리에 실패한 제출 배열

  <Expandable title="실패 결과 속성">
    <ResponseField name="submissionId" type="string" required>
      처리에 실패한 제출 ID
    </ResponseField>

    <ResponseField name="recordIds" type="array" required>
      빈 배열 (실패한 제출에 대해 생성된 레코드 없음)
    </ResponseField>

    <ResponseField name="status" type="string" required>
      처리 상태 (이 배열의 경우 항상 "failed")
    </ResponseField>

    <ResponseField name="error" type="string" required>
      제출이 실패한 이유에 대한 설명
    </ResponseField>
  </Expandable>
</ResponseField>

### 오류 응답

<ResponseExample>
  ```json 오류 theme={null}
  {
    "errorCode": "missing_required_parameters",
    "errorMessage": "Required parameters are missing: worklistId, submissionIds, projectId, alias"
  }
  ```
</ResponseExample>

## 오류 코드

| 오류 코드                         | HTTP 상태 | 설명                              |
| ----------------------------- | ------- | ------------------------------- |
| `invalid_path`                | 400     | 잘못된 요청 메서드                      |
| `invalid_project`             | 400     | 잘못된 프로젝트 ID 또는 온고잉 모니터링 옵션 비활성화 |
| `invalid_worklist`            | 400     | 워크리스트가 비활성 상태                   |
| `invalid_submissionIds`       | 400     | 제출 ID 배열 형식 오류 또는 최대 개수 초과      |
| `invalid_admin`               | 400     | 프로젝트의 관리자 목록에서 관리자를 찾을 수 없음     |
| `missing_required_parameters` | 400     | 필수 요청 매개변수 누락                   |
| `all_submissions_failed`      | 500     | 모든 제출이 처리에 실패                   |
| `processing_failed`           | 500     | 레코드 등록 또는 데이터 처리 실패             |
| `internal_server_error`       | 500     | 예상치 못한 서버 오류                    |

## 중요 사항

<Warning>
  **등록을 위한 전제 조건:**

  * 제출은 등록되기 전에 승인되어야 함
  * 각 제출은 유효한 `fullName`과 `birthDate` 필드를 가져야 함
  * 활성 워크리스트만 새 레코드를 받을 수 있음
  * 요청당 최대 25개 제출
</Warning>

<Tip>
  **모범 사례:**

  * 등록 시도 전에 제출 승인 상태 확인
  * 효율성 향상을 위해 여러 제출에 배치 작업 사용
  * 부분 실패에 대한 응답 모니터링 및 적절한 처리
  * 향후 참조를 위해 생성된 레코드 ID 추적
</Tip>

## 속도 제한

<Info>
  이 엔드포인트는 표준 속도 제한 정책을 따릅니다. 각 요청은 동시에 최대 25개의 제출을 처리할 수 있습니다.
</Info>

## 관련 엔드포인트

<CardGroup cols={2}>
  <Card title="온고잉 모니터링 레코드 조회" icon="magnifying-glass" iconType="regular" href="/api-reference/api-reference-guide/aml_data/aml-ongoing-monitoring/Get-Ongoing-Monitoring">
    특정 모니터링 레코드에 대한 상세 정보 조회
  </Card>

  <Card title="온고잉 모니터링 레코드 삭제" icon="trash" href="/api-reference/api-reference-guide/aml_data/aml-ongoing-monitoring/Delete-Ongoing-Monitoring">
    시스템에서 온고잉 모니터링 레코드 제거
  </Card>
</CardGroup>