{ "service": "better_stack", "displayName": "Better Stack", "categories": [ "Developer Tools" ], "authTypes": [ "api_key" ], "auth": [ { "type": "api_key", "label": "API Token", "placeholder": "bst_...", "description": "Better Stack API token used with the Authorization Bearer header. Create it from Better Stack > API tokens: https://betterstack.com/docs/errors/api/getting-api-token/." } ], "homepageUrl": "https://betterstack.com", "actions": [ { "id": "better_stack.acknowledge_incident", "service": "better_stack", "name": "acknowledge_incident", "description": "Acknowledge a Better Stack incident to stop further escalations.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "incident_id": { "type": "string", "minLength": 1, "description": "The Better Stack incident ID." }, "acknowledged_by": { "type": "string", "minLength": 1, "description": "User email or custom identifier acknowledging the incident." } }, "additionalProperties": false, "required": [ "incident_id" ], "description": "Input payload for acknowledging a Better Stack incident." }, "outputSchema": { "type": "object", "properties": { "incident": { "type": "object", "properties": { "id": { "type": "string", "description": "Better Stack incident identifier." }, "type": { "type": "string", "description": "Resource type returned by Better Stack, usually incident." }, "attributes": { "type": "object", "properties": { "name": { "type": "string", "description": "Incident name returned by Better Stack." }, "url": { "anyOf": [ { "type": "string", "description": "Affected URL when present." }, { "type": "null" } ] }, "http_method": { "anyOf": [ { "type": "string", "description": "HTTP method of the affected check when present." }, { "type": "null" } ] }, "cause": { "type": "string", "description": "Incident cause summary." }, "incident_group_id": { "anyOf": [ { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier returned by Better Stack." }, { "type": "number", "description": "Numeric identifier returned by Better Stack." } ], "description": "String or numeric Better Stack identifier." }, { "type": "null" } ] }, "started_at": { "type": "string", "description": "Timestamp when the incident started.", "format": "date-time" }, "acknowledged_at": { "anyOf": [ { "type": "string", "description": "Timestamp when the incident was acknowledged.", "format": "date-time" }, { "type": "null" } ] }, "acknowledged_by": { "anyOf": [ { "type": "string", "description": "Actor that acknowledged the incident." }, { "type": "null" } ] }, "resolved_at": { "anyOf": [ { "type": "string", "description": "Timestamp when the incident was resolved.", "format": "date-time" }, { "type": "null" } ] }, "resolved_by": { "anyOf": [ { "type": "string", "description": "Actor that resolved the incident." }, { "type": "null" } ] }, "status": { "type": "string", "description": "Incident status reported by Better Stack." }, "team_name": { "type": "string", "description": "Owning Better Stack team name." }, "response_content": { "anyOf": [ { "type": "string", "description": "Captured response content when Better Stack includes it." }, { "type": "null" } ] }, "response_options": { "anyOf": [ { "type": "string", "description": "Serialized response options returned by Better Stack." }, { "type": "null" } ] }, "regions": { "anyOf": [ { "type": "array", "items": { "type": "string", "minLength": 1, "description": "Monitoring region code." }, "description": "Monitoring regions attached to the incident." }, { "type": "null" } ] }, "response_url": { "anyOf": [ { "type": "string", "description": "Response URL captured for the incident, when present." }, { "type": "null" } ] }, "screenshot_url": { "anyOf": [ { "type": "string", "description": "Screenshot URL captured for the incident, when present." }, { "type": "null" } ] }, "origin_url": { "anyOf": [ { "type": "string", "description": "Origin URL returned by Better Stack, when present." }, { "type": "null" } ] }, "escalation_policy_id": { "anyOf": [ { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier returned by Better Stack." }, { "type": "number", "description": "Numeric identifier returned by Better Stack." } ], "description": "String or numeric Better Stack identifier." }, { "type": "null" } ] }, "call": { "type": "boolean", "description": "Whether calls are enabled for this incident." }, "sms": { "type": "boolean", "description": "Whether SMS notifications are enabled for this incident." }, "email": { "type": "boolean", "description": "Whether email notifications are enabled for this incident." }, "push": { "type": "boolean", "description": "Whether push notifications are enabled for this incident." }, "critical_alert": { "type": "boolean", "description": "Whether critical push notifications are enabled for this incident." }, "slack_channels": { "type": "array", "items": { "type": "string", "minLength": 1, "description": "Slack channel name linked to the incident." }, "description": "Slack channels attached to the incident." }, "metadata": { "type": "object", "additionalProperties": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "String", "User", "Team", "Policy", "Schedule", "SlackIntegration", "LinearIntegration", "JiraIntegration", "MicrosoftTeamsWebhook", "ZapierWebhook", "NativeWebhook", "PagerDutyWebhook" ], "description": "Metadata value type accepted by Better Stack." }, "value": { "type": "string", "description": "String value used when the metadata entry type is String." }, "item_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier returned by Better Stack." }, { "type": "number", "description": "Numeric identifier returned by Better Stack." } ], "description": "String or numeric Better Stack identifier." }, "name": { "type": "string", "description": "Referenced item name returned by Better Stack or accepted when creating metadata." }, "email": { "type": "string", "description": "Referenced user email accepted by Better Stack for User metadata values.", "format": "email" } }, "additionalProperties": false, "description": "A Better Stack metadata value." }, "description": "Metadata values for a single metadata key.", "minItems": 1 }, "description": "Metadata entries grouped by metadata key." } }, "additionalProperties": true, "description": "Attributes returned for a Better Stack incident." }, "relationships": { "type": "object", "properties": { "monitor": { "type": "object", "properties": { "data": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "description": "Identifier of the related Better Stack resource." }, "type": { "type": "string", "description": "Type of the related Better Stack resource." } }, "additionalProperties": false, "required": [ "id", "type" ], "description": "Reference to a related Better Stack resource." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "data" ], "description": "Better Stack relationship entry." }, "heartbeat": { "type": "object", "properties": { "data": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "description": "Identifier of the related Better Stack resource." }, "type": { "type": "string", "description": "Type of the related Better Stack resource." } }, "additionalProperties": false, "required": [ "id", "type" ], "description": "Reference to a related Better Stack resource." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "data" ], "description": "Better Stack relationship entry." }, "webhook_integration": { "type": "object", "properties": { "data": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "description": "Identifier of the related Better Stack resource." }, "type": { "type": "string", "description": "Type of the related Better Stack resource." } }, "additionalProperties": false, "required": [ "id", "type" ], "description": "Reference to a related Better Stack resource." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "data" ], "description": "Better Stack relationship entry." }, "email_integration": { "type": "object", "properties": { "data": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "description": "Identifier of the related Better Stack resource." }, "type": { "type": "string", "description": "Type of the related Better Stack resource." } }, "additionalProperties": false, "required": [ "id", "type" ], "description": "Reference to a related Better Stack resource." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "data" ], "description": "Better Stack relationship entry." }, "incoming_webhook": { "type": "object", "properties": { "data": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "description": "Identifier of the related Better Stack resource." }, "type": { "type": "string", "description": "Type of the related Better Stack resource." } }, "additionalProperties": false, "required": [ "id", "type" ], "description": "Reference to a related Better Stack resource." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "data" ], "description": "Better Stack relationship entry." }, "call_routing": { "type": "object", "properties": { "data": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "description": "Identifier of the related Better Stack resource." }, "type": { "type": "string", "description": "Type of the related Better Stack resource." } }, "additionalProperties": false, "required": [ "id", "type" ], "description": "Reference to a related Better Stack resource." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "data" ], "description": "Better Stack relationship entry." } }, "additionalProperties": true, "description": "Relationships attached to a Better Stack incident." } }, "additionalProperties": false, "required": [ "id", "type", "attributes" ], "description": "A Better Stack incident resource." } }, "additionalProperties": false, "required": [ "incident" ], "description": "Single Better Stack incident response." } }, { "id": "better_stack.create_incident", "service": "better_stack", "name": "create_incident", "description": "Create a Better Stack incident and alert the current on-call responder.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "team_name": { "type": "string", "minLength": 1, "description": "Team name used when a global Better Stack API token needs explicit team scoping." }, "requester_email": { "type": "string", "description": "Email address of the requester that opened the incident.", "format": "email" }, "name": { "type": "string", "minLength": 1, "description": "Short incident name." }, "summary": { "type": "string", "minLength": 1, "description": "Brief summary of the incident." }, "description": { "type": "string", "minLength": 1, "description": "Full description of the incident." }, "call": { "type": "boolean", "description": "Whether Better Stack should call the current on-call responder." }, "sms": { "type": "boolean", "description": "Whether Better Stack should send an SMS to the on-call responder." }, "email": { "type": "boolean", "description": "Whether Better Stack should send an email to the on-call responder." }, "critical_alert": { "type": "boolean", "description": "Whether Better Stack should send a critical push notification." }, "team_wait": { "type": "integer", "minimum": 1, "description": "Seconds to wait before escalating to the whole team." }, "policy_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier returned by Better Stack." }, { "type": "number", "description": "Numeric identifier returned by Better Stack." } ], "description": "String or numeric Better Stack identifier." }, "metadata": { "type": "object", "additionalProperties": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "String", "User", "Team", "Policy", "Schedule", "SlackIntegration", "LinearIntegration", "JiraIntegration", "MicrosoftTeamsWebhook", "ZapierWebhook", "NativeWebhook", "PagerDutyWebhook" ], "description": "Metadata value type accepted by Better Stack." }, "value": { "type": "string", "description": "String value to send when the metadata entry type is String." }, "item_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier returned by Better Stack." }, { "type": "number", "description": "Numeric identifier returned by Better Stack." } ], "description": "String or numeric Better Stack identifier." }, "name": { "type": "string", "description": "Referenced item name for non-String metadata values." }, "email": { "type": "string", "description": "Referenced user email for User metadata values.", "format": "email" } }, "additionalProperties": false, "description": "A Better Stack metadata value accepted by incident mutations.", "allOf": [ { "if": { "anyOf": [ { "properties": { "type": { "const": "String" } }, "required": [ "type" ] }, { "not": { "required": [ "type" ] } } ] }, "then": { "required": [ "value" ] } }, { "if": { "properties": { "type": { "enum": [ "User", "Team", "Policy", "Schedule", "SlackIntegration", "LinearIntegration", "JiraIntegration", "MicrosoftTeamsWebhook", "ZapierWebhook", "NativeWebhook", "PagerDutyWebhook" ] } }, "required": [ "type" ] }, "then": { "anyOf": [ { "required": [ "item_id" ] }, { "required": [ "name" ] }, { "properties": { "type": { "const": "User" } }, "required": [ "type", "email" ] } ] } } ] }, "description": "Metadata values to attach under a single metadata key.", "minItems": 1 }, "description": "Metadata payload accepted by Better Stack incident mutations." } }, "additionalProperties": false, "required": [ "summary" ], "description": "Input payload for creating a Better Stack incident." }, "outputSchema": { "type": "object", "properties": { "incident": { "type": "object", "properties": { "id": { "type": "string", "description": "Better Stack incident identifier." }, "type": { "type": "string", "description": "Resource type returned by Better Stack, usually incident." }, "attributes": { "type": "object", "properties": { "name": { "type": "string", "description": "Incident name returned by Better Stack." }, "url": { "anyOf": [ { "type": "string", "description": "Affected URL when present." }, { "type": "null" } ] }, "http_method": { "anyOf": [ { "type": "string", "description": "HTTP method of the affected check when present." }, { "type": "null" } ] }, "cause": { "type": "string", "description": "Incident cause summary." }, "incident_group_id": { "anyOf": [ { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier returned by Better Stack." }, { "type": "number", "description": "Numeric identifier returned by Better Stack." } ], "description": "String or numeric Better Stack identifier." }, { "type": "null" } ] }, "started_at": { "type": "string", "description": "Timestamp when the incident started.", "format": "date-time" }, "acknowledged_at": { "anyOf": [ { "type": "string", "description": "Timestamp when the incident was acknowledged.", "format": "date-time" }, { "type": "null" } ] }, "acknowledged_by": { "anyOf": [ { "type": "string", "description": "Actor that acknowledged the incident." }, { "type": "null" } ] }, "resolved_at": { "anyOf": [ { "type": "string", "description": "Timestamp when the incident was resolved.", "format": "date-time" }, { "type": "null" } ] }, "resolved_by": { "anyOf": [ { "type": "string", "description": "Actor that resolved the incident." }, { "type": "null" } ] }, "status": { "type": "string", "description": "Incident status reported by Better Stack." }, "team_name": { "type": "string", "description": "Owning Better Stack team name." }, "response_content": { "anyOf": [ { "type": "string", "description": "Captured response content when Better Stack includes it." }, { "type": "null" } ] }, "response_options": { "anyOf": [ { "type": "string", "description": "Serialized response options returned by Better Stack." }, { "type": "null" } ] }, "regions": { "anyOf": [ { "type": "array", "items": { "type": "string", "minLength": 1, "description": "Monitoring region code." }, "description": "Monitoring regions attached to the incident." }, { "type": "null" } ] }, "response_url": { "anyOf": [ { "type": "string", "description": "Response URL captured for the incident, when present." }, { "type": "null" } ] }, "screenshot_url": { "anyOf": [ { "type": "string", "description": "Screenshot URL captured for the incident, when present." }, { "type": "null" } ] }, "origin_url": { "anyOf": [ { "type": "string", "description": "Origin URL returned by Better Stack, when present." }, { "type": "null" } ] }, "escalation_policy_id": { "anyOf": [ { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier returned by Better Stack." }, { "type": "number", "description": "Numeric identifier returned by Better Stack." } ], "description": "String or numeric Better Stack identifier." }, { "type": "null" } ] }, "call": { "type": "boolean", "description": "Whether calls are enabled for this incident." }, "sms": { "type": "boolean", "description": "Whether SMS notifications are enabled for this incident." }, "email": { "type": "boolean", "description": "Whether email notifications are enabled for this incident." }, "push": { "type": "boolean", "description": "Whether push notifications are enabled for this incident." }, "critical_alert": { "type": "boolean", "description": "Whether critical push notifications are enabled for this incident." }, "slack_channels": { "type": "array", "items": { "type": "string", "minLength": 1, "description": "Slack channel name linked to the incident." }, "description": "Slack channels attached to the incident." }, "metadata": { "type": "object", "additionalProperties": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "String", "User", "Team", "Policy", "Schedule", "SlackIntegration", "LinearIntegration", "JiraIntegration", "MicrosoftTeamsWebhook", "ZapierWebhook", "NativeWebhook", "PagerDutyWebhook" ], "description": "Metadata value type accepted by Better Stack." }, "value": { "type": "string", "description": "String value used when the metadata entry type is String." }, "item_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier returned by Better Stack." }, { "type": "number", "description": "Numeric identifier returned by Better Stack." } ], "description": "String or numeric Better Stack identifier." }, "name": { "type": "string", "description": "Referenced item name returned by Better Stack or accepted when creating metadata." }, "email": { "type": "string", "description": "Referenced user email accepted by Better Stack for User metadata values.", "format": "email" } }, "additionalProperties": false, "description": "A Better Stack metadata value." }, "description": "Metadata values for a single metadata key.", "minItems": 1 }, "description": "Metadata entries grouped by metadata key." } }, "additionalProperties": true, "description": "Attributes returned for a Better Stack incident." }, "relationships": { "type": "object", "properties": { "monitor": { "type": "object", "properties": { "data": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "description": "Identifier of the related Better Stack resource." }, "type": { "type": "string", "description": "Type of the related Better Stack resource." } }, "additionalProperties": false, "required": [ "id", "type" ], "description": "Reference to a related Better Stack resource." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "data" ], "description": "Better Stack relationship entry." }, "heartbeat": { "type": "object", "properties": { "data": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "description": "Identifier of the related Better Stack resource." }, "type": { "type": "string", "description": "Type of the related Better Stack resource." } }, "additionalProperties": false, "required": [ "id", "type" ], "description": "Reference to a related Better Stack resource." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "data" ], "description": "Better Stack relationship entry." }, "webhook_integration": { "type": "object", "properties": { "data": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "description": "Identifier of the related Better Stack resource." }, "type": { "type": "string", "description": "Type of the related Better Stack resource." } }, "additionalProperties": false, "required": [ "id", "type" ], "description": "Reference to a related Better Stack resource." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "data" ], "description": "Better Stack relationship entry." }, "email_integration": { "type": "object", "properties": { "data": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "description": "Identifier of the related Better Stack resource." }, "type": { "type": "string", "description": "Type of the related Better Stack resource." } }, "additionalProperties": false, "required": [ "id", "type" ], "description": "Reference to a related Better Stack resource." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "data" ], "description": "Better Stack relationship entry." }, "incoming_webhook": { "type": "object", "properties": { "data": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "description": "Identifier of the related Better Stack resource." }, "type": { "type": "string", "description": "Type of the related Better Stack resource." } }, "additionalProperties": false, "required": [ "id", "type" ], "description": "Reference to a related Better Stack resource." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "data" ], "description": "Better Stack relationship entry." }, "call_routing": { "type": "object", "properties": { "data": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "description": "Identifier of the related Better Stack resource." }, "type": { "type": "string", "description": "Type of the related Better Stack resource." } }, "additionalProperties": false, "required": [ "id", "type" ], "description": "Reference to a related Better Stack resource." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "data" ], "description": "Better Stack relationship entry." } }, "additionalProperties": true, "description": "Relationships attached to a Better Stack incident." } }, "additionalProperties": false, "required": [ "id", "type", "attributes" ], "description": "A Better Stack incident resource." } }, "additionalProperties": false, "required": [ "incident" ], "description": "Single Better Stack incident response." }, "followUpActions": [ "better_stack.acknowledge_incident", "better_stack.escalate_incident" ] }, { "id": "better_stack.escalate_incident", "service": "better_stack", "name": "escalate_incident", "description": "Escalate a Better Stack incident to a user, team, schedule, policy, or organization.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "incident_id": { "type": "string", "minLength": 1, "description": "The Better Stack incident ID." }, "escalation_type": { "type": "string", "enum": [ "User", "Team", "Schedule", "Policy", "Organization" ], "description": "Escalation target type accepted by Better Stack." }, "user_email": { "type": "string", "description": "User email to escalate the incident to.", "format": "email" }, "user_id": { "type": "integer", "minimum": 1, "description": "User ID to escalate the incident to." }, "team_name": { "type": "string", "minLength": 1, "description": "Team name to escalate the incident to." }, "team_id": { "type": "integer", "minimum": 1, "description": "Team ID to escalate the incident to." }, "schedule_id": { "type": "integer", "minimum": 1, "description": "On-call schedule ID to escalate the incident to." }, "policy_id": { "type": "integer", "minimum": 1, "description": "Escalation policy ID to escalate the incident to." }, "call": { "type": "boolean", "description": "Whether the escalation should trigger phone calls." }, "sms": { "type": "boolean", "description": "Whether the escalation should trigger SMS notifications." }, "email": { "type": "boolean", "description": "Whether the escalation should trigger email notifications." }, "push": { "type": "boolean", "description": "Whether the escalation should trigger push notifications." }, "critical_alert": { "type": "boolean", "description": "Whether the escalation should trigger critical push notifications." }, "metadata": { "type": "object", "additionalProperties": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "String", "User", "Team", "Policy", "Schedule", "SlackIntegration", "LinearIntegration", "JiraIntegration", "MicrosoftTeamsWebhook", "ZapierWebhook", "NativeWebhook", "PagerDutyWebhook" ], "description": "Metadata value type accepted by Better Stack." }, "value": { "type": "string", "description": "String value to send when the metadata entry type is String." }, "item_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier returned by Better Stack." }, { "type": "number", "description": "Numeric identifier returned by Better Stack." } ], "description": "String or numeric Better Stack identifier." }, "name": { "type": "string", "description": "Referenced item name for non-String metadata values." }, "email": { "type": "string", "description": "Referenced user email for User metadata values.", "format": "email" } }, "additionalProperties": false, "description": "A Better Stack metadata value accepted by incident mutations.", "allOf": [ { "if": { "anyOf": [ { "properties": { "type": { "const": "String" } }, "required": [ "type" ] }, { "not": { "required": [ "type" ] } } ] }, "then": { "required": [ "value" ] } }, { "if": { "properties": { "type": { "enum": [ "User", "Team", "Policy", "Schedule", "SlackIntegration", "LinearIntegration", "JiraIntegration", "MicrosoftTeamsWebhook", "ZapierWebhook", "NativeWebhook", "PagerDutyWebhook" ] } }, "required": [ "type" ] }, "then": { "anyOf": [ { "required": [ "item_id" ] }, { "required": [ "name" ] }, { "properties": { "type": { "const": "User" } }, "required": [ "type", "email" ] } ] } } ] }, "description": "Metadata values to attach under a single metadata key.", "minItems": 1 }, "description": "Metadata payload accepted by Better Stack incident mutations." } }, "additionalProperties": false, "required": [ "incident_id", "escalation_type" ], "description": "Input payload for escalating a Better Stack incident.", "allOf": [ { "if": { "properties": { "escalation_type": { "const": "User" } }, "required": [ "escalation_type" ] }, "then": { "anyOf": [ { "required": [ "user_email" ] }, { "required": [ "user_id" ] } ] } }, { "if": { "properties": { "escalation_type": { "const": "Team" } }, "required": [ "escalation_type" ] }, "then": { "anyOf": [ { "required": [ "team_name" ] }, { "required": [ "team_id" ] } ] } }, { "if": { "properties": { "escalation_type": { "const": "Schedule" } }, "required": [ "escalation_type" ] }, "then": { "required": [ "schedule_id" ] } }, { "if": { "properties": { "escalation_type": { "const": "Policy" } }, "required": [ "escalation_type" ] }, "then": { "required": [ "policy_id" ], "not": { "anyOf": [ { "required": [ "call" ] }, { "required": [ "sms" ] }, { "required": [ "email" ] }, { "required": [ "push" ] }, { "required": [ "critical_alert" ] } ] } } } ] }, "outputSchema": { "type": "object", "properties": { "incident": { "type": "object", "properties": { "id": { "type": "string", "description": "Better Stack incident identifier." }, "type": { "type": "string", "description": "Resource type returned by Better Stack, usually incident." }, "attributes": { "type": "object", "properties": { "name": { "type": "string", "description": "Incident name returned by Better Stack." }, "url": { "anyOf": [ { "type": "string", "description": "Affected URL when present." }, { "type": "null" } ] }, "http_method": { "anyOf": [ { "type": "string", "description": "HTTP method of the affected check when present." }, { "type": "null" } ] }, "cause": { "type": "string", "description": "Incident cause summary." }, "incident_group_id": { "anyOf": [ { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier returned by Better Stack." }, { "type": "number", "description": "Numeric identifier returned by Better Stack." } ], "description": "String or numeric Better Stack identifier." }, { "type": "null" } ] }, "started_at": { "type": "string", "description": "Timestamp when the incident started.", "format": "date-time" }, "acknowledged_at": { "anyOf": [ { "type": "string", "description": "Timestamp when the incident was acknowledged.", "format": "date-time" }, { "type": "null" } ] }, "acknowledged_by": { "anyOf": [ { "type": "string", "description": "Actor that acknowledged the incident." }, { "type": "null" } ] }, "resolved_at": { "anyOf": [ { "type": "string", "description": "Timestamp when the incident was resolved.", "format": "date-time" }, { "type": "null" } ] }, "resolved_by": { "anyOf": [ { "type": "string", "description": "Actor that resolved the incident." }, { "type": "null" } ] }, "status": { "type": "string", "description": "Incident status reported by Better Stack." }, "team_name": { "type": "string", "description": "Owning Better Stack team name." }, "response_content": { "anyOf": [ { "type": "string", "description": "Captured response content when Better Stack includes it." }, { "type": "null" } ] }, "response_options": { "anyOf": [ { "type": "string", "description": "Serialized response options returned by Better Stack." }, { "type": "null" } ] }, "regions": { "anyOf": [ { "type": "array", "items": { "type": "string", "minLength": 1, "description": "Monitoring region code." }, "description": "Monitoring regions attached to the incident." }, { "type": "null" } ] }, "response_url": { "anyOf": [ { "type": "string", "description": "Response URL captured for the incident, when present." }, { "type": "null" } ] }, "screenshot_url": { "anyOf": [ { "type": "string", "description": "Screenshot URL captured for the incident, when present." }, { "type": "null" } ] }, "origin_url": { "anyOf": [ { "type": "string", "description": "Origin URL returned by Better Stack, when present." }, { "type": "null" } ] }, "escalation_policy_id": { "anyOf": [ { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier returned by Better Stack." }, { "type": "number", "description": "Numeric identifier returned by Better Stack." } ], "description": "String or numeric Better Stack identifier." }, { "type": "null" } ] }, "call": { "type": "boolean", "description": "Whether calls are enabled for this incident." }, "sms": { "type": "boolean", "description": "Whether SMS notifications are enabled for this incident." }, "email": { "type": "boolean", "description": "Whether email notifications are enabled for this incident." }, "push": { "type": "boolean", "description": "Whether push notifications are enabled for this incident." }, "critical_alert": { "type": "boolean", "description": "Whether critical push notifications are enabled for this incident." }, "slack_channels": { "type": "array", "items": { "type": "string", "minLength": 1, "description": "Slack channel name linked to the incident." }, "description": "Slack channels attached to the incident." }, "metadata": { "type": "object", "additionalProperties": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "String", "User", "Team", "Policy", "Schedule", "SlackIntegration", "LinearIntegration", "JiraIntegration", "MicrosoftTeamsWebhook", "ZapierWebhook", "NativeWebhook", "PagerDutyWebhook" ], "description": "Metadata value type accepted by Better Stack." }, "value": { "type": "string", "description": "String value used when the metadata entry type is String." }, "item_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier returned by Better Stack." }, { "type": "number", "description": "Numeric identifier returned by Better Stack." } ], "description": "String or numeric Better Stack identifier." }, "name": { "type": "string", "description": "Referenced item name returned by Better Stack or accepted when creating metadata." }, "email": { "type": "string", "description": "Referenced user email accepted by Better Stack for User metadata values.", "format": "email" } }, "additionalProperties": false, "description": "A Better Stack metadata value." }, "description": "Metadata values for a single metadata key.", "minItems": 1 }, "description": "Metadata entries grouped by metadata key." } }, "additionalProperties": true, "description": "Attributes returned for a Better Stack incident." }, "relationships": { "type": "object", "properties": { "monitor": { "type": "object", "properties": { "data": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "description": "Identifier of the related Better Stack resource." }, "type": { "type": "string", "description": "Type of the related Better Stack resource." } }, "additionalProperties": false, "required": [ "id", "type" ], "description": "Reference to a related Better Stack resource." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "data" ], "description": "Better Stack relationship entry." }, "heartbeat": { "type": "object", "properties": { "data": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "description": "Identifier of the related Better Stack resource." }, "type": { "type": "string", "description": "Type of the related Better Stack resource." } }, "additionalProperties": false, "required": [ "id", "type" ], "description": "Reference to a related Better Stack resource." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "data" ], "description": "Better Stack relationship entry." }, "webhook_integration": { "type": "object", "properties": { "data": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "description": "Identifier of the related Better Stack resource." }, "type": { "type": "string", "description": "Type of the related Better Stack resource." } }, "additionalProperties": false, "required": [ "id", "type" ], "description": "Reference to a related Better Stack resource." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "data" ], "description": "Better Stack relationship entry." }, "email_integration": { "type": "object", "properties": { "data": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "description": "Identifier of the related Better Stack resource." }, "type": { "type": "string", "description": "Type of the related Better Stack resource." } }, "additionalProperties": false, "required": [ "id", "type" ], "description": "Reference to a related Better Stack resource." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "data" ], "description": "Better Stack relationship entry." }, "incoming_webhook": { "type": "object", "properties": { "data": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "description": "Identifier of the related Better Stack resource." }, "type": { "type": "string", "description": "Type of the related Better Stack resource." } }, "additionalProperties": false, "required": [ "id", "type" ], "description": "Reference to a related Better Stack resource." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "data" ], "description": "Better Stack relationship entry." }, "call_routing": { "type": "object", "properties": { "data": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "description": "Identifier of the related Better Stack resource." }, "type": { "type": "string", "description": "Type of the related Better Stack resource." } }, "additionalProperties": false, "required": [ "id", "type" ], "description": "Reference to a related Better Stack resource." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "data" ], "description": "Better Stack relationship entry." } }, "additionalProperties": true, "description": "Relationships attached to a Better Stack incident." } }, "additionalProperties": false, "required": [ "id", "type", "attributes" ], "description": "A Better Stack incident resource." } }, "additionalProperties": false, "required": [ "incident" ], "description": "Single Better Stack incident response." } }, { "id": "better_stack.get_incident", "service": "better_stack", "name": "get_incident", "description": "Get a Better Stack incident by ID with included resource context when available.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "incident_id": { "type": "string", "minLength": 1, "description": "The Better Stack incident ID." } }, "additionalProperties": false, "required": [ "incident_id" ], "description": "Input payload for getting a Better Stack incident." }, "outputSchema": { "type": "object", "properties": { "incident": { "type": "object", "properties": { "id": { "type": "string", "description": "Better Stack incident identifier." }, "type": { "type": "string", "description": "Resource type returned by Better Stack, usually incident." }, "attributes": { "type": "object", "properties": { "name": { "type": "string", "description": "Incident name returned by Better Stack." }, "url": { "anyOf": [ { "type": "string", "description": "Affected URL when present." }, { "type": "null" } ] }, "http_method": { "anyOf": [ { "type": "string", "description": "HTTP method of the affected check when present." }, { "type": "null" } ] }, "cause": { "type": "string", "description": "Incident cause summary." }, "incident_group_id": { "anyOf": [ { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier returned by Better Stack." }, { "type": "number", "description": "Numeric identifier returned by Better Stack." } ], "description": "String or numeric Better Stack identifier." }, { "type": "null" } ] }, "started_at": { "type": "string", "description": "Timestamp when the incident started.", "format": "date-time" }, "acknowledged_at": { "anyOf": [ { "type": "string", "description": "Timestamp when the incident was acknowledged.", "format": "date-time" }, { "type": "null" } ] }, "acknowledged_by": { "anyOf": [ { "type": "string", "description": "Actor that acknowledged the incident." }, { "type": "null" } ] }, "resolved_at": { "anyOf": [ { "type": "string", "description": "Timestamp when the incident was resolved.", "format": "date-time" }, { "type": "null" } ] }, "resolved_by": { "anyOf": [ { "type": "string", "description": "Actor that resolved the incident." }, { "type": "null" } ] }, "status": { "type": "string", "description": "Incident status reported by Better Stack." }, "team_name": { "type": "string", "description": "Owning Better Stack team name." }, "response_content": { "anyOf": [ { "type": "string", "description": "Captured response content when Better Stack includes it." }, { "type": "null" } ] }, "response_options": { "anyOf": [ { "type": "string", "description": "Serialized response options returned by Better Stack." }, { "type": "null" } ] }, "regions": { "anyOf": [ { "type": "array", "items": { "type": "string", "minLength": 1, "description": "Monitoring region code." }, "description": "Monitoring regions attached to the incident." }, { "type": "null" } ] }, "response_url": { "anyOf": [ { "type": "string", "description": "Response URL captured for the incident, when present." }, { "type": "null" } ] }, "screenshot_url": { "anyOf": [ { "type": "string", "description": "Screenshot URL captured for the incident, when present." }, { "type": "null" } ] }, "origin_url": { "anyOf": [ { "type": "string", "description": "Origin URL returned by Better Stack, when present." }, { "type": "null" } ] }, "escalation_policy_id": { "anyOf": [ { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier returned by Better Stack." }, { "type": "number", "description": "Numeric identifier returned by Better Stack." } ], "description": "String or numeric Better Stack identifier." }, { "type": "null" } ] }, "call": { "type": "boolean", "description": "Whether calls are enabled for this incident." }, "sms": { "type": "boolean", "description": "Whether SMS notifications are enabled for this incident." }, "email": { "type": "boolean", "description": "Whether email notifications are enabled for this incident." }, "push": { "type": "boolean", "description": "Whether push notifications are enabled for this incident." }, "critical_alert": { "type": "boolean", "description": "Whether critical push notifications are enabled for this incident." }, "slack_channels": { "type": "array", "items": { "type": "string", "minLength": 1, "description": "Slack channel name linked to the incident." }, "description": "Slack channels attached to the incident." }, "metadata": { "type": "object", "additionalProperties": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "String", "User", "Team", "Policy", "Schedule", "SlackIntegration", "LinearIntegration", "JiraIntegration", "MicrosoftTeamsWebhook", "ZapierWebhook", "NativeWebhook", "PagerDutyWebhook" ], "description": "Metadata value type accepted by Better Stack." }, "value": { "type": "string", "description": "String value used when the metadata entry type is String." }, "item_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier returned by Better Stack." }, { "type": "number", "description": "Numeric identifier returned by Better Stack." } ], "description": "String or numeric Better Stack identifier." }, "name": { "type": "string", "description": "Referenced item name returned by Better Stack or accepted when creating metadata." }, "email": { "type": "string", "description": "Referenced user email accepted by Better Stack for User metadata values.", "format": "email" } }, "additionalProperties": false, "description": "A Better Stack metadata value." }, "description": "Metadata values for a single metadata key.", "minItems": 1 }, "description": "Metadata entries grouped by metadata key." } }, "additionalProperties": true, "description": "Attributes returned for a Better Stack incident." }, "relationships": { "type": "object", "properties": { "monitor": { "type": "object", "properties": { "data": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "description": "Identifier of the related Better Stack resource." }, "type": { "type": "string", "description": "Type of the related Better Stack resource." } }, "additionalProperties": false, "required": [ "id", "type" ], "description": "Reference to a related Better Stack resource." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "data" ], "description": "Better Stack relationship entry." }, "heartbeat": { "type": "object", "properties": { "data": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "description": "Identifier of the related Better Stack resource." }, "type": { "type": "string", "description": "Type of the related Better Stack resource." } }, "additionalProperties": false, "required": [ "id", "type" ], "description": "Reference to a related Better Stack resource." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "data" ], "description": "Better Stack relationship entry." }, "webhook_integration": { "type": "object", "properties": { "data": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "description": "Identifier of the related Better Stack resource." }, "type": { "type": "string", "description": "Type of the related Better Stack resource." } }, "additionalProperties": false, "required": [ "id", "type" ], "description": "Reference to a related Better Stack resource." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "data" ], "description": "Better Stack relationship entry." }, "email_integration": { "type": "object", "properties": { "data": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "description": "Identifier of the related Better Stack resource." }, "type": { "type": "string", "description": "Type of the related Better Stack resource." } }, "additionalProperties": false, "required": [ "id", "type" ], "description": "Reference to a related Better Stack resource." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "data" ], "description": "Better Stack relationship entry." }, "incoming_webhook": { "type": "object", "properties": { "data": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "description": "Identifier of the related Better Stack resource." }, "type": { "type": "string", "description": "Type of the related Better Stack resource." } }, "additionalProperties": false, "required": [ "id", "type" ], "description": "Reference to a related Better Stack resource." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "data" ], "description": "Better Stack relationship entry." }, "call_routing": { "type": "object", "properties": { "data": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "description": "Identifier of the related Better Stack resource." }, "type": { "type": "string", "description": "Type of the related Better Stack resource." } }, "additionalProperties": false, "required": [ "id", "type" ], "description": "Reference to a related Better Stack resource." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "data" ], "description": "Better Stack relationship entry." } }, "additionalProperties": true, "description": "Relationships attached to a Better Stack incident." } }, "additionalProperties": false, "required": [ "id", "type", "attributes" ], "description": "A Better Stack incident resource." }, "included": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "description": "Identifier of the included Better Stack resource." }, "type": { "type": "string", "description": "Type of the included Better Stack resource." }, "attributes": { "type": "object", "properties": { "url": { "anyOf": [ { "type": "string", "description": "URL of the included resource, when present." }, { "type": "null" } ] }, "pronounceable_name": { "type": "string", "description": "Human-readable name of the included resource, when present." }, "status": { "type": "string", "description": "Status of the included resource, when present." } }, "additionalProperties": true, "description": "Selected attributes returned for the included resource." }, "relationships": { "type": "object", "properties": {}, "additionalProperties": true, "description": "Relationships returned for the included resource, when present." } }, "additionalProperties": true, "description": "A related Better Stack resource included with an incident response." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "incident", "included" ], "description": "Single Better Stack incident response with included resource context." }, "followUpActions": [ "better_stack.list_incident_comments" ] }, { "id": "better_stack.list_incident_comments", "service": "better_stack", "name": "list_incident_comments", "description": "List all comments attached to a Better Stack incident.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "incident_id": { "type": "string", "minLength": 1, "description": "The Better Stack incident ID." } }, "additionalProperties": false, "required": [ "incident_id" ], "description": "Input payload for listing Better Stack incident comments." }, "outputSchema": { "type": "object", "properties": { "comments": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "Incident comment identifier." }, "type": { "type": "string", "description": "Resource type returned by Better Stack, usually incident_comment." }, "attributes": { "type": "object", "properties": { "id": { "type": "integer", "description": "Numeric incident comment identifier." }, "content": { "type": "string", "description": "Comment content." }, "user_id": { "type": "integer", "description": "Author user ID when Better Stack returns it." }, "user_email": { "type": "string", "description": "Author email when Better Stack returns it.", "format": "email" }, "created_at": { "type": "string", "description": "Timestamp when the comment was created.", "format": "date-time" }, "updated_at": { "type": "string", "description": "Timestamp when the comment was last updated.", "format": "date-time" } }, "additionalProperties": false, "required": [ "id", "content", "created_at", "updated_at" ], "description": "Incident comment attributes." } }, "additionalProperties": false, "required": [ "id", "type", "attributes" ], "description": "A Better Stack incident comment." }, "description": "Comments returned for the Better Stack incident." } }, "additionalProperties": false, "required": [ "comments" ], "description": "Incident comments returned by Better Stack." } }, { "id": "better_stack.list_incidents", "service": "better_stack", "name": "list_incidents", "description": "List Better Stack incidents with optional date and status filters.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "team_name": { "type": "string", "minLength": 1, "description": "Team name used when a global Better Stack API token needs explicit team scoping." }, "from": { "type": "string", "description": "Only return incidents on or after this date.", "format": "date" }, "to": { "type": "string", "description": "Only return incidents on or before this date.", "format": "date" }, "monitor_id": { "type": "integer", "minimum": 1, "description": "Only return incidents for this monitor ID." }, "heartbeat_id": { "type": "integer", "minimum": 1, "description": "Only return incidents for this heartbeat ID." }, "resolved": { "type": "boolean", "description": "Whether to return resolved incidents only or unresolved incidents only." }, "acknowledged": { "type": "boolean", "description": "Whether to return acknowledged incidents only or unacknowledged incidents only." }, "page": { "type": "integer", "minimum": 1, "description": "Page number to return." }, "per_page": { "type": "integer", "minimum": 1, "maximum": 50, "description": "Number of incidents to return per page. Better Stack incident lists allow up to 50." } }, "additionalProperties": false, "description": "Filters and pagination parameters for listing Better Stack incidents." }, "outputSchema": { "type": "object", "properties": { "incidents": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "Better Stack incident identifier." }, "type": { "type": "string", "description": "Resource type returned by Better Stack, usually incident." }, "attributes": { "type": "object", "properties": { "name": { "type": "string", "description": "Incident name returned by Better Stack." }, "url": { "anyOf": [ { "type": "string", "description": "Affected URL when present." }, { "type": "null" } ] }, "http_method": { "anyOf": [ { "type": "string", "description": "HTTP method of the affected check when present." }, { "type": "null" } ] }, "cause": { "type": "string", "description": "Incident cause summary." }, "incident_group_id": { "anyOf": [ { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier returned by Better Stack." }, { "type": "number", "description": "Numeric identifier returned by Better Stack." } ], "description": "String or numeric Better Stack identifier." }, { "type": "null" } ] }, "started_at": { "type": "string", "description": "Timestamp when the incident started.", "format": "date-time" }, "acknowledged_at": { "anyOf": [ { "type": "string", "description": "Timestamp when the incident was acknowledged.", "format": "date-time" }, { "type": "null" } ] }, "acknowledged_by": { "anyOf": [ { "type": "string", "description": "Actor that acknowledged the incident." }, { "type": "null" } ] }, "resolved_at": { "anyOf": [ { "type": "string", "description": "Timestamp when the incident was resolved.", "format": "date-time" }, { "type": "null" } ] }, "resolved_by": { "anyOf": [ { "type": "string", "description": "Actor that resolved the incident." }, { "type": "null" } ] }, "status": { "type": "string", "description": "Incident status reported by Better Stack." }, "team_name": { "type": "string", "description": "Owning Better Stack team name." }, "response_content": { "anyOf": [ { "type": "string", "description": "Captured response content when Better Stack includes it." }, { "type": "null" } ] }, "response_options": { "anyOf": [ { "type": "string", "description": "Serialized response options returned by Better Stack." }, { "type": "null" } ] }, "regions": { "anyOf": [ { "type": "array", "items": { "type": "string", "minLength": 1, "description": "Monitoring region code." }, "description": "Monitoring regions attached to the incident." }, { "type": "null" } ] }, "response_url": { "anyOf": [ { "type": "string", "description": "Response URL captured for the incident, when present." }, { "type": "null" } ] }, "screenshot_url": { "anyOf": [ { "type": "string", "description": "Screenshot URL captured for the incident, when present." }, { "type": "null" } ] }, "origin_url": { "anyOf": [ { "type": "string", "description": "Origin URL returned by Better Stack, when present." }, { "type": "null" } ] }, "escalation_policy_id": { "anyOf": [ { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier returned by Better Stack." }, { "type": "number", "description": "Numeric identifier returned by Better Stack." } ], "description": "String or numeric Better Stack identifier." }, { "type": "null" } ] }, "call": { "type": "boolean", "description": "Whether calls are enabled for this incident." }, "sms": { "type": "boolean", "description": "Whether SMS notifications are enabled for this incident." }, "email": { "type": "boolean", "description": "Whether email notifications are enabled for this incident." }, "push": { "type": "boolean", "description": "Whether push notifications are enabled for this incident." }, "critical_alert": { "type": "boolean", "description": "Whether critical push notifications are enabled for this incident." }, "slack_channels": { "type": "array", "items": { "type": "string", "minLength": 1, "description": "Slack channel name linked to the incident." }, "description": "Slack channels attached to the incident." }, "metadata": { "type": "object", "additionalProperties": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "String", "User", "Team", "Policy", "Schedule", "SlackIntegration", "LinearIntegration", "JiraIntegration", "MicrosoftTeamsWebhook", "ZapierWebhook", "NativeWebhook", "PagerDutyWebhook" ], "description": "Metadata value type accepted by Better Stack." }, "value": { "type": "string", "description": "String value used when the metadata entry type is String." }, "item_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier returned by Better Stack." }, { "type": "number", "description": "Numeric identifier returned by Better Stack." } ], "description": "String or numeric Better Stack identifier." }, "name": { "type": "string", "description": "Referenced item name returned by Better Stack or accepted when creating metadata." }, "email": { "type": "string", "description": "Referenced user email accepted by Better Stack for User metadata values.", "format": "email" } }, "additionalProperties": false, "description": "A Better Stack metadata value." }, "description": "Metadata values for a single metadata key.", "minItems": 1 }, "description": "Metadata entries grouped by metadata key." } }, "additionalProperties": true, "description": "Attributes returned for a Better Stack incident." }, "relationships": { "type": "object", "properties": { "monitor": { "type": "object", "properties": { "data": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "description": "Identifier of the related Better Stack resource." }, "type": { "type": "string", "description": "Type of the related Better Stack resource." } }, "additionalProperties": false, "required": [ "id", "type" ], "description": "Reference to a related Better Stack resource." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "data" ], "description": "Better Stack relationship entry." }, "heartbeat": { "type": "object", "properties": { "data": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "description": "Identifier of the related Better Stack resource." }, "type": { "type": "string", "description": "Type of the related Better Stack resource." } }, "additionalProperties": false, "required": [ "id", "type" ], "description": "Reference to a related Better Stack resource." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "data" ], "description": "Better Stack relationship entry." }, "webhook_integration": { "type": "object", "properties": { "data": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "description": "Identifier of the related Better Stack resource." }, "type": { "type": "string", "description": "Type of the related Better Stack resource." } }, "additionalProperties": false, "required": [ "id", "type" ], "description": "Reference to a related Better Stack resource." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "data" ], "description": "Better Stack relationship entry." }, "email_integration": { "type": "object", "properties": { "data": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "description": "Identifier of the related Better Stack resource." }, "type": { "type": "string", "description": "Type of the related Better Stack resource." } }, "additionalProperties": false, "required": [ "id", "type" ], "description": "Reference to a related Better Stack resource." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "data" ], "description": "Better Stack relationship entry." }, "incoming_webhook": { "type": "object", "properties": { "data": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "description": "Identifier of the related Better Stack resource." }, "type": { "type": "string", "description": "Type of the related Better Stack resource." } }, "additionalProperties": false, "required": [ "id", "type" ], "description": "Reference to a related Better Stack resource." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "data" ], "description": "Better Stack relationship entry." }, "call_routing": { "type": "object", "properties": { "data": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "description": "Identifier of the related Better Stack resource." }, "type": { "type": "string", "description": "Type of the related Better Stack resource." } }, "additionalProperties": false, "required": [ "id", "type" ], "description": "Reference to a related Better Stack resource." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "data" ], "description": "Better Stack relationship entry." } }, "additionalProperties": true, "description": "Relationships attached to a Better Stack incident." } }, "additionalProperties": false, "required": [ "id", "type", "attributes" ], "description": "A Better Stack incident resource." }, "description": "Incidents returned by Better Stack." }, "pagination": { "type": "object", "properties": { "first": { "anyOf": [ { "type": "string", "description": "URL of the first page, or null when not available." }, { "type": "null" } ] }, "last": { "anyOf": [ { "type": "string", "description": "URL of the last page, or null when not available." }, { "type": "null" } ] }, "prev": { "anyOf": [ { "type": "string", "description": "URL of the previous page, or null when not available." }, { "type": "null" } ] }, "next": { "anyOf": [ { "type": "string", "description": "URL of the next page, or null when not available." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "first", "last", "prev", "next" ], "description": "Pagination links returned by Better Stack." } }, "additionalProperties": false, "required": [ "incidents", "pagination" ], "description": "Paginated Better Stack incident list." }, "followUpActions": [ "better_stack.get_incident" ] }, { "id": "better_stack.list_metadata", "service": "better_stack", "name": "list_metadata", "description": "List Better Stack metadata records for incidents or other supported owner types.", "requiredScopes": [], "providerPermissions": [], "inputSchema": { "type": "object", "properties": { "team_name": { "type": "string", "minLength": 1, "description": "Team name used when a global Better Stack API token needs explicit team scoping." }, "owner_id": { "type": "string", "minLength": 1, "description": "Only return metadata records for this owner ID." }, "owner_type": { "type": "string", "enum": [ "Monitor", "Heartbeat", "Incident", "WebhookIntegration", "EmailIntegration", "IncomingWebhook", "CallRouting" ], "description": "Owner type accepted by the Better Stack metadata API." }, "page": { "type": "integer", "minimum": 1, "description": "Page number to return." }, "per_page": { "type": "integer", "minimum": 1, "maximum": 250, "description": "Number of metadata records to return per page." } }, "additionalProperties": false, "description": "Filters and pagination parameters for listing Better Stack metadata." }, "outputSchema": { "type": "object", "properties": { "metadata": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "Metadata record identifier." }, "type": { "type": "string", "description": "Resource type returned by Better Stack, usually metadata." }, "attributes": { "type": "object", "properties": { "key": { "type": "string", "description": "Metadata key." }, "values": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "String", "User", "Team", "Policy", "Schedule", "SlackIntegration", "LinearIntegration", "JiraIntegration", "MicrosoftTeamsWebhook", "ZapierWebhook", "NativeWebhook", "PagerDutyWebhook" ], "description": "Metadata value type accepted by Better Stack." }, "value": { "type": "string", "description": "String value used when the metadata entry type is String." }, "item_id": { "anyOf": [ { "type": "string", "minLength": 1, "description": "String identifier returned by Better Stack." }, { "type": "number", "description": "Numeric identifier returned by Better Stack." } ], "description": "String or numeric Better Stack identifier." }, "name": { "type": "string", "description": "Referenced item name returned by Better Stack or accepted when creating metadata." }, "email": { "type": "string", "description": "Referenced user email accepted by Better Stack for User metadata values.", "format": "email" } }, "additionalProperties": false, "description": "A Better Stack metadata value." }, "description": "Metadata values stored under the key." }, "team_name": { "type": "string", "description": "Team that owns the metadata record." }, "owner_id": { "type": "string", "description": "Owner ID for the metadata record." }, "owner_type": { "type": "string", "enum": [ "Monitor", "Heartbeat", "Incident", "WebhookIntegration", "EmailIntegration", "IncomingWebhook", "CallRouting" ], "description": "Owner type accepted by the Better Stack metadata API." } }, "additionalProperties": false, "required": [ "key", "values", "team_name", "owner_id", "owner_type" ], "description": "Metadata record attributes." } }, "additionalProperties": false, "required": [ "id", "type", "attributes" ], "description": "A Better Stack metadata record." }, "description": "Metadata records returned by Better Stack." }, "pagination": { "type": "object", "properties": { "first": { "anyOf": [ { "type": "string", "description": "URL of the first page, or null when not available." }, { "type": "null" } ] }, "last": { "anyOf": [ { "type": "string", "description": "URL of the last page, or null when not available." }, { "type": "null" } ] }, "prev": { "anyOf": [ { "type": "string", "description": "URL of the previous page, or null when not available." }, { "type": "null" } ] }, "next": { "anyOf": [ { "type": "string", "description": "URL of the next page, or null when not available." }, { "type": "null" } ] } }, "additionalProperties": false, "required": [ "first", "last", "prev", "next" ], "description": "Pagination links returned by Better Stack." } }, "additionalProperties": false, "required": [ "metadata", "pagination" ], "description": "Paginated Better Stack metadata list." } } ] }