CoreDash Uptime API en MCP-tools: monitors en checks
Vraag uptime-monitors op, voeg ze toe, pas ze aan en verwijder ze met je CoreDash API key. Lees hun checks uit, of laat een AI-agent het doen via MCP.
Arjen Karel - linkedin
Last update: 2026-10-19
Trusted by market leaders · Client results
Authenticatie
De uptime-endpoints gebruiken dezelfde Bearer-tokens als de rest van de CoreDash API:
- Project API key (
cdk_...): ziet de monitors gekoppeld aan dat RUM-project. Maak je hiermee een monitor aan, dan is die gekoppeld aan dat project. - Master key (
cdk_master_..., Agency API): alle monitors op het account, plus de monitors gekoppeld aan projecten die het account kan openen. - MCP OAuth-token: dezelfde scope als een project key.
Endpoints
| Methode en pad | Wat het doet |
|---|---|
GET /api/uptime/monitors | Elke monitor met zijn state, laatste check, uptime over 7 dagen en de uitkomst van de laatste 48 checks. |
POST /api/uptime/monitors | Voegt een monitor toe. Geeft 201 en de monitor terug. De eerste check draait binnen een minuut. |
GET /api/uptime/monitors/:id | Eén monitor met zijn recente checks, nieuwste eerst. ?limit= tot 2100 (7 dagen met een origin-check). |
PATCH /api/uptime/monitors/:id | Past de velden aan die je meestuurt. paused: true stopt de checks. |
DELETE /api/uptime/monitors/:id | Verwijdert de monitor en zijn checkgeschiedenis. |
POST /api/uptime/monitors/:id/check | Vraagt direct een check aan. Geeft 202 terug; het resultaat is er binnen ongeveer een minuut. |
Een monitor toevoegen
| Veld | Betekenis |
|---|---|
url | Verplicht. Een volledige http- of https-URL. |
name | Weergavenaam. Standaard: de host van de URL. |
project_id | Alleen master key: koppel de monitor aan een RUM-project voor de TTFB-vergelijking. |
origin_ip | Publiek IP van je server. Voegt de origin-check toe, die DNS en het CDN omzeilt. Een lege string verwijdert deze. |
headers | Tot 5 request-headers, [{ "name", "value" }], voor een firewall-regel die de checker doorlaat. |
expect_status | De status die telt als up. Standaard 200. |
paused | Alleen PATCH. true stopt de checks, false start ze weer. |
Hoe een monitor eruitziet
state is een van de volgende:
up: de laatste check is geslaagd.failing: de laatste check faalde, die ervoor slaagde.down: twee mislukte checks op rij, dus beide servers zagen het falen.blocked: een 403, een 429 of een Cloudflare-challenge. Zie de checker doorlaten.warn: elke andere status dan degene die telt als up.pendingofpaused.
Een mislukte check heeft een error: dns, connect, connect_timeout, timeout (30 seconden), tls, redirects of network. Het origin-IP en de headerwaarden krijg je alleen terug via GET /api/uptime/monitors/:id. Lijsten en MCP-antwoorden maskeren ze.
MCP-tools
De CoreDash MCP-server heeft zes uptime-tools naast de RUM-tools. Met een master key hebben ze geen project_id nodig.
| Tool | Waar je het voor gebruikt |
|---|---|
list_uptime_monitors | "Is alles up?" |
get_uptime_monitor | "Was de checkout deze week down, en sinds wanneer?" Geeft de recente checks terug en de uptime daarover. |
create_uptime_monitor | "Monitor ook onze inlogpagina." |
update_uptime_monitor | Pas de URL, het origin-IP of de headers aan, of pauzeer een monitor. |
delete_uptime_monitor | Verwijder een monitor en zijn geschiedenis. |
check_uptime_now | "Check het nu opnieuw." |
