Better Uptime
What is Better Uptime?
System Status
Search…
Getting started
Frequently Asked Questions
🔭
Monitoring
Getting started
Working with monitors
Customizing monitors
Monitor types
📯
On-call scheduling and alering
Creating on-call rotation schedules
How on-call schedules work
Escalation policies
Urgencies
☎
Incidents
Working with incidents
Creating incidents manually
Postmortems
🖼
Status pages
Custom sub-domain: status.yourdomain.com
Working with status pages
Customizing status pages
⚙
Team and account management
Team management
Account settings
📟
API
Getting started
Monitors API
Escalation Policies API
Monitor Groups API
Heartbeats API
Heartbeat Groups API
Incidents API
Status Pages API
Status Page Sections API
Status Page Resources API
Status Page Reports API
Status Page Report Updates API
Metadata API
On-call Calendar API
🔗
Integrations
Slack
Zapier
Microsoft Teams
Webhooks
Google Cloud
AWS
New Relic
Prometheus
Zabbix
Grafana
Datadog
Powered By
GitBook
Heartbeats API
Manage your heartbeats using simple HTTP API.
Do you need help with the integration?
Let us know at
[email protected]
e.com
.
Obtaining an API token
Please, see
Obtaining an API token
.
get
https://betteruptime.com
/api/v2/heartbeats
Listing all existing heartbeats
Example cURL
1
curl
--request GET
\
2
--url https://betteruptime.com/api/v2/heartbeats
\
3
--header
'Authorization: Bearer YOUR_API_TOKEN'
Copied!
get
https://betteruptime.com
/api/v2/heartbeats/:heartbeat_id
Getting a single heartbeat
Example cURL
1
curl
--request GET
\
2
--url https://betteruptime.com/api/v2/heartbeats/12345
\
3
--header
'Authorization: Bearer YOUR_API_TOKEN'
Copied!
post
https://betteruptime.com
/api/v2/heartbeats
Creating a heartbeat
Example cURL
1
curl
--request POST
\
2
--url https://betteruptime.com/api/v2/heartbeats
\
3
--header
'Authorization: Bearer YOUR_API_TOKEN'
\
4
--header
'Content-Type: application/json'
\
5
--data
'{
6
"name": "Testing heartbeat",
7
"period": 10800,
8
"grace": 300
9
}'
Copied!
patch
https://betteruptime.com
/api/v2/heartbeats/:heartbeat_id
Updating an existing endpoint
Example cURL
1
curl
--request PATCH
\
2
--url https://betteruptime.com/api/v2/heartbeats/12345
\
3
--header
'Authorization: Bearer YOUR_API_TOKEN'
\
4
--header
'Content-Type: application/json'
\
5
--data
'{
6
"name": "Testing heartbeat, with an update"
7
}'
Copied!
delete
https://betteruptime.com
/api/v2/heartbeats/:heartbeat_id
Deleting an existing heartbeat
Example cURL
1
curl
--request DELETE
\
2
--url https://betteruptime.com/api/v2/heartbeats/12345
\
3
--header
'Authorization: Bearer YOUR_API_TOKEN'
Copied!
API - Previous
Monitor Groups API
Next - API
Heartbeat Groups API
Last modified
2mo ago
Copy link
Contents
Obtaining an API token
get
Listing all existing heartbeats
get
Getting a single heartbeat
post
Creating a heartbeat
patch
Updating an existing endpoint
delete
Deleting an existing heartbeat