Reject a held action
POST
/v1/agent-action-requests/:id/rejectWrite API
The action never runs. The agent is told, with your reason if you give one, and explains it to the customer in its own words. Returns 409 when someone already answered it or it expired.
Permission: agents:approve · 60 requests / minute
Path parameters
- idstringRequired
- The requestId from the list or the webhook event.
Request body
- reasonstringOptional
- Why it was rejected, up to 500 characters.
curl -X POST "https://public-api.wsmartsender.com/v1/agent-action-requests/667f1a2b3c4d5e6f7a8b9c0d/reject" \
-H "X-Api-Key: wss_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"reason": "Price is wrong; the agent should offer 199."
}'Response fields200
{ requestId, conversationId, contactId, agentId, toolName, summary, status: rejected, reviewedBy, reviewedAt, rejectionReason }