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

# Handles `DELETE /v1/webhooks/endpoints/{endpoint_id}`.

> Disables rather than deletes. The endpoint's row and every delivery made
to it stay, because "what did we send there, and when did we stop" is a
question the audit trail has to keep being able to answer.

The tenant comes from the actor and nowhere else, and it is part of the
statement that makes the change: another tenant's endpoint does not match,
so it answers exactly as an endpoint that never existed does.

# Errors

Returns `401` without usable credentials, `403` without `WEBHOOKS_MANAGE`,
`404` when this tenant has no such endpoint, and `503` when the store
cannot be reached.



## OpenAPI

````yaml /openapi.json delete /v1/webhooks/endpoints/{endpoint_id}
openapi: 3.1.0
info:
  title: Esectra API
  description: >-
    Transaction screening, identity verification, and wallet risk.


    Every create route accepts `Idempotency-Key`; replaying one returns the
    original record with `200` where the first call returned `201`. `POST
    /v1/transactions` requires the header, because a duplicated transaction is a
    duplicated financial record.
  license:
    name: proprietary
    identifier: proprietary
  version: 0.1.0
servers: []
security: []
paths:
  /v1/webhooks/endpoints/{endpoint_id}:
    delete:
      tags:
        - Webhooks
      summary: Handles `DELETE /v1/webhooks/endpoints/{endpoint_id}`.
      description: >-
        Disables rather than deletes. The endpoint's row and every delivery made

        to it stay, because "what did we send there, and when did we stop" is a

        question the audit trail has to keep being able to answer.


        The tenant comes from the actor and nowhere else, and it is part of the

        statement that makes the change: another tenant's endpoint does not
        match,

        so it answers exactly as an endpoint that never existed does.


        # Errors


        Returns `401` without usable credentials, `403` without
        `WEBHOOKS_MANAGE`,

        `404` when this tenant has no such endpoint, and `503` when the store

        cannot be reached.
      operationId: disable_endpoint_handler
      parameters:
        - name: endpoint_id
          in: path
          description: Endpoint to disable
          required: true
          schema:
            type: string
      responses:
        '204':
          description: >-
            Disabled, or already disabled. Deliveries stop; the endpoint and its
            delivery history are kept
        '401':
          description: No usable credentials
        '403':
          description: The caller does not hold WEBHOOKS_MANAGE
        '404':
          description: This tenant has no such endpoint
        '503':
          description: A backing store could not be reached
      security:
        - api_key: []
        - session_cookie: []
components:
  securitySchemes:
    api_key:
      type: http
      scheme: bearer
      description: >-
        A tenant API key. Acts for exactly one tenant and cannot conclude a
        case, because a conclusion records a person.
    session_cookie:
      type: apiKey
      in: cookie
      name: esectra_session
      description: >-
        A signed-in reviewer's session. httpOnly and SameSite=Lax; set by `POST
        /v1/control/sessions` and only usable once the second factor is met.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.