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

# Delete event subscription

Delete an event subscription. Headout stops delivering events to its URL immediately, and the subscription cannot be retrieved via any API afterwards.

```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl --location --request DELETE 'https://www.headout.com/api/public/v2/event-subscriptions/whsub_01j9z8x7v6w5u4t3s2r1q0p9o8/' \
--header 'Headout-Auth: <YOUR_API_KEY>'
```

```json 204 theme={"theme":{"light":"github-light","dark":"github-dark"}}
```

```json 404 theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "timestamp": 1786441790000,
  "traceId": "aad8e04d4cb6d466",
  "traceTokenOriginal": "E33C34A07812483E9DE02FF272F48A34",
  "error": {
    "code": "CAL-P0008",
    "message": "No event subscription found for this ID"
  }
}
```


## OpenAPI

````yaml DELETE /api/public/v2/event-subscriptions/{id}/
openapi: 3.1.0
info:
  title: Headout API Docs - Common v2
  version: 0.0.1
servers:
  - url: https://www.headout.com
    description: Production server
  - url: https://www.sandbox-headout.com
    description: Sandbox server
security: []
paths:
  /api/public/v2/event-subscriptions/{id}/:
    delete:
      tags:
        - Event Subscriptions
      summary: Delete event subscription
      operationId: v2DeleteEventSubscription
      parameters:
        - $ref: '#/components/parameters/eventSubscriptionId'
      responses:
        '204':
          description: Event subscription deleted
        '404':
          description: No event subscription found for this ID
      security:
        - apiKeyAuth: []
components:
  parameters:
    eventSubscriptionId:
      name: id
      in: path
      required: true
      schema:
        type: string
      description: >-
        Identifier of the event subscription, e.g. `whsub_01j...`. Returned as
        `id` from Create event subscription and List event subscriptions.
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Headout-Auth

````

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