> ## Documentation Index
> Fetch the complete documentation index at: https://ekacare-durgesh-output-language.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete a Webhook

> Deletes an existing webhook based on its ID. This endpoint allows partners to remove a previously registered webhook by specifying its unique identifier in the path parameter. The `id` parameter is required and must match the ID of the webhook to be deleted. Upon successful deletion, the service will no longer send POST requests to the webhook's URL for the specified scope. This operation helps partners manage and clean up their webhook configurations.




## OpenAPI

````yaml delete /notification/v1/connect/webhook/subscriptions/{id}
openapi: 3.1.0
info:
  title: Webhook Service for the Clients
  description: >
    The Webhook Service allows clients to register webhooks that are triggered
    based on specific events. Each webhook is associated with a business_id,
    client_id, endpoint, and scopes. The scopes defines the type of events that
    will trigger the webhook.
  version: 1.0.0
servers:
  - url: https://api.eka.care
security: []
paths:
  /notification/v1/connect/webhook/subscriptions/{id}:
    delete:
      tags:
        - Webhooks
      summary: Delete a Webhook
      description: >
        Deletes an existing webhook based on its ID. This endpoint allows
        partners to remove a previously registered webhook by specifying its
        unique identifier in the path parameter. The `id` parameter is required
        and must match the ID of the webhook to be deleted. Upon successful
        deletion, the service will no longer send POST requests to the webhook's
        URL for the specified scope. This operation helps partners manage and
        clean up their webhook configurations.
      parameters:
        - name: id
          in: path
          required: true
          description: The unique identifier of the webhook to be deleted.
          schema:
            type: string
      responses:
        '200':
          description: Webhook deleted successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    description: A message indicating the status of the response.
                    example: webhook deleted successfully
                  msg:
                    type: string
                    description: A message indicating the status of the response.
                    example: success
        '400':
          description: Bad request.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      message:
                        type: string
                        example: requested webhook is not registered
                      code:
                        type: string
                        example: INVALID_REQUEST
        '401':
          description: Unauthorized request.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      message:
                        type: string
                        example: Unauthorized request
                      code:
                        type: string
                        example: INVALID_REQUEST
        '404':
          description: Webhook not found.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      message:
                        type: string
                        example: Webhook not found
                      code:
                        type: string
                        example: INVALID_REQUEST
        '500':
          description: Server error.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      message:
                        type: string
                        example: Internal Server Error
                      code:
                        type: string
                        example: SERVER_ERROR
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >
        The API requires a Bearer token in the Authorization header for
        authentication.

````