curl -X DELETE \
  https://verification.didit.me/v3/session/11111111-2222-3333-4444-555555555555/delete/ \
  -H 'x-api-key: YOUR_API_KEY'

{
  "session_id": "4c5c7f3a-3b1d-4b7e-9c39-2b4f7e6a1d02",
  "session_number": 1024,
  "face_retention_outcome": "deleted",
  "biometric_template_uuid": null,
  "biometric_template_expires_at": null,
  "deleted_child_verifications": 0
}

उपयोगकर्ता और व्यवसाय सत्यापन

सत्र हटाने का API: GDPR भूल जाने का अधिकार

Didit से KYC या KYB सत्र और उसका सारा डेटा हटाएं। डिफ़ॉल्ट रूप से फ़ेस एम्बेडिंग भी हटती है; opt-in एप्लिकेशन बिना इमेज का बायोमेट्रिक टेम्पलेट रख सकते हैं।

DELETE

session

{sessionId}

delete

curl -X DELETE \
  https://verification.didit.me/v3/session/11111111-2222-3333-4444-555555555555/delete/ \
  -H 'x-api-key: YOUR_API_KEY'

{
  "session_id": "4c5c7f3a-3b1d-4b7e-9c39-2b4f7e6a1d02",
  "session_number": 1024,
  "face_retention_outcome": "deleted",
  "biometric_template_uuid": null,
  "biometric_template_expires_at": null,
  "deleted_child_verifications": 0
}

KYC और KYB सहायता

यह उपयोगकर्ता सत्यापन (KYC) और व्यवसाय सत्यापन (KYB) दोनों तरह के सत्रों के लिए काम करता है। session_id को दोनों सत्र प्रकारों में खोजा जाता है, और हटाने का व्यवहार दोनों पर एक जैसा लागू होता है। बायोमेट्रिक टेम्पलेट को रखने का नियम केवल KYC सत्रों पर लागू होता है, क्योंकि केवल KYC सत्रों में फ़ेस एम्बेडिंग होती है।

व्यवहार

सत्र को उसके सभी सत्यापन प्रयासों के साथ हटाया जाता है, जिनमें वे परिणाम भी शामिल हैं जिन्हें पुनः सबमिशन ने बदल दिया था। इसमें उसका निर्णय, निकाला गया डेटा, संबंधित सुविधा रिकॉर्ड (पहचान सत्यापन, रजिस्ट्री जाँच, दस्तावेज़, AML, IP विश्लेषण, और इसी तरह के अन्य), उसकी समीक्षाएँ और गतिविधि लॉग, तथा उसकी सभी संग्रहीत फ़ाइलें शामिल हैं।
व्यवसाय सत्यापन (KYB) सत्र को हटाने पर वे सत्यापन भी हट जाते हैं जो उसने अपने प्रमुख व्यक्तियों (KYC) और कॉर्पोरेट स्वामियों (KYB) के लिए बनाए थे, और यह प्रक्रिया पुनरावर्ती रूप से चलती है। रिस्पॉन्स में deleted_child_verifications में बताया जाता है कि कितने सत्यापन हटाए गए। जिस सत्यापन से वह केवल लिंक करता है, जैसे कोई मौजूदा स्वीकृत KYC जिसे उसने दोबारा उपयोग किया, वह नहीं हटता।
ई-हस्ताक्षर का डेटा भी इसके साथ हट जाता है: हस्ताक्षर के लिए भेजे गए दस्तावेज़ और उनकी मूल Word फ़ाइलें, हस्ताक्षरित PDF, साक्ष्य PDF, हस्ताक्षर छवियाँ और हर फ़ील्ड का मान। उनके डाउनलोड पाथ 404 लौटाते हैं।
सत्र सूची और निर्णय रिस्पॉन्स से तुरंत गायब हो जाता है, और कॉल से पहले जारी किए गए मीडिया URL काम करना बंद कर देते हैं।
सत्र के लिए कतार में लगी webhook डिलीवरी और उनके पुनः प्रयास हटा दिए जाते हैं।
हटाए गए सत्यापनों द्वारा शुरू की गई सतत AML निगरानी और KYB रजिस्ट्री निगरानी रुक जाती है।
हटाना स्थायी और अपरिवर्तनीय है। कोई पुनर्स्थापना endpoint नहीं है, इसलिए इस कॉल से पहले आपको जो भी चाहिए, जैसे निर्णय PDF, उसे एक्सपोर्ट कर लें।
रिस्पॉन्स 200 OK होता है, जो हटाने की प्रक्रिया पूरी होने के बाद भेजा जाता है। इसके JSON बॉडी में बताया जाता है कि सत्र के चेहरे के बायोमेट्रिक डेटा के साथ क्या हुआ। यदि आपका क्लाइंट अब भी 204 की अपेक्षा करता है, तो Migration देखें।

अंतिम रूप दी गई नियामक रिपोर्ट में डेटा

यदि सत्र ऐसे केस का हिस्सा है जिसकी नियामक रिपोर्ट को अंतिम रूप दिया जा चुका है, तो अनुरोध 409 लौटाता है और कुछ भी नहीं हटता। रिस्पॉन्स में code: in_filed_report होता है और उसमें हर रिपोर्ट का नाम होता है:

{
  "detail": "This session is part of a finalized regulatory report, so it cannot be deleted.",
  "code": "in_filed_report",
  "reports": [
    {
      "uuid": "5ec00000-0000-4000-8000-000000000007",
      "report_number": "SAR-0001",
      "report_type": "SAR",
      "case_uuid": "c1a5e000-0000-4000-8000-000000000001"
    }
  ]
}

हर रिपोर्ट को रिपोर्ट हटाएँ के जरिए हटाएँ, फिर हटाने का अनुरोध दोहराएँ। रिपोर्ट हटाने से सत्र नहीं हटता; इस endpoint को दोबारा कॉल करने तक सत्र बना रहता है।

फ़ेस बायोमेट्रिक डेटा: हटाना या रखना

हर KYC सत्र में, जिसमें लाइवनेस सेल्फ़ी हो, एक फ़ेस एम्बेडिंग होती है जो चेहरा खोज 1:N और डुप्लिकेट पहचान को सक्षम करती है। डिफ़ॉल्ट रूप से यह एम्बेडिंग सत्र के साथ ही हटा दी जाती है (face_retention_policy: delete_with_session), ताकि जिस व्यक्ति का सत्र आपने हटाया है, वह फिर से सत्यापन कर सके और डुप्लिकेट के रूप में चिह्नित न हो। जिन एप्लिकेशन को सत्र हटाए जाने के बाद भी डुप्लिकेट पहचान जारी रखनी है, वे बायोमेट्रिक टेम्पलेट रखने का विकल्प चुन सकते हैं। तब Didit सामान्य रूप से सत्र और उसका सारा डेटा हटा देता है, लेकिन सत्र के उपयोगकर्ता से जुड़ा एक अलग से प्रबंधित, इमेज-रहित फ़ेस बायोमेट्रिक टेम्पलेट रख लेता है।

रखा गया बायोमेट्रिक टेम्पलेट बायोमेट्रिक डेटा है। वह अनाम नहीं है, अस्थायी नहीं है, और सत्र के साथ हटाया नहीं जाता। वह अपनी निर्धारित समाप्ति, लागू कानून की किसी पहले की समय-सीमा, उपयोगकर्ता हटाए जाने, गोपनीयता-मिटाने के अनुरोध, या स्पष्ट रूप से पूरी तरह हटाने पर ही हटता है। इसे केवल तभी सक्षम करें जब आपके नियंत्रक के निर्देश और गोपनीयता सूचना में यह शामिल हो।

रखा गया टेम्पलेट क्या रखता है और क्या कभी नहीं रखता:

रखा जाता है	कभी नहीं रखा जाता
मिलान के लिए इस्तेमाल होने वाला संख्यात्मक फ़ेस टेम्पलेट	चेहरे की इमेज, लाइवनेस वीडियो, दस्तावेज़ की इमेज, पोर्ट्रेट क्रॉप, और कोई अन्य मीडिया
एक नई यादृच्छिक टेम्पलेट id और एक अपारदर्शी `provenance_reference`	हटाए गए सत्र की ID, संख्या, निर्णय, निकाले गए पहचान फ़ील्ड, या फ़ीचर payload
स्वामी उपयोगकर्ता (`vendor_user_uuid`, मौजूदा `vendor_data`)	ब्लॉकलिस्ट स्थिति, पिछले मिलान, धोखाधड़ी लेबल, या संगठनों के पार पहचान के दावे
रखने का मेटाडेटा: `retained_at`, `expires_at`, नीति, ओवरराइड, निर्देश वर्ग, `instruction_id`, और कार्रवाई करने वाले प्रिंसिपल की आईडी	कार्रवाई करने वाले का ईमेल पता

रखने की सेटिंग तीन जगह होती है, सबसे व्यापक से सबसे विशिष्ट तक:

एप्लिकेशन नीति के तहत Business Console → App Settings → Data retention में, या PATCH /v3/webhook/ के ज़रिए (face_retention_days, face_retention_policy)। देखें डेटा प्रतिधारण।
प्रति-कॉल ओवरराइड retain_face_embeddings के ज़रिए, इस endpoint पर और Batch Delete Sessions पर।
निर्देश वर्ग deletion_instruction के ज़रिए। privacy_erasure निर्देश हमेशा सबसे ऊपर रहता है: वह उस उपयोगकर्ता के हर रखे गए टेम्पलेट को पूरी तरह हटा देता है और कोई नया टेम्पलेट नहीं रखता।

अनुरोध बॉडी

सभी फ़ील्ड वैकल्पिक हैं। बॉडी छोड़ने पर एप्लिकेशन नीति का पालन होता है।

फ़ील्ड	प्रकार	विवरण
`retain_face_embeddings`	boolean या null	इस हटाने के लिए एप्लिकेशन नीति को ओवरराइड करें। `true` एक टेम्पलेट रखता है, `false` सत्र के साथ एम्बेडिंग हटा देता है, `null` या छोड़ने पर नीति का पालन होता है।
`face_retention_days`	integer (1-3650)	टेम्पलेट के लिए सीमित अवधि। जब टेम्पलेट रखा जाए तो यह आवश्यक है, जब तक एप्लिकेशन पहले से `face_retention_days` सेट न करता हो।
`face_retention_deadline`	datetime (ISO 8601)	वैकल्पिक कठोर समाप्ति। भविष्य में होनी चाहिए।
`deletion_instruction`	`operational_session_delete` (डिफ़ॉल्ट) या `privacy_erasure`	आप जो निर्देश दे रहे हैं उसका वर्ग। `privacy_erasure` सत्र के उपयोगकर्ता के लिए सत्र हटाने से पहले हर रखा गया टेम्पलेट पूरी तरह हटा देता है, और इसे `retain_face_embeddings: true` के साथ नहीं जोड़ा जा सकता।
`instruction_id`	string (अधिकतम 255)	इस निर्देश के लिए आपका स्थायी संदर्भ, जैसे आपकी मिटाने की टिकट id। इसे ऑडिट ट्रेल और किसी भी रखे गए टेम्पलेट पर दर्ज किया जाता है। छोड़ने पर Didit एक बनाता है, जिसे टेम्पलेट विवरण में देखा जा सकता है।

रिस्पॉन्स

{
  "session_id": "4c5c7f3a-3b1d-4b7e-9c39-2b4f7e6a1d02",
  "session_number": 1024,
  "face_retention_outcome": "retained_with_user",
  "biometric_template_uuid": "9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b",
  "biometric_template_expires_at": "2027-10-09T10:15:00Z",
  "deleted_child_verifications": 0
}

फ़ील्ड	विवरण
`session_id`	हटाया गया सत्र।
`session_number`	हटाए गए सत्र का नंबर।
`face_retention_outcome`	सत्र के फ़ेस बायोमेट्रिक डेटा के साथ क्या हुआ। नीचे की तालिका देखें।
`biometric_template_uuid`	रखे गए बायोमेट्रिक टेम्पलेट की id जब `face_retention_outcome` `retained_with_user` हो; अन्यथा `null`।
`biometric_template_expires_at`	जब रखा गया बायोमेट्रिक टेम्पलेट हटेगा; कोई टेम्पलेट न रखा गया हो तो `null`।
`deleted_child_verifications`	KYB सत्र के लिए, कितने सत्यापन उसने बनाए थे (उसके प्रमुख व्यक्तियों के KYC सत्र और उसके कॉर्पोरेट स्वामियों के KYB सत्र, पुनरावर्ती रूप से) उसके साथ हटाए गए। KYC सत्र के लिए हमेशा `0`।

`face_retention_outcome`	अर्थ
`deleted`	सत्र और उसकी फ़ेस एम्बेडिंग हटाई गई। डिफ़ॉल्ट व्यवहार।
`retained_with_user`	सत्र हटाया गया। एक इमेज-रहित बायोमेट्रिक टेम्पलेट उपयोगकर्ता से जुड़ा रहता है; उसकी id `biometric_template_uuid` है। इसे Biometric Templates API से प्रबंधित करें।
`none`	सत्र में हटाने या रखने के लिए कोई फ़ेस एम्बेडिंग नहीं थी (उदाहरण के लिए KYB सत्र, या लाइवनेस सेल्फ़ी के बिना KYC सत्र)।
`ineligible_no_vendor_user`	रखने का अनुरोध किया गया था, पर सत्र किसी उपयोगकर्ता से जुड़ा नहीं है (वह `vendor_data` के बिना बनाया गया था), इसलिए टेम्पलेट को कहीं एंकर नहीं किया जा सकता। सत्र और उसकी एम्बेडिंग हटा दी गईं। यह अपात्र परिणाम ऑडिट ट्रेल पर दर्ज होता है।

प्रतिक्रिया पुष्टि करती है कि Didit ने आपका हटाने का निर्देश स्वीकार करके लागू कर दिया है। यह मिटाने का प्रमाणपत्र नहीं है: instruction_id को अपने मिटाने के लॉग में रखें, ताकि बाद में ऑडिट ट्रेल से मिलान कर सकें।

रखने की अवधि और समाप्ति

हर रखे गए टेम्पलेट की एक सीमित expires_at होती है। Didit इसे इनमें से सबसे पहले वाले पर सेट करता है:

अनुरोध से face_retention_days, या जब अनुरोध इसे छोड़े तो एप्लिकेशन का face_retention_days;
एप्लिकेशन की सामान्य डेटा-प्रतिधारण अवधि, जब वह कॉन्फ़िगर हो;
अनुरोध से face_retention_deadline, जब वह दिया गया हो।

जो अनुरोध बिना किसी सीमित अवधि के टेम्पलेट रखेगा, वह 400 के साथ अस्वीकार होता है और कुछ भी नहीं हटाया जाता। रखे गए टेम्पलेट उस सबसे पहले लागू ग्राहक निर्देश, उद्देश्य की समाप्ति, कॉन्फ़िगर की गई समाप्ति, डेटा-विषय के मिटाने के निर्देश, या वैधानिक बायोमेट्रिक समय-सीमा से ज़्यादा जीवित नहीं रह सकते। आपके उपयोगकर्ताओं पर लागू कानूनों के अनुरूप अवधि चुनना आपकी ज़िम्मेदारी है; जब भी कोई लागू नियम ऐसा माँगे, छोटी अवधि चुनें।

गोपनीयता मिटाना

deletion_instruction: "privacy_erasure" भेजें जब आप डेटा विषय के अनुरोध पर कार्य कर रहे हों। Didit सत्र के उपयोगकर्ता से जुड़े हर प्रतिधारित बायोमेट्रिक टेम्पलेट को हटाता है, फिर सत्र और उसकी एम्बेडिंग हटाता है। एप्लिकेशन की प्रतिधारण नीति प्राइवेसी इरेज़र निर्देश को ओवरराइड नहीं कर सकती, और retain_face_embeddings: true को 400 के साथ अस्वीकार किया जाता है। Batch Delete Users से उपयोगकर्ता हटाने पर उसके प्रतिधारित टेम्पलेट भी हटा दिए जाते हैं।

किन चीज़ों पर असर नहीं पड़ता

सत्र हटाने से ये अपने-आप साफ़ नहीं होते। अगर आप मिटाने के अधिकार का अनुरोध संभाल रहे हैं, तो इन्हें अलग से ध्यान में रखें।

ब्लॉकलिस्ट प्रविष्टियाँ जो सत्र से बनी थीं (चेहरा या दस्तावेज़), जस की तस रहती हैं। उन्हें ब्लॉकलिस्ट से हटाएँ। चेहरे की ब्लॉकलिस्ट प्रविष्टि की अपनी बायोमेट्रिक प्रविष्टि होती है, जो किसी भी प्रतिधारित टेम्पलेट से स्वतंत्र है।
सत्र के लिए पहले से जारी शेयर token रद्द नहीं होते, लेकिन उनके आयात के लिए कुछ बचा नहीं है: इनमें से किसी एक के साथ आयात करने पर 400 के साथ {"share_token": ["Original session does not exist."]} मिलता है।
सत्र के लिए पहले से डिलीवर किए गए webhooks पर असर नहीं पड़ता। जो डिलीवरी अभी कतार में हैं और उनके पुनः प्रयास, हटा दिए जाते हैं। हटाने के लिए खुद कोई webhook जारी नहीं होता।
सत्यापन द्वारा पहले से उपभोग किए गए क्रेडिट वापस नहीं किए जाते।
ई-हस्ताक्षर चरण द्वारा हस्ताक्षरकर्ता को पहले से ईमेल की गई हस्ताक्षरित प्रतियाँ हस्ताक्षरकर्ता के मेलबॉक्स में रहती हैं और उन पर असर नहीं पड़ता।
मूल उपयोगकर्ता या व्यवसाय इकाई नहीं हटाई जाती। उनके लिए उपयोगकर्ता हटाएँ या व्यवसाय हटाएँ का उपयोग करें। अगर उपयोगकर्ता का प्रोफ़ाइल चित्र हटाए गए सत्र से आया था, तो वह चित्र हटा दिया जाता है।
प्रतिधारित बायोमेट्रिक टेम्पलेट (केवल तब जब आपने इसे चालू किया हो) तब तक बना रहता है जब तक उसकी समय-सीमा समाप्त न हो या आप उसे हटा न दें। इसे Biometric Templates API से हटाएँ, उपयोगकर्ता को हटाकर, या उसी उपयोगकर्ता के किसी दूसरे सत्र को deletion_instruction: "privacy_erasure" के साथ दोबारा हटाकर।

उदाहरण

डिफ़ॉल्ट (एप्लिकेशन नीति)
बायोमेट्रिक टेम्पलेट प्रतिधारित करें
चालू किए गए एप्लिकेशन पर ज़बरदस्ती हटाना
प्राइवेसी इरेज़र
उपयोगकर्ता के बिना सत्र
व्यवसाय सत्यापन (KYB) सत्र

curl -X DELETE https://verification.didit.me/v3/session/4c5c7f3a-.../delete/ \
  -H "x-api-key: YOUR_API_KEY"

उस एप्लिकेशन पर रिस्पॉन्स जिसने इसे चालू नहीं किया है:

{
  "session_id": "4c5c7f3a-3b1d-4b7e-9c39-2b4f7e6a1d02",
  "session_number": 1024,
  "face_retention_outcome": "deleted",
  "biometric_template_uuid": null,
  "biometric_template_expires_at": null,
  "deleted_child_verifications": 0
}

curl -X DELETE https://verification.didit.me/v3/session/4c5c7f3a-.../delete/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"retain_face_embeddings": true, "face_retention_days": 365, "instruction_id": "cleanup-2026-08-0142"}'

{
  "session_id": "4c5c7f3a-3b1d-4b7e-9c39-2b4f7e6a1d02",
  "session_number": 1024,
  "face_retention_outcome": "retained_with_user",
  "biometric_template_uuid": "9d2f4b6e-1c3a-4e8f-b7d5-0a1c2e3f4a5b",
  "biometric_template_expires_at": "2027-10-09T10:15:00Z",
  "deleted_child_verifications": 0
}

curl -X DELETE https://verification.didit.me/v3/session/4c5c7f3a-.../delete/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"retain_face_embeddings": false}'

{
  "session_id": "4c5c7f3a-3b1d-4b7e-9c39-2b4f7e6a1d02",
  "session_number": 1024,
  "face_retention_outcome": "deleted",
  "biometric_template_uuid": null,
  "biometric_template_expires_at": null,
  "deleted_child_verifications": 0
}

curl -X DELETE https://verification.didit.me/v3/session/4c5c7f3a-.../delete/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"deletion_instruction": "privacy_erasure", "instruction_id": "dsar-2026-0142"}'

सत्र के उपयोगकर्ता के हर प्रतिधारित टेम्पलेट को पहले हटाया जाता है, फिर सत्र हटाया जाता है:

{
  "session_id": "4c5c7f3a-3b1d-4b7e-9c39-2b4f7e6a1d02",
  "session_number": 1024,
  "face_retention_outcome": "deleted",
  "biometric_template_uuid": null,
  "biometric_template_expires_at": null,
  "deleted_child_verifications": 0
}

vendor_data के बिना बनाए गए सत्र में ऐसा कोई उपयोगकर्ता नहीं होता जिससे टेम्पलेट जोड़ा जा सके:

curl -X DELETE https://verification.didit.me/v3/session/7a1e9c2d-.../delete/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"retain_face_embeddings": true, "face_retention_days": 365}'

{
  "session_id": "7a1e9c2d-5f4b-4c3a-8e2d-1b0a9f8e7d6c",
  "session_number": 1031,
  "face_retention_outcome": "ineligible_no_vendor_user",
  "biometric_template_uuid": null,
  "biometric_template_expires_at": null,
  "deleted_child_verifications": 0
}

curl -X DELETE https://verification.didit.me/v3/session/bs-01HJX1.../delete/ \
  -H "x-api-key: YOUR_API_KEY"

व्यवसाय सत्यापन उन तीन सत्यापनों के साथ हटाया जाता है जो उसने अपने प्रमुख व्यक्तियों के लिए बनाए थे:

{
  "session_id": "0f3c9b7e-2d1a-4e5f-8c6b-7a9d8e1f2c3b",
  "session_number": 88,
  "face_retention_outcome": "none",
  "biometric_template_uuid": null,
  "biometric_template_expires_at": null,
  "deleted_child_verifications": 3
}

त्रुटियाँ

स्थिति	कब	बॉडी
`400`	`privacy_erasure` को `retain_face_embeddings: true` के साथ जोड़ा गया है	`{"retain_face_embeddings": ["Privacy erasure cannot retain biometric templates."]}`
`400`	अनुरोध या एप्लिकेशन पर बिना सीमित अवधि के प्रतिधारण माँगा गया है	`{"detail": "A finite biometric-template retention duration is required."}`
`403`	क्रेडेंशियल में `delete:sessions` नहीं है, या वह सत्र का स्वामी नहीं है	`{"detail": "You do not have permission to perform this action."}`
`404`	अज्ञात या पहले से हटाया गया सत्र	`{"detail": "Not found."}`
`503`	सत्र हटाते समय कोई स्टोरेज सेवा या मॉनिटरिंग प्रदाता उपलब्ध नहीं था।	`{"detail": "The session could not be deleted because a storage service or a monitoring provider is unavailable. The session is still in place; repeat the request to finish deleting it."}`
`503`	टेम्पलेट प्रतिधारित करते या हटाते समय कोई बायोमेट्रिक स्टोर उपलब्ध नहीं था। पुनः प्रयास एक ही टेम्पलेट पर अभिसरित होते हैं।	`{"detail": "The biometric-template operation could not finish because an external store is unavailable. The operation is retryable."}`

400 पर कुछ भी नहीं हटाया जाता। 503 पर सत्र अब भी मौजूद रहता है: वही अनुरोध तब तक दोहराएँ जब तक वह 200 न लौटाए। उसकी कुछ संग्रहीत फ़ाइलें या उसकी फ़ेस एम्बेडिंग पहले ही हट चुकी हो सकती है, इसलिए 503 के बाद उन पर भरोसा न करें।

अनुमति

इसके लिए delete:sessions आवश्यक है। यही अनुमति उपयोगकर्ता सत्यापन (KYC) और व्यवसाय सत्यापन (KYB) दोनों सत्रों पर लागू होती है, और प्रतिधारण ओवरराइड पर भी।

बैच में हटाना

KYC सत्रों पर बल्क ऑपरेशन के लिए POST /v3/sessions/delete/ का उपयोग करें। यह वही प्रतिधारण और निर्देश फ़ील्ड स्वीकार करता है। अनुरोध में मेल खाने वाले अधिकतम 20 सत्र हटाए जाते हैं, और हर सत्र का अलग परिणाम मिलता है; 20 से अधिक सत्र डिलीशन जॉब के रूप में चलाए जाते हैं। देखें सत्र बैच में हटाएँ।

204 प्रतिक्रियाओं से माइग्रेशन

इस रिलीज़ तक एंडपॉइंट 204 No Content लौटाता था। अब यह ऊपर दर्ज JSON बॉडी के साथ 200 OK लौटाता है, ताकि हर हटाने में उसका face_retention_outcome रिपोर्ट हो। जो क्लाइंट 204 की जाँच करते हैं, उन्हें अपडेट करें। डिफ़ॉल्ट व्यवहार वही है: मौजूदा एप्लिकेशन delete_with_session पर बने रहते हैं, और कोई माइग्रेशन आपकी ओर से प्रतिधारण चालू नहीं करता। इसे कंसोल में या PATCH /v3/webhook/ के ज़रिए स्पष्ट रूप से चालू करें।

आपकी एप्लिकेशन की 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।

पथ पैरामीटर

sessionId

string<uuid>

आवश्यक

हटाए जाने वाले उपयोगकर्ता सत्यापन (KYC) या व्यवसाय सत्यापन (KYB) सत्र का UUID (session_id), जैसा कि सत्र बनने पर लौटाया गया था। यह कैनोनिकल हाइफ़न वाला UUID होना चाहिए — गैर-UUID मान रूट से मेल नहीं खाता है और 404 लौटाता है।

उदाहरण:

"11111111-2222-3333-4444-555555555555"

बॉडी

application/json

वैकल्पिक। ऑपरेशनल विलोपन के साथ एप्लिकेशन की डेटा प्रतिधारण नीति का पालन करने के लिए बॉडी को पूरी तरह छोड़ दें।

retain_face_embeddings

boolean | null

इस विलोपन के लिए एप्लिकेशन की face_retention_policy को ओवरराइड करें। true सत्र हटाए जाने के बाद सत्र के उपयोगकर्ता से जुड़े एक छवि-मुक्त चेहरे के बायोमेट्रिक टेम्पलेट को रखता है; false सत्र के साथ फ़ेस एम्बेडिंग को हटा देता है; एप्लिकेशन नीति का पालन करने के लिए छोड़ दें या null रखें। KYB सत्रों के लिए और बिना फ़ेस एम्बेडिंग वाले सत्रों के लिए अनदेखा किया जाता है।

उदाहरण:

true

face_retention_days

integer

किसी बनाए रखे गए टेम्पलेट के लिए सीमित प्रतिधारण अवधि, दिनों में। जब कोई टेम्पलेट बनाए रखा जाता है तो यह आवश्यक होता है, जब तक कि एप्लिकेशन पहले से ही face_retention_days सेट न कर दे। टेम्पलेट की expires_at इस अवधि, एप्लिकेशन की सामान्य डेटा प्रतिधारण विंडो और face_retention_deadline में से जो सबसे पहले हो, वह होती है।

आवश्यक सीमा: 1 <= x <= 3650

उदाहरण:

365

face_retention_deadline

string<date-time>

प्रतिधारित टेम्पलेट के लिए वैकल्पिक हार्ड समाप्ति। भविष्य की होनी चाहिए।

उदाहरण:

"2027-08-28T00:00:00Z"

deletion_instruction

enum<string>

डिफ़ॉल्ट:operational_session_delete

आपके द्वारा दिए जा रहे निर्देश का वर्ग। operational_session_delete सत्र को हटा देता है और केवल तभी टेम्पलेट को बनाए रखता है जब नीति या retain_face_embeddings ऐसा कहे। privacy_erasure सत्र को हटाने से पहले सत्र के उपयोगकर्ता से जुड़े प्रत्येक बनाए रखे गए बायोमेट्रिक टेम्पलेट को मिटा देता है, इसे एप्लिकेशन नीति द्वारा ओवरराइड नहीं किया जा सकता है, और इसे retain_face_embeddings: true (400) के साथ जोड़ा नहीं जा सकता है।

उपलब्ध विकल्प:

operational_session_delete,

privacy_erasure

उदाहरण:

"operational_session_delete"

instruction_id

string

इस विलोपन निर्देश के लिए आपका स्थायी संदर्भ (उदाहरण के लिए एक इरेज़र-टिकट id)। ऑडिट ट्रेल पर और किसी भी बनाए रखे गए टेम्पलेट पर रिकॉर्ड किया जाता है। छोड़ दिए जाने पर Didit द्वारा जनरेट किया जाता है।

Maximum string length: 255

उदाहरण:

"dsar-2026-0142"

प्रतिक्रिया

सत्र हटाया गया। बॉडी यह रिपोर्ट करती है कि सत्र के चेहरे के बायोमेट्रिक डेटा का क्या हुआ और, KYB सत्र के लिए, इसके द्वारा बनाए गए कितने सत्यापन इसके साथ हटाए गए थे।

session_id

string<uuid>

हटाया गया सत्र।

session_number

integer | null

हटाए गए सत्र की संख्या।

face_retention_outcome

enum<string>

सत्र के फ़ेस बायोमेट्रिक डेटा के साथ क्या हुआ। deleted: सत्र के साथ फ़ेस एम्बेडिंग हटा दी गई थी (डिफ़ॉल्ट)। retained_with_user: सत्र हटा दिया गया है और एक छवि-मुक्त बायोमेट्रिक टेम्पलेट उपयोगकर्ता से जुड़ा रहता है; biometric_template_uuid देखें। none: सत्र में कोई फ़ेस एम्बेडिंग नहीं थी (उदाहरण के लिए एक KYB सत्र, या लाइवनेस सेल्फ़ी के बिना एक KYC सत्र)। ineligible_no_vendor_user: प्रतिधारण का अनुरोध किया गया था लेकिन सत्र में कोई लिंक किया गया उपयोगकर्ता नहीं है, इसलिए एम्बेडिंग सत्र के साथ हटा दी गई थी। इस endpoint पर इस फ़ील्ड के माध्यम से बायोमेट्रिक-स्टोर विफलता की रिपोर्ट कभी नहीं दी जाती है: यह 503 लौटाता है और सत्र हटाया नहीं जाता है।

उपलब्ध विकल्प:

retained_with_user,

deleted,

none,

ineligible_no_vendor_user

biometric_template_uuid

string<uuid> | null

जब face_retention_outcome, retained_with_user हो, तब प्रतिधारित बायोमेट्रिक टेम्पलेट का Id; अन्यथा null। इसे /v3/biometric-templates/{template_uuid}/ के माध्यम से प्रबंधित करें।

biometric_template_expires_at

string<date-time> | null

प्रतिधारित बायोमेट्रिक टेम्पलेट कब हटाया जाता है, जब face_retention_outcome, retained_with_user हो; कोई टेम्पलेट प्रतिधारित न होने पर null।

deleted_child_verifications

integer

व्यवसाय सत्यापन (KYB) सत्र के लिए: इसके द्वारा बनाए गए कितने सत्यापन (इसके प्रमुख व्यक्तियों के KYC सत्र और इसके कॉर्पोरेट स्वामियों के KYB सत्र, पुनरावर्ती रूप से) इसके साथ हटा दिए गए थे। KYC सत्र के लिए हमेशा 0।

अंतिम संशोधन 7 नवंबर 2026

​KYC और KYB सहायता

​व्यवहार

​अंतिम रूप दी गई नियामक रिपोर्ट में डेटा

​फ़ेस बायोमेट्रिक डेटा: हटाना या रखना

​अनुरोध बॉडी

​रिस्पॉन्स

​रखने की अवधि और समाप्ति

​गोपनीयता मिटाना

​किन चीज़ों पर असर नहीं पड़ता

​उदाहरण

​त्रुटियाँ

​अनुमति

​बैच में हटाना

​204 प्रतिक्रियाओं से माइग्रेशन

​संबंधित

प्राधिकरण

पथ पैरामीटर

बॉडी

प्रतिक्रिया

KYC और KYB सहायता

व्यवहार

अंतिम रूप दी गई नियामक रिपोर्ट में डेटा

फ़ेस बायोमेट्रिक डेटा: हटाना या रखना

अनुरोध बॉडी

रिस्पॉन्स

रखने की अवधि और समाप्ति

गोपनीयता मिटाना

किन चीज़ों पर असर नहीं पड़ता

उदाहरण

त्रुटियाँ

अनुमति

बैच में हटाना

204 प्रतिक्रियाओं से माइग्रेशन

संबंधित