Retrieve a single fleet by ID.
Desired output config format.
ini
json
yaml
Group of agents sharing the same config.
GET /v1/fleets/{fleetID} HTTP/1.1 Host: cloud-api.calyptia.com Authorization: Bearer YOUR_SECRET_TOKEN Accept: */*
OK
{ "id": "123e4567-e89b-12d3-a456-426614174000", "projectID": "123e4567-e89b-12d3-a456-426614174000", "name": "my-fleet", "minFluentBitVersion": "v1.0.0", "rawConfig": "text", "configFormat": "ini", "tags": [ "dev" ], "agentsCount": { "active": 1, "inactive": 1, "withErrors": 1 }, "createdAt": "2025-04-20T12:09:13.786Z", "updatedAt": "2025-04-20T12:09:13.786Z" }
Delete a single fleet by its ID. All associated agents will remain but the shared config wil be detached.
DELETE /v1/fleets/{fleetID} HTTP/1.1 Host: cloud-api.calyptia.com Authorization: Bearer YOUR_SECRET_TOKEN Accept: */*
Deleted.
{ "deleted": true, "deletedAt": "2025-04-20T12:09:13.786Z" }
Update a fleet details.
null
updated-fleet
The fleet fluent-bit configuration in the format defined by configFormat.
updated
false
PATCH /v1/fleets/{fleetID} HTTP/1.1 Host: cloud-api.calyptia.com Authorization: Bearer YOUR_SECRET_TOKEN Content-Type: application/json Accept: */* Content-Length: 111 { "name": "updated-fleet", "rawConfig": "text", "configFormat": "ini", "tags": [ "updated" ], "skipConfigValidation": true }
Updated.
{ "updatedAt": "2025-04-20T12:09:13.786Z" }