Agents

Agents

get

Agents from a project.

Authorizations
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
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-27T23:47:34.756Z",
    "lastMetricsAddedAt": "2025-06-27T23:47:34.756Z",
    "createdAt": "2025-06-27T23:47:34.756Z",
    "updatedAt": "2025-06-27T23:47:34.756Z",
    "environmentName": "default"
  }
]

Delete Agents

delete

Delete agents from a project.

Authorizations
Path parameters
projectIDstring · uuidRequired
Query parameters
agent_idstring · uuid[]Optional

List of agent IDs to delete.

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

Deleted

No content