Skip to main content
How to Use the Cloudways API

Learn how to use Cloudways API to leverage the technology behind the platform and build your applications on top of it.

Usama Zafar avatar
Written by Usama Zafar
Updated over 4 months ago

Table of Contents

Cloudways Platform API provides the power, flexibility, and ease of use of the Cloudways Platform in a simple to use API. With Cloudways API, developers, e-commerce store owners, and development agencies can leverage the technology behind the Cloudways Platform and build their applications on top of it.

You can integrate server operations, perform application-related tasks, and automate different workflows of your servers. Cloudways API is powerful yet intuitive and easy to use and allows you the power to do everything with it that you can on the Platform.

Important

If you change your email address associated with your Cloudways account, your Cloudways API key will also be updated. This means you will need to reconfigure your integrations using the new API key. Please ensure you update any systems or applications that rely on the Cloudways API to avoid disruptions in service.

How to Use the Cloudways API

Step #1 — Launch API

Log into the Cloudways Platform with your credentials and click on API from the top menu icon.

Step #2 — Generate an API Key

On the next page, you will need to create an API Key. This API Key will be needed for you to authorize yourself to the API in order to use it. To do that, click on Generate API Key.

Step #3 — Access API Documentation and Playground

Once the key is generated, click on it to copy and proceed to the next step.

You can also access API Documentation and API Playground right from here.

API Secret Key: If you ever wish to change your API Key, click on Regenerate Key. This will revoke your old Key, so please keep a note of your Key at a safe place to use it in the future.

API Documentation: For details of the API and each of its end-points, the API Documentation is the authoritative source. It covers detailed specifications and documentation of the Platform API.

API Playground: This is an online, in-browser playground for interacting with the API. This is by far the best way to become familiar with the API and test-friendly waters. Please note that while we call it the Playground, any actions performed on the playground will be performed against your main account with which you will authenticate. You will have to be careful which end-points you call on which of your servers. The safest path would be to use a test server under your account for this.

Important

Please note that Cloudways API rate limit is 100 requests per minute.

Step #4 — Use the API Playground to Become Familiar With the API

In this step, click on the Authorize button on the top right corner and enter your registered Cloudways account email ID and the API Key you copied in Step 3.

The API Playground will make it very easy for you to test out different API end-points and observe how they behave. You will also find helpful examples of each API endpoint call. Once you have become familiar and comfortable with the API, you can dive deep into the API Documentation and begin coding up your programs to use the Platform API.

That’s it! We hope this article was helpful. If you need any help, then feel free to search your query on Cloudways Support Center or contact us via chat (Need a Hand > Send us a Message). Alternatively, you can also create a support ticket.

Did this answer your question?