Sites in the Woods

API

Monitoring data for your team's sites (status, uptime, incidents, daily insights and domains) and the writes a team makes, for your agents and scripts. A key sees only its own team. Competitors are never included.

A public site's status page numbers need no key: /status/<slug>/data.json and data.csv carry its daily uptime, response time and outages for 90 days (CC BY 4.0).

Authentication

Create a key on the team dashboard's API keys page (team sign-in needed). It's shown once. Send it on every request:

Authorization: Bearer sm_…

A Viewer key reads (GET and HEAD). On teams with 10 sites or more, a Member key can also dismiss incidents, ask for a check again and start or end maintenance windows, and an Admin key can also pause and resume sites: the POST routes below. A key never does more than its creator can now. A signed-in team member's browser can call the GET routes with its cookie; writes need a key. This page, /api and /api/openapi.json need no key.

Conventions

Errors

errorStatusWhen
unauthorized401No key, or an unknown or revoked one.
forbidden403A write by a key whose role or team can't make it (writes need a Member or Admin key and 10 sites), a POST to a route that only reads, a write without a key, or a form post from another site.
not_found404An unknown site slug or API path.
method_not_allowed405Anything but GET or HEAD on a page.
conflict409A write this incident can't take (one that can't be checked again, say).
validation_error400A parameter isn't valid; `issues` says which.
request_too_large413A request body over 64 KB.
rate_limited429More requests this minute than the key's team's sites allow (comes with Retry-After): 60 on the free site, 300 from 2 sites, 1,000 from 25.
auth_unavailable503The key or sign-in couldn't be checked right now (comes with Retry-After). Your key or session is probably fine: retry.

MCP

https://sitesinthewoods.com/mcp is a hosted MCP server with one tool per route below (the writes for Member and Admin keys only), named by its operation id (status, sites_by_slug…) and returning the route's own JSON. It takes the same key, sent the same way; listing its tools needs none. It speaks protocol 2026-07-28 and the 2025 revisions. Its card is at /mcp/server-card.

Claude Code:

claude mcp add --transport http sites-in-the-woods https://sitesinthewoods.com/mcp --header "Authorization: Bearer $SITES_IN_THE_WOODS_API_KEY"

Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "sites-in-the-woods": {
      "url": "https://sitesinthewoods.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:SITES_IN_THE_WOODS_API_KEY}"
      }
    }
  }
}

VS Code (.vscode/mcp.json):

{
  "inputs": [
    {
      "type": "promptString",
      "id": "sites-in-the-woods-key",
      "description": "Sites in the Woods API key",
      "password": true
    }
  ],
  "servers": {
    "sites-in-the-woods": {
      "type": "http",
      "url": "https://sitesinthewoods.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:sites-in-the-woods-key}"
      }
    }
  }
}

Agent skills teach an agent the jobs these routes do (checking status, connecting, finding what's wrong, holding alerts), each one a SKILL.md it can install. The checks behind this data are open source: agent-ready-uptime.

Routes

GET /api/status

Every one of the team's sites: its status right now, and the open incidents. Call this first, or on a schedule (at most once a minute, as often as the checks run), to see whether anything is down or warning right now.

curl -H "Authorization: Bearer sm_…" https://sitesinthewoods.com/api/status
Response fields (18)
FieldTypeMeaning
dataobject
data.sitesobject[]
data.sites[].slugstring
data.sites[].namestring
data.sites[].statusstring
data.sites[].pausedboolean
data.openIncidentsobject[]
data.openIncidents[].kindstring
data.openIncidents[].severity"down" | "warning"
data.openIncidents[].sitestring or null
data.openIncidents[].startedAtstringISO 8601, UTC (…Z)
data.openIncidents[].causestring or null
data.openIncidents[].dismissedboolean
next_stepsobject[] (optional)calls that usually come next ({method, path, why, tool})
next_steps[].methodstring (optional)
next_steps[].pathstring (optional)
next_steps[].whystring (optional)
next_steps[].toolstring (optional)the MCP tool that makes this call, for data routes
Response shape
{
  "data": {
    "sites": [
      {
        "slug": "…",
        "name": "…",
        "status": "…",
        "paused": false
      }
    ],
    "openIncidents": [
      {
        "kind": "…",
        "severity": "down",
        "site": "…",
        "startedAt": "2026-11-14T12:00:00.000Z",
        "cause": "…",
        "dismissed": false
      }
    ]
  },
  "next_steps": [
    {
      "method": "…",
      "path": "…",
      "why": "…",
      "tool": "…"
    }
  ]
}

GET /api/sites

The team's sites: status, homepage uptime over 1, 7 and 30 days, open incidents. Call this to compare sites or report on uptime over the last day, week or month. It also lists the slugs every other route takes.

curl -H "Authorization: Bearer sm_…" https://sitesinthewoods.com/api/sites
Response fields (29)
FieldTypeMeaning
dataobject[]
data[].slugstring
data[].namestring
data[].projectstring
data[].urlstring
data[].statusstring
data[].pausedboolean
data[].publicboolean
data[].checkFrom"us-west" | "us-east" | "split"where the homepage, nav and newest-content checks run; a failure is checked again from the other location before it alerts or counts against uptime
data[].uptimeobject or nullthe homepage's checks over the last 1, 7 and 30 days
data[].uptime.d1object
data[].uptime.d1.okinteger
data[].uptime.d1.totalinteger
data[].uptime.d1.percentnumber or nullok / total × 100, two decimals; null with no checks
data[].uptime.d7object
data[].uptime.d7.okinteger
data[].uptime.d7.totalinteger
data[].uptime.d7.percentnumber or nullok / total × 100, two decimals; null with no checks
data[].uptime.d30object
data[].uptime.d30.okinteger
data[].uptime.d30.totalinteger
data[].uptime.d30.percentnumber or nullok / total × 100, two decimals; null with no checks
data[].openIncidentsinteger
data[].dismissedintegerof those, how many the team dismissed
next_stepsobject[] (optional)calls that usually come next ({method, path, why, tool})
next_steps[].methodstring (optional)
next_steps[].pathstring (optional)
next_steps[].whystring (optional)
next_steps[].toolstring (optional)the MCP tool that makes this call, for data routes
Response shape
{
  "data": [
    {
      "slug": "…",
      "name": "…",
      "project": "…",
      "url": "…",
      "status": "…",
      "paused": false,
      "public": false,
      "checkFrom": "us-west",
      "uptime": {
        "d1": {
          "ok": 0,
          "total": 0,
          "percent": 0
        },
        "d7": {
          "ok": 0,
          "total": 0,
          "percent": 0
        },
        "d30": {
          "ok": 0,
          "total": 0,
          "percent": 0
        }
      },
      "openIncidents": 0,
      "dismissed": 0
    }
  ],
  "next_steps": [
    {
      "method": "…",
      "path": "…",
      "why": "…",
      "tool": "…"
    }
  ]
}

GET /api/sites/:slug

One site: its last 7 days (as in the weekly brief), open incidents, domain and TLS expiry. Call this to answer questions about one site: how it did this week, what's wrong with it now, and when its domain or certificate runs out.

curl -H "Authorization: Bearer sm_…" https://sitesinthewoods.com/api/sites/SITE-SLUG
ParameterInTypeMeaning
slugpathstringsite slug, as in /api/sites
Response fields (69)
FieldTypeMeaning
dataobject
data.slugstring
data.namestring
data.projectstring
data.urlstring
data.statusstring
data.pausedboolean
data.publicboolean
data.checkFrom"us-west" | "us-east" | "split"where the homepage, nav and newest-content checks run; a failure is checked again from the other location before it alerts or counts against uptime
data.weekobject or nullthe last 7 days, as in the weekly brief; null for paused sites
data.week.fromstringISO 8601, UTC (…Z)
data.week.tostringISO 8601, UTC (…Z)
data.week.uptimeobject
data.week.uptime.okinteger
data.week.uptime.totalinteger
data.week.uptime.percentnumber or nullok / total × 100, two decimals; null with no checks
data.week.typicalMsnumber or nullmedian homepage response time (time to first byte); for a site checked from both locations, of their average, each location counted once
data.week.outagesinteger
data.week.longestOutageMsnumber or null
data.week.warningsinteger
data.week.dismissedinteger
data.week.readersobject or nullreal readers on phones (Chrome UX Report, 28 days); null when Chrome has too little data. Times in ms
data.week.readers.periodEndstring
data.week.readers.lcpP75number or null
data.week.readers.inpP75number or null
data.week.readers.clsP75number or null
data.week.readers.ttfbP75number or null
data.week.htmlBytesobject
data.week.htmlBytes.nownumber or null
data.week.htmlBytes.weekAgonumber or null
data.week.brokenLinkPagesinteger
data.week.pageErrorsbooleannew errors from the site's own code right now
data.week.trafficobject or null
data.week.traffic.visitsnumber
data.week.traffic.weekBeforenumber or null
data.week.traffic.pagesnumber
data.week.traffic.cacheHitsnumber
data.openIncidentsobject[]
data.openIncidents[].idstring
data.openIncidents[].kindstring
data.openIncidents[].labelstring
data.openIncidents[].severity"down" | "warning"
data.openIncidents[].sitestring or nullsite slug
data.openIncidents[].urlstring or nullthe page or file it's about
data.openIncidents[].domainstring or null
data.openIncidents[].startedAtstringISO 8601, UTC (…Z)
data.openIncidents[].resolvedAtstring or nullISO 8601, UTC (…Z)
data.openIncidents[].causestring or null
data.openIncidents[].detailsobject
data.openIncidents[].dismissedobject or nullthe team marked it as noise: still open, never alerts again
data.openIncidents[].dismissed.bystring
data.openIncidents[].dismissed.atstringISO 8601, UTC (…Z)
data.openIncidents[].likelyCauseobject or null (optional)open outages and slowdowns only: the monitor's rules, as in the alert
data.openIncidents[].likelyCause.likelystring or null
data.openIncidents[].likelyCause.cluesstring[]
data.domainobject or null
data.domain.namestring
data.domain.expiresAtstring or nullISO 8601, UTC (…Z)
data.domain.daysLeftnumber or null
data.domain.registrarstring or null
data.tlsobject
data.tls.expiresAtstring or nullISO 8601, UTC (…Z)
data.tls.daysLeftnumber or null
data.tls.issuerstring or null
next_stepsobject[] (optional)calls that usually come next ({method, path, why, tool})
next_steps[].methodstring (optional)
next_steps[].pathstring (optional)
next_steps[].whystring (optional)
next_steps[].toolstring (optional)the MCP tool that makes this call, for data routes
Response shape
{
  "data": {
    "slug": "…",
    "name": "…",
    "project": "…",
    "url": "…",
    "status": "…",
    "paused": false,
    "public": false,
    "checkFrom": "us-west",
    "week": {
      "from": "2026-11-14T12:00:00.000Z",
      "to": "2026-11-14T12:00:00.000Z",
      "uptime": {
        "ok": 0,
        "total": 0,
        "percent": 0
      },
      "typicalMs": 0,
      "outages": 0,
      "longestOutageMs": 0,
      "warnings": 0,
      "dismissed": 0,
      "readers": {
        "periodEnd": "…",
        "lcpP75": 0,
        "inpP75": 0,
        "clsP75": 0,
        "ttfbP75": 0
      },
      "htmlBytes": {
        "now": 0,
        "weekAgo": 0
      },
      "brokenLinkPages": 0,
      "pageErrors": false,
      "traffic": {
        "visits": 0,
        "weekBefore": 0,
        "pages": 0,
        "cacheHits": 0
      }
    },
    "openIncidents": [
      {
        "id": "…",
        "kind": "…",
        "label": "…",
        "severity": "down",
        "site": "…",
        "url": "…",
        "domain": "…",
        "startedAt": "2026-11-14T12:00:00.000Z",
        "resolvedAt": "2026-11-14T12:00:00.000Z",
        "cause": "…",
        "details": {},
        "dismissed": {
          "by": "…",
          "at": "2026-11-14T12:00:00.000Z"
        },
        "likelyCause": {
          "likely": "…",
          "clues": [
            "…"
          ]
        }
      }
    ],
    "domain": {
      "name": "…",
      "expiresAt": "2026-11-14T12:00:00.000Z",
      "daysLeft": 0,
      "registrar": "…"
    },
    "tls": {
      "expiresAt": "2026-11-14T12:00:00.000Z",
      "daysLeft": 0,
      "issuer": "…"
    }
  },
  "next_steps": [
    {
      "method": "…",
      "path": "…",
      "why": "…",
      "tool": "…"
    }
  ]
}

GET /api/sites/:slug/insights

One site's daily insights: page weight, security headers, prefetches, page errors, broken links, cache, dead ends. Call this when a site is slow or heavy, or to find what to fix: the daily browser load's page weight, missing security headers, JavaScript errors and broken links.

curl -H "Authorization: Bearer sm_…" https://sitesinthewoods.com/api/sites/SITE-SLUG/insights
ParameterInTypeMeaning
slugpathstringsite slug, as in /api/sites
Response fields (86)
FieldTypeMeaning
dataobject
data.readersobject or nullreal readers on phones (Chrome UX Report, 28 days); null when Chrome has too little data. Times in ms
data.readers.periodEndstring
data.readers.lcpP75number or null
data.readers.inpP75number or null
data.readers.clsP75number or null
data.readers.ttfbP75number or null
data.pagesobject[]the homepage and the newest page, measured daily
data.pages[].urlstring
data.pages[].latestobject or null
data.pages[].latest.daystring
data.pages[].latest.measuredAtstringISO 8601, UTC (…Z)
data.pages[].latest.okboolean
data.pages[].latest.errorstring or null
data.pages[].latest.htmlBytesnumber or null
data.pages[].latest.wireBytesnumber or null
data.pages[].latest.scriptsnumber or null
data.pages[].latest.jsBytesnumber or null
data.pages[].latest.cssBytesnumber or null
data.pages[].latest.imagesnumber or null
data.pages[].latest.frameworkBytesnumber or null
data.pages[].latest.headersobject
data.pages[].latest.headers.gradestring or null
data.pages[].latest.headers.findingsobject[]
data.pages[].latest.headers.findings[].idstring
data.pages[].latest.headers.findings[].okboolean
data.pages[].latest.headers.findings[].weightnumber
data.pages[].latest.headers.findings[].detailstring
data.pages[].latest.prefetchesobject
data.pages[].latest.prefetches.requestsnumber or null
data.pages[].latest.prefetches.prefetchesnumber or null
data.pages[].latest.prefetches.pagesnumber or null
data.pages[].latest.prefetches.uncachednumber or null
data.pages[].latest.pageErrorsobject[] or nullnull when the browser view didn't run
data.pages[].latest.pageErrors[].kind"exception" | "console" | "asset"
data.pages[].latest.pageErrors[].messagestring
data.pages[].latest.pageErrors[].sourcestring or null
data.pages[].latest.pageErrors[].ownboolean
data.pages[].latest.pageErrors[].countnumber
data.pages[].latest.badgeLinksobject[] or nulllinks on the page to our public status pages (an embedded badge, or a plain link); null when not looked for
data.pages[].latest.badgeLinks[].hrefstring
data.pages[].latest.badgeLinks[].relstringits rel tokens, "" when none
data.cacheobject or nullCloudflare cache over the last 24 hours, across the site's monitored pages
data.cache.pagesinteger
data.cache.okinteger
data.cache.hitsinteger
data.cache.leastobject or null
data.cache.least.pathstring
data.cache.least.okinteger
data.cache.least.hitsinteger
data.brokenLinksobject[]
data.brokenLinks[].pagestring
data.brokenLinks[].linksobject[]
data.brokenLinks[].links[].urlstring
data.brokenLinks[].links[].statusnumber or null
data.brokenLinks[].links[].errorstring or null
data.pageChecksobject or nullwhere people find no way forward: the pages the daily run reads, and one made-up path (latest day of the last 3)
data.pageChecks.daystring
data.pageChecks.pagesSeeninteger
data.pageChecks.pagesCheckedinteger
data.pageChecks.notFoundobject or nullthe answer to one made-up path; null when it didn't run
data.pageChecks.notFound.state"not_found" | "soft_404" | "login" | "redirect_off_host" | "blocked" | "error"
data.pageChecks.notFound.statusnumber or null
data.pageChecks.notFound.wayOnbooleana 404 or 410 that links anywhere on the site, or has a search form
data.pageChecks.notFound.unconfirmedbooleana bad answer a second made-up path didn't repeat
data.pageChecks.navOnlystring[]pages whose only links are the navigation
data.pageChecks.noWayBackobject[]pages with no link to their section
data.pageChecks.noWayBack[].pagestring
data.pageChecks.noWayBack[].parentstring
data.pageChecks.unclearLabelsinteger or nulllinks whose label says nothing alone (links hidden from assistive technology aren't counted); null when the pages' language isn't covered
data.apiChecksobject[]where agents find no way forward: up to three keyless GETs a day to the site's own API (latest day of the last 3)
data.apiChecks[].specstringthe OpenAPI file's URL
data.apiChecks[].daystring
data.apiChecks[].notCheckedstring or nullwhy nothing was probed (YAML, another host…)
data.apiChecks[].probesobject[]
data.apiChecks[].probes[].kind"not_found" | "unauthorized" | "list"
data.apiChecks[].probes[].urlstring
data.apiChecks[].probes[].state"answered" | "blocked" | "redirect" | "error"
data.apiChecks[].probes[].statusnumber or null
data.apiChecks[].probes[].recoversboolean or nullerrors: the body says how to recover
data.apiChecks[].probes[].pagingboolean or nulllists: a next link and a way to stop
next_stepsobject[] (optional)calls that usually come next ({method, path, why, tool})
next_steps[].methodstring (optional)
next_steps[].pathstring (optional)
next_steps[].whystring (optional)
next_steps[].toolstring (optional)the MCP tool that makes this call, for data routes
Response shape
{
  "data": {
    "readers": {
      "periodEnd": "…",
      "lcpP75": 0,
      "inpP75": 0,
      "clsP75": 0,
      "ttfbP75": 0
    },
    "pages": [
      {
        "url": "…",
        "latest": {
          "day": "…",
          "measuredAt": "2026-11-14T12:00:00.000Z",
          "ok": false,
          "error": "…",
          "htmlBytes": 0,
          "wireBytes": 0,
          "scripts": 0,
          "jsBytes": 0,
          "cssBytes": 0,
          "images": 0,
          "frameworkBytes": 0,
          "headers": {
            "grade": "…",
            "findings": [
              {
                "id": "…",
                "ok": false,
                "weight": 0,
                "detail": "…"
              }
            ]
          },
          "prefetches": {
            "requests": 0,
            "prefetches": 0,
            "pages": 0,
            "uncached": 0
          },
          "pageErrors": [
            {
              "kind": "exception",
              "message": "…",
              "source": "…",
              "own": false,
              "count": 0
            }
          ],
          "badgeLinks": [
            {
              "href": "…",
              "rel": "…"
            }
          ]
        }
      }
    ],
    "cache": {
      "pages": 0,
      "ok": 0,
      "hits": 0,
      "least": {
        "path": "…",
        "ok": 0,
        "hits": 0
      }
    },
    "brokenLinks": [
      {
        "page": "…",
        "links": [
          {
            "url": "…",
            "status": 0,
            "error": "…"
          }
        ]
      }
    ],
    "pageChecks": {
      "day": "…",
      "pagesSeen": 0,
      "pagesChecked": 0,
      "notFound": {
        "state": "not_found",
        "status": 0,
        "wayOn": false,
        "unconfirmed": false
      },
      "navOnly": [
        "…"
      ],
      "noWayBack": [
        {
          "page": "…",
          "parent": "…"
        }
      ],
      "unclearLabels": 0
    },
    "apiChecks": [
      {
        "spec": "…",
        "day": "…",
        "notChecked": "…",
        "probes": [
          {
            "kind": "not_found",
            "url": "…",
            "state": "answered",
            "status": 0,
            "recovers": false,
            "paging": false
          }
        ]
      }
    ]
  },
  "next_steps": [
    {
      "method": "…",
      "path": "…",
      "why": "…",
      "tool": "…"
    }
  ]
}

GET /api/sites/:slug/scans

One site's API recovery scans, newest first: state, how each ended, and findings by weight. Call this to see whether a site has been scanned for dead ends (API errors that don't say how to recover, lists without paging, pages nothing links to) and how the last scan came out. Scans are started from the dashboard by an admin or owner.

curl -H "Authorization: Bearer sm_…" https://sitesinthewoods.com/api/sites/SITE-SLUG/scans
ParameterInTypeMeaning
slugpathstringsite slug, as in /api/sites
limit optionalqueryinteger (default 20)page size, clamped to 1–100
offset optionalqueryinteger (default 0)rows to skip, at most 1000
Response fields (20)
FieldTypeMeaning
dataobject[]
data[].idstring
data[].state"quoting" | "quoted" | "queued" | "running" | "paused" | "done" | "stopped" | "failed"
data[].endingstring or nullhow it ended: complete, team_stopped, we_stopped, ownership_lost, plan_changed, site_removed, blocked, budget, error
data[].startedAtstring or nullISO 8601, UTC (…Z)
data[].finishedAtstring or nullISO 8601, UTC (…Z)
data[].kind"scan" | "rescan" | "rerun"
data[].findingsobject or null
data[].findings.highnumber
data[].findings.mediumnumber
data[].findings.lightnumber
data[].findings.warningnumber
limitintegerpage size used (1–100)
offsetintegerrows skipped
has_morebooleananother page follows
next_stepsobject[] (optional)calls that usually come next ({method, path, why, tool})
next_steps[].methodstring (optional)
next_steps[].pathstring (optional)
next_steps[].whystring (optional)
next_steps[].toolstring (optional)the MCP tool that makes this call, for data routes
Response shape
{
  "data": [
    {
      "id": "…",
      "state": "quoting",
      "ending": "…",
      "startedAt": "2026-11-14T12:00:00.000Z",
      "finishedAt": "2026-11-14T12:00:00.000Z",
      "kind": "scan",
      "findings": {
        "high": 0,
        "medium": 0,
        "light": 0,
        "warning": 0
      }
    }
  ],
  "limit": 0,
  "offset": 0,
  "has_more": false,
  "next_steps": [
    {
      "method": "…",
      "path": "…",
      "why": "…",
      "tool": "…"
    }
  ]
}

GET /api/sites/:slug/scans/:id

One API recovery scan: what it saw, its findings, the fixes and what changed since the last scan. Call this for a scan's results: findings by weight with the places on the site, three to five fixes in words and as a block for a coding agent, and new, fixed and still-open findings since the previous scan. It never includes text from the scanned site.

curl -H "Authorization: Bearer sm_…" https://sitesinthewoods.com/api/sites/SITE-SLUG/scans/INCIDENT-ID
ParameterInTypeMeaning
slugpathstringsite slug, as in /api/sites
idpathstringscan id, as in /api/sites/{slug}/scans
Response fields (35)
FieldTypeMeaning
dataobject
data.idstring
data.state"quoting" | "quoted" | "queued" | "running" | "paused" | "done" | "stopped" | "failed"
data.endingstring or nullhow it ended: complete, team_stopped, we_stopped, ownership_lost, plan_changed, site_removed, blocked, budget, error
data.startedAtstring or nullISO 8601, UTC (…Z)
data.finishedAtstring or nullISO 8601, UTC (…Z)
data.kind"scan" | "rescan" | "rerun"
data.findingsobject or null
data.findings.highnumber
data.findings.mediumnumber
data.findings.lightnumber
data.findings.warningnumber
data.seenobject or nullpaths probed, pages read, requests…
data.itemsobject[]
data.items[].checkstring
data.items[].weight"high" | "medium" | "light" | "warning"
data.items[].countnumber
data.items[].placesstring[]up to 50 paths on the site
data.fixesobject[]
data.fixes[].titlestring
data.fixes[].textstring
data.fixes[].placesstring[]
data.fixes[].morenumber
data.agentBlockstring or nullthe fixes for a coding agent, written by our code: no text from the site
data.compareobject or null
data.compare.previousstring
data.compare.fixednumber
data.compare.addednumber
data.compare.opennumber
data.compare.notCheckednumber
next_stepsobject[] (optional)calls that usually come next ({method, path, why, tool})
next_steps[].methodstring (optional)
next_steps[].pathstring (optional)
next_steps[].whystring (optional)
next_steps[].toolstring (optional)the MCP tool that makes this call, for data routes
Response shape
{
  "data": {
    "id": "…",
    "state": "quoting",
    "ending": "…",
    "startedAt": "2026-11-14T12:00:00.000Z",
    "finishedAt": "2026-11-14T12:00:00.000Z",
    "kind": "scan",
    "findings": {
      "high": 0,
      "medium": 0,
      "light": 0,
      "warning": 0
    },
    "seen": {},
    "items": [
      {
        "check": "…",
        "weight": "high",
        "count": 0,
        "places": [
          "…"
        ]
      }
    ],
    "fixes": [
      {
        "title": "…",
        "text": "…",
        "places": [
          "…"
        ],
        "more": 0
      }
    ],
    "agentBlock": "…",
    "compare": {
      "previous": "…",
      "fixed": 0,
      "added": 0,
      "open": 0,
      "notChecked": 0
    }
  },
  "next_steps": [
    {
      "method": "…",
      "path": "…",
      "why": "…",
      "tool": "…"
    }
  ]
}

GET /api/sites/:slug/maintenance

One site's maintenance windows: on now, scheduled, and the last 30 days. Call this to see whether a site is in a maintenance window (its alerts held, its uptime not counting that time) and when the next one is. Windows are started from the dashboard or a deploy calling the site's maintenance URL (POST <url>/start?minutes=30, POST <url>/end), which the dashboard shows to admins.

curl -H "Authorization: Bearer sm_…" https://sitesinthewoods.com/api/sites/SITE-SLUG/maintenance
ParameterInTypeMeaning
slugpathstringsite slug, as in /api/sites
Response fields (14)
FieldTypeMeaning
dataobject
data.windowsobject[]newest start first
data.windows[].startsAtstring
data.windows[].endsAtstringat most 24 hours after startsAt; an early end shows here
data.windows[].state"scheduled" | "on" | "ended"
data.windows[].scope"site" | "project"this site only, or every site in its project
data.windows[].reasonstring or nullthe team's own words; never on the public page
data.windows[].createdBystringa person, or "maintenance URL"
data.windows[].endedBystring or nullwho ended it early; null when it ran its course
next_stepsobject[] (optional)calls that usually come next ({method, path, why, tool})
next_steps[].methodstring (optional)
next_steps[].pathstring (optional)
next_steps[].whystring (optional)
next_steps[].toolstring (optional)the MCP tool that makes this call, for data routes
Response shape
{
  "data": {
    "windows": [
      {
        "startsAt": "…",
        "endsAt": "…",
        "state": "scheduled",
        "scope": "site",
        "reason": "…",
        "createdBy": "…",
        "endedBy": "…"
      }
    ]
  },
  "next_steps": [
    {
      "method": "…",
      "path": "…",
      "why": "…",
      "tool": "…"
    }
  ]
}

GET /api/sites/:slug/map

One site's structure from its sitemaps: sections, new and removed pages, what fails. Call this to see where a site is changing or breaking without crawling it: every path with pages under it, with new and removed pages in the window, pages that fail, broken links and sitemaps that miss pages. Add ?section= for one section's pages. Our sites only (competitors' sitemaps aren't read).

curl -H "Authorization: Bearer sm_…" https://sitesinthewoods.com/api/sites/SITE-SLUG/map
ParameterInTypeMeaning
slugpathstringsite slug, as in /api/sites
range optionalquery"24h" | "7d" | "30d" (default "7d")the window for new and removed pages
section optionalquerystringa section path such as "/c" to list its pages
Response fields (49)
FieldTypeMeaning
dataobject
data.rangestring
data.sitemapsstring[]
data.firstFetchAtstring or nullpages listed then count as there from the start, never as new
data.pagesnumber
data.newInWindownumber
data.removedInWindownumber
data.checkednumberpages the monitor checks itself; the rest are known from the sitemap
data.linkCheckednumber or nulllisted URLs link-checked in the last 7 days, when every sitemap URL is checked
data.historyobject[]the whole site's days in the window (at least two), oldest first; kept 400 days, since monitoring began
data.history[].daystringYYYY-MM-DD, a UTC day
data.history[].pagesnumberpages listed at the day's end
data.history[].newnumber
data.history[].removednumber
data.sectionsobject[]every path with pages under it, largest first within each level; a lone page such as /about is a page, not a section
data.sections[].pathstring"/c/alaska-news" (no trailing slash)
data.sections[].depthnumber1 for a top-level section
data.sections[].pagesnumberlive pages at or under this path
data.sections[].newInWindownumberfirst seen in the window (not in the sitemap's first fetch)
data.sections[].removedInWindownumberdropped from every sitemap in the window (removed pages are kept 30 days)
data.sections[].neweststring or nullnewest page's content date, else first seen
data.sections[].tone"up" | "warn" | "down"up: no known problem; warn: warnings or more than 20% removed; down: a page fails
data.sections[].failingnumberlisted URLs that fail
data.sections[].brokenLinkPagesnumberpages with an open broken-links incident
data.sections[].checkednumberpages the monitor checks itself
data.sections[].missingFromobject[]sitemaps that list at least half the pages here but miss some, and how many they miss
data.sections[].missingFrom[].sitemapstring
data.sections[].missingFrom[].countnumber
data.sections[].historyobject[] or nulla top-level section's days in the window, oldest first; null below the top level
data.sections[].history[].daystringYYYY-MM-DD, a UTC day
data.sections[].history[].pagesnumberpages listed at the day's end
data.sections[].history[].newnumber
data.sections[].history[].removednumber
data.pagesShownobject[] or nullwith ?section=: that section's pages, newest first, at most 1000
data.pagesShown[].urlstring
data.pagesShown[].pathstring
data.pagesShown[].titlestring or null
data.pagesShown[].datestringcontent date (published, created, last modified), else first seen
data.pagesShown[].isNewboolean
data.pagesShown[].checkedboolean
data.pagesShown[].tone"up" | "warn" | "down"
data.pagesShown[].failsboolean
data.pagesShown[].hasBrokenLinksboolean
data.pagesShown[].missingFromstring[]
next_stepsobject[] (optional)calls that usually come next ({method, path, why, tool})
next_steps[].methodstring (optional)
next_steps[].pathstring (optional)
next_steps[].whystring (optional)
next_steps[].toolstring (optional)the MCP tool that makes this call, for data routes
Response shape
{
  "data": {
    "range": "…",
    "sitemaps": [
      "…"
    ],
    "firstFetchAt": "…",
    "pages": 0,
    "newInWindow": 0,
    "removedInWindow": 0,
    "checked": 0,
    "linkChecked": 0,
    "history": [
      {
        "day": "…",
        "pages": 0,
        "new": 0,
        "removed": 0
      }
    ],
    "sections": [
      {
        "path": "…",
        "depth": 0,
        "pages": 0,
        "newInWindow": 0,
        "removedInWindow": 0,
        "newest": "…",
        "tone": "up",
        "failing": 0,
        "brokenLinkPages": 0,
        "checked": 0,
        "missingFrom": [
          {
            "sitemap": "…",
            "count": 0
          }
        ],
        "history": [
          {
            "day": "…",
            "pages": 0,
            "new": 0,
            "removed": 0
          }
        ]
      }
    ],
    "pagesShown": [
      {
        "url": "…",
        "path": "…",
        "title": "…",
        "date": "…",
        "isNew": false,
        "checked": false,
        "tone": "up",
        "fails": false,
        "hasBrokenLinks": false,
        "missingFrom": [
          "…"
        ]
      }
    ]
  },
  "next_steps": [
    {
      "method": "…",
      "path": "…",
      "why": "…",
      "tool": "…"
    }
  ]
}

GET /api/sites/:slug/events

What changed on one site: incidents opened and resolved, code pushes, maintenance, new pages. Call this to find what changed before a number moved (clicks fell, pages got slower): the site's timeline, newest first, the same events the dashboard draws on its charts. Page through with limit and offset.

curl -H "Authorization: Bearer sm_…" https://sitesinthewoods.com/api/sites/SITE-SLUG/events
ParameterInTypeMeaning
slugpathstringsite slug, as in /api/sites
range optionalquery"24h" | "7d" | "30d" (default "7d")the window
limit optionalqueryinteger (default 50)page size, clamped to 1–200
offset optionalqueryinteger (default 0)rows to skip, at most 1000
Response fields (22)
FieldTypeMeaning
dataobject[]
data[].idstringstable id: <source>:<row id>[:resolved]
data[].atstringISO 8601, UTC (…Z)
data[].kind"incident" | "resolved" | "push" | "maintenance" | "paused" | "resumed" | "published"
data[].incidentKindstring (optional)for incident and resolved events, as in /api/incidents
data[].tone"down" | "warning" | "change"a problem in its severity, or a change
data[].glyph"problem" | "search" | "config" | "push" | "published" | "paused"what kind of change: drawn as the chart rail's shape
data[].labelstringone line in our words; for a push, its commit's first line
data[].detailstring or null (optional)an incident's cause, a push's repo and author, a window's reason
data[].beforestring (optional)
data[].afterstring (optional)
data[].hrefstring (optional)the commit, or the incident on the dashboard
data[].targetIdstring or null (optional)
data[].untilstring (optional)a maintenance window's end
limitintegerpage size used (1–100)
offsetintegerrows skipped
has_morebooleananother page follows
next_stepsobject[] (optional)calls that usually come next ({method, path, why, tool})
next_steps[].methodstring (optional)
next_steps[].pathstring (optional)
next_steps[].whystring (optional)
next_steps[].toolstring (optional)the MCP tool that makes this call, for data routes
Response shape
{
  "data": [
    {
      "id": "…",
      "at": "2026-11-14T12:00:00.000Z",
      "kind": "incident",
      "incidentKind": "…",
      "tone": "down",
      "glyph": "problem",
      "label": "…",
      "detail": "…",
      "before": "…",
      "after": "…",
      "href": "…",
      "targetId": "…",
      "until": "…"
    }
  ],
  "limit": 0,
  "offset": 0,
  "has_more": false,
  "next_steps": [
    {
      "method": "…",
      "path": "…",
      "why": "…",
      "tool": "…"
    }
  ]
}

GET /api/incidents

Incidents, open now or recent; open outages and slowdowns carry the likely cause. Call this to see what went wrong and why: open and recent incidents, newest first, with the likely cause on open outages and slowdowns. Page through with limit and offset.

curl -H "Authorization: Bearer sm_…" https://sitesinthewoods.com/api/incidents
ParameterInTypeMeaning
state optionalquery"open" | "recent" (default "open")open: open now; recent: newest first, open or closed
site optionalquerystringsite slug
limit optionalqueryinteger (default 20)page size, clamped to 1–100
offset optionalqueryinteger (default 0)rows to skip, at most 1000
Response fields (26)
FieldTypeMeaning
dataobject[]
data[].idstring
data[].kindstring
data[].labelstring
data[].severity"down" | "warning"
data[].sitestring or nullsite slug
data[].urlstring or nullthe page or file it's about
data[].domainstring or null
data[].startedAtstringISO 8601, UTC (…Z)
data[].resolvedAtstring or nullISO 8601, UTC (…Z)
data[].causestring or null
data[].detailsobject
data[].dismissedobject or nullthe team marked it as noise: still open, never alerts again
data[].dismissed.bystring
data[].dismissed.atstringISO 8601, UTC (…Z)
data[].likelyCauseobject or null (optional)open outages and slowdowns only: the monitor's rules, as in the alert
data[].likelyCause.likelystring or null
data[].likelyCause.cluesstring[]
limitintegerpage size used (1–100)
offsetintegerrows skipped
has_morebooleananother page follows
next_stepsobject[] (optional)calls that usually come next ({method, path, why, tool})
next_steps[].methodstring (optional)
next_steps[].pathstring (optional)
next_steps[].whystring (optional)
next_steps[].toolstring (optional)the MCP tool that makes this call, for data routes
Response shape
{
  "data": [
    {
      "id": "…",
      "kind": "…",
      "label": "…",
      "severity": "down",
      "site": "…",
      "url": "…",
      "domain": "…",
      "startedAt": "2026-11-14T12:00:00.000Z",
      "resolvedAt": "2026-11-14T12:00:00.000Z",
      "cause": "…",
      "details": {},
      "dismissed": {
        "by": "…",
        "at": "2026-11-14T12:00:00.000Z"
      },
      "likelyCause": {
        "likely": "…",
        "clues": [
          "…"
        ]
      }
    }
  ],
  "limit": 0,
  "offset": 0,
  "has_more": false,
  "next_steps": [
    {
      "method": "…",
      "path": "…",
      "why": "…",
      "tool": "…"
    }
  ]
}

GET /api/domains

The team's domains: registration expiry, registrar, nameservers, status. Call this to check renewals: which domains expire soon, who the registrar is, and whether nameservers or registry locks changed.

curl -H "Authorization: Bearer sm_…" https://sitesinthewoods.com/api/domains
Response fields (14)
FieldTypeMeaning
dataobject[]
data[].namestring
data[].expiresAtstring or nullISO 8601, UTC (…Z)
data[].daysLeftnumber or null
data[].registrarstring or null
data[].nameserversstring[]
data[].statusFlagsstring[]
data[].lastCheckedAtstring or nullISO 8601, UTC (…Z)
data[].sitesstring[]
next_stepsobject[] (optional)calls that usually come next ({method, path, why, tool})
next_steps[].methodstring (optional)
next_steps[].pathstring (optional)
next_steps[].whystring (optional)
next_steps[].toolstring (optional)the MCP tool that makes this call, for data routes
Response shape
{
  "data": [
    {
      "name": "…",
      "expiresAt": "2026-11-14T12:00:00.000Z",
      "daysLeft": 0,
      "registrar": "…",
      "nameservers": [
        "…"
      ],
      "statusFlags": [
        "…"
      ],
      "lastCheckedAt": "2026-11-14T12:00:00.000Z",
      "sites": [
        "…"
      ]
    }
  ],
  "next_steps": [
    {
      "method": "…",
      "path": "…",
      "why": "…",
      "tool": "…"
    }
  ]
}

POST /api/incidents/:id/dismiss

Dismiss an open incident as noise. Hides it from the open lists for the whole team; it never alerts again and closes without a message. Not every kind can be dismissed (409). Needs a Member or Admin key, on a team with 10 sites or more.

curl -X POST -H "Authorization: Bearer sm_…" https://sitesinthewoods.com/api/incidents/INCIDENT-ID/dismiss
ParameterInTypeMeaning
idpathstringincident id, as in /api/incidents
Response fields (11)
FieldTypeMeaning
dataobject
data.idstring
data.kindstring
data.sitestring or nullits site's slug
data.dismissedboolean
data.recheckRequestedboolean
next_stepsobject[] (optional)calls that usually come next ({method, path, why, tool})
next_steps[].methodstring (optional)
next_steps[].pathstring (optional)
next_steps[].whystring (optional)
next_steps[].toolstring (optional)the MCP tool that makes this call, for data routes
Response shape
{
  "data": {
    "id": "…",
    "kind": "…",
    "site": "…",
    "dismissed": false,
    "recheckRequested": false
  },
  "next_steps": [
    {
      "method": "…",
      "path": "…",
      "why": "…",
      "tool": "…"
    }
  ]
}

POST /api/incidents/:id/undismiss

Bring back a dismissed incident. Undoes a dismiss: the incident shows and alerts again. Needs a Member or Admin key, on a team with 10 sites or more.

curl -X POST -H "Authorization: Bearer sm_…" https://sitesinthewoods.com/api/incidents/INCIDENT-ID/undismiss
ParameterInTypeMeaning
idpathstringincident id, as in /api/incidents
Response fields (11)
FieldTypeMeaning
dataobject
data.idstring
data.kindstring
data.sitestring or nullits site's slug
data.dismissedboolean
data.recheckRequestedboolean
next_stepsobject[] (optional)calls that usually come next ({method, path, why, tool})
next_steps[].methodstring (optional)
next_steps[].pathstring (optional)
next_steps[].whystring (optional)
next_steps[].toolstring (optional)the MCP tool that makes this call, for data routes
Response shape
{
  "data": {
    "id": "…",
    "kind": "…",
    "site": "…",
    "dismissed": false,
    "recheckRequested": false
  },
  "next_steps": [
    {
      "method": "…",
      "path": "…",
      "why": "…",
      "tool": "…"
    }
  ]
}

POST /api/incidents/:id/recheck

Check an incident again now. The monitor checks it again within 30 seconds, after a fix, instead of waiting for the next scheduled check. Not every kind can be checked again (409). Needs a Member or Admin key, on a team with 10 sites or more.

curl -X POST -H "Authorization: Bearer sm_…" https://sitesinthewoods.com/api/incidents/INCIDENT-ID/recheck
ParameterInTypeMeaning
idpathstringincident id, as in /api/incidents
Response fields (11)
FieldTypeMeaning
dataobject
data.idstring
data.kindstring
data.sitestring or nullits site's slug
data.dismissedboolean
data.recheckRequestedboolean
next_stepsobject[] (optional)calls that usually come next ({method, path, why, tool})
next_steps[].methodstring (optional)
next_steps[].pathstring (optional)
next_steps[].whystring (optional)
next_steps[].toolstring (optional)the MCP tool that makes this call, for data routes
Response shape
{
  "data": {
    "id": "…",
    "kind": "…",
    "site": "…",
    "dismissed": false,
    "recheckRequested": false
  },
  "next_steps": [
    {
      "method": "…",
      "path": "…",
      "why": "…",
      "tool": "…"
    }
  ]
}

POST /api/sites/:slug/maintenance/start

Start a maintenance window on a site now. Call this before a deploy: alerts for the site are held (checks still run) until the window ends, after `minutes` (default 30, at most 24 hours) or when you end it. Starting again replaces the open window. Needs a Member or Admin key, on a team with 10 sites or more.

curl -X POST -H "Authorization: Bearer sm_…" -H "content-type: application/json" -d '{"minutes":30,"reason":"deploy"}' https://sitesinthewoods.com/api/sites/SITE-SLUG/maintenance/start
ParameterInTypeMeaning
slugpathstringsite slug, as in /api/sites
minutes optionalbodyintegerhow long, default 30
reason optionalbodystringthe team's own words; never public
Response fields (10)
FieldTypeMeaning
dataobject
data.idstring
data.startsAtstringISO 8601, UTC (…Z)
data.endsAtstringISO 8601, UTC (…Z)
data.reasonstring or null
next_stepsobject[] (optional)calls that usually come next ({method, path, why, tool})
next_steps[].methodstring (optional)
next_steps[].pathstring (optional)
next_steps[].whystring (optional)
next_steps[].toolstring (optional)the MCP tool that makes this call, for data routes
Response shape
{
  "data": {
    "id": "…",
    "startsAt": "2026-11-14T12:00:00.000Z",
    "endsAt": "2026-11-14T12:00:00.000Z",
    "reason": "…"
  },
  "next_steps": [
    {
      "method": "…",
      "path": "…",
      "why": "…",
      "tool": "…"
    }
  ]
}

POST /api/sites/:slug/maintenance/end

End a site's maintenance windows now. Call this after a deploy: alerts for the site go out again from now. Ending with no window on answers `ended: 0`. Needs a Member or Admin key, on a team with 10 sites or more.

curl -X POST -H "Authorization: Bearer sm_…" https://sitesinthewoods.com/api/sites/SITE-SLUG/maintenance/end
ParameterInTypeMeaning
slugpathstringsite slug, as in /api/sites
Response fields (7)
FieldTypeMeaning
dataobject
data.endedintegerwindows ended
next_stepsobject[] (optional)calls that usually come next ({method, path, why, tool})
next_steps[].methodstring (optional)
next_steps[].pathstring (optional)
next_steps[].whystring (optional)
next_steps[].toolstring (optional)the MCP tool that makes this call, for data routes
Response shape
{
  "data": {
    "ended": 0
  },
  "next_steps": [
    {
      "method": "…",
      "path": "…",
      "why": "…",
      "tool": "…"
    }
  ]
}

POST /api/sites/:slug/pause

Pause a site's checks. Stops every check of the site, keeping its history, until it's resumed. Nothing alerts while it's paused. Needs an Admin key, on a team with 10 sites or more.

curl -X POST -H "Authorization: Bearer sm_…" https://sitesinthewoods.com/api/sites/SITE-SLUG/pause
ParameterInTypeMeaning
slugpathstringsite slug, as in /api/sites
Response fields (8)
FieldTypeMeaning
dataobject
data.slugstring
data.pausedboolean
next_stepsobject[] (optional)calls that usually come next ({method, path, why, tool})
next_steps[].methodstring (optional)
next_steps[].pathstring (optional)
next_steps[].whystring (optional)
next_steps[].toolstring (optional)the MCP tool that makes this call, for data routes
Response shape
{
  "data": {
    "slug": "…",
    "paused": false
  },
  "next_steps": [
    {
      "method": "…",
      "path": "…",
      "why": "…",
      "tool": "…"
    }
  ]
}

POST /api/sites/:slug/resume

Resume a paused site's checks. Starts the site's checks again within a minute. Needs an Admin key, on a team with 10 sites or more.

curl -X POST -H "Authorization: Bearer sm_…" https://sitesinthewoods.com/api/sites/SITE-SLUG/resume
ParameterInTypeMeaning
slugpathstringsite slug, as in /api/sites
Response fields (8)
FieldTypeMeaning
dataobject
data.slugstring
data.pausedboolean
next_stepsobject[] (optional)calls that usually come next ({method, path, why, tool})
next_steps[].methodstring (optional)
next_steps[].pathstring (optional)
next_steps[].whystring (optional)
next_steps[].toolstring (optional)the MCP tool that makes this call, for data routes
Response shape
{
  "data": {
    "slug": "…",
    "paused": false
  },
  "next_steps": [
    {
      "method": "…",
      "path": "…",
      "why": "…",
      "tool": "…"
    }
  ]
}

Generated from the same route table as the OpenAPI doc, so the two always agree.