List all Linear integrations

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

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

Query parameters

team_name
string
page
integer
per_page
integer

Headers

Authorization
required string
200

Response body

{
  "data": [
    {
      "id": "66368",
      "type": "linear_integration",
      "attributes": {
        "team_id": "t123456",
        "team_name": "My team",
        "applications": [],
        "notifications": {
          "spikes": false,
          "new_errors": true,
          "automatically_reopened": true,
          "occurrence_milestones": false,
          "occurrence_threshold": true,
          "affected_users_threshold": false
        },
        "occurrence_threshold_count": 100,
        "occurrence_threshold_interval": "hour",
        "affected_users_threshold_count": 10,
        "tag_filter": [
          {
            "tag": "environment",
            "values": [
              "production"
            ]
          }
        ],
        "name": "Platform errors",
        "linear_team_id": "9cfb482a-81e3-4154-b5b9-2c805e70a02d",
        "linear_assignee_id": "",
        "linear_status_id": "5c3a1f8e-2b7d-4e61-9a0c-7d4b8e2f1a36",
        "linear_resolved_status_id": "e2d4f6a8-1b3c-4d5e-8f70-9a1b2c3d4e5f",
        "linear_project_id": "",
        "linear_label_ids": [
          "0b8f3c2e-6a1d-4f97-b5e4-3c2a1d0e9f8b"
        ],
        "linear_priority": "high",
        "auto_reopen": true,
        "auto_resolve": true,
        "sync_comments": true
      }
    }
  ],
  "pagination": {
    "first": "https://errors.betterstack.com/api/v1/linear-integrations?page=1",
    "last": "https://errors.betterstack.com/api/v1/linear-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.applications
array of objects
attributes.applications[].application_id
integer
attributes.applications[].environments
array of strings
attributes.notifications
object
attributes.notifications.spikes
boolean
attributes.notifications.new_errors
boolean
attributes.notifications.automatically_reopened
boolean
attributes.notifications.occurrence_milestones
boolean
attributes.notifications.occurrence_threshold
boolean
attributes.notifications.affected_users_threshold
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.name
string
attributes.linear_team_id
string
attributes.linear_assignee_id
string
attributes.linear_status_id
string
attributes.linear_resolved_status_id
string
attributes.linear_project_id
string
attributes.linear_label_ids
array of strings
attributes.linear_priority
string
attributes.auto_reopen
boolean
attributes.auto_resolve
boolean
attributes.sync_comments
boolean
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/linear-integrations \
  --header "Authorization: Bearer $TOKEN"