Fleets

Fleets.

get

List all the fleets within a project.

Authorizations
Path parameters
projectIDstring · uuidRequired
Query parameters
namestring · max: 32Optional
tags_querystringOptional

"AND" separated query

Example: dev AND prod
lastintegerOptional
beforestringOptional
config_formatstring · enumOptional

Desired output config format.

Possible values:
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 fleet.

post

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
minFluentBitVersionstringRequired

semver

Example: 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"
}