PATCH /webhooks/{id}

Updated Oct 1, 20261 minute read

Update a webhook

Change the URL, the events, or both. Deliveries already booked keep the body they were given.

Part of Webhooks.

Parameters

Name	In	Type	Required	Description
`id`	path	`string`	Yes

application/json, required.

Field	Type	Required	Description
`url`	`string`	No
`events`	`"message.created" \| "conversation.created" \| "conversation.updated" \| "bug.created" \| "suggestion.created" \| "signal.updated" \| "knowledge.suggestion.created"[]`	No

Status	Description
`200`	Done.
`400`	The request is malformed, and the message names the field.
`401`	The bearer token is missing, revoked, or expired.
`403`	The token's person does not hold the role this needs.
`404`	Not one of yours, or not there at all.
`429`	Too many requests. Wait the seconds in `Retry-After`. Limits depend on the plan. See rate limits.

Field	Type	Required	Description
`ok`	`boolean`	No

{
  "ok": true
}

curl -X PATCH https://api.median.sh/v1/webhooks/id \
  -H "Authorization: Bearer $BEARER_AUTH"