> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # API обновления статуса AML-проверки > Didit: установка статуса AML-скрининга сессии, например «одобрена» после снятия совпадений, без изменения общего решения по сессии. Промпт API для обновления статуса AML-проверки Скопировать промпт в буфер обмена \

\`Set the status of the AML screening check of a Didit verification session through the API.

Endpoint:
PATCH https://verification.didit.me/v3/session/{session_id}/update-aml-status/

Authentication:
Send my Didit API key in the x-api-key header. A scoped key needs decisions: write.

Goal:
\- Record my compliance decision on a session's AML check as a whole (the status of an aml_screenings[] entry in the session decision), for example Approved after my team cleared every hit.

Request body (JSON):
\- status (required): "Approved", "Declined", "In Review", "Not Finished" or "Resub Requested".
\- node_id (optional): the workflow node ID of the AML check when the session ran several AML steps. It can also be sent as the node_id query parameter. Without it the most recent AML check is updated.

Behavior:
\- Works for user (KYC) and business (KYB) session IDs.
\- Only the AML check changes. The session status is not recomputed: use PATCH /v3/session/{session_id}/update-status/ to change the session decision, and PATCH /v3/session/{session_id}/update-aml-hit-status/ to mark individual hits.
\- When the status changes, Didit adds an AML_STATUS_UPDATED activity entry and sends a data.updated webhook.
\- Sending the status the check already has returns 200 and changes nothing (no activity entry, no webhook).

Example call:
curl -X PATCH "https://verification.didit.me/v3/session/11111111-2222-3333-4444-555555555555/update-aml-status/" \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"status": "Approved"}'

What to read from the response:
\- status: the AML check status now.
\- previous_status: the status before the call (equal to status when nothing changed).

Failure modes:
\- 400: status missing or not one of the allowed values.
\- 401: the API key has expired.
\- 403: missing key (a wrong, revoked or expired key gets 401), a key of another application, a scoped key without decisions: write, or a request from outside the key's IP allowlist.
\- 404: the session does not exist, was deleted, or is outside a scoped key's limits, or it has no AML check (for that node_id). This is checked before the body, so it wins over a 400.

Side effects: changes the AML check status, adds an activity entry and sends a data.updated webhook (only when the status changed).

For the full integration shape, see /integration/integration-prompt.`

\
Вставьте в Чтобы принимать решения по отдельным совпадениям, а не по всей проверке, используйте [Обновление статуса совпадения AML](https://docs.didit.me/ru/sessions-api/update-aml-hit-status.md). О том, как формируются результаты и статусы скрининга, см. в разделе [AML-скрининг](https://docs.didit.me/ru/core-technology/aml-screening/overview.md). ## OpenAPI ````yaml ru/openapi-25.json PATCH /v3/session/{sessionId}/update-aml-status/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: >- API верификации личности. Аутентификация выполняется с помощью заголовка x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/session/{sessionId}/update-aml-status/: patch: tags: - Sessions summary: Обновить статус AML-проверки description: >- Задайте статус проверки AML-скрининга сессии в целом (поле `status` записи `aml_screenings[]` в решении по сессии), например `Approved`, после того как ваша команда разобралась со всеми совпадениями. Работает для идентификаторов сессий KYC и KYB; передайте `node_id` (параметр запроса или поле тела), если в сессии выполнялось более одного шага AML, иначе будет обновлена последняя проверка AML. При фактическом изменении статуса регистрируется запись активности `AML_STATUS_UPDATED` и отправляется [webhook](https://docs.didit.me/ru/integration/webhooks) `data.updated`; отправка текущего статуса возвращает `200` и ничего не меняет. Статус сессии повторно не вычисляется: используйте `PATCH /v3/session/{sessionId}/update-status/` для решения по сессии и `PATCH /v3/session/{sessionId}/update-aml-hit-status/` для отдельных совпадений. Для API-ключа с ограниченными правами требуется `decisions: write`. operationId: patch_v3_session_update_aml_status parameters: - name: sessionId in: path required: true description: >- UUID сессии верификации (`session_id`, возвращённый `POST /v3/session/`). Принимает ID сессий как Проверки пользователей (KYC), так и Верификации бизнеса (KYB): сервер сопоставляет ID для обоих типов сессий. Должен быть корректным UUID; некорректное значение не соответствует маршруту и возвращает HTML `404`. schema: type: string format: uuid example: 11111111-2222-3333-4444-555555555555 - name: node_id in: query required: false description: >- ID узла графа сценария для обновляемой AML-проверки. Требуется, только если в сессии выполнялось более одного AML-шага. Имеет приоритет над `node_id` в теле запроса. schema: type: string example: feature_aml_1 requestBody: required: true content: application/json: schema: type: object required: - status properties: status: type: string enum: - Not Finished - Approved - Declined - In Review - Resub Requested description: Новый статус AML-проверки. example: Approved node_id: type: string description: >- ID узла графа сценария для AML-проверки в качестве альтернативы параметру запроса. example: feature_aml_1 example: status: Approved responses: '200': description: >- Статус AML-проверки установлен (или не изменён, если он уже имел это значение). content: application/json: schema: type: object required: - message - status - previous_status properties: message: type: string description: Всегда `AML status updated successfully`. status: type: string enum: - Not Finished - Approved - Declined - In Review - Resub Requested description: Текущий статус AML-проверки. previous_status: type: string enum: - Not Finished - Approved - Declined - In Review - Resub Requested description: >- Статус до вызова. Совпадает со `status`, если изменений не было. example: message: AML status updated successfully status: Approved previous_status: In Review '400': description: >- Ошибка валидации: `status` отсутствует или не входит в число допустимых значений. Поиск AML-проверки выполняется в первую очередь, поэтому сессия без AML-проверки возвращает `404` даже при некорректном теле запроса. content: application/json: examples: Missing status: summary: Пустое тело запроса или отсутствие статуса value: status: - This field is required. Invalid status: summary: status отсутствует в перечислении enum value: status: - '"Cleared" is not a valid choice.' '401': description: >- Срок действия API-ключа с ограниченной областью действия истёк. Это единственный случай, возвращающий `401`: отсутствующий, недействительный или отозванный ключ возвращает `403`. content: application/json: schema: type: object properties: detail: type: string description: Понятное сообщение об ошибке. examples: Expired key: summary: Срок действия ключа истёк value: detail: This API key has expired. '403': description: >- Ошибка аутентификации или авторизации. Отсутствующий ключ возвращает `403`, как и ключ другого приложения, ключ с ограниченной областью действия без необходимого для этого endpoint разрешения, а также запрос не из разрешённого списка IP-адресов ключа; неверный, отозванный или истекший ключ возвращает `401`. Различайте их по полю `detail`. content: application/json: schema: type: object properties: detail: type: string description: Понятное сообщение об ошибке. examples: Missing or invalid credentials: summary: >- Заголовок x-api-key отсутствует, либо ключ не прошёл валидацию value: detail: >- Authentication credentials were not provided or are invalid. Other application: summary: >- Действительный ключ, принадлежащий приложению, отличному от приложения сессии value: detail: You do not have permission to perform this action. Scoped key without decisions write: summary: >- У ключа с ограниченной областью действия отсутствует разрешение decisions: write value: detail: This API key has no write access to decisions. IP not allowed: summary: Запрос с IP-адреса вне списка разрешённых IP ключа value: detail: This API key can't be used from this IP address. '404': description: >- Сессия не существует, была удалена или находится за пределами ограничений ключа с ограниченным доступом, либо не содержит AML-проверки (для указанного `node_id`). Поиск сессии выполняется до проверки учетных данных, поэтому неизвестный `sessionId` возвращает `404` даже без действительного ключа. content: application/json: schema: type: object properties: detail: type: string description: Понятное сообщение об ошибке. examples: Unknown session: summary: Сессия с этим ID не существует или была удалена value: detail: Not found. Outside key limits: summary: >- Сессия находится за пределами ограничений ключа с ограниченным доступом (также возвращается для сессии, удаленной только что) value: detail: Session not found. No AML check: summary: В сессии никогда не выполнялся шаг AML value: detail: The session does not have an AML check. No AML check for node: summary: node_id не соответствует AML-проверке этой сессии value: detail: >- The session does not have an AML check for node 'feature_aml_2'. '429': description: >- Превышен лимит запросов: 300 запросов на запись (POST, PATCH, DELETE) в минуту на один API-ключ. Подождите указанное в `Retry-After` количество секунд перед повторной попыткой; заголовки `X-RateLimit-*` показывают доступный лимит. content: application/json: schema: type: object properties: detail: type: string description: Понятное сообщение об ошибке. examples: Rate limited: summary: Бюджет на текущую минуту исчерпан value: detail: >- Write request rate limit exceeded. You can make up to 300 requests per minute. headers: Retry-After: description: Количество секунд ожидания перед повторной попыткой. schema: type: integer minimum: 1 example: 30 security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X PATCH 'https://verification.didit.me/v3/session/11111111-2222-3333-4444-555555555555/update-aml-status/' \ -H 'x-api-key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"status": "Approved"}' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.sessions.update_aml_status( "11111111-2222-3333-4444-555555555555", status="Approved", ) print(result) - lang: javascript label: Node.js source: >- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.sessions.updateAmlStatus("11111111-2222-3333-4444-555555555555", { status: "Approved", }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Sessions.UpdateAMLStatus(ctx, \"11111111-2222-3333-4444-555555555555\", didit.SessionsUpdateAMLStatusParams{\n\tStatus: \"Approved\",\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import me.didit.Didit; import me.didit.types.SessionsUpdateAmlStatusParams; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.sessions().updateAmlStatus("11111111-2222-3333-4444-555555555555", SessionsUpdateAmlStatusParams.builder() .status(SessionsUpdateAmlStatusParams.Status.of("Approved")) .build()); System.out.println(result); - lang: php label: PHP source: >- sessions->updateAmlStatus('11111111-2222-3333-4444-555555555555', [ 'status' => 'Approved', ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.sessions.update_aml_status( "11111111-2222-3333-4444-555555555555", status: "Approved" ) puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.Sessions.UpdateAmlStatusAsync("11111111-2222-3333-4444-555555555555", new SessionsUpdateAmlStatusParams { Status = "Approved", }); Console.WriteLine(JsonSerializer.Serialize(result)); components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- API-ключ вашего приложения из раздела «Разработчикам» -> «API-ключи» в Business Console. Основной ключ имеет полный доступ. Именованный ключ может иметь ограниченную область действия: без доступа, чтение или запись для каждого ресурса, ограничение определенными сценариями или одобренными сессиями, списком IP-адресов и сроком действия. 401 означает, что ключ неверен, отозван или его срок действия истек; 403 означает, что ключ не был передан, у ключа нет доступа к этому ресурсу или действию, либо запрос поступил с адреса вне его списка IP-адресов; 404 на маршруте сессии означает, что сессия не входит в сценарии или статусы ключа. Ключ без доступа к медиа получает URL изображений, видео и PDF как null, а ключ без прав на запись сессий получает ссылки на сессии и токены как null. См. https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.