POST -Register a new system with the API

Again we will use a REST client to show how this is done. We will register a new system based on the agent that was registered in this section.

The API to use here is



Authorization can be set to "basic" and use your AIMS login credentials.

Here, agentId is the same id you used when registering your agent.

There are two more fields in the request: majorVersion and minorVersion. They hold the version number of your agent. If you registered a new agent without specifying anything version-related, you can leave them at 1 and 0, respectively, which are their default values when you register an agent. You still have to specify them explicitly in the request.

In response to your request you will get an object describing your newly created system, which looks similar to what you have sent, but has an additional id field that identifies your new system.

"agentId": "",
"majorVersion": 1,
"minorVersion": 0,
"name": "API AIMS"


Make sure you check the response for the field named "id". This field contains the unique identifier for the registered system.

You can then visit the Topology section in AIMS and see that your system is registered