Error

wallet_refused

The balance cannot cover this message

HTTP status402
RetryNo: fix the request first
detailsThe wallet's refusal: what the message needed and what was available.

What happened

The balance cannot cover this message.

Why

The workspace's prepaid balance cannot cover the message's price, so nothing was sent.

How to fix it

Top up the wallet (or turn on auto top-up) in the dashboard, then send again.

Example response

HTTP 402
{
  "error": "wallet_refused",
  "message": "The balance cannot cover this message.",
  "requestId": "req-8f2c1d4b",
  "retryable": false,
  "docs": "https://docs.vlayers.ai/errors/wallet_refused"
}

See Errors, retries and idempotency for how to handle errors in general.

On this page