Manage Agents

Get Agents

The general endpoint for retrieving agents:

The request returns an Agents entity which contains instances of an Agent entity. Only authorized agents are included by default. The request accepts locator parameter which should be typed as AgentLocator.

For example, to get all connected and authorized agents, use:

To list all enabled authorized agents, use:

To list all agents (including unauthorized), use:

The request uses default filtering (depending on the specified locator dimensions, others can have default implied value). To disable this filtering, add defaultFilter:false locator dimension to the locator parameter.

Enable/Disable Agent

To enable or disable an agent, PUT true or false text as text/plain to the following endpoint:

To supply a comment with the request, PUT the EnabledInfo entity to:

Payload example:

Authorize/Unauthorize Agent

To authorize or unauthorize an agent, you can (similarly to enabling/disabling agent) PUT true or false text as text/plain to the following endpoint:

To supply a comment with the request, PUT the AuthorizedInfo entity to:

Payload example:

Get/Update Single Agent Property

To get a specific agent property, use this request:

For example, this request will return (in text/plain) the agent name for an agent with the ID 1:

To update the property, PUT the text/plain value to the same endpoint.

Delete Build Agent

To delete an agent, use: