Fleets
List all the fleets within a project.
Authorizations
Path parameters
projectIDstring · uuidRequired
Query parameters
namestring · max: 32Optional
tags_querystringOptionalExample:
"AND" separated query
dev AND prod
lastintegerOptional
beforestringOptional
config_formatstring · enumOptionalPossible values:
Desired output config format.
Responses
200
OK
application/json
get
GET /v1/projects/{projectID}/fleets HTTP/1.1
Host: cloud-api.calyptia.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200
OK
[
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"projectID": "123e4567-e89b-12d3-a456-426614174000",
"name": "my-fleet",
"minFluentBitVersion": "v1.0.0",
"rawConfig": "text",
"configFormat": "classic",
"tags": [
"dev"
],
"agentsCount": {
"active": 1,
"inactive": 1,
"withErrors": 1
},
"createdAt": "2025-06-30T21:03:47.839Z",
"updatedAt": "2025-06-30T21:03:47.839Z"
}
]
Create a fleet on the given project. Agents can be added later to this fleet and all of them will share the same config.
Authorizations
Path parameters
projectIDstring · uuidRequired
Body
namestring · max: 32RequiredExample:
my-fleet
minFluentBitVersionstringRequiredExample:
semver
v1.0.0
rawConfigstringRequired
The fleet fluent-bit configuration in the format defined by configFormat.
configFormatstring · enum | nullableOptionalPossible values:
tagsstring[]RequiredExample:
dev
skipConfigValidationbooleanRequiredDefault:
false
Responses
201
Created
application/json
post
POST /v1/projects/{projectID}/fleets HTTP/1.1
Host: cloud-api.calyptia.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 138
{
"name": "my-fleet",
"minFluentBitVersion": "v1.0.0",
"rawConfig": "text",
"configFormat": "classic",
"tags": [
"dev"
],
"skipConfigValidation": false
}
201
Created
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"createdAt": "2025-06-30T21:03:47.839Z"
}