Syntropy Agent is an easy-to-use dependency to automatically encrypt and connect endpoints within a network. Syntropy's user interface allows heightened visibility into network health and connectivity.
Property Type Description Example agent_id
integer
Unique identifier for the agent
. 123
agent_public_ipv4
string
(IPv4 format )IP address of the agent in IPv4 format 198.185.159.144
agent_location_city
string
City, where your agent is based. "Vilnius"
agent_device_id
string
A unique agent identifier. Usually machine id
or other unique UUID
with a workspace id prefix
(to scope this agent to workspace). "bf130282-6c2d-4c90-b112-490b051160a3"
agent_name
string
Name of the agent as it appears in Platform UI. "default agent"
agent_status
string
Current status
of the agent. "OK"
agent_version
string
formatted as SemVersion Version of the agent . 3.2.0
agent_locked_fields
Locked Fields object
Fields that cannot be amended after creation of the agent. { "location_country": true, "location_city": true, "location_lat": true, "location_lon": true, "provider_name": true, "tags": [ "string" ], "name": true }
agent_modified_at
string
(ISO 8601 date and time )Date and time when this agent was modified. Formatted as an ISO 8601 date time string. "2020-03-17T19:10:04.968Z"
agent_is_virtual
boolean
Indicates if it's a virtual agent . true
agent_type
string
Possible types: LINUX
, MACOS
, WINDOWS
, VIRTUAL
"Linux"
agent_provider
Provider object
Returns provider of agent's endpoint. Full list of providers { "provider_name": "string", "provider_id": 123 }
agent_tags
Tags object
Agent specific words that can help you to create some rules around specific tags. [ { "tag_name": "string", "tag_id": 1110 } ]
agent_services_subnets_enabled_count
integer
Number of enabled subnets of the agent's endpoint. 4
agent_services_subnets_count
integer
Number of subnets of the agent's endpoint. 23
agent_location_country
string
formatted as country ISO code Agent's location country two-letter code . "LT"
agent_is_online
boolean
Current status of the agent. true
Property Type Description Example agent_location_country
boolean
Indicates if agent's country cannot be changed after creation. true
agent_location_city
boolean
Indicates if agent's city cannot be changed after creation. true
agent_location_lat
boolean
Indicates if agent's location latitude cannot be changed after creation. true
agent_location_lon
boolean
Indicates if agent's location longitude cannot be changed after creation. true
agent_provider_name
boolean
Indicates if agent's provider's name cannot be changed after creation. true
agent_tags
array
of strings
List of the tags that cannot be changed after creation of the agent. ["tag_1", "tag_2"]
agent_name
boolean
Indicates if agent's name cannot be changed after creation. true
Property Type Description Example agent_provider_id
integer
Unique identifier for the provider
. 1 agent_provider_name
string
Name of the provider
. Full list of providers . "Amazon Web Services"
Property Type Description Example agent_tag_name
string
Name of the tag
given to the agent . "tag"
agent_tag_id
integer
Unique identifier for the tag
. 123
JSON
{
"data": [
{
"agent_id": 1110,
"agent_public_ipv4": "198.185.159.144",
"agent_location_city": "Vilnius",
"agent_device_id": "2852:fTNiX0klwU01r0fe",
"agent_name": "default agent",
"agent_status": "OK",
"agent_version": "3.2.0",
"agent_locked_fields": {
"agent_location_country": true,
"agent_location_city": true,
"agent_location_lat": true,
"agent_location_lon": true,
"agent_provider_name": true,
"agent_tags": [
"tag_1",
"tag_2"
],
"agent_name": true
},
"agent_modified_at": "2022-06-17T13:31:30.614Z",
"agent_is_virtual": true,
"agent_type": "LINUX",
"agent_provider": {
"agent_provider_name": "Amazon Web Services",
"agent_provider_id": 1
},
"agent_tags": [
{
"agent_tag_name": "tag_1",
"agent_tag_id": 2
}
],
"agent_services_subnets_enabled_count": 0,
"agent_services_subnets_count": 0,
"agent_location_country": "LT",
"agent_is_online": true
}
]
}