API Call Name:

v1 Get AgentID

API Call URL:

https://api.hetrixtools.com/v1/<API_TOKEN>/get/agentid/<UPTIME_MONITOR_ID>/

API Call Info:

This API Call is used to get (or generate) the unique Server Agent ID attached to an Uptime Monitor.

If there is no Server Agent ID attached to the Uptime Monitor that you are requesting it for, a new one will be generated during the API Call.

The Server Agent ID is used by the Server Agent, installed on your server, in order to send data to our platform. Each Server Agent uses a unique Server Agent ID.

API Call Link Variables:

API Call Return Payload:

{
	"AgentID": "zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz",
	"Status": "old"
}

API Call Return Payload Variables:

  • AgentID – will be the unique Server Agent ID that is attached to this Uptime Monitor (that you’ve requested the API Call for)
  • Status – will either be “new” or “old“. If this value is “new” it means that this Uptime Monitor had no Server Agent ID attached to it, and a new one has just been generated using this API Call; if this value is “old” it means that this Uptime Monitor already had a Server Agent ID attached to it.