List active agents

GET 
/node

Discover all active agents in the fleet.

Responses

200

List of active agents.

application/json

Schema

Schema

agents

object[]

required

Array [

hostname stringrequired

The hostname of the agent.

]

total integerrequired

Total number of active agents.

Example (from schema)

{
  "agents": [
    {
      "hostname": "string"
    }
  ],
  "total": 0
}

401

Unauthorized - API key required

application/json

Schema

Schema

error string

A description of the error that occurred.

details string

Additional details about the error.

code integer

The error code.

Example (from schema)

{
  "error": "Failed to retrieve status.",
  "details": "Failed due to network timeout.",
  "code": 500
}

403

Forbidden - Insufficient permissions

application/json

Schema

Schema

error string

A description of the error that occurred.

details string

Additional details about the error.

code integer

The error code.

Example (from schema)

{
  "error": "Failed to retrieve status.",
  "details": "Failed due to network timeout.",
  "code": 500
}

500

Error discovering agents.

application/json

Schema

Schema

error string

A description of the error that occurred.

details string

Additional details about the error.

code integer

The error code.

Example (from schema)

{
  "error": "Failed to retrieve status.",
  "details": "Failed due to network timeout.",
  "code": 500
}

Loading...