# DELETE /api/v1/event-subscriptions/:id

Auth: Bearer

HTML: https://cooperemail.com/docs/reference/event-subscription-delete

## Summary

End an MCP event subscription. Requires webhook_write. The row is kept for audit with status ended and retained true. It does not deliver and does not count toward the 20 subscription cap. Deleting an id that is already ended returns that same row. Another account's id is 404 event_subscription_not_found. An inbox-scoped key for a different inbox gets the same 404.

## Request

This call has no JSON body.

## Response

HTTP 200. Sample values illustrate the schema.

```json
{
  "object": "event_subscription",
  "id": "inb_example",
  "name": "string",
  "inbox_id": "inb_example",
  "inbox": "string",
  "callback_host": "string",
  "status": "active",
  "refresh_before": "string",
  "created_at": "2026-10-18T12:00:00.000Z"
}
```

## Errors

- HTTP 404 event_subscription_not_found
- HTTP 403 permission_denied

The live `message` is the sentence for that code. Branch on `code`.

```json
{
  "error": {
    "type": "not_found",
    "code": "event_subscription_not_found",
    "docs_url": "https://cooperemail.com/docs#event_subscription_not_found"
  }
}
```

## Idempotency

This route does not document Idempotency-Key or client_id.