EvoHub Docs Sign in

Uptime API › Monitors

List monitors that need attention

Use with AI
View as MarkdownThis page as plain text, for pasting into an AI tool Open in ClaudeAsk Claude questions about this page Open in ChatGPTAsk ChatGPT questions about this page
Connect to Cursor / VS Code / ClaudeSearch and read these docs from your AI tool (MCP server)

MCP server URL

https://docs-dev.evohub.io/mcp

Add to CursorAdd to VS Code

Claude Code

claude mcp add --transport http evohub-docs-docs https://docs-dev.evohub.io/mcp

Claude (claude.ai and Claude Desktop): Settings → Connectors → Add custom connector, and paste the URL above.

Claude Desktop — claude_desktop_config.json

{
  "mcpServers": {
    "evohub-docs-docs": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://docs-dev.evohub.io/mcp"
      ]
    }
  }
}

Cursor — ~/.cursor/mcp.json

{
  "mcpServers": {
    "evohub-docs-docs": {
      "url": "https://docs-dev.evohub.io/mcp"
    }
  }
}

VS Code — .vscode/mcp.json

{
  "servers": {
    "evohub-docs-docs": {
      "type": "http",
      "url": "https://docs-dev.evohub.io/mcp"
    }
  }
}

llms.txtllms-full.txt

GET/api/v1/monitors/attention

The caller's active monitors that are down or degraded: down ones first, then by how long they have been in that state, oldest first. since is when the monitor went down (from its open outage) or when its slow alert was raised.

incident_id and cause are filled for a down monitor with an open outage, and only when the caller also holds uptime:incident:read; otherwise they are null.

Requires the uptime:monitor:read scope.

Authorization

Any one of:

Parameters

Query parameters

  • team_id string
    Narrow to one team's monitors, or none for only the organization-wide ones. It never widens what the caller can see.
    Example: none
  • limit integer
    How many monitors to return. Values above 100 are read as 100.
    Default: 20 · Minimum: 1 · Maximum: 100

Responses

200

The monitors needing attention; an empty list when all is well.

Content type: application/json

Type: object

  • data array of AttentionMonitor
    Show AttentionMonitor properties
    • id string required
    • name string required
    • last_status string required
      One of: down degraded
    • since string (date-time) | null required
    • incident_id string | null required
    • cause string | null required

400

limit is not a positive integer (INVALID_LIMIT).

Content type: application/json

Type: Error

  • error object required
    • code string required
      Example: MONITOR_NOT_FOUND
    • message string required
      Example: monitor not found
    • request_id string

401

No API key was sent, or it is unknown, revoked or expired (UNAUTHORIZED).

Content type: application/json

Type: Error

  • error object required
    • code string required
      Example: MONITOR_NOT_FOUND
    • message string required
      Example: monitor not found
    • request_id string

403

The key lacks the scope this endpoint needs (FORBIDDEN).

Content type: application/json

Type: Error

  • error object required
    • code string required
      Example: MONITOR_NOT_FOUND
    • message string required
      Example: monitor not found
    • request_id string

429

Too many requests (RATE_LIMITED). Wait for Retry-After seconds.

Headers

  • Retry-After integer
    Seconds to wait before retrying.

Content type: application/json

Type: Error

  • error object required
    • code string required
      Example: MONITOR_NOT_FOUND
    • message string required
      Example: monitor not found
    • request_id string

500

Something went wrong on EvoHub's side (INTERNAL_ERROR). Retry later.

Content type: application/json

Type: Error

  • error object required
    • code string required
      Example: MONITOR_NOT_FOUND
    • message string required
      Example: monitor not found
    • request_id string

Example request

curl -X GET 'https://evohub.io/api/v1/monitors/attention' \
  -H 'Authorization: Bearer <TOKEN>'

Last updated