Skip to content

Apply alert changes (hot reload)

POST
/api/v1/alerts/apply
curl --request POST \
--url https://example.com/api/v1/alerts/apply \
--header 'Authorization: <Authorization>'

Queues a reload-alerts service command for osctrl-tls. The TLS process reloads its alert rule snapshot and resets the channel sender cache without restarting. The snapshot swap is atomic; in-flight matches finish against the old ruleset.

Reload requested

Media typeapplication/json
object
command
object
action
string
command_id
string
consumed_at
string
consumed_by
string
created_at
string
expires_at
string
recovered_at
string
recovered_by
string
requested_by
string
requested_from
string
status
string
target_service
string
message
string
service
string
Examplegenerated
{
"command": {
"action": "example",
"command_id": "example",
"consumed_at": "example",
"consumed_by": "example",
"created_at": "example",
"expires_at": "example",
"recovered_at": "example",
"recovered_by": "example",
"requested_by": "example",
"requested_from": "example",
"status": "example",
"target_service": "example"
},
"message": "example",
"service": "example"
}

Unauthorized

Media typeapplication/json
object
code
string
error
string
Examplegenerated
{
"code": "example",
"error": "example"
}

Forbidden

Media typeapplication/json
object
code
string
error
string
Examplegenerated
{
"code": "example",
"error": "example"
}

Alerts disabled or service commands unavailable

Media typeapplication/json
object
code
string
error
string
Examplegenerated
{
"code": "example",
"error": "example"
}