v4

latestOpenAPI 3.1.02026-08-03427198448.4 KB
Agent Chat

Respond To Permission Request

Respond to a permission request from the agent.

When the agent calls send_invoice, send_proposal, or send_gmail, it emits a permission_request event via SSE. The frontend displays a confirmation dialog and calls this endpoint with the user's response.

The agent waits up to 60 seconds for a response. If no response is received, the permission request times out and the tool call is denied.

Request body: thread_id: The thread ID request_id: The permission request ID (from the permission_request event) approved: True to allow the action, False to deny message: Optional message explaining the decision (shown to agent if denied)

Returns: success: True if the response was handled message: Status message

post/api/permission-response

Query parameters

user_idstring
org_idstring

Request body

thread_idstring nullable
request_idstring required
approvedboolean required
messagestring nullable

Response

Successful Response

{"stackTrail":"paths:/api/permission-response:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}