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

Create a chat

Creates a new chat and starts the first agent turn on your message. The request returns as soon as the message is saved. Poll the chat status until it leaves processing, then get the chat to read the answer.

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

Headers

Authorization
required string

Bearer $TOKEN

Content-Type
required string

application/json

Body parameters

team_name
string

Required if using global API token to specify the team which should own the chat.

message
required string

Your first message to the agent.

name
string

Chat name. If omitted, the chat is named automatically after the first turn.

201

Returns the newly created chat, still processing. Its transcript holds your message and a placeholder for the agent's answer.

Response body

{
  "data": {
    "id": "12345",
    "type": "chat",
    "attributes": {
      "team_id": 123456,
      "team_name": "example-team",
      "name": "Checkout 5xx spike",
      "status": "processing",
      "message_count": 2,
      "last_message_at": "2026-09-07T10:30:00.000Z",
      "total_tokens": 0,
      "created_at": "2026-09-07T10:30:00.000Z",
      "updated_at": "2026-09-07T10:30:00.000Z",
      "messages": [
        {
          "id": 9001,
          "message_type": "user",
          "text": "Why did checkout start returning 5xx at 10:15?",
          "artifacts": [],
          "created_at": "2026-09-07T10:30:00.000Z",
          "user": null
        },
        {
          "id": 9002,
          "message_type": "ai",
          "text": null,
          "artifacts": [],
          "created_at": "2026-09-07T10:30:00.000Z",
          "user": null
        }
      ],
      "pending_confirmations": []
    }
  }
}
401

Unauthorized

Response body

{
  "errors": "Invalid authentication"
}
403

Forbidden - AI SRE Not Included In Your Plan

Response body

{
  "errors": "AI SRE is not available on this plan."
}
422

Unprocessable Entity - Missing Required Attributes

Response body

{
  "errors": "Sorry, you are missing some required attributes",
  "required_attributes": [
    "message"
  ]
}
422

Unprocessable Entity - Validation Errors

Response body

{
  "errors": "Sorry, some values are incorrect",
  "invalid_values": {
    "message": "can't be blank"
  }
}

Example cURL

Example
curl --request POST \
  --url https://chat.betterstack.com/api/v2/chats \
  --header "Authorization: Bearer $TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
    "message": "Why did checkout start returning 5xx at 10:15?",
    "name": "Checkout 5xx spike"
  }'


Previous article

Get a single chat

Next article

Get chat status