Skip to main content

Using APIs with Centreon Cloud

API tokens​

You need an API Token (a type of authentication token) to authenticate with the Centreon APIs. To generate one, go to Administration > Authentication tokens.

An API token is linked to one Centreon user and is valid only for a certain period of time. API calls will be executed according to the rights assigned to this user. A specific user can have several tokens.

Insert your API token in the header of your API call:

Headers {
    Content-Type = application/json
    X-AUTH-TOKEN = your-centreon-token
}

If authentication fails, check whether the token is not revoked or expired.

Centreon Cloud, BAM, and Autodiscovery API address​

https://[organization].[region].centreon.cloud/[instance-name]/api/latest/...

Example: https://my-organization.euwest1.centreon.cloud/centreon/api/latest/...

Centreon MAP API address​

Replace serverURL with the URL of your MAP server (not your central server).

https://[organization].[region].centreon.cloud/_[instance-name]/centreon-map/api/latest/...