> ## 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. # Rimuovi dalla Blocklist API: sblocca elementi di sessione > POST /v3/blocklist/remove/: rimuovi il blocco su volto, documento, numero di telefono o email di una sessione di verifica Didit in una chiamata. Prompt dell'API per rimuovere dalla blocklist Copia il prompt negli appunti \

\`Lift the block on the face, document, phone number or email address of one of my Didit verification sessions through the Management API.

Endpoint:
POST https://verification.didit.me/v3/blocklist/remove/

Authentication:
Use the x-api-key header with my Didit API key. A scoped API key needs workflows: write.

Goal:
\- Undo a blocklist decision for a session, for example after a false positive.

Request body (application/json):
\{
"session_id": "33333333-4444-5555-6666-777777777777", // required: a verification session of my application
"unblock_face": true,       // optional, default false
"unblock_document": true,   // optional, default false
"unblock_phone": false,     // optional, default false
"unblock_email": false      // optional, default false
}
At least one unblock_* flag must be true.

Behavior:
\- Didit uses the session's most recent record of each selected type.
\- The record is no longer flagged as blocklisted, and the system blocklist entries created from it are deleted, so it no longer declines new sessions.
\- Entries added by value are not touched: if the same phone number was also added to the phone blocklist by hand, it stays blocked until I delete that entry with DELETE /v3/lists/{list_uuid}/entries/{entry_uuid}/.
\- Unblocking a record that is not blocklisted succeeds and changes nothing.
\- Sessions that already finished are not changed.

Example call:
curl -X POST "https://verification.didit.me/v3/blocklist/remove/" \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"session_id": "33333333-4444-5555-6666-777777777777", "unblock_face": true, "unblock_document": true}'

Example response (200):
\{ "message": "Successfully removed from blocklist." }

Failure modes:
\- 400: session_id is missing ({ "session_id": ["This field is required."] }) or not a UUID ({ "session_id": ["Must be a valid UUID."] }); the session is not a verification session of this application ({ "non_field_errors": ["Session not found"] }; business verification sessions are not accepted); no flag is true ({ "non_field_errors": ["Must specify at least one item to unblock"] }); or the session has no record of a selected type ({ "non_field_errors": ["Session does not have an email record"] }).
\- 401: the API key has expired.
\- 403: missing x-api-key (a wrong, revoked or expired key gets 401) ({ "detail": "You do not have permission to perform this action." }), or a scoped key without workflows: write.
\- 429: rate limited (see /integration/rate-limiting); back off and retry.

Side effects:
\- Deletes the matching entries from the system face, document, phone and email blocklists.

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

\
Incolla in Rimuovi il blocco da ciò che una sessione di verifica ha raccolto: il volto, il documento d'identità, il numero di telefono o l'indirizzo email. Il record non è più contrassegnato come presente nella blocklist e le voci della blocklist del sistema create a partire da esso vengono eliminate, così il sistema non rifiuta più nuove sessioni.> [!NOTE] > > Solo le voci create dai record della sessione vengono rimosse. Un valore aggiunto manualmente a un elenco, ad esempio lo stesso numero di telefono inserito nella blocklist dei numeri di telefono, rimane bloccato: trovalo con [Elenca voci](https://docs.didit.me/it/management-api/lists/list-entries.md) e rimuovilo con [Elimina voce](https://docs.didit.me/it/management-api/lists/delete-entry.md).Per vedere cosa è attualmente bloccato, usa [Elenca elementi nella blocklist](https://docs.didit.me/it/management-api/blocklist/list.md). Consulta [Utenti nella blocklist](https://docs.didit.me/it/console/blocklist-users.md) per gestire la blocklist nella console. ## OpenAPI ````yaml it/openapi-25.json POST /v3/blocklist/remove/ 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/blocklist/remove/: post: tags: - Blocklist summary: Rimuovi elementi della sessione dalla blocklist description: >- Rimuove il blocco su volto, documento d'identità, numero di telefono o indirizzo email di una sessione di verifica della persona dell'applicazione. Per ogni tipo selezionato, Didit recupera il record più recente della sessione, rimuove il contrassegno di inserimento in blocklist ed elimina le voci della blocklist di sistema create a partire da tale record, evitando così che nuove sessioni vengano rifiutate. Le voci aggiunte a una lista per valore non vengono modificate: cercale con [List list entries](https://docs.didit.me/it/management-api/lists/list-entries) ed eliminale con [Delete a list entry](https://docs.didit.me/it/management-api/lists/delete-entry). Lo sblocco di un record non presente in blocklist va a buon fine senza apportare modifiche, e le sessioni già terminate non subiscono variazioni. Una chiave API con ambito limitato richiede `workflows: write`. operationId: remove_from_blocklist requestBody: required: true content: application/json: schema: type: object required: - session_id description: Almeno un flag `unblock_*` deve essere `true`. properties: session_id: type: string format: uuid description: >- Una sessione di verifica di una persona della tua applicazione. Le sessioni eliminate vengono rifiutate. unblock_face: type: boolean default: false description: Rimuove il blocco sul volto della sessione. unblock_document: type: boolean default: false description: Rimuove il blocco sul documento d'identità della sessione. unblock_phone: type: boolean default: false description: Rimuove il blocco sul numero di telefono della sessione. unblock_email: type: boolean default: false description: Rimuove il blocco sull'indirizzo email della sessione. examples: Face and document: value: session_id: 33333333-4444-5555-6666-777777777777 unblock_face: true unblock_document: true responses: '200': description: Il blocco sugli elementi selezionati è stato revocato. content: application/json: schema: type: object required: - message properties: message: type: string description: Sempre `Successfully removed from blocklist.` examples: Unblocked: value: message: Successfully removed from blocklist. '400': description: >- Il corpo non è valido, la sessione non è una sessione di verifica di questa applicazione oppure non contiene record del tipo selezionato. Non è stato modificato nulla. content: application/json: examples: Unknown session: value: non_field_errors: - Session not found No item selected: value: non_field_errors: - Must specify at least one item to unblock No email record: value: non_field_errors: - Session does not have an email record Invalid session id: value: session_id: - Must be a valid UUID. Missing session id: value: session_id: - This field is required. '401': description: >- La chiave API con ambito è scaduta. Altri errori di autenticazione restituiscono `403`. content: application/json: examples: Expired API key: value: detail: This API key has expired. '403': description: >- L'intestazione `x-api-key` è mancante (una chiave errata, revocata o scaduta riceve `401`), oppure una chiave API con ambito limitato non dispone di `workflows: write` o viene utilizzata da un indirizzo IP non presente nella sua allowlist. content: application/json: examples: Missing or invalid API key: value: detail: You do not have permission to perform this action. Scoped key without workflows access: value: detail: This API key has no write access to workflows. '429': $ref: '#/components/responses/RateLimitedWrite' security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: |- curl -X POST 'https://verification.didit.me/v3/blocklist/remove/' \ -H 'x-api-key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "session_id": "33333333-4444-5555-6666-777777777777", "unblock_face": true, "unblock_document": true }' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.blocklist.remove( session_id="33333333-4444-5555-6666-777777777777", unblock_face=True, unblock_document=True, ) 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.blocklist.remove({ session_id: "33333333-4444-5555-6666-777777777777", unblock_face: true, unblock_document: true, }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Blocklist.Remove(ctx, didit.BlocklistRemoveParams{\n\tSessionID: \"33333333-4444-5555-6666-777777777777\",\n\tUnblockFace: didit.Bool(true),\n\tUnblockDocument: didit.Bool(true),\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.BlocklistRemoveParams; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.blocklist().remove(BlocklistRemoveParams.builder() .sessionId("33333333-4444-5555-6666-777777777777") .unblockFace(true) .unblockDocument(true) .build()); System.out.println(result); - lang: php label: PHP source: |- blocklist->remove([ 'session_id' => '33333333-4444-5555-6666-777777777777', 'unblock_face' => true, 'unblock_document' => true, ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.blocklist.remove( session_id: "33333333-4444-5555-6666-777777777777", unblock_face: true, unblock_document: true ) 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.Blocklist.RemoveAsync(new BlocklistRemoveParams { SessionId = "33333333-4444-5555-6666-777777777777", UnblockFace = true, UnblockDocument = true, }); Console.WriteLine(JsonSerializer.Serialize(result)); components: responses: RateLimitedWrite: description: >- Il limite di scrittura condiviso di 300 richieste al minuto per chiave API è stato superato. Rispetta `Retry-After` prima di riprovare. content: application/json: schema: type: object required: - detail properties: detail: type: string example: detail: >- Write request rate limit exceeded. You can make up to 300 requests per minute. 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.