This article provides a basic overview of REST API Client requirements for the CloudControl API


This article outlines the fundamental requirements for REST clients that are suitable to use for making successful requests to the CloudControl API.

The article applies equally for REST clients that are embedded in code integrations as for those that are intended for human use, although the latter is the primary focus of this outline.


CloudControl is a REST-style stateless API and requires that each REST client supports the ability to:

  1. communicate over HTTPS.
  2. set an arbitrary request URL.
  3. specify HTTP BASIC Authorization header.
  4. specify HTTP Request Headers and respective values.
  5. specify HTTP Request Parameters.
  6. specify arbitrary Request Body content. 
    1. *API 0.9 supports a combination of HTTP FORM and XML requests.
    2. *API 2 supports either JSON or XML on any request.
  7. copy and paste request samples, and values from responses.

*The request format is of less relevance if accessing Reports APIs. Refer to the API documentation for detailed information.

Nice to have REST Client features

  1. JSON request and response formatting for ease of reading.
  2. XML request and response formatting for ease of reading.
  3. The ability to save and substitute variables, e.g. an API host.
  4. The ability to save, organize and reuse requests, e.g. Get Network Domain.

Example REST Client

Postman REST Client ( was used for all screenshots in API integration articles on this documentation website.


For detailed API usage please refer to the API documentation.

The most likely error scenarios that Users encounter when first attempting to use the CloudControl REST API are: 

  1. Incorrectly configured Authorization Request Header
  2. Incorrect API URL
    1. Missing \{org-id\}
  3. Incorrect Request Method
  4. Missing Accept Request Header
  5. Typographic Error in JSON or XML content.

API functions require you to input the Organization ID (ORG ID) and the ID of any resources that are being managed.
If you are unaware of how to find the ID for your organization, or for one of the assets in your environment, see:
How do I Determine the ID of a Cloud Account or Other Cloud Resource


How do I Determine the ID of a Cloud Account or Other Cloud Resource

Recently Updated