Skip to main content
PATCH
/
api
/
v1
/
webhooks
/
{id}
Update webhook subscription
curl --request PATCH \
  --url https://app.larm.dev/api/v1/webhooks/{id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "<string>",
  "events": [
    "<string>"
  ],
  "enabled": true
}
'
{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "url": "https://example.com/webhooks/larm",
    "events": ["monitor.state_changed"],
    "enabled": false,
    "inserted_at": "2025-03-01T12:00:00Z",
    "updated_at": "2025-03-01T14:30:00Z"
  }
}
Requires monitors:read_write permission. Only include the fields you want to change.
​
id
string
required
Webhook subscription ID (UUID)
​
url
string
HTTPS endpoint URL to receive webhook events
​
events
string[]
Events to subscribe to. Valid values: monitor.state_changed, monitor.created, monitor.updated, monitor.deleted.
​
enabled
boolean
Whether the subscription is active
{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "url": "https://example.com/webhooks/larm",
    "events": ["monitor.state_changed"],
    "enabled": false,
    "inserted_at": "2025-03-01T12:00:00Z",
    "updated_at": "2025-03-01T14:30:00Z"
  }
}