Using the APIs with our Postman collection

You can try all the request examples in our documentation through a popular Postman REST client. You can do so by installing our Postman collection, optionally configuring your environment and executing the requests.

1. Installing the collection

If you don't have Postman installed, you can get it from the Postman apps page.

Then, use the following button to quickly install a Kentico Cloud collection of requests:

Run in Postman

Postman will ask in which its variant the collection will open. After confirming all dialogs, the collection will appear in the left pane:

The Kentico Cloud collection for Postman

The Kentico Cloud collection for Postman

2. (Optional) Configuring your environment

In Postman, Environments are just sets of variables and their values. These variables can then be used everywhere in Postman (in your requests).

In our collection, there are already all the appropriate variables defined in the collection's property dialog (accessible by right-clicking and hitting Edit). They have also been given sample values.

The variables defined in the collection itself

The variables defined in the collection itself

But, you may want to clone these variables into your own Environment for two reasons:

  • You can have several Environments that hold several sets of values of the variables.
  • When a variable is defined in an Environment (instead of the Edit dialog of the collection), Postman will offer these variables via its auto-complete functionality every time you edit the example requests.
Using a variable that has been defined via an Environment

Using a variable that has been defined via an Environment

3. Executing the requests

In the left pane, the collection can be expanded. The collection's structure mimics what you see in the navigation on this site. In each folder, you'll find requests.

You can execute the request by clicking Send. If you have an Environment configured and selected in the top right corner of the window, the variable values of the Environment will be used. Otherwise, the values configured in the collection's Edit dialog will be taken into account.

Upon clicking Send, you'll be presented with a response.

A response of a sample request

A response of a sample request

Storing API keys

You can supply your API keys to the sample requests by right-clicking the folders in the collection and clicking Edit. Then, in the Authorization tab you'll be able to insert your API key.

Warning: Keys are synced into your Postman account in the cloud

The API keys, once configured, will be synced to your Postman account on Postman servers.

We advise against storing of the API key in your collection permanently.

Warning: Do not share the collection further with your API keys in it

We advise against storing your API keys in your collection permanently as the collection might be mistakenly shared or exported together with these keys.

Happy playing with our APIs!