---
title: "Retrieve the scheduled database event consistency of a specific cluster"
method: GET
path: "/api/clusters/{clusterName}/schema/events"
tags: ["ClusterSchema"]
---

# Retrieve the scheduled database event consistency of a specific cluster

`GET /api/clusters/{clusterName}/schema/events`

## Request

- The document declares no server URL.
- Auth: none declared. Required headers: `Authorization`

Scheduled database events (MySQL/MariaDB EVENT objects) as the last schema scan collected them on the master and the replicas (monitoring-schema-events), compared with the master: per server the collection state (checked, unavailable, unsupported, not-checked) and, for a replica, the comparison (consistent, different, not-checked); per event its presence, status class (active, disabled, unknown) and definition CRC64 on each checked server, and its drifts (missing, extra, definition, definer, status). A server absent from an event's nodes was not checked: it is never reported missing. It never carries an event definition, schedule, comment or definer. Observational only: the schema drift signal is WARN0164. enabled is false, with no server and no event, when monitoring-schema-events is off. Requires db-show-schema (or cluster-sharding, through /schema).

## Path parameters

- `clusterName` string, required

## Headers

- `Authorization` string, required

## Response `200`

Scheduled database event consistency

- ClusterEventSchemaView
  - `enabled` boolean
  - `events` ClusterEventSchemaEventView[]
    - `db` string
    - `drifts` ClusterEventSchemaDriftView[]
      - `drift` string
      - `serverId` string
    - `name` string
    - `nodes` object
  - `servers` ClusterEventSchemaServerView[]
    - `collectedAt` integer
    - `collection` string
    - `comparison` string
    - `id` string
    - `isMaster` boolean
    - `url` string

## Other responses

- `403`: No valid ACL
- `500`: No cluster

## Changes

- **2026-10-12** `d4e4c5013f0c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/signal18/apis/signal-18-dashboard-api/changes/api/clusters/:clusterName/schema/events/get.md)

---

[API](https://skmtc.dev/signal18/apis/signal-18-dashboard-api.md) - [All operations](https://skmtc.dev/signal18/apis/signal-18-dashboard-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signal18/apis/signal-18-dashboard-api/revisions/8ee8a1e31294?raw)