> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spherepay.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete a Webhook Endpoint

> Delete a webhook endpoint by its ID. Future events will no longer be delivered to it.

Use this endpoint to stop delivery to a webhook endpoint. Deletion moves the endpoint to the `deleted` state, invalidates its signing secret, and halts every future delivery. Deleted endpoints stop counting against the six-endpoint limit.

Because there is no update operation, deletion is also half of the update path: register the replacement first, confirm it is receiving and verifying deliveries, then delete the endpoint it replaces. Both endpoints receive matching events while they overlap, so handlers must deduplicate on the event `id`.

<Warning>
  This action is terminal and cannot be undone. The signing secret is invalidated with it, so a replacement endpoint gets a new secret and your verification configuration has to be updated.
</Warning>


## OpenAPI

````yaml openapi/spherepay.yaml DELETE /v2/webhook-endpoints/{id}
openapi: 3.0.0
info:
  contact: {}
  description: The Sphere REST API for payments, transfers, and accounts.
  title: Sphere API
  version: '2'
servers:
  - description: Production
    url: https://api.spherepay.co
security:
  - bearer: []
tags: []
paths:
  /v2/webhook-endpoints/{id}:
    delete:
      summary: Delete a Webhook Endpoint V2
      description: >-
        Delete a webhook endpoint by its ID. Future events will no longer be
        delivered to it.
      operationId: deleteV2WebhookEndpointsById
      parameters:
        - in: path
          name: id
          required: true
          schema:
            type: string
      responses:
        '204':
          description: The webhook endpoint is deleted. No content is returned.
        '400':
          content:
            application/json:
              examples:
                Bad Request:
                  summary: Bad Request
                  value:
                    code: address/invalid
                    correlationId: 28c61e885c6e5eaa78c1a2183a9b883c
                    detail: Invalid request parameters
                    status: 400
              schema:
                $ref: '#/components/schemas/ProblemDetailsDto'
          description: Bad Request
        '404':
          content:
            application/json:
              examples:
                Not Found:
                  summary: Not Found
                  value:
                    code: resource/not-found
                    correlationId: 28c61e885c6e5eaa78c1a2183a9b883c
                    detail: Resource not found
                    status: 404
              schema:
                $ref: '#/components/schemas/ProblemDetailsDto'
          description: Not Found
        '422':
          content:
            application/json:
              examples:
                Validation Error:
                  summary: Validation Error
                  value:
                    code: validation/failed
                    correlationId: 28c61e885c6e5eaa78c1a2183a9b883c
                    detail: Validation failed
                    errors:
                      - detail: Invalid email format
                        pointer: /email
                      - detail: Name is required
                        pointer: /name
                    status: 422
              schema:
                $ref: '#/components/schemas/ProblemDetailsDto'
          description: Unprocessable Entity - Validation Error
components:
  schemas:
    ProblemDetailsDto:
      properties:
        code:
          type: string
        correlationId:
          type: string
        detail:
          type: string
        errors:
          items:
            properties:
              detail:
                type: string
              header:
                type: string
              parameter:
                type: string
              pointer:
                type: string
            required:
              - detail
            type: object
          type: array
        status:
          type: integer
        title:
          type: string
      required:
        - status
        - detail
      type: object
  securitySchemes:
    bearer:
      bearerFormat: JWT
      scheme: bearer
      type: http

````