Last updated on 1st April 2026

List Network Agents via API

This method will return a list of all network agents in your DeployHQ account.

Tip: You can explore and test this endpoint interactively using our OpenAPI documentation.

URL

/agents

HTTP Method

GET

Supported Parameters

None

Example cURL Request

curl -H "Content-type: application/json" \
-H "Accept: application/json" \
--user adam@atechmedia.com:my-api-key \
https://test.deployhq.com/agents

Example Response

[
  {
    "id": 12345,
    "created_at": "2018-05-31T10:56:34.000+01:00",
    "identifier": "9e11def8-8c43-454e-8c99-3c5b9cf08396",
    "name": "Test Agent #1",
    "online": false,
    "revoked_at": null,
    "updated_at": "2018-05-31T10:57:02.000+01:00",
    "url": "https://test.deployhq.com/agents/9e11def8-8c43-454e-8c99-3c5b9cf08396"
  }
]