Skip to main content

​
Authentication

All API requests require a Bearer token in the Authorization header. 
Authorization: Bearer YOUR_API_TOKEN

​
Getting Your API Token

  1. Log in to the CloudBlast Panel
  2. Go to Account Settings > API
  3. Copy your API token

​
IP Whitelisting

If you’ve configured an IP whitelist in your account settings (apiAddress field), only requests from that IP address will be accepted. Requests from other IPs will receive a 403 error: 
{
  "error": {
    "code": "IP_NOT_ALLOWED",
    "message": "Your IP address is not whitelisted for API access."
  }
}
To allow requests from any IP, leave the IP whitelist field empty.

​
Example Request

curl -H "Authorization: Bearer cb_live_abc123..." \
  https://console.cloudblast.io/api/v2/account

​
Error Responses

StatusCodeDescription
401UNAUTHENTICATEDMissing or invalid Authorization header
401INVALID_TOKENThe API token doesn’t match any account
403ACCOUNT_BANNEDYour account has been suspended
403IP_NOT_ALLOWEDRequest IP is not in your whitelist