Better Stack

Better Stack integration (Developer Tools). Imported from open-connector.

API key7 toolshttps://uptime.betterstack.com

GET

better_stack_list_incidents

List Better Stack incidents with optional date and status filters.

/api/v3/incidents

9 parameters

Param	Type	Required	Description
team_name	string	optional	Team name used when a global Better Stack API token needs explicit team scoping.
from	string	optional	Only return incidents on or after this date.
to	string	optional	Only return incidents on or before this date.
monitor_id	integer	optional	Only return incidents for this monitor ID.
heartbeat_id	integer	optional	Only return incidents for this heartbeat ID.
resolved	boolean	optional	Whether to return resolved incidents only or unresolved incidents only.
acknowledged	boolean	optional	Whether to return acknowledged incidents only or unacknowledged incidents only.
page	integer	optional	Page number to return.
per_page	integer	optional	Number of incidents to return per page. Better Stack incident lists allow up to…

GET

better_stack_get_incident

Get a Better Stack incident by ID with included resource context when available.

/api/v3/incidents/{incident_id}

1 parameter

Param	Type	Required	Description
incident_id	string	required	The Better Stack incident ID.

POST

better_stack_create_incident

Create a Better Stack incident and alert the current on-call responder.

/api/v3/incidents

12 parameters

Param	Type	Required	Description
team_name	string	optional	Team name used when a global Better Stack API token needs explicit team scoping.
requester_email	string	optional	Email address of the requester that opened the incident.
name	string	optional	Short incident name.
summary	string	required	Brief summary of the incident.
description	string	optional	Full description of the incident.
call	boolean	optional	Whether Better Stack should call the current on-call responder.
sms	boolean	optional	Whether Better Stack should send an SMS to the on-call responder.
email	boolean	optional	Whether Better Stack should send an email to the on-call responder.
critical_alert	boolean	optional	Whether Better Stack should send a critical push notification.
team_wait	integer	optional	Seconds to wait before escalating to the whole team.
policy_id	string	optional	String or numeric Better Stack identifier.
metadata	object	optional	Metadata payload accepted by Better Stack incident mutations.

POST

better_stack_acknowledge_incident

Acknowledge a Better Stack incident to stop further escalations.

/api/v3/incidents/{incident_id}/acknowledge

2 parameters

Param	Type	Required	Description
incident_id	string	required	The Better Stack incident ID.
acknowledged_by	string	optional	User email or custom identifier acknowledging the incident.

POST

better_stack_escalate_incident

Escalate a Better Stack incident to a user, team, schedule, policy, or organization.

/api/v3/incidents/{incident_id}/escalate

14 parameters

Param	Type	Required	Description
incident_id	string	required	The Better Stack incident ID.
escalation_type	string	required	Escalation target type accepted by Better Stack.
user_email	string	optional	User email to escalate the incident to.
user_id	integer	optional	User ID to escalate the incident to.
team_name	string	optional	Team name to escalate the incident to.
team_id	integer	optional	Team ID to escalate the incident to.
schedule_id	integer	optional	On-call schedule ID to escalate the incident to.
policy_id	integer	optional	Escalation policy ID to escalate the incident to.
call	boolean	optional	Whether the escalation should trigger phone calls.
sms	boolean	optional	Whether the escalation should trigger SMS notifications.
email	boolean	optional	Whether the escalation should trigger email notifications.
push	boolean	optional	Whether the escalation should trigger push notifications.
critical_alert	boolean	optional	Whether the escalation should trigger critical push notifications.
metadata	object	optional	Metadata payload accepted by Better Stack incident mutations.

GET

better_stack_list_incident_comments

List all comments attached to a Better Stack incident.

/api/v2/incidents/{incident_id}/comments

1 parameter

Param	Type	Required	Description
incident_id	string	required	The Better Stack incident ID.

GET

better_stack_list_metadata

List Better Stack metadata records for incidents or other supported owner types.

/api/v3/metadata

5 parameters

Param	Type	Required	Description
team_name	string	optional	Team name used when a global Better Stack API token needs explicit team scoping.
owner_id	string	optional	Only return metadata records for this owner ID.
owner_type	string	optional	Owner type accepted by the Better Stack metadata API.
page	integer	optional	Page number to return.
per_page	integer	optional	Number of metadata records to return per page.