> ## 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. # Aggiorna stato controllo AML API > Con Didit imposta lo stato dello screening AML di una sessione, ad esempio approvata dopo i riscontri, senza modificare la decisione della sessione. Prompt dell'API per aggiornare lo stato del controllo AML Copia il prompt negli appunti \

\`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.`

\
Incolla in Per decidere sulle singole corrispondenze invece che sull'intero controllo, usa [Aggiorna lo stato di un riscontro AML](https://docs.didit.me/it/sessions-api/update-aml-hit-status.md). Per sapere come vengono prodotti i risultati e gli stati dello screening, consulta [Screening AML](https://docs.didit.me/it/core-technology/aml-screening/overview.md). ## OpenAPI ````yaml it/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 di verifica dell'identità. Autenticati con l'intestazione x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/session/{sessionId}/update-aml-status/: patch: tags: - Sessions summary: Aggiorna lo stato di un controllo AML description: >- Imposta lo stato del controllo di Screening AML di una sessione nel suo complesso (lo `status` di una voce `aml_screenings[]` nella decisione della sessione), ad esempio `Approved` dopo che il tuo team ha autorizzato ogni hit. Funziona per gli ID sessione KYC e KYB; passa `node_id` (parametro di query o campo del body) quando la sessione ha eseguito più di un passaggio AML, altrimenti viene aggiornato il controllo AML più recente. Quando lo stato cambia effettivamente, viene registrata una voce di attività `AML_STATUS_UPDATED` e viene inviato un [webhook](https://docs.didit.me/it/integration/webhooks) `data.updated`; l'invio dello stato attuale restituisce `200` e non modifica nulla. Lo stato della sessione non viene ricalcolato: usa `PATCH /v3/session/{sessionId}/update-status/` per la decisione della sessione e `PATCH /v3/session/{sessionId}/update-aml-hit-status/` per singoli hit. Una chiave API con ambito limitato richiede `decisions: write`. operationId: patch_v3_session_update_aml_status parameters: - name: sessionId in: path required: true description: >- UUID della sessione di verifica (il `session_id` restituito da `POST /v3/session/`). Accetta sia ID di sessione di Verifica degli utenti (KYC) sia di Verifica aziendale (KYB): il server risolve l'ID per entrambi i tipi di sessione. Deve essere un UUID ben formato; un valore malformato non corrisponde alla route e restituisce una pagina HTML `404`. schema: type: string format: uuid example: 11111111-2222-3333-4444-555555555555 - name: node_id in: query required: false description: >- ID del nodo del grafo del workflow relativo al controllo AML da aggiornare. Necessario solo se la sessione ha eseguito più di un passaggio AML. Ha la precedenza rispetto a `node_id` nel corpo. 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: Nuovo stato del controllo AML. example: Approved node_id: type: string description: >- ID del nodo del grafo del workflow relativo al controllo AML, in alternativa al parametro di query. example: feature_aml_1 example: status: Approved responses: '200': description: >- Stato del controllo AML impostato (o invariato se aveva già questo valore). content: application/json: schema: type: object required: - message - status - previous_status properties: message: type: string description: Sempre `AML status updated successfully`. status: type: string enum: - Not Finished - Approved - Declined - In Review - Resub Requested description: Stato del controllo AML attuale. previous_status: type: string enum: - Not Finished - Approved - Declined - In Review - Resub Requested description: >- Stato prima della chiamata. Uguale a `status` se nulla è cambiato. example: message: AML status updated successfully status: Approved previous_status: In Review '400': description: >- Errore di validazione: `status` mancante o non compreso tra i valori consentiti. La ricerca del controllo AML viene eseguita per prima, quindi una sessione senza un controllo AML restituisce `404` anche con un corpo non valido. content: application/json: examples: Missing status: summary: Corpo vuoto o nessuno stato value: status: - This field is required. Invalid status: summary: status non è presente nell'enum value: status: - '"Cleared" is not a valid choice.' '401': description: >- La chiave API con ambito è scaduta. Questo è l'unico caso che restituisce `401`: una chiave mancante, non valida o revocata restituisce `403`. content: application/json: schema: type: object properties: detail: type: string description: Messaggio di errore di facile lettura. examples: Expired key: summary: La data di scadenza della chiave è stata superata value: detail: This API key has expired. '403': description: >- Errore di autenticazione o autorizzazione. Una chiave mancante restituisce `403`, così come la chiave di un'altra applicazione, una chiave con ambito limitato priva dell'autorizzazione necessaria per questo endpoint e una richiesta proveniente dall'esterno dell'allowlist IP della chiave; una chiave errata, revocata o scaduta restituisce `401`. Distinguili tramite `detail`. content: application/json: schema: type: object properties: detail: type: string description: Messaggio di errore di facile lettura. examples: Missing or invalid credentials: summary: >- Nessuna intestazione x-api-key, oppure validazione della chiave non riuscita value: detail: >- Authentication credentials were not provided or are invalid. Other application: summary: >- Una chiave valida appartenente a un'applicazione diversa da quella della sessione value: detail: You do not have permission to perform this action. Scoped key without decisions write: summary: 'La chiave con ambito non dispone di decisions: write' value: detail: This API key has no write access to decisions. IP not allowed: summary: >- Richiesta proveniente da un indirizzo esterno all'allowlist degli IP della chiave value: detail: This API key can't be used from this IP address. '404': description: >- La sessione non esiste, è stata eliminata o non rientra nei limiti di una chiave con ambito limitato, oppure non presenta alcun controllo AML (per il `node_id` specificato). La ricerca della sessione viene eseguita prima della verifica delle credenziali, quindi un `sessionId` sconosciuto restituisce `404` anche senza una chiave valida. content: application/json: schema: type: object properties: detail: type: string description: Messaggio di errore di facile lettura. examples: Unknown session: summary: >- Nessuna sessione con questo ID esiste, oppure è stata eliminata value: detail: Not found. Outside key limits: summary: >- La sessione non rientra nei limiti di una chiave con ambito limitato (restituito anche per una sessione eliminata pochi istanti prima) value: detail: Session not found. No AML check: summary: La sessione non ha mai eseguito un passaggio AML value: detail: The session does not have an AML check. No AML check for node: summary: node_id non corrisponde a un controllo AML della sessione value: detail: >- The session does not have an AML check for node 'feature_aml_2'. '429': description: >- Limite di frequenza superato: 300 richieste di scrittura (POST, PATCH, DELETE) al minuto per chiave API. Attendi i secondi indicati in `Retry-After` prima di riprovare; le intestazioni `X-RateLimit-*` indicano il budget. content: application/json: schema: type: object properties: detail: type: string description: Messaggio di errore di facile lettura. examples: Rate limited: summary: Budget per il minuto corrente esaurito value: detail: >- Write request rate limit exceeded. You can make up to 300 requests per minute. headers: Retry-After: description: Secondi da attendere prima di effettuare un nuovo tentativo. 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: >- La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.