Agents

Agents

get

Agents from a project.

Authorizations

userproject

Path parameters

projectIDstring · uuidRequired

Query parameters

fleet_idstring · uuidOptional

Filter agents from a single fleet.

lastintegerOptional

Last agents.

beforestringOptional

Agents before the given cursor.

namestringOptional

Name matching agents.

tags_querystringOptional

Tag query.

Example: tagone AND tagtwo

environment_idstringOptional

Environment ID for matching agents.

Responses

200

OK

application/json

get

HTTPcURLJavaScriptPython

GET /v1/projects/{projectID}/agents HTTP/1.1
Host: cloud-api.calyptia.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

OK

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "fleetID": "123e4567-e89b-12d3-a456-426614174000",
    "token": "redacted",
    "name": "my-agent",
    "machineID": "text",
    "type": "fluentbit",
    "version": "v1.8.6",
    "edition": "community",
    "status": "healthy",
    "os": "unknown",
    "arch": "unknown",
    "flags": [
      "text"
    ],
    "tags": [
      "text"
    ],
    "rawConfig": "text",
    "metadata": {},
    "firstMetricsAddedAt": "2025-06-06T00:29:13.113Z",
    "lastMetricsAddedAt": "2025-06-06T00:29:13.113Z",
    "createdAt": "2025-06-06T00:29:13.113Z",
    "updatedAt": "2025-06-06T00:29:13.113Z",
    "environmentName": "default"
  }
]

Delete Agents

delete

Delete agents from a project.

Authorizations

userproject

Path parameters

projectIDstring · uuidRequired

Query parameters

agent_idstring · uuid[]Optional

List of agent IDs to delete.

Responses

204

Deleted

delete

HTTPcURLJavaScriptPython

DELETE /v1/projects/{projectID}/agents HTTP/1.1
Host: cloud-api.calyptia.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

204

Deleted

No content