List actions waiting for approval
GET
/v1/agent-action-requestsRead 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 }