API Reference
API Authentication
Authenticate your API requests with Bearer tokens.
Overview
All wasaaCloud API requests require authentication using a Bearer token. Tokens are generated from Dashboard → API Keys.
Base URL
https://api.wasaacloud.com
All endpoints are prefixed with /api/.
Authenticating requests
Token scopes
| Scope | Permissions |
|---|---|
| instances:read | List and view instances |
| instances:write | Create, update, start, stop, restart instances |
| storage:read | List and view buckets and objects |
| storage:write | Create buckets, upload and delete objects |
| billing:read | View invoices and billing summary |
| domains:read | List and view domains and DNS records |
| domains:write | Create, update and delete DNS records |
Rate limits
API requests are limited to 1,000 requests per hour per token. The response headers include:
X-RateLimit-Limit— requests per hourX-RateLimit-Remaining— remaining requestsX-RateLimit-Reset— Unix timestamp when the limit resets
Exceeding the rate limit returns HTTP 429. Implement exponential backoff in your integrations.
Was this article helpful?
Need more help? Open a support ticket