---
title: "Change url, events or enabled. Turning it back on clears the failure count. API keys only."
method: PATCH
path: "/v1/webhook-endpoints/{id}"
---

# Change url, events or enabled. Turning it back on clears the failure count. API keys only.

`PATCH /v1/webhook-endpoints/{id}`

## Request

- Base URL: `https://api.lumeta.ai`
- URL: `https://api.lumeta.ai/v1/webhook-endpoints/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Request body

- object
  - `url` string, uri: https:// on port 443, resolving to a public address.
  - `events` string[]: ["*"] (the default) for every event.
  - `enabled` boolean: PATCH only. true also clears the failure count.

## Response `200`

OK

- WebhookEndpoint
  - `id` string: `hook_<n>`
  - `url` string
  - `events` string[]: ["*"] or a list of generation.succeeded, generation.failed.
  - `enabled` boolean: false after you switch it off, or after an event failed every retry with no success in between.
  - `failure_count` integer: Failed attempts in a row; a 2xx resets it.
  - `last_success_at` string, nullable
  - `last_failure_at` string, nullable
  - `disabled_at` string, nullable
  - `created_at` string

## Other responses

- `default`: Error

---

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