Explore documentation
  1. Welcome to AI SRE 👋
  2. AI SRE vs MCP server
  3. Agent configuration
  4. Writing code
    1. Creating pull requests for errors
    2. Bulk resolving errors
  5. Analyzing data
    1. Analyzing incidents
    2. Analyzing logs
    3. Checking for outliers
  6. Managing data
    1. Creating dashboards
    2. Importing Datadog dashboards
    3. Importing Grafana dashboards
  7. Integrations
    1. Linear
    2. Sentry
    3. Datadog
    4. Grafana
    5. GitHub
    6. Notion
  8. AI SRE API
    1. Getting an API token
    2. Chats API
      1. List all chats GET
      2. Get a single chat GET
      3. Create a chat POST
      4. Get chat status GET
      5. Reply to a chat POST
      6. Approve or deny a confirmation PATCH
      7. Remove a chat DELETE

List all chats

Returns a paginated list of your team's chats.

GET https://chat.betterstack.com/api/v2/chats

Query parameters

team_name
string

Filter chats belonging to a specified team when using global API token.

page
integer

Page number

per_page
integer

Items per page (default: 50, max: 250)

Headers

Authorization
required string

Bearer $TOKEN

200

Returns a paginated list of chats, most recently updated first. See Chat statuses for what each status means.

Response body

{
  "data": [
    {
      "id": "12345",
      "type": "chat",
      "attributes": {
        "team_id": 123456,
        "team_name": "example-team",
        "name": "Checkout 5xx spike",
        "status": "idle",
        "message_count": 4,
        "last_message_at": "2026-09-07T10:32:18.000Z",
        "total_tokens": 15420,
        "created_at": "2026-09-07T10:30:00.000Z",
        "updated_at": "2026-09-07T10:32:18.000Z"
      }
    }
  ],
  "pagination": {
    "first": "https://chat.betterstack.com/api/v2/chats?page=1",
    "last": "https://chat.betterstack.com/api/v2/chats?page=3",
    "prev": null,
    "next": "https://chat.betterstack.com/api/v2/chats?page=2"
  }
}
401

Unauthorized

Response body

{
  "errors": "Invalid authentication"
}

Example cURL

Example
curl --request GET \
  --url https://chat.betterstack.com/api/v2/chats \
  --header "Authorization: Bearer $TOKEN"


Previous article

Getting started with AI SRE API

Next article

Get a single chat