Skip to main content
POST
Submit tool-call input (batch)

Authorizations

Authorization
string
header
required

Personal access token, sent as Authorization: Bearer <token>. Each operation lists the permission it needs: read_only or full_access. A full-access token can call every operation. A read-only token can call only the operations that list read_only; anything else returns 403 read_only_credential_route_not_allowed.

Path Parameters

app_id
string
required

ID of the app whose AI chat this request acts on.

Body

application/json
tool_call_ids
string[]
required

IDs of the tool calls to answer, up to 100. They all get the same action, and a repeated ID is answered once.

Maximum array length: 100
Example:
action
enum<string>
required

Whether to let these tool calls run or turn them down.

Available options:
approved,
rejected
Example:

"approved"

Response

Successful Response

The app after a batch of tool calls was answered, with one result per call.

results
BatchToolCallResultSummary · object[] | null

One entry per tool call that was answered, in the order they were processed. A repeated ID appears once, so this can be shorter than the list you sent. Empty when the request was a duplicate that had already been applied.

app
ChatTurnResponse · object | null

The app once the resumed turn finished.