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

# Delete a subscription

> Permanently deletes a subscription; Verbex stops delivering its events. This cannot be undone - to temporarily stop deliveries instead, set `active: false` via Update.



## OpenAPI

````yaml /api-reference/openapi.json delete /v1/public/webhook/subscription/{id}
openapi: 3.1.0
info:
  title: Verbex Platform API
  description: API for managing AI agents, calls, phone numbers, and more.
  version: 1.0.0
servers: []
security: []
paths:
  /v1/public/webhook/subscription/{id}:
    delete:
      tags:
        - Webhook Subscriptions
      summary: Delete a subscription
      description: >-
        Permanently deletes a subscription; Verbex stops delivering its events.
        This cannot be undone - to temporarily stop deliveries instead, set
        `active: false` via Update.
      operationId: delete_webhook_subscription
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            title: Id
          description: The subscription ID.
      responses:
        '204':
          description: No Content (empty body).
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WebhookAuthErrorResponse'
          description: Unauthorized - missing or invalid Bearer token.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WebhookErrorResponse'
          description: Not Found - no subscription exists for the given id.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WebhookErrorResponse'
          description: Internal Server Error.
      security:
        - BearerAuth: []
components:
  schemas:
    WebhookAuthErrorResponse:
      type: object
      title: WebhookAuthErrorResponse
      description: >-
        Authentication failures rejected at the API gateway (401) return this
        leaner body (note camelCase `traceId`).
      properties:
        error:
          type: string
          title: Error
          example: Authentication
        message:
          type: string
          title: Message
          example: Authentication failed
        traceId:
          type: string
          title: Trace Id
          example: e679120f-1d1c-41d2-947c-34e194d5a4a1
    WebhookErrorResponse:
      type: object
      title: WebhookErrorResponse
      description: Service-level error body (400, 404, 409, 500).
      properties:
        status:
          type: integer
          title: Status
          example: 400
        type:
          type: string
          title: Type
          example: VALIDATION_ERROR
        message:
          type: string
          title: Message
          example: Validation failed
        details:
          type: object
          title: Details
          description: >-
            Optional structured detail (e.g. `fields` -> per-field validation
            messages).
        timestamp:
          type: string
          format: date-time
          title: Timestamp
        path:
          type: string
          title: Path
          example: /v1/public/webhook/subscription
        trace_id:
          type: string
          title: Trace Id
          example: 341b5325-a0be-4533-85dd-6f697476dfc3
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        API key passed as a Bearer token in the `Authorization` header:
        `Authorization: Bearer <YOUR_API_KEY>`.

````