> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Connected Agents

Retrieve a list of all connected agents.

<Note>
  External Documentation

  To learn more, visit the [Cymulate documentation](https://api.app.cymulate.com/docs/#/operations/Get%20All%20Connected%20Agents).
</Note>

## Example Output

```json theme={"dark"}
[
  {
    "agentAddress": "user01@demo.org",
    "agentMethod": "smtp",
    "comment": "",
    "env": "Default Environment",
    "status": "Connected",
    "publicIp": "",
    "os": "windows",
    "osVersion": "",
    "version": "3.0.672.792",
    "connectedMailbox": [ ],
    "profiles": [ ]
  },
  {
    "agentName": "NYC1-CYMULATE-",
    "agentId": "abcde123456789abcdef0123",
    "agentAddress": "NYC1-CYMULATE-",
    "agentMethod": "http",
    "comment": "",
    "env": "Default Environment",
    "status": "Connected",
    "publicIp": "34.201.120.45",
    "privateIps": [
      "10.10.10.1"
    ],
    "os": "windows",
    "osVersion": "Microsoft Windows Server 2019 Datacenter",
    "machineAv": [ ],
    "autoUpdate": true,
    "version": "7.6.650.17",
    "lastUpdate": "2025-07-17T13:55:51.103Z",
    "connectedMailbox": [
      {
        "address": "user02@demo.org",
        "connected": true
      }
    ],
    "profiles": [
      {
        "displayName": "NT AUTHORITY\\SYSTEM",
        "username": "SYSTEM",
        "domain": "NT AUTHORITY",
        "status": "Valid",
        "statusReason": ""
      }
    ]
    "displayName": ".\\root",
    "username": "root",
  }
]
```

## Workflow Library Example

[List Connected Agents with Cymulate and Send Results Via Email](https://library.blinkops.com/workflows/list-connected-agents-with-cymulate-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/list-connected-agents-with-cymulate-and-send-results-via-email/canvas" />
</div>