Skip to main content
PATCH
/
v1
/
webhook-endpoints
/
{id}
Update an outbound webhook endpoint
curl --request PATCH \
  --url https://api.example.com/v1/webhook-endpoints/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Slack #alerts",
  "url": "https://hooks.slack.com/services/T00/B00/xxx",
  "events": [
    "budget.threshold_reached",
    "policy.violation"
  ],
  "enabled": true
}
'

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

Body

application/json
​
name
string

Human-readable name for this endpoint

Example:

"Slack #alerts"

​
url
string

Destination URL for webhook delivery

Example:

"https://hooks.slack.com/services/T00/B00/xxx"

​
type
enum<string>

Payload format: slack uses the Slack incoming-webhook shape

Available options:
slack,
generic
​
events
string[]

Event types this endpoint subscribes to

Example:
[
  "budget.threshold_reached",
  "policy.violation"
]
​
enabled
boolean

Enable or disable delivery to this endpoint

Example:

true

Response

200 - undefined