Skip to main content
POST
Decide Action Approvals

Authorizations

Authorization
string
header
required

Bearer token authentication using your API key

Path Parameters

chat_id
string
required

Chat ID

message_id
string
required

Message ID

Body

Accept or reject pending approvals in one request. The assistant resumes only when the message has no pending approvals left, and exactly once.

decisions
object[]
required

One decision per pending tool call.

Required array length: 1 - 32 elements
background
boolean

When true, decisions are recorded immediately and any execution runs in the background. Defaults to false, which blocks until the step finishes when these were the last pending approvals.

Response

200 - application/json

The chat message schema

id
string
required
role
enum<string>
required

The role of the message

Available options:
user,
assistant,
system,
tool,
event,
note
model
string
required

The model used for the message

status
enum<string>
required

The chat status

Available options:
RUNNING,
COMPLETED,
FAILED,
CANCELED
created_at
string<date-time> | null
required
updated_at
string<date-time> | null
required
messages
object[]

The message content

System message

member
object

The member of the chat

error
string

Error message if the message failed

broadcast_id
string

ID of the broadcast this message originates from

is_broadcast_message
boolean

Whether this message was sent via a broadcast template

usage
object

The usage information for the message

delivered_at
string<date-time> | null

When the message was delivered to the recipient

reactions
object[]

Emoji reactions on the message