What you unlock
Uptime monitoring
List monitors, check availability, view response times, and manage heartbeats from chat.
Incident management
Create, acknowledge, escalate, and resolve incidents. Add comments and track timelines.
On-call scheduling
View on-call schedules, manage escalation policies, and check who’s currently on call.
Status pages
Manage status pages, publish incident reports, and keep your users informed about service health.
Connect Better Stack
Open Settings → Integrations
In any workspace go to Settings → Integrations and select Better Stack.
Get your API key
Log in at betterstack.com, go to your account settings, and copy your API token.
Agent tools
Any agent in your workspace can use Better Stack tools once an API key is connected.Monitors & Heartbeats
| Tool | Description |
|---|---|
| List monitors | List all uptime monitors |
| Get monitor | Retrieve details of a specific monitor |
| Create monitor | Create a new uptime monitor |
| Get availability | Check a monitor’s availability percentage |
| Get response times | View response time data for a monitor |
| List heartbeats | List all heartbeat monitors |
| Get heartbeat | Check the status of a heartbeat monitor |
Incidents
| Tool | Description |
|---|---|
| List incidents | List all incidents with status filters |
| Create incident | Create a new incident manually |
| Acknowledge incident | Mark an incident as acknowledged |
| Resolve incident | Resolve an open incident |
| Escalate incident | Escalate an incident to the next responder |
| Add incident comment | Post a comment on an incident timeline |
On-Call & Escalation
| Tool | Description |
|---|---|
| List on-call schedules | View all on-call schedules |
| Get on-call schedule | Retrieve details of a specific schedule |
| List escalation policies | View all escalation policies |
| Get escalation policy | Retrieve details of a specific policy |
Status Pages
| Tool | Description |
|---|---|
| List status pages | List all status pages |
| Get status page | Retrieve status page details and resources |
| Create status report | Publish an incident report on a status page |
| Create status update | Add a status update to an existing report |
Triggers
Automated triggers for Better Stack are not yet available. Triggers will be added in a future update — check back
soon.
Example use cases
Quick uptime check from chat
Quick uptime check from chat
Ask “Is our API up?” and the agent checks the relevant monitors, returns availability percentages and response
times, and flags any active incidents.
Incident response from Mantle
Incident response from Mantle
When an alert fires, use your agent to acknowledge the incident, post an update to the status page, and escalate to
the on-call engineer — all from a single chat conversation.
Weekly reliability report
Weekly reliability report
An agent fetches uptime percentages, incident counts, and mean time to resolution for the past week, then posts a
formatted summary to your #engineering channel.
Troubleshooting
My API key isn't working
My API key isn't working
Verify the token was copied from your Better Stack account settings. Make sure the token has access to both the
Uptime and Logs products if you need both.
Monitors not showing up
Monitors not showing up
Check that the API token belongs to the team that owns the monitors. Better Stack API tokens are scoped to a
specific team — monitors from other teams won’t appear.
Incident actions fail
Incident actions fail
Some incident actions (acknowledge, resolve, escalate) require specific permissions. Verify the API token has write
access and the incident is in a state that allows the action.
Status page updates aren't visible
Status page updates aren't visible
Updates may take a moment to propagate to your public status page. Verify the status page is published and the
report is associated with the correct status page.
Back to Integrations
View all available integrations