CoreDash Uptime API och MCP-verktyg: monitorer och kontroller

Uptime-monitorer via CoreDash API

Läs och ändra dina CoreDash-projekts uptime-monitorer via REST, med API-nyckeln du redan använder för din RUM-data. En AI-agent läser dem via MCP.

curl https://app.coredash.app/api/uptime/monitors \
  -H "Authorization: Bearer cdk_your_key"

API-nycklar för uptime-monitorer

Uptime-slutpunkterna tar nycklarna från CoreDash API och Agency API.

Skapa en projektnyckel på sidan Connect Your AI i projektets sidomeny: ge den ett namn och klicka på Generate API key. Samma nycklar finns i projektinställningarna under API Keys (MCP). Endast projektets ägare kan skapa dem. En masternyckel hämtas från sidan Agency API i sidomenyn, på agency-konton. När ett projekt har löpt ut får dess projektnyckel 401 vid varje anrop.

En gäst i ett projekt kan läsa dess monitorer. För att lägga till, ändra, flytta och ta bort dem krävs ett projekt du äger.

OAuth-tokenet från en AI-anslutning som Claude (mcp_at_) kan bara läsa. POST, PATCH och DELETE med det ger 403.

Uptime-slutpunkter

Origin-IP och headervärdena är hemligheter. De returneras från POST, PATCH och GET /api/uptime/monitors/:id. Listan och MCP-verktygen utelämnar origin_ip och visar varje headervärde som ••••.

Monitor-objektet

Fälten summary och rum

Både listan och den enskilda monitorn innehåller en summary: rounds_7d och down_rounds_7d räknar de senaste 7 dagarnas rundor, uptime_7d är procentandelen av dessa rundor utan en down-kontroll, och recent innehåller de senaste 48 rundorna, äldst först, med det sämsta utfallet för varje runda. En monitor utan kontroller under de senaste 7 dagarna har summary: null.

Den enskilda monitorn innehåller även rum: TTFB vid p75 som dina verkliga besökare fick under de senaste 7 dagarna, hämtat från projektets RUM-data, för att jämföra med checkerns ttfb_ms. Fältet är null så länge projektet saknar RUM-data.

GET /api/uptime/monitors/:id

curl "https://app.coredash.app/api/uptime/monitors/6ad68c7a844fad80b752fd16?limit=2" \
  -H "Authorization: Bearer cdk_your_key"

{
  "monitor": {
    "id": "6ad68c7a844fad80b752fd16",
    "name": "Checkout",
    "url": "https://www.example.com/checkout/",
    "project_id": "655f1f77bcf86cd799439011",
    "paused": false,
    "expect_status": 200,
    "origin_check": true,
    "origin_ip": "203.0.113.10",
    "headers": [{ "name": "X-Staging-Auth", "value": "k7Qp2vX9mR4tL8wZ" }],
    "state": "up",
    "last_check_at": "2026-10-20T08:00:09.000Z",
    "last_up_at": "2026-10-20T08:00:09.000Z",
    "down_since": null,
    "last_down": { "from": "2026-10-18T19:00:11.000Z", "to": "2026-10-18T20:00:10.000Z" },
    "check_requested_at": null,
    "last": {
      "edge": { "at": "2026-10-20T08:00:09.000Z", "server": "scan1", "mode": "edge", "outcome": "up", "status": 200, "ttfb_ms": 212, "total_ms": 388, "connect_ms": 14, "redirects": 0, "final_url": "https://www.example.com/checkout/", "error": null, "error_text": null, "cloudflare": true, "cache_status": "DYNAMIC" },
      "origin": { "at": "2026-10-20T08:00:09.000Z", "server": "scan1", "mode": "origin", "outcome": "up", "status": 200, "ttfb_ms": 640, "total_ms": 702, "connect_ms": 9, "redirects": 0, "final_url": "https://www.example.com/checkout/", "error": null, "error_text": null, "cloudflare": false, "cache_status": null },
      "origin_is_cdn": false
    },
    "cert_expires": "2027-01-02T23:59:59.000Z",
    "created_at": "2026-10-06T09:12:41.000Z"
  },
  "summary": {
    "rounds_7d": 336,
    "down_rounds_7d": 2,
    "uptime_7d": 99.4,
    "recent": [
      { "at": "2026-10-20T07:30:10.000Z", "outcome": "up" },
      { "at": "2026-10-20T08:00:09.000Z", "outcome": "up" }
    ]
  },
  "checks": [
    { "at": "2026-10-20T08:00:09.000Z", "server": "scan1", "mode": "edge", "outcome": "up", "status": 200, "ttfb_ms": 212, "total_ms": 388, "connect_ms": 14, "redirects": 0, "final_url": "https://www.example.com/checkout/", "error": null, "error_text": null, "cloudflare": true, "cache_status": "DYNAMIC" },
    { "at": "2026-10-20T08:00:09.000Z", "server": "scan1", "mode": "origin", "outcome": "up", "status": 200, "ttfb_ms": 640, "total_ms": 702, "connect_ms": 9, "redirects": 0, "final_url": "https://www.example.com/checkout/", "error": null, "error_text": null, "cloudflare": false, "cache_status": null }
  ],
  "rum": { "ttfb_p75": 1920, "rating": "poor", "period": "last 7 days" }
}

I det verkliga svaret innehåller recent 48 rundor; det här exemplet visar de två senaste.

Check-objektet och dess utfall

Var 30:e minut kontrollerar en runda alla monitorer, från två servrar i tur och ordning: scan1 vid :00, scan2 vid :30. En runda kontrollerar alltid URL:en på samma sätt som besökarna når den, via DNS och ditt CDN (edge). Med en origin-IP kontrolleras även din server direkt (origin). API:et saknar anrop för att kontrollera en monitor mellan rundor. Kontroller sparas i 30 dagar.

Varje kontroll skickar user-agenten CoreDash/1.0 (uptime; +https://www.coredash.app/bot). Ligger monitorns URL på ditt projekts egen webbplats (dess host, med eller utan www, eller en subdomän) skickar kontrollen även headern X-CoreDash-Bot med ditt projekts hemliga värde, från fliken CoreDash bot token i dina projektinställningar. En monitor på någon annan webbplats får ingen token. Vid en omdirigering följer denna token regeln för dina angivna headers: den följer bara med så länge omdirigeringen stannar på monitorns host. En egen header med namnet X-CoreDash-Bot tas bort. Sidan CoreDash bot har mer information om båda.

Hur en kontroll får sitt utfall

Det sämsta utfallet bland en rundas kontroller avgör monitorns status, från sämst till bäst: down, blocked, warn, up.

Monitorstatusar

En monitor i ett projekt vars prenumeration har löpt ut behåller sina inställningar och sin senaste status. Den kontrolleras inte igen förrän projektet är betalt.

Lägg till, ändra och ta bort en monitor

POST /api/uptime/monitors

curl -X POST https://app.coredash.app/api/uptime/monitors \
  -H "Authorization: Bearer cdk_master_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.example.com/checkout/",
    "name": "Checkout",
    "project_id": "655f1f77bcf86cd799439011",
    "origin_ip": "203.0.113.10",
    "headers": [{ "name": "X-Staging-Auth", "value": "k7Qp2vX9mR4tL8wZ" }],
    "expect_status": 200
  }'

Svaret är 201 med den nya monitorn, inklusive origin-IP och headervärden:

{
  "monitor": {
    "id": "6ad68c7a844fad80b752fd16",
    "name": "Checkout",
    "url": "https://www.example.com/checkout/",
    "project_id": "655f1f77bcf86cd799439011",
    "paused": false,
    "expect_status": 200,
    "origin_check": true,
    "origin_ip": "203.0.113.10",
    "headers": [{ "name": "X-Staging-Auth", "value": "k7Qp2vX9mR4tL8wZ" }],
    "state": "pending",
    "last_check_at": null,
    "last_up_at": null,
    "down_since": null,
    "last_down": null,
    "check_requested_at": "2026-10-20T09:12:41.000Z",
    "last": {},
    "cert_expires": null,
    "created_at": "2026-10-20T09:12:41.000Z"
  }
}

PATCH /api/uptime/monitors/:id

Skicka bara de fält du ändrar. headers ersätter hela listan, så skicka med alla headers du vill behålla. Detta pausar en monitor:

curl -X PATCH https://app.coredash.app/api/uptime/monitors/6ad68c7a844fad80b752fd16 \
  -H "Authorization: Bearer cdk_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "paused": true }'

Med en masternyckel flyttar project_id monitorn, enligt samma regler som vid POST.

DELETE /api/uptime/monitors/:id

curl -X DELETE https://app.coredash.app/api/uptime/monitors/6ad68c7a844fad80b752fd16 \
  -H "Authorization: Bearer cdk_your_key"

Det går inte att ångra. För att stoppa kontrollerna och behålla historiken skickar du { "paused": true } med PATCH.

Fel och gränser i Uptime API

Fel returneras som { "error": "..." } med en av följande statuskoder:

Gränser: 25 monitorer per projekt, 5 extra headers per monitor, 2100 kontroller per GET för en enskild monitor och 30 dagars kontrollhistorik.

MCP-verktyg för uptime

CoreDash MCP-server på https://app.coredash.app/api/mcp har två uptime-verktyg vid sidan av RUM-verktygen, plus list_projects för projekten din nyckel når. Alla tre kan enbart läsa. För att lägga till, ändra eller ta bort en monitor använder du appen eller REST-slutpunkterna ovan med en CoreDash API-nyckel. Verktygen behöver inget project_id: en projektnyckel läser sitt eget projekt, medan en masternyckel eller en OAuth-anslutning som Claude läser alla projekt du äger eller bjudits in till.

curl -X POST https://app.coredash.app/api/mcp \
  -H "Authorization: Bearer cdk_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_uptime_monitor",
      "arguments": { "monitor_id": "6ad68c7a844fad80b752fd16", "limit": 48 }
    }
  }'

Svaret är JSON-RPC-wrappern från CoreDash API, med resultatet som en JSON-sträng i result.content[0].text. En okänd monitor ger { "error": "Monitor not found" } där, och result.isError är true.

Mer om uptime och CoreDash API

• Uptime-bevakning: vad CoreDash kontrollerar och vad du ser i appen.
• CoreDash API: projektnycklar, JSON-RPC-formatet och RUM-verktygen.
• Agency API: masternycklar och projekt via REST.
• CoreDash bot: user-agenten, X-CoreDash-Bot-headern och adresserna.
• Släpp igenom CoreDash i brandväggen: för en monitor som visar Blockerad.