API reference · Schema
ClusterEvent
objectstringrequiredAlways `cluster_event`: the type of this object
One of
cluster_eventidstringrequiredUnique ID (`cle_…`)
ID with prefix cle_
typestringrequiredcreated, running, degraded, stopped, deleted
severitystringrequiredHow much it matters
One of
infowarningerrormessagestringrequiredOne sentence for people
rankinteger | nullrequiredThe member it is about, when it is about one
created_atstring (date-time)requiredWhen it was created (ISO 8601, UTC)
Example
{
"object": "cluster_event",
"id": "cle_01jc5zq4m8k3v6x9t2w7r0b1e4",
"type": "string",
"severity": "info",
"message": "string",
"rank": 1,
"created_at": "2026-01-01T00:00:00.000Z"
}Used by
- The cluster’s timeline, oldest first
GET /v1/clusters/{cluster_id}/events