GET private-agent/get/{agent_id}
Retrieves a specific private agent by ID for the current customer.
URL Parameters
| Name | Description |
|---|---|
| agent_id | The ID of the agent to retrieve. |
Remarks
Use GET private agents route to get the list of private agents having values applicable for agent_id.Request example
curl --request GET "https://api-asm1.apica.io/v3/private-agent/get/{agent_id}?auth_ticket=C471ADC4-19B4-4219-BBF4-671A97EC653E"
Response body model example and description
{
"agent_id": "242bcbc3-7357-4680-9020-877378074553",
"agent_name": "sample string 2",
"customer_guid": "6c1fef1a-dbce-43c5-a36a-01a45a070fc3",
"geoloc": "sample string 4",
"created_utc": "2025-04-03T17:20:33",
"last_updated_utc": "2025-04-03T17:20:33",
"enabled": true,
"health": "sample string 8",
"status": "sample string 9",
"status_updated_at": 10,
"certificate_valid_from_utc": "2025-04-03T17:20:33",
"certificate_valid_till_utc": "2025-04-03T17:20:33",
"node_status": "sample string 13",
"status_description": "sample string 14",
"scheduling_eligibility": "sample string 15"
}
| Name | Type | Description |
|---|---|---|
| AgentId | Guid |
The unique identifier of the agent. |
| AgentName | String |
The name of the agent. |
| CustomerGuid | Guid |
The unique identifier of the customer. |
| Geoloc | String |
The geolocation string. |
| CreatedUtc | DateTime |
The UTC timestamp when the agent was created. |
| LastUpdatedUtc | DateTime |
The UTC timestamp when the agent was last updated. |
| Enabled | Boolean |
Indicates whether the agent is enabled. |
| Health | String |
The health status of the agent. |
| Status | String |
The current status of the agent. |
| StatusUpdatedAt | Integer |
The timestamp when the status was last updated. |
| CertificateValidFromUtc | DateTime |
The UTC timestamp from when the agent's certificate is valid. |
| CertificateValidTillUtc | DateTime |
The UTC timestamp until the agent's certificate is valid. |
| NodeStatus | String |
The status of the node. |
| StatusDescription | String |
A description of the agent's status. |
| SchedulingEligibility | String |
Indicates the scheduling eligibility of the agent. |