---
title: "Disable webhook endpoint (soft-delete)"
method: DELETE
path: "/v1/webhooks/{id}"
tags: ["Webhooks"]
---

# Disable webhook endpoint (soft-delete)

`DELETE /v1/webhooks/{id}`

## Request

- Base URL: `https://api.predictasiax.com`
- URL: `https://api.predictasiax.com/v1/webhooks/{id}`
- Auth: HTTP bearer

Soft-disable — the row stays with active=false, disabled_at_ms, disabled_reason=user_requested. Cannot be re-enabled by design (event ordering guarantee); register a new webhook to resume. Scope: builder:apps:write.

## Response `200`

Webhook disabled

- object
  - `data` object
    - `webhook` object
      - `id` string
      - `active` boolean
      - `disabled_at_ms` integer
  - `meta` object
    - `ts_ms` integer
    - `trace_id` string

## Other responses

- `403`: webhook belongs to a different builder
- `404`: webhook not found

---

[API](https://skmtc.dev/predictasiax/apis/predictasiax-network-api.md) · [All operations](https://skmtc.dev/predictasiax/apis/predictasiax-network-api/llms.txt) · [OpenAPI document](https://skmtc.dev/predictasiax/apis/predictasiax-network-api/revisions/c2ed1a03ce79?raw)