Fleets

Fleets.

get

List all the fleets within a project.

Authorizations

userproject

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

HTTPcURLJavaScriptPython

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-19T04:39:14.986Z",
    "updatedAt": "2025-06-19T04:39:14.986Z"
  }
]

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

userproject

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

HTTPcURLJavaScriptPython

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-19T04:39:14.986Z"
}