> ## 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: सत्र के आइटम अनब्लॉक करें > POST /v3/blocklist/remove/: Didit सत्यापन सत्र के चेहरे, दस्तावेज़, फ़ोन नंबर या ईमेल का ब्लॉक एक ही कॉल में हटाएं। ब्लॉकलिस्ट से हटाने वाला API प्रॉम्प्ट प्रॉम्प्ट को क्लिपबोर्ड पर कॉपी करें \

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

\
यहाँ पेस्ट करें किसी एक सत्यापन सत्र द्वारा एकत्र की गई जानकारी पर लगी रोक हटाएँ: उसका चेहरा, पहचान दस्तावेज़, फ़ोन नंबर या ईमेल पता। रिकॉर्ड अब ब्लॉकलिस्टेड के रूप में चिह्नित नहीं रहता, और उससे बनाई गई सिस्टम ब्लॉकलिस्ट प्रविष्टियाँ हटा दी जाती हैं, इसलिए सिस्टम अब नए सत्रों को अस्वीकार नहीं करता।> [!NOTE] > > केवल उन प्रविष्टियों को हटाया जाता है जो सत्र के रिकॉर्ड से बनाई गई थीं। कोई मान जिसे किसी ने हाथ से सूची में जोड़ा हो, जैसे फ़ोन ब्लॉकलिस्ट में टाइप किया गया वही फ़ोन नंबर, अवरुद्ध ही रहता है: उसे [सूची प्रविष्टियाँ](https://docs.didit.me/hi/management-api/lists/list-entries.md) देखकर खोजें और [प्रविष्टि हटाएँ](https://docs.didit.me/hi/management-api/lists/delete-entry.md) से हटाएँ।वर्तमान में क्या अवरुद्ध है, यह देखने के लिए [ब्लॉकलिस्टेड आइटम सूचीबद्ध करें](https://docs.didit.me/hi/management-api/blocklist/list.md) का उपयोग करें। कंसोल में ब्लॉकलिस्ट प्रबंधित करने के लिए [उपयोगकर्ताओं को ब्लॉकलिस्ट करें](https://docs.didit.me/hi/console/blocklist-users.md) देखें। ## OpenAPI ````yaml hi/openapi-25.json POST /v3/blocklist/remove/ 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/blocklist/remove/: post: tags: - Blocklist summary: सत्र आइटमों को ब्लॉकलिस्ट से हटाएं description: >- एप्लिकेशन के किसी एक व्यक्ति सत्यापन सत्र के चेहरे, पहचान दस्तावेज़, फ़ोन नंबर या ईमेल पते पर लगे ब्लॉक को हटाता है। प्रत्येक चयनित प्रकार के लिए, Didit सत्र का सबसे हालिया रिकॉर्ड लेता है, इसके ब्लॉकलिस्ट किए गए फ़्लैग को हटाता है और उस रिकॉर्ड से बनाई गई सिस्टम ब्लॉकलिस्ट प्रविष्टियों को हटा देता है, ताकि यह अब नए सत्रों को अस्वीकार न करे। मान द्वारा किसी सूची में जोड़ी गई प्रविष्टियों को छुआ नहीं जाता है: उन्हें [List list entries](https://docs.didit.me/hi/management-api/lists/list-entries) से ढूंढें और [Delete a list entry](https://docs.didit.me/hi/management-api/lists/delete-entry) से हटाएं। ऐसे रिकॉर्ड को अनब्लॉक करना जो ब्लॉकलिस्टेड नहीं है सफल रहता है और कुछ भी नहीं बदलता है, और जो सत्र पहले ही समाप्त हो चुके हैं उन्हें बदला नहीं जाता है। स्कोप्ड API कुंजी के लिए `workflows: write` की आवश्यकता होती है। operationId: remove_from_blocklist requestBody: required: true content: application/json: schema: type: object required: - session_id description: कम से कम एक `unblock_*` फ़्लैग `true` होना चाहिए। properties: session_id: type: string format: uuid description: >- आपके एप्लिकेशन का एक व्यक्ति सत्यापन सत्र। हटाए गए सत्र अस्वीकार कर दिए जाते हैं। unblock_face: type: boolean default: false description: सत्र के चेहरे पर लगा ब्लॉक हटाएं। unblock_document: type: boolean default: false description: सत्र के पहचान दस्तावेज़ पर लगा ब्लॉक हटाएं। unblock_phone: type: boolean default: false description: सत्र के फ़ोन नंबर पर लगा ब्लॉक हटाएं। unblock_email: type: boolean default: false description: सत्र के ईमेल पते पर लगा ब्लॉक हटाएं। examples: Face and document: value: session_id: 33333333-4444-5555-6666-777777777777 unblock_face: true unblock_document: true responses: '200': description: चयनित आइटमों पर लगा ब्लॉक हटा दिया गया था। content: application/json: schema: type: object required: - message properties: message: type: string description: हमेशा `Successfully removed from blocklist.` examples: Unblocked: value: message: Successfully removed from blocklist. '400': description: >- बॉडी अमान्य है, सत्र इस एप्लिकेशन का सत्यापन सत्र नहीं है, या इसमें चयनित प्रकार का कोई रिकॉर्ड नहीं है। कुछ भी नहीं बदला गया। 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: >- स्कोप्ड API कुंजी की समय-सीमा समाप्त हो गई है। अन्य प्रमाणीकरण विफलताओं पर `403` मिलता है। content: application/json: examples: Expired API key: value: detail: This API key has expired. '403': description: >- `x-api-key` हेडर अनुपस्थित है (गलत, निरस्त या समय-सीमा समाप्त कुंजी को `401` मिलता है), या किसी स्कोप्ड API कुंजी में `workflows: write` की कमी है या इसका उपयोग इसकी अनुमति सूची से बाहर के किसी IP पते से किया गया है। 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: >- प्रति API कुंजी प्रति मिनट 300 अनुरोधों की साझा लिखने की सीमा पार हो गई। पुनः प्रयास करने से पहले `Retry-After` का पालन करें। 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: >- आपकी एप्लिकेशन की API कुंजी, Business Console में Developers -> API keys से। प्राथमिक कुंजी के पास पूर्ण एक्सेस होता है। एक नामित कुंजी को स्कोप किया जा सकता है: प्रति संसाधन none, read या write, कुछ वर्कफ़्लो या स्वीकृत सत्रों तक सीमित, IP पतों की सूची तक सीमित, और समाप्ति तिथि तक सीमित। 401 का अर्थ है कि कुंजी गलत है, निरस्त कर दी गई है या उसकी समय-सीमा समाप्त हो गई है; 403 का अर्थ है कि कोई कुंजी नहीं भेजी गई थी, कुंजी के पास इस संसाधन या कार्रवाई का एक्सेस नहीं है, या अनुरोध उसकी IP सूची से बाहर के पते से आया था; सत्र रूट पर 404 का अर्थ है कि सत्र कुंजी के वर्कफ़्लो या स्थितियों से बाहर है। मीडिया एक्सेस के बिना एक कुंजी को छवि, वीडियो और PDF URL null के रूप में प्राप्त होते हैं, और सत्र write के बिना एक कुंजी को सत्र लिंक और token null के रूप में प्राप्त होते हैं। देखें https://docs.didit.me/console/api-keys। ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.