---
title: "Delete a webhook endpoint"
method: DELETE
path: "/webhooks/{id}"
tags: ["webhooks"]
---

# Delete a webhook endpoint

`DELETE /webhooks/{id}`

## Request

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

Remove an endpoint. Its pending deliveries are marked failed rather than sent: an endpoint that has been deleted must not deliver an hour later. The delivery log goes with it. Deleting an endpoint that is already gone is a 404 — unlike revoking a key, there is no credential here to be sure is dead.

## Path parameters

- `id` string, uuid, required

## Headers

- `Idempotency-Key` string, required

## Response `200`

Delete a webhook endpoint

- object
  - `deleted` true, required
  - `id` string, required

## Other responses

- `400`: `validation_failed` — That request is not valid. · `idempotency_key_required` — This operation needs an Idempotency-Key header: a string of up to 128 characters, unique to this request, so a retry cannot do the work twice.
- `401`: `unauthorized` — Authentication is required.
- `403`: `forbidden_scope` — This credential does not carry the scope this operation needs. · `email_unverified` — Confirm your email address to use this operation.
- `404`: `not_found` — No such resource.
- `409`: `idempotency_conflict` — That idempotency key was already used with a different request. · `idempotency_in_progress` — That idempotency key is still being processed. · `conflict` — That request conflicts with the current state.
- `429`: `rate_limited` — Too many requests. Try again shortly.
- `500`: `internal_error` — Something went wrong. Try again.

---

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