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

Get chat status

Returns the status of a chat without its transcript. Poll this endpoint after you create a chat or reply to it.

GET https://chat.betterstack.com/api/v2/chats/{id}/status

URL parameters

id
required string

The ID of the chat.

Headers

Authorization
required string

Bearer $TOKEN

200

Returns the chat status and any pending confirmations. See Chat statuses below for what each status means.

Response body

{
  "data": {
    "id": "12345",
    "type": "chat_status",
    "attributes": {
      "status": "awaiting_confirmation",
      "pending_confirmations": [
        {
          "id": 501,
          "tool_name": "Bash",
          "tool_input": {
            "command": "kubectl rollout restart deployment/checkout-api -n production"
          },
          "status": "pending",
          "resolution_note": null,
          "expires_at": "2026-09-07T11:31:05.000Z",
          "confirmed_at": null,
          "created_at": "2026-09-07T10:31:05.000Z"
        }
      ]
    }
  }
}
401

Unauthorized

Response body

{
  "errors": "Invalid authentication"
}
404

Not Found

Response body

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

Example cURL

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


Chat statuses

Status What it means
processing The agent is working on the latest message. Poll again in a few seconds.
awaiting_confirmation The agent wants to run a tool that needs your approval and waits for you. Approve or deny each confirmation listed in pending_confirmations. The agent then continues and the status returns to processing.
idle The turn is over. Get the chat to read the answer, or reply to continue.

Previous article

Create a chat

Next article

Reply to a chat