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

Approve or deny a confirmation

Approves or denies a pending tool-use confirmation. AI SRE asks for a confirmation before sensitive actions such as writing code or creating alerts. While a confirmation is pending, the chat status is awaiting_confirmation and the agent waits. Once you resolve it, the agent continues and the status returns to processing.

PATCH https://chat.betterstack.com/api/v2/chats/{chat_id}/confirmations/{id}

URL parameters

chat_id
required string

The ID of the chat.

id
required integer

The ID of the confirmation, from pending_confirmations in the chat status.

Headers

Authorization
required string

Bearer $TOKEN

Content-Type
required string

application/json

Body parameters

approved
required boolean

Set to true to approve the action, false to deny it.

comment
string

A note for the agent. When denying, the agent sees it as the reason.

allow_tool_for_session
boolean

Set to true when approving to also allow this tool for the rest of the agent session, so the agent does not ask again.

200

Returns the resolved confirmation.

Response body

{
  "data": {
    "id": "501",
    "type": "confirmation",
    "attributes": {
      "tool_name": "Bash",
      "tool_input": {
        "command": "kubectl rollout restart deployment/checkout-api -n production"
      },
      "status": "approved",
      "resolution_note": null,
      "expires_at": "2026-09-07T11:31:05.000Z",
      "confirmed_at": "2026-09-07T10:33:40.000Z",
      "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"
}
409

Conflict - Already Resolved

Response body

{
  "errors": "This confirmation is no longer pending."
}
422

Unprocessable Entity - Validation Errors

Response body

{
  "errors": "Sorry, some values are incorrect",
  "invalid_values": {
    "approved": "must be true or false"
  }
}

Example cURL

Example
curl --request PATCH \
  --url https://chat.betterstack.com/api/v2/chats/12345/confirmations/501 \
  --header "Authorization: Bearer $TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
    "approved": true,
    "allow_tool_for_session": false
  }'


Previous article

Reply to a chat

Next article

Remove a chat