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

# Delete Webhook

> This endpoint allows you to deactivate a specific webhook configuration associated with your account. Therefore, it updates the webhook's status to **inactive**, ensuring it no longer sends notifications while keeping its configuration for future reference or reactivation.

#### Request

| Field | **Type** | Required | Description |
| --- | --- | --- | --- |
| Authorization | Header | Yes | The access token, valid for 5 minutes, is used to authenticate requests to other endpoints. |
| clientID | URL | Yes | Include your assigned **ID** in the URL, obtainable through the **Get infoClient** endpoint. |
| webhookID | URL | Yes | ID of the webhook to deactivate, obtainable through **GET /api/webhooks/{clientId}**. |

#### Response

On success, the server confirms that the webhook has been deactivated by returning the updated webhook details, including its new status.

| **Field** | **Description** |
| --- | --- |
| Id | The unique identifier of the webhook. |
| method | The HTTP method used by the webhook (e.g., POST). |
| process | The process the webhook monitors (`ramp`, `compliance` or `wallet_transfer`). |
| status | Indicates the webhook is now inactive (false). |
| url | The destination URL where notifications are sent. |
| userId | The unique identifier of the user associated with the webhook. |



## OpenAPI

````yaml /business/openapi.json delete /api/webhooks/{clientId}/{webhook_id}
openapi: 3.1.0
info:
  title: Kravata Business API
  version: '1.0'
  description: >-
    Kravata Business API: on-ramp and off-ramp orders between fiat and
    stablecoins for your own accounts and wallets.
servers:
  - url: https://testapi.kravata.co
    description: Test
  - url: https://apiv2.kravata.co
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Authentication
  - name: Accounts
  - name: Wallets
  - name: Ramp Orders
  - name: Webhooks
paths:
  /api/webhooks/{clientId}/{webhook_id}:
    delete:
      tags:
        - Webhooks
      summary: Delete Webhook
      description: >-
        This endpoint allows you to deactivate a specific webhook configuration
        associated with your account. Therefore, it updates the webhook's status
        to **inactive**, ensuring it no longer sends notifications while keeping
        its configuration for future reference or reactivation.


        #### Request


        | Field | **Type** | Required | Description |

        | --- | --- | --- | --- |

        | Authorization | Header | Yes | The access token, valid for 5 minutes,
        is used to authenticate requests to other endpoints. |

        | clientID | URL | Yes | Include your assigned **ID** in the URL,
        obtainable through the **Get infoClient** endpoint. |

        | webhookID | URL | Yes | ID of the webhook to deactivate, obtainable
        through **GET /api/webhooks/{clientId}**. |


        #### Response


        On success, the server confirms that the webhook has been deactivated by
        returning the updated webhook details, including its new status.


        | **Field** | **Description** |

        | --- | --- |

        | Id | The unique identifier of the webhook. |

        | method | The HTTP method used by the webhook (e.g., POST). |

        | process | The process the webhook monitors (`ramp`, `compliance` or
        `wallet_transfer`). |

        | status | Indicates the webhook is now inactive (false). |

        | url | The destination URL where notifications are sent. |

        | userId | The unique identifier of the user associated with the
        webhook. |
      operationId: delete-webhook
      parameters:
        - name: clientId
          in: path
          required: true
          description: ''
          schema:
            type: string
            format: uuid
        - name: webhook_id
          in: path
          required: true
          description: >-
            The unique identifier of your account. This specifies which client's
            webhook will be deactivated.
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  method:
                    type: string
                  process:
                    type: string
                  status:
                    type: boolean
                  url:
                    type: string
                  userId:
                    type: string
              examples:
                api-webhooks:
                  summary: api/webhooks
                  value:
                    id: 9d536767-5424-4f63-bb5a-962a99d94306
                    method: POST
                    process: ramp
                    status: false
                    url: https://your-server.example.com/webhooks/kravata
                    userId: 20ec3cb9-497c-480f-9478-4d64c7b43064
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Access token from POST /api/token (valid 5 minutes).

````