Connection
- Authentication: API key (Uptime API token).
Sign in at betterstack.com → Settings → API tokens → Team-based tokens → select your team → create a Uptime API token. Copy the token.See Better Stack’s documentation.
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Connect Better Stack to your Atako agents — 10 read and 6 write actions.
| Action | Description |
|---|---|
get_incident | Retrieve a single incident by its ID. |
get_monitor | Retrieve a single monitor by its ID. |
get_monitor_availability | Get availability summary (SLA) for a monitor. Optionally filter by date range with from/to (YYYY-MM-DD). Values for total_downtime, longest_incident, and average_incident are in seconds. |
get_monitor_response_times | Get response times for a monitor over the last 24 hours, grouped by region. |
list_heartbeats | List all heartbeats (cron / scheduled job monitors). |
list_incidents | List all incidents. Supports pagination (max 50 per page). Filter by date range (from/to YYYY-MM-DD), monitor_id, heartbeat_id, resolved, or acknowledged. |
list_monitor_groups | List all monitor groups. |
list_monitors | List all monitors. Returns a paginated list of monitors with their status, URL, name, check frequency, and regions. |
list_status_page_reports | List all reports (incidents / maintenance) on a status page. |
list_status_pages | List all status pages. |
| Action | Description |
|---|---|
acknowledge_incident | Acknowledge an ongoing incident to prevent further escalations. Body: { acknowledged_by: string } — user email or custom identifier (string, not an object). incident_id is a string (the incident ID). |
create_monitor | Create a new uptime monitor. monitor_type: enum string (status, expected_status_code, keyword, keyword_absence, ping, tcp, udp, smtp, pop, imap, dns, playwright). url: string (the URL or host to monitor). pronounceable_name: string (human-readable name). check_frequency: integer in seconds (minimum 30). regions: array of enum strings (us, eu, as, au) or subset. email: optional boolean (send email alerts). push: optional boolean (send push notification to on-call). Do NOT pass call or sms (not exposed). |
create_status_page_report | Create a status page report (incident or maintenance). Body: title: string (report title), message: string (first status update message), report_type: string enum (“manual” or “maintenance”, default “manual”), affected_resources: array of objects (each with status_page_resource_id: string and status: string enum “resolved”/“degraded”/“downtime”/“maintenance”). status_page_id is a string (the status page ID). |
pause_monitor | Pause a monitor. Sends body { paused: true }. The monitor_id is a string (the monitor ID). |
resolve_incident | Resolve an ongoing incident. Body: { resolved_by: string } — user email or custom identifier (string, not an object). incident_id is a string (the incident ID). |
resume_monitor | Resume a paused monitor. Sends body { paused: false }. The monitor_id is a string (the monitor ID). |