Webhooks

Change an endpoint

Its URL, its events, or whether it is enabled.

PATCH/v1/webhook-endpoints/{id}

TL;DR

Question	Answer
What does it do?	Change an endpoint.
What does it need?	An API key or an OAuth access token.
What does it take?	A JSON body with the fields below, and `id` in the path.
What does it return?	Status 200 with a body of type `WebhookEndpoint`.
In the SDK?	`flung.webhookEndpoints.update()`
What can go wrong?	`401` Missing, unknown, revoked or expired API key; `404` No such endpoint in this workspace; `422` The request failed validation; `429` Too many requests for this credential; wait for `retry-after` seconds. Every failure has the same error shape.

What it does

Its URL, its events, or whether it is enabled. The signing secret stays; rotate it separately.

Example

1curl -X PATCH 'https://api.flung.dev/v1/webhook-endpoints/whe_aaaaaaaaaaaaaaaaaaaaaaaa' \2  --header "Authorization: Bearer $FLUNG_API_KEY" \3  --header 'Content-Type: application/json' \4  --data '{}'

1import { Flung } from '@flung.dev/sdk'2
3const flung = new Flung({ apiKey: process.env.FLUNG_API_KEY! })4const result = await flung.webhookEndpoints.update({5  id: 'whe_aaaaaaaaaaaaaaaaaaaaaaaa',6})

1const response = await fetch('https://api.flung.dev/v1/webhook-endpoints/whe_aaaaaaaaaaaaaaaaaaaaaaaa', {2  method: 'PATCH',3  headers: {4    'Authorization': `Bearer ${process.env.FLUNG_API_KEY}`,5    'Content-Type': 'application/json',6  },7  body: JSON.stringify({}),8})9if (!response.ok) throw new Error((await response.json()).error.message)10const result = await response.json()

A successful answer looks like this:

1{2  "id": "whe_aaaaaaaaaaaaaaaaaaaaaaaa",3  "url": "string",4  "events": [5    "string"6  ],7  "enabled": true,8  "createdAt": "2026-11-01T09:00:00.000Z"9}

Path parameters

Field	Type	Required	Description
`id`	`string`	yes

Request body

The body has the type an object, with the fields below.

Field	Type	Required	Description
`url`	`string`	no	at most 2048 characters.
`events`	`WebhookEvent[]`	no
`enabled`	`boolean`	no	false pauses deliveries; events in the meantime are not sent.

Responses

Status	Meaning	Body
200	The endpoint.	`WebhookEndpoint`
401	Missing, unknown, revoked or expired API key.	`Error`
404	No such endpoint in this workspace.	`Error`
422	The request failed validation.	`Error`
429	Too many requests for this credential; wait for `retry-after` seconds.	`Error`

Response body

A 200 answer has the type WebhookEndpoint.

Field	Type	Required
`id`	`string`	yes
`url`	`string`	yes
`events`	`string[]`	yes
`enabled`	`boolean`	yes
`createdAt`	`string`	yes

Doc	Why
API reference	Every endpoint
Schemas	Every request and response type
Errors	Every error code and what to do about it