---
title: "Delete a webhook subscription"
method: DELETE
path: "/v2/webhook-subscriptions/{subscription_id}"
tags: ["Webhooks"]
---

# Delete a webhook subscription

`DELETE /v2/webhook-subscriptions/{subscription_id}`

## Request

- Base URL: `https://api.arize.com`
- URL: `https://api.arize.com/v2/webhook-subscriptions/{subscription_id}`
- Auth: HTTP bearer

Delete a webhook subscription by its ID. The webhook stops receiving
that event from the source. Other subscriptions on the source and the
webhook itself are unaffected.

Deleting a subscription requires `PROMPT_UPDATE` for a prompt source,
`EVALUATOR_UPDATE` for an evaluator source, `PROJECT_EVAL_TASK_UPDATE`
(or `EXPERIMENT_EVAL_TASK_UPDATE` for a dataset task) for a task source,
or a space, organization, or account admin role for a space source,
since a space subscription covers every task in the space, including
tasks in restricted projects. Callers who can read the source
(`PROMPT_READ`, `EVALUATOR_READ`, `PROJECT_EVAL_TASK_READ` or
`EXPERIMENT_EVAL_TASK_READ`) but lack the required permission receive
a 403; sources the caller cannot read yield a 404.

<Warning>This endpoint is in alpha, read more [here](https://arize.com/docs/ax/rest-reference#api-version-stages).</Warning>

## Path parameters

- `subscription_id` string, required: A universally unique identifier (base64-encoded opaque string).

## Response `204`

Webhook subscription successfully deleted

## Other responses

- `400`: Invalid request
- `401`: Authentication is required
- `403`: Insufficient permissions to access this resource
- `404`: Not found
- `429`: Rate limit exceeded

## Changes

> 49 revisions in range; 1 not diffed.

- **2026-09-12** `2a4c8244d07b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/arize-ai/apis/arize-rest-api/changes/v2/webhook-subscriptions/:subscription_id/delete.md)

---

[API](https://skmtc.dev/arize-ai/apis/arize-rest-api.md) - [All operations](https://skmtc.dev/arize-ai/apis/arize-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/arize-ai/apis/arize-rest-api/revisions/83b6feb52a3e?raw)