Skip to main content
GET
Get an on-premise agent.

Authorizations

Authorization
string
header
required

Enter your JWT token

Path Parameters

id
integer<int32>
required

The identifier of the agent to retrieve.

Response

The detailed representation of the agent.

Full detail for one on-premise agent.

agentId
integer<int32>
required

Identifier of the agent.

status
string
required

Liveness of the agent: WaitingForConnection, Online, Offline or Disabled.

createdBy
string<uuid>
required

Identifier of the user who created the agent.

createdDate
string<date-time>
required

When the agent was created.

name
string | null

Display name of the agent.

description
string | null

Optional description of the agent.

version
string | null

Version the agent last self-reported. Null until it first connects.

lastSeenAt
string<date-time> | null

Last heartbeat received from the agent. Null when it has never connected.

updatedBy
string<uuid> | null

Identifier of the user who last updated the agent.

updatedDate
string<date-time> | null

When the agent was last updated.

settings
object

Runtime settings currently stored for the agent.

appliedToAgent
boolean | null

False when a settings write reached the database but not the agent, because the agent was Offline. Null on reads - only set by update responses.

dispatchedTaskIds
string[] | null

Cloud task identifiers dispatched to the live agent by a settings write. Empty when offline.