Get a single Slack integration

Returns a single Slack integration with the settings of its Configure page.

GET https://errors.betterstack.com/api/v1/slack-integrations/{id}

URL parameters

id
required string

Headers

Authorization
required string
200

Response body

{
  "data": {
    "id": "188",
    "type": "slack_integration",
    "attributes": {
      "team_id": "t123456",
      "team_name": "My team",
      "applications": [
        {
          "application_id": 1234,
          "environments": [
            "production"
          ]
        }
      ],
      "notifications": {
        "spikes": true,
        "spike_protection": true,
        "new_releases": true,
        "new_errors": true,
        "occurrence_milestones": true,
        "occurrence_threshold": false,
        "affected_users_threshold": true,
        "automatically_reopened": false
      },
      "occurrence_threshold_count": 10,
      "occurrence_threshold_interval": "minute",
      "affected_users_threshold_count": 50,
      "tag_filter": [
        {
          "tag": "level",
          "values": [
            "error",
            "fatal"
          ]
        }
      ],
      "slack_team_name": "My Slack workspace",
      "slack_channel_name": "#errors",
      "post_updates": "thread_based",
      "broadcast_updates": true,
      "ai_sre_on_mention": true
    }
  }
}
401

Response body

{
  "errors": "Invalid Team API token. How to find your Team API token: https://betterstack.com/docs/logs/api/getting-started/#obtaining-a-logtail-api-token"
}
404

Response body

{
  "errors": "Resource with the provided ID was not found"
}

Response attributes

id
string
type
string
attributes.team_id
string
attributes.team_name
string
attributes.applications
array of objects
attributes.applications[].application_id
integer
attributes.applications[].environments
array of strings
attributes.notifications
object
attributes.notifications.spikes
boolean
attributes.notifications.spike_protection
boolean
attributes.notifications.new_releases
boolean
attributes.notifications.new_errors
boolean
attributes.notifications.occurrence_milestones
boolean
attributes.notifications.occurrence_threshold
boolean
attributes.notifications.affected_users_threshold
boolean
attributes.notifications.automatically_reopened
boolean
attributes.occurrence_threshold_count
integer
attributes.occurrence_threshold_interval
string
attributes.affected_users_threshold_count
integer
attributes.tag_filter
array of objects
attributes.tag_filter[].tag
string
attributes.tag_filter[].values
array of strings
attributes.slack_team_name
string
attributes.slack_channel_name
string
attributes.post_updates
string
attributes.broadcast_updates
boolean
attributes.ai_sre_on_mention
boolean

Example cURL

Example
curl --request GET \
  --url https://errors.betterstack.com/api/v1/slack-integrations/188 \
  --header "Authorization: Bearer $TOKEN"