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

# Delete a webhook

> Permanently delete a webhook registration, including its event subscriptions and delivery logs.

After deletion, no new deliveries are sent to the endpoint. Deliveries that were already queued for the webhook are discarded rather than retried. Deletion cannot be undone — to receive events again, register a new webhook.

Requires the `write` scope.



## OpenAPI

````yaml DELETE /v1/webhooks/{id}
openapi: 3.1.0
info:
  title: SimpleDocs API
  version: 1.0.0
  description: >-
    The SimpleDocs API lets you programmatically manage repository documents,
    workflows, requests, and webhooks.


    All endpoints are scoped to the company associated with your OAuth
    application.


    **Rate limiting:** 600 requests per minute per IP address.


    **Base URL:** `https://app.simpledocs.com/api`
servers:
  - url: https://app.simpledocs.com/api
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Authentication
    description: Obtain access tokens via OAuth2 client credentials
  - name: Repository Documents
    description: Upload and manage documents in your repository
  - name: Workflows
    description: List workflows and retrieve their schemas
  - name: Requests
    description: Create and track legal requests
  - name: Webhooks
    description: Register webhooks to receive event notifications
paths:
  /v1/webhooks/{id}:
    delete:
      tags:
        - Webhooks
      summary: Delete a webhook
      description: >-
        Permanently delete a webhook registration, including its event
        subscriptions and delivery logs.


        After deletion, no new deliveries are sent to the endpoint. Deliveries
        that were already queued for the webhook are discarded rather than
        retried. Deletion cannot be undone — to receive events again, register a
        new webhook.


        Requires the `write` scope.
      operationId: deleteWebhook
      parameters:
        - name: id
          in: path
          required: true
          description: The webhook's ID, as returned by the list and create endpoints.
          schema:
            type: string
            example: '42'
      responses:
        '204':
          description: The webhook was deleted. The response has no body.
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
      security:
        - bearerAuth:
            - write
components:
  responses:
    Unauthorized:
      description: The access token is missing, invalid, expired, or revoked.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/RFC9457Error'
          examples:
            expired:
              summary: Token expired
              value:
                type: token_expired
                status: 401
                title: Token Expired
                detail: The access token has expired.
                instance: /api/v1/workflows
                request_id: abc-123
            revoked:
              summary: Token revoked
              value:
                type: token_revoked
                status: 401
                title: Token Revoked
                detail: The access token has been revoked.
                instance: /api/v1/workflows
                request_id: abc-123
            invalid:
              summary: Invalid token
              value:
                type: invalid_token
                status: 401
                title: Invalid Token
                detail: The access token is invalid.
                instance: /api/v1/workflows
                request_id: abc-123
    Forbidden:
      description: The access token does not have the required scope.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/RFC9457Error'
          example:
            type: insufficient_scope
            status: 403
            title: Forbidden
            detail: The access token does not have the required scope.
            instance: /api/v1/repository_documents
            request_id: abc-123
    NotFound:
      description: The requested resource was not found.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/RFC9457Error'
          example:
            type: request_not_found
            status: 404
            title: Request not found
            detail: The request you are trying to access does not exist.
            instance: /api/v1/requests/abc123
            request_id: abc-123
  schemas:
    RFC9457Error:
      type: object
      description: >-
        Error responses follow [RFC
        9457](https://www.rfc-editor.org/rfc/rfc9457) Problem Details format.
      properties:
        type:
          type: string
          description: A machine-readable error type identifier.
          example: parameter_missing
        status:
          type: integer
          example: 400
        title:
          type: string
          example: Bad Request
        detail:
          type: string
          description: A human-readable explanation of the error.
          example: File or URL is required
        instance:
          type: string
          description: The request path that generated the error.
          example: /api/v1/repository_documents
        request_id:
          type: string
          description: A unique identifier for the request, useful for support.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Obtain a Bearer token via the [Create access
        token](/api-reference/authentication/create-token) endpoint using the
        OAuth2 client credentials flow.

````