Explore documentation
  1. Welcome to AI SRE 👋
  2. AI SRE vs MCP server
  3. Customize AI SRE
  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
    3. List models GET

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.

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"
}

Response attributes

id
string

The ID of the chat.

type
string

Always chat_status.

attributes.status
string

Whether the agent is working on the chat: processing, awaiting_confirmation, or idle. Chat statuses explains each.

attributes.pending_confirmations
array

The tool runs waiting for your approval, oldest first, empty unless the status is awaiting_confirmation.

attributes.pending_confirmations[].id
integer

The ID of the confirmation, used to approve or deny it.

attributes.pending_confirmations[].tool_name
string

The name of the tool the agent wants to run, such as Bash.

attributes.pending_confirmations[].tool_input
object

The input the agent wants to run the tool with, such as the command.

attributes.pending_confirmations[].status
string

Always pending, since only confirmations still waiting for a decision are listed.

attributes.pending_confirmations[].resolution_note
string or null

The note left with the decision, always null here since the confirmation is still pending.

attributes.pending_confirmations[].expires_at
string

When the confirmation expires if nobody approves or denies it, as an ISO 8601 date-time in UTC.

attributes.pending_confirmations[].confirmed_at
string or null

When the confirmation was approved or denied, always null here since the confirmation is still pending.

attributes.pending_confirmations[].created_at
string

When the agent asked for the confirmation, as an ISO 8601 date-time in UTC.

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