Agents
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_querystringOptionalExample:
Tag query.
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 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