Error

test_mode_only

Only a test key can do this

HTTP status403
RetryNo: fix the request first

What happened

Only a test key can do this.

Why

The operation exists only in test mode (POST /v1/test/inbound), and the request used a live key.

How to fix it

Use a test key (vl_test_…) from the dashboard.

Example response

HTTP 403
{
  "error": "test_mode_only",
  "message": "Only a test key can do this.",
  "requestId": "req-8f2c1d4b",
  "retryable": false,
  "docs": "https://docs.vlayers.ai/errors/test_mode_only"
}

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

On this page