Delete an alert channel

DELETE

/api/v1/alerts/channels/{id}

curl --request DELETE \
  --url https://example.com/api/v1/alerts/channels/1 \
  --header 'Authorization: <Authorization>'

Deletes an alert channel by ID. Rules referencing it keep the dangling ID and the dispatcher skips it; deletion takes effect on the next alert reload.

Authorizations

• ApiKeyAuth

Parameters

Path Parameters

id

required

integer

Channel ID

Responses

204

No content

400

Bad request

Media typeapplication/json

object

code

string

error

string

Example^generated

{
  "code": "example",
  "error": "example"
}

401

Unauthorized

Media typeapplication/json

object

code

string

error

string

Example^generated

{
  "code": "example",
  "error": "example"
}

403

Forbidden

Media typeapplication/json

object

code

string

error

string

Example^generated

{
  "code": "example",
  "error": "example"
}

404

Not found

Media typeapplication/json

object

code

string

error

string

Example^generated

{
  "code": "example",
  "error": "example"
}

503

Alerts disabled

Media typeapplication/json

object

code

string

error

string

Example^generated

{
  "code": "example",
  "error": "example"
}