Escalate a rejected URL

POST

Request manual review of a rejected URL. Only URLs in 'rejected' status can be escalated; the status then moves to 'escalated'.

Authorization

Authorizationheaderrequired
Bearer YOUR_API_KEY. Create a key in the dashboard.

Path parameters

urlIdstringrequired

Body

application/json

reasonstringrequired
Why the URL should be reviewed manually.
Limitsmin length 10 · max length 1000

Responses

200URL escalated for manual review.

urlobjectrequired
7 properties
- idstringrequired
- urlstringrequired
  The verified URL.
- domainstringrequired
  Domain extracted from the URL.
- statusstringrequired
  Status of a verified URL.
  One ofpendingapprovedrejectedescalatedmalicious
- approvalTypestring
  How the URL was approved or rejected.
  One ofmanualauto_web_risk
- createdAtstring<date-time>required
- updatedAtstring<date-time>
messagestringrequired

400Only rejected URLs can be escalated, or the URL is already escalated.

codestringrequired
messagestringrequired
detailsobject

401Unauthorized.

codestringrequired
messagestringrequired
detailsobject

404URL not found.

codestringrequired
messagestringrequired
detailsobject


curl -X POST "https://api.zavu.dev/v1/urls/url_abc123/escalate" \
  -H "Authorization: Bearer $ZAVUDEV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "reason": "This is our official landing page and was rejected in error."
}'


{
  "url": {
    "id": "url_abc123",
    "url": "https://example.com/page",
    "domain": "example.com",
    "status": "pending",
    "approvalType": "manual",
    "createdAt": "2026-01-01T00:00:00Z",
    "updatedAt": "2026-01-01T00:00:00Z"
  },
  "message": "string"
}