> ## 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. # webhook गंतव्य हटाएँ API > Didit का webhook गंतव्य, उसका साइनिंग सीक्रेट और डिलीवरी लॉग स्थायी रूप से हटाएँ। प्रति कॉल webhook ऑपरेशन, कोई अनुबंध नहीं। webhook गंतव्य हटाने के लिए API प्रॉम्प्ट प्रॉम्प्ट को क्लिपबोर्ड पर कॉपी करें \

\`Delete a Didit webhook destination through the Management API.

Endpoint:
DELETE https://verification.didit.me/v3/webhook/destinations/{destination_uuid}/

Authentication:
Use the x-api-key header with my Didit API key.

Goal:
\- Delete a destination so Didit stops pushing webhooks to its URL. Use this when retiring an integration, rotating to a new URL, or cleaning up test destinations.

Path parameter:
\- destination_uuid — the destination UUID from GET /v3/webhook/destinations/.

Important semantics:
\- After this call, no new webhook is sent to this destination's URL. Other destinations subscribed to the same events keep receiving deliveries.
\- The destination, its signing secret and its entire delivery log are deleted permanently and cannot be recovered; its deliveries, delivery detail and resend routes answer 404.
\- The destination disappears from GET /v3/webhook/destinations/ and subsequent GET /v3/webhook/destinations/{destination_uuid}/ calls return 404.
\- Didit also updates the application's legacy webhook_url: it becomes the URL of the oldest remaining enabled destination, or is cleared when no enabled destination is left, so other tooling sees "no webhook configured".
\- Returns 204 No Content with an empty body on success.
\- Idempotent in effect: calling DELETE again on the same UUID returns 404.

Workflow when rotating endpoints:
1\. POST /v3/webhook/destinations/ to create the new destination and capture its secret_shared_key.
2\. Verify the new endpoint is receiving and validating webhooks correctly.
3\. DELETE the old destination.

Example call:
curl -X DELETE "https://verification.didit.me/v3/webhook/destinations/{destination_uuid}/" \
-H "x-api-key: YOUR_API_KEY"

Failure modes:
\- 401 — missing or malformed x-api-key.
\- 403 — canonical { "detail": "You do not have permission to perform this action." } envelope.
\- 404 — destination not found in this application (or already deleted).

Side effects:
\- The destination, its signing secret and its delivery log are deleted permanently. This cannot be undone.
\- No new webhook is sent to its URL.

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

\
यहाँ पेस्ट करें > [!WARNING] > > गंतव्य हटाना स्थायी है। > गंतव्य, उसका साइनिंग सीक्रेट और उसका पूरा डिलीवरी लॉग हटा दिए जाते हैं और उन्हें पुनः प्राप्त नहीं किया जा सकता। ## OpenAPI ````yaml hi/openapi-25.json DELETE /v3/webhook/destinations/{destination_uuid}/ 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/webhook/destinations/{destination_uuid}/: delete: tags: - Webhook summary: webhook गंतव्य हटाएं description: >- किसी webhook गंतव्य, उसके हस्ताक्षर सीक्रेट और उसके संपूर्ण डिलीवरी लॉग को स्थायी रूप से हटाएँ। इसे पूर्ववत नहीं किया जा सकता। गंतव्य के URL पर कोई नया webhook नहीं भेजा जाता है; उन्हीं इवेंट्स की सदस्यता लेने वाले अन्य गंतव्य उन्हें प्राप्त करते रहते हैं। इसके बाद गंतव्य अब `GET /v3/webhook/destinations/` में दिखाई नहीं देता है, और `/v3/webhook/destinations/{destination_uuid}/` के अंतर्गत प्रत्येक रूट, जिसमें उसकी डिलीवरी, डिलीवरी का विवरण और उसका पुनः प्रेषण शामिल है, 404 लौटाता है। एप्लिकेशन का लीगेसी `webhook_url` सबसे पुराने शेष सक्षम गंतव्य के URL पर सेट किया जाता है, या कोई सक्षम गंतव्य न बचने पर साफ़ कर दिया जाता है। DELETE को पुनः कॉल करने पर 404 मिलता है। operationId: delete_webhook_destination parameters: - name: destination_uuid in: path required: true description: हटाए जाने वाले गंतव्य का UUID। schema: type: string format: uuid example: 11111111-2222-3333-4444-555555555555 responses: '204': description: >- गंतव्य, हस्ताक्षर सीक्रेट और डिलीवरी लॉग स्थायी रूप से हटा दिए गए। कोई रिस्पॉन्स बॉडी नहीं। '403': description: >- API कुंजी अनुपलब्ध, विकृत, समाप्त हो चुकी है, या किसी भिन्न एप्लिकेशन के लिए स्कोप की गई है। अनुपलब्ध कुंजी `403` लौटाती है; गलत, निरस्त या समाप्त हो चुकी कुंजी `401` लौटाती है। content: application/json: examples: Forbidden: value: detail: You do not have permission to perform this action. '404': description: >- एप्लिकेशन के लिए इस UUID वाला कोई गंतव्य मौजूद नहीं है (पहले ही हटा दिया गया है या कभी मौजूद नहीं था)। content: application/json: examples: Not found: value: detail: Webhook destination not found. '429': description: रेट लिमिट पार हो गई; थोड़ा रुकें और पुनः प्रयास करें। content: application/json: examples: Throttled: value: detail: Request was throttled. Expected available in 30 seconds. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X DELETE 'https://verification.didit.me/v3/webhook/destinations/11111111-2222-3333-4444-555555555555/' \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() client.webhooks.destinations.delete( "11111111-2222-3333-4444-555555555555", ) - lang: javascript label: Node.js source: >- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); await didit.webhooks.destinations.delete("11111111-2222-3333-4444-555555555555"); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nif err := client.Webhooks.Destinations.Delete(ctx, \"11111111-2222-3333-4444-555555555555\"); err != nil {\n\tlog.Fatal(err)\n}" - lang: java label: Java source: >- import me.didit.Didit; // Reads DIDIT_API_KEY. Didit client = new Didit(); client.webhooks().destinations().delete("11111111-2222-3333-4444-555555555555"); - lang: php label: PHP source: >- webhooks->destinations->delete('11111111-2222-3333-4444-555555555555'); - lang: ruby label: Ruby source: >- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new didit.webhooks.destinations.delete("11111111-2222-3333-4444-555555555555") - lang: csharp label: .NET source: >- using System; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); await client.Webhooks.Destinations.DeleteAsync("11111111-2222-3333-4444-555555555555"); components: 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.