Error Codes

HTTP Status Codes

Code	Meaning	Common Cause
200	Success	Request completed
400	Bad Request	Missing required fields, invalid parameters
401	Unauthorized	Missing or invalid Bearer token
402	Payment Required	Insufficient credits
403	Forbidden	No permission to access this resource
404	Not Found	Resource doesn't exist
429	Too Many Requests	Rate limit exceeded
500	Internal Server Error	Server-side error or execution failure
504	Gateway Timeout	Resource exceeded 120s timeout

Error Response Format

{
  "error": "Description of what went wrong",
  "requestId": "req-xxx"
}

Common Errors

"Alias required"

You must set an alias before creating resources. Set one at universalapi.co/keys or via API:

curl -s -X POST https://api.universalapi.co/user/alias \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"alias": "your-name"}' | jq

"Insufficient credits"

Your account doesn't have enough credits. Check balance at universalapi.co or purchase more via the Pricing page.

"Execution error"

The resource's source code threw an exception. Check the code and logs.