Error
action_refused
The send was stopped before it went out
| HTTP status | 403 |
|---|---|
| Retry | No: fix the request first |
| details | reason: capability_not_declared or policy_blocked. |
What happened
The send was stopped before it went out.
Why
VoiceLayer checks every message an outside agent (an API key or a connected app) sends. This one was stopped because the key or app is not allowed to send, or your workspace's security policy said no. Nothing was sent, and the refusal is recorded in the Access log.
How to fix it
Give the key or app permission to send messages (Access page), or ask the workspace owner about the policy. details.reason says which.
Example response
{
"error": "action_refused",
"message": "The send was stopped before it went out.",
"requestId": "req-8f2c1d4b",
"retryable": false,
"docs": "https://docs.vlayers.ai/errors/action_refused"
}See Errors, retries and idempotency for how to handle errors in general.