List actions waiting for approval

GET
/v1/agent-action-requests
Read API

Actions an AI agent is holding for a person to approve (tools set to the approval policy), newest first. The same queue as the Approvals page in the app: answer from your own system with approve or reject, and whoever answers first wins. Pair it with the agent.approval_requested and agent.approval_resolved webhook events. A key limited to one number sees only that number; a key limited to its owner’s assigned chats is refused.

Permission: agents:approve · 60 requests / minute

Query parameters

connectionIdstringOptional
Only requests on this number.
conversationIdstringOptional
Only requests held in this conversation.
cursorstringOptional
nextCursor from the previous page.
limitintegerOptional
Items per page. Default 25, maximum 100.
curl -X GET "https://public-api.wsmartsender.com/v1/agent-action-requests" \
  -H "X-Api-Key: wss_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Response fields200

{ items: [{ requestId, organizationId, conversationId, contactId, contactName, agentId, toolName, summary, status, expiresAt, reviewedBy, reviewedAt, rejectionReason }], nextCursor }