Appeal a switched-off endpoint

POST
/v1/endpoints/{endpoint}/appeal

When VoiceLayer switched an endpoint off because of an abuse report, this puts your answer on the endpoint's record and in the operators' queue. It answers 202; an operator reviews it and either switches the endpoint back on or tells you why not. Only an endpoint VoiceLayer switched off can be appealed.

Requires an API key with the workspace:write scope.

Authorization

apiKey
headerAuthorizationBearer <token>

A secret API key from the dashboard (Developers → API keys): vl_live_…, or vl_test_… for test mode. Each operation says which scope the key needs.

Path Parameters

endpoint*string

The endpoint id: the first segment of its run.vlayers.ai URL.

Request Body

application/json
  1. body
message*string

What happened, and what you changed (10 to 2,000 characters).

Length10 <= length <= 2000

Response Body

The appeal is on the endpoint's record for an operator to review

application/json
  1. response
reportId*string
status*"appealed"
Value in"appealed"
Example Request
curl -X POST "https://api.vlayers.ai/v1/endpoints/$ENDPOINT_ID/appeal" \  -H "Authorization: Bearer $VOICELAYER_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "message": "The page was a test of ours and has been removed."  }'
Example Response
{  "reportId": "rep_0123456789abcdef01",  "status": "appealed"}