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

# Delete webhook endpoint

> Requires a workspace Management Token (mt-...), created at Dashboard > API > Management Tokens. Send Authorization: Bearer mt-.... Inference API keys (sk-...) and webhook signing secrets (whsec_...) are not accepted. Only the token workspace is accessible.

Use a workspace **Management Token (`mt-...`)**, not an inference API key (`sk-...`) or signing secret (`whsec_...`). Create one at [Dashboard → API → Management Tokens](https://tokenlab.sh/dashboard/api?tab=tokens) and send `Authorization: Bearer mt-...`. Access is scoped to that workspace.

See [Webhook management API guide](/guides/webhooks) for events, verification, retries and troubleshooting.


## OpenAPI

````yaml openapi.json DELETE /v1/management/webhooks/{webhookId}
openapi: 3.1.0
info:
  title: TokenLab AI Gateway
  description: >-
    Organization balance, API key management, and key-level usage/billing via
    management token
  version: 1.0.0
  termsOfService: https://tokenlab.sh/tos
  contact:
    name: Technical Support
    email: support@tokenlab.sh
servers:
  - url: https://api.tokenlab.sh
    description: Production server
security:
  - BearerAuth: []
tags:
  - name: Chat
    description: Chat completions API (OpenAI-compatible)
  - name: Responses
    description: OpenAI Responses API-compatible native endpoints
  - name: Embeddings
    description: Text embeddings API
  - name: Images
    description: Image generation API
  - name: Audio
    description: Audio processing API (TTS & STT)
  - name: Video
    description: Video generation API
  - name: Models
    description: Available models listing
  - name: Anthropic
    description: Anthropic-compatible Messages API
  - name: Gemini
    description: Google Gemini-compatible API
  - name: Management
    description: >-
      Organization API key management and key-level usage/billing via management
      token
  - name: Files
    description: Batch file upload and retrieval
  - name: Batches
    description: OpenAI-compatible asynchronous batch jobs
  - name: Seedance Volc Compatible
    description: Seedance 2.0 Volc-style compatibility endpoints
  - name: Decisions
  - name: Webhooks
    description: >-
      Workspace webhook management with Management Tokens (mt-...). Inference
      API keys do not grant management access.
paths:
  /v1/management/webhooks/{webhookId}:
    delete:
      tags:
        - Webhooks
      summary: Delete webhook endpoint
      description: >-
        Requires a workspace Management Token (mt-...), created at Dashboard >
        API > Management Tokens. Send Authorization: Bearer mt-.... Inference
        API keys (sk-...) and webhook signing secrets (whsec_...) are not
        accepted. Only the token workspace is accessible.
      operationId: deleteWebhook
      parameters:
        - name: webhookId
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 128
      responses:
        '200':
          description: Delete webhook endpoint result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeletedWebhookEndpoint'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          description: Webhook not found in this workspace
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '409':
          description: Endpoint quota reached or endpoint paused
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
      security:
        - ManagementTokenAuth: []
components:
  schemas:
    DeletedWebhookEndpoint:
      type: object
      required:
        - id
        - object
        - deleted
      properties:
        id:
          type: string
        object:
          type: string
          enum:
            - webhook_endpoint
        deleted:
          type: boolean
          const: true
      additionalProperties: false
    ApiError:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          properties:
            message:
              type: string
              description: Error message
            type:
              type: string
              description: Error type
              enum:
                - unauthorized
                - invalid_api_key
                - expired_api_key
                - permission_error
                - insufficient_balance
                - quota_exceeded
                - invalid_request_error
                - model_not_found
                - context_length_exceeded
                - unsupported_tool_choice
                - rate_limit_exceeded
                - server_error
                - upstream_error
                - all_channels_failed
                - timeout_error
                - not_found_error
                - no_contract_compatible_route
                - request_shape_channel_mismatch
                - upstream_contract_mismatch
                - platform_normalization_error
                - async_task_not_found
                - async_task_mapping_invalid
                - delivery_tier_unavailable
            code:
              type: string
              description: Error code
            param:
              type: string
              description: Parameter that caused the error
            model:
              type: string
              description: Model associated with the error
            did_you_mean:
              type: string
            suggestions:
              type: array
              items:
                type: object
                required:
                  - id
                properties:
                  id:
                    type: string
                additionalProperties: true
            alternatives:
              type: array
              items:
                type: object
                required:
                  - id
                  - status
                  - tags
                properties:
                  id:
                    type: string
                  status:
                    type: string
                  tags:
                    type: array
                    items:
                      type: string
                additionalProperties: true
            hint:
              type: string
            retry_after:
              type: number
            retryable:
              type: boolean
            balance_usd:
              type: number
            estimated_cost_usd:
              type: number
            supported_operations:
              type: array
              items:
                type: string
            supported_parameters:
              type: array
              items:
                type: string
            required_selectors:
              type: array
              items:
                type: string
            optional_selectors:
              type: array
              items:
                type: string
            allowed_resolutions:
              type: array
              items:
                type: string
            allowed_durations:
              type: array
              items:
                type: string
            allowed_aspect_ratios:
              type: array
              items:
                type: string
            prompt_max_characters:
              type: number
            recommended_request:
              type: object
              additionalProperties: true
            request_endpoint:
              type:
                - string
                - 'null'
            request_shape_mode:
              type:
                - string
                - 'null'
            status_mode:
              type:
                - string
                - 'null'
            request_id:
              type: string
          required:
            - message
            - type
          additionalProperties: true
      additionalProperties: true
    ValidationError:
      allOf:
        - $ref: '#/components/schemas/ApiError'
        - type: object
          properties:
            validation_errors:
              type: array
              items:
                type: object
                properties:
                  field:
                    type: string
                  message:
                    type: string
                  code:
                    type: string
  responses:
    BadRequest:
      description: Bad Request - Invalid input
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ValidationError'
          example:
            error:
              message: 'model: Model is required'
              type: invalid_request_error
              param: model
            validation_errors:
              - field: model
                message: Model is required
    Unauthorized:
      description: Unauthorized - Invalid or missing API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
          example:
            error:
              message: Invalid API key provided
              type: invalid_api_key
    Forbidden:
      description: Forbidden
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
          example:
            error:
              message: Organization is not active
              type: invalid_request_error
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        API Key authentication. Create or manage API keys in [Dashboard > API >
        API Keys](https://tokenlab.sh/dashboard/api?tab=keys).
    ManagementTokenAuth:
      type: http
      scheme: bearer
      bearerFormat: Management Token
      description: >-
        Management token authentication. Create or manage Management Tokens in
        [Dashboard > API > Management
        Tokens](https://tokenlab.sh/dashboard/api?tab=tokens).

````