API Overview

The CloudSigma API is a REST API that accepts JSON requests and returns JSON responses. All endpoints are under the /v1/ prefix.

Base URL

https://cloudsigma.a13e.com

All examples in this documentation use the production base URL.

Authentication

Every endpoint (except /v1/health) requires a Bearer token in the Authorization header:

Authorization: Bearer <token>

CloudSigma supports two token types:

See Authentication for setup instructions.

Response Envelope

All responses use a consistent envelope format.

Success:

{
  "success": true,
  "data": { ... }
}

Error:

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable description"
  }
}

HTTP status codes follow standard conventions: 200 for success, 400 for bad requests, 401 for unauthorized, 403 for forbidden, 429 for rate limits, and 500 for server errors.

Rate Limits

Monthly Limits by Tier

CORS

The API supports CORS for browser-based requests from allowed origins.

Endpoints