REST API for Developers

SAYMON API belongs to the REpresentational State Transfer (REST) category. It allows to perform "RESTful" operations such as reading, modifying, adding or deletion data from a cloud account or on-site installation.

New methods and their description are constantly added here:

What can be done using the SAYMON API?

Every operation available in SAYMON web interface can be implemented with API, for example:

and many more.

What API commands are allowed?

SAYMON API has been implemented as JSON over HTTP and allows the following REST Commands:

Command Purpose


Fetch information about existing items


Create new items


Update and modify existing items


Update and modify existing items


Remove existing items

Access rights

Abilities to access to data or perform actions depends on the permissions available for the SAYMON user account.


There are several options which can be used for authentication.

Basic Access Authorization

Basic authentication can be used in order to get info about the account as follows:

$ curl -v -u login:password -H "Content-Type: application/json" -X GET


  • login is account’s username,

  • password account’s password,

  • is the server’s hostname.

Session ID (Cookie)

The system allows to store session ID in Cookies and use the ID in next requests:

$ curl -v --cookie-jar cookies.txt -H "Content-Type: application/json" -X POST --data '{"login": "login", "password": "password"}'
$ curl -v --cookie cookies.txt -H "Content-Type: application/json" -X GET
  type: "POST",
  url: "",
  dataType: 'json',
  async: true,
    "login": "login",
    "password": "password"
  success: function (res){
    console.log('Thanks for your login!');
    console.log('Session ID:'+res);
  error: function () {
    console.log('Login failed!');


  • login is account’s username,

  • password account’s password,

  • is the server’s hostname.

API Key (API Token)

This authentication method can be disabled. Server configuration parameter server.user.auth_token_enabled disables token authentication. Web-application parameter authTokenEnabled disables the Authorization link field in the Web-interface.

In order to obtain an API Token it is necessary to:

  1. Login with these credentials to the system web interface.

  2. Click on the login at the top right corner.

  3. Open the System configuration window.

The API token will be available in the field Authorization link:

It can be used in each request as follows:

$ curl -v -H "Content-Type: application/json" -X GET


  • is the server’s hostname.