Introducing Agents.·Read
Getting StartedKey ConceptsHow-to GuidesCLITrickest SDKSandbox SDKAPI ReferenceChangelog
Get a fleet by ID

Get a fleet by ID

Fetches a single fleet by its ID. Only fleets in your own vault are returned.

GET/api/fleets/{id}
Path parameters
idnumberrequired

Path parameter: id

Request

curl
curl -X GET https://trickest.io/api/fleets/{id} \
  -H "Authorization: Bearer $TRICKEST_TOKEN"

Responses

200Fleet details
idstringrequired
namestringrequired
vault_idstring
vaultstring
clusterstring
defaultboolean
typeenumrequired

One of: HOSTED, MANAGED

max_machinesnumber
active_machinesnumber
machines_countnumber
machinesobjectrequired

created_datestringrequired
modified_datestring
400Bad Request – validation error or malformed input
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

401Unauthorized – missing or expired token
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

403Forbidden – insufficient permissions
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

429Too Many Requests – rate limited
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

500Internal Server Error
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

PreviousFleetsCreate a self-hosted fleetFleetsNextUpdate a fleet