CoreDash uptime-API och MCP-verktyg: monitorer och kontroller
Lista, lägg till, ändra och ta bort uptime-monitorer med din CoreDash-API-nyckel, läs av deras kontroller eller låt en AI-agent göra det via MCP.
Arjen Karel - linkedin
Last update: 2026-10-19
Autentisering
Uptime-endpoints tar samma Bearer-tokens som resten av CoreDash API:
- Projekt-API-nyckel (
cdk_...): ser monitorerna kopplade till det RUM-projektet. En monitor du skapar med den kopplas till det projektet. - Master-nyckel (
cdk_master_..., Agency API): alla monitorer på kontot, plus monitorerna kopplade till projekt kontot kan öppna. - MCP OAuth-token: samma scope som en projektnyckel.
Endpoints
| Metod och sökväg | Vad den gör |
|---|---|
GET /api/uptime/monitors | Alla monitorer med sitt state, senaste kontroll, uptime över 7 dagar och utfallet från de senaste 48 kontrollerna. |
POST /api/uptime/monitors | Lägger till en monitor. Returnerar 201 och monitorn. Första kontrollen körs inom en minut. |
GET /api/uptime/monitors/:id | En monitor med sina senaste kontroller, nyast först. ?limit= upp till 2100 (7 dagar med en origin-kontroll). |
PATCH /api/uptime/monitors/:id | Ändrar fälten du skickar. paused: true stoppar kontrollerna. |
DELETE /api/uptime/monitors/:id | Tar bort monitorn och dess kontrollhistorik. |
POST /api/uptime/monitors/:id/check | Begär en kontroll direkt. Returnerar 202; resultatet kommer inom ungefär en minut. |
Lägg till en monitor
| Fält | Betydelse |
|---|---|
url | Obligatorisk. En fullständig http- eller https-URL. |
name | Visningsnamn. Standard: URL:ens host. |
project_id | Endast master-nyckel: koppla monitorn till ett RUM-projekt för TTFB-jämförelsen. |
origin_ip | Publik IP till din server. Lägger till en origin-kontroll som går förbi DNS och CDN. En tom sträng tar bort den. |
headers | Upp till 5 request-headers, [{ "name", "value" }], för en brandväggsregel som släpper igenom checkern. |
expect_status | Statusen som räknas som up. Standard 200. |
paused | Endast PATCH. true stoppar kontrollerna, false startar dem igen. |
Så ser en monitor ut
state är något av följande:
up: senaste kontrollen lyckades.failing: senaste kontrollen misslyckades, den innan lyckades.down: två misslyckade kontroller i rad, så båda servrarna såg felet.blocked: en 403, en 429 eller en Cloudflare-challenge. Se släppa igenom checkern.warn: all annan status än den som räknas som up.pendingellerpaused.
En misslyckad kontroll har ett error: dns, connect, connect_timeout, timeout (30 sekunder), tls, redirects eller network. Origin-IP och headervärden returneras bara från GET /api/uptime/monitors/:id. Listor och MCP-svar maskerar dem.
MCP-verktyg
CoreDash MCP-server har sex uptime-verktyg vid sidan av RUM-verktygen. Med en master-nyckel behöver de inget project_id.
| Verktyg | Används till |
|---|---|
list_uptime_monitors | ”Är allt uppe?” |
get_uptime_monitor | ”Låg checkouten nere i veckan, och sedan när?” Returnerar de senaste kontrollerna och deras uptime. |
create_uptime_monitor | ”Övervaka inloggningssidan också.” |
update_uptime_monitor | Ändra URL, origin-IP eller headers, eller pausa en monitor. |
delete_uptime_monitor | Ta bort en monitor och dess historik. |
check_uptime_now | ”Kontrollera igen nu.” |