API Overview


This article is deprecated. Smart Tools reached End of Life (EOL) on July 31, 2019 and is no longer available for use with on-premises Virtual Apps and Desktops Sites or Sites using the Virtual Apps and Desktops service. For more information about Smart Tools deprecation and alternatives, see the following articles:

REST APIs allow you to retrieve and collect useful system information from Citrix Smart Tools database. You can also perform some basic management functions using the REST APIs.

The global URL to access any API is httpsː//SERVERNAME/SUPPORTED_VERSION/. The server name will change depending on the environment. Current supported version is v0. For example, https://smart.cloud.com/v0/.

By default, every string passed to and from is UTF-8 encoded. Some of them are Base64 encoded. Each API explicitly specifies which field is base64 encoded.

Before you access any API, ensure that you have the apikey and apisecret key. The client can not use same username and password used to access the Citrix Smart Tools UI. You can interchange apikey and secret key also as client_id and client_secret for OAuth2 authentication purposes. After successful authentication every API must have a parameter access_token, which contains a VALID_TOKEN_GENERATED_BY_AUTHENTICATION.

The system will respond with an HTTP error code, if an invalid or incorrect API is passed. The following table describes some of the HTTP status error codes:

Error Code Description Resolution
400 Bad input parameters or error messages. Ensure correct input parameters are provided.
401 Bad credentials or expired token. Ensure valid authentication credentials are used.
404 Bad API name. Ensure the correct API is passed.
500 Internal server error. This happens only if errors are not handled properly on the server. Ensure errors are properly handled at the internal server.

API Overview