Skip to main content
PUT
/
v1
/
risk
/
channels
Add, update, or remove alert channels
curl --request PUT \
  --url https://api.range.org/v1/risk/channels \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "operations": [
    {
      "action": "add",
      "channel": {
        "name": "Primary Slack Channel",
        "type": "slack",
        "params": {
          "webhook_url": "https://hooks.slack.com/services/T00/B00/xxxx"
        }
      }
    },
    {
      "action": "update",
      "channel": {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "name": "Renamed Channel",
        "enabled": false
      }
    },
    {
      "action": "remove",
      "channel": {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
      }
    }
  ]
}
'
{
  "acknowledged": true
}

Authorizations

Authorization
string
header
required

Use Authorization: Bearer

Body

application/json
operations
object[]
required
Required array length: 1 - 1000 elements
Example:
[
{
"action": "add",
"channel": {
"name": "Primary Slack Channel",
"type": "slack",
"params": {
"webhook_url": "https://hooks.slack.com/services/T00/B00/xxxx"
}
}
},
{
"action": "update",
"channel": {
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"name": "Renamed Channel",
"enabled": false
}
},
{
"action": "remove",
"channel": {
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
}
]

Response

200 - application/json
acknowledged
boolean
required
Example:

true

Last modified on July 1, 2026