List all Microsoft Teams integrations

Lists the Microsoft Teams integrations of Errors, with the settings of their Configure pages. Connect and remove them in Errors → Integrations

GET https://errors.betterstack.com/api/v1/microsoft-teams-integrations

Query parameters

team_name
string
page
integer
per_page
integer

Headers

Authorization
required string
200

Response body

{
  "data": [
    {
      "id": "55",
      "type": "microsoft_teams_integration",
      "attributes": {
        "team_id": "t123456",
        "team_name": "My team",
        "notifications": {
          "spikes": true,
          "spike_protection": true,
          "new_releases": true,
          "new_errors": true,
          "occurrence_milestones": true,
          "occurrence_threshold": false,
          "affected_users_threshold": false,
          "automatically_reopened": false
        },
        "occurrence_threshold_count": 10,
        "occurrence_threshold_interval": "minute",
        "affected_users_threshold_count": 10,
        "tag_filter": [],
        "microsoft_teams_team_name": "Engineering",
        "microsoft_teams_channel_name": "General",
        "routes": [
          {
            "applications": [
              {
                "application_id": 1234,
                "environments": [
                  "production"
                ]
              }
            ],
            "channels": [
              {
                "id": "19:a1b2c3d4e5f6@thread.tacv2",
                "name": "Checkout errors"
              }
            ]
          },
          {
            "applications": [],
            "channels": [
              {
                "id": "19:f6e5d4c3b2a1@thread.tacv2",
                "name": "General"
              }
            ]
          }
        ]
      }
    }
  ],
  "pagination": {
    "first": "https://errors.betterstack.com/api/v1/microsoft-teams-integrations?page=1",
    "last": "https://errors.betterstack.com/api/v1/microsoft-teams-integrations?page=1",
    "prev": null,
    "next": null
  }
}
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"
}

Response attributes

id
string
type
string
attributes.team_id
string
attributes.team_name
string
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.microsoft_teams_team_name
string
attributes.microsoft_teams_channel_name
string
attributes.routes
array of objects
attributes.routes[].applications
array of objects
attributes.routes[].applications[].application_id
integer
attributes.routes[].applications[].environments
array of strings
attributes.routes[].channels
array of objects
attributes.routes[].channels[].id
string
attributes.routes[].channels[].name
string
pagination.first
string
pagination.last
string
pagination.prev
string or null
pagination.next
string or null

Example cURL

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