Reject a held action

POST
/v1/agent-action-requests/:id/reject
Write 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 }