Platform

Fleet summary for a template

Every agent this template provisioned, as one cohort: how many there are, how they split across the template versions they were built from, and how many a previous rollout declined to touch. plt_ or user JWT.

get/v1/platform/apps/{appId}/fleets/{template_id}

Request

  • Base URL: https://api.1claw.co
  • URL: https://api.1claw.co/v1/platform/apps/{appId}/fleets/{template_id}
  • Auth: HTTP bearer

Path parameters

appIdstring uuid required
template_idstring uuid required

Response

Fleet summary

template_idstring uuid
template_namestring
current_versioninteger
spec_hashstring nullable

SHA-256 of the template spec. Lets a caller tell a version bump that changed nothing from one that did. Null on templates written before migration 245.

total_agentsinteger
agents_on_current_versioninteger
agents_behindinteger
drifted_agentsinteger

Agents a previous rollout declined to touch.

bulk_patchable_fieldsstring[]

The fields bulk-patch and rollout will carry. Read this rather than hard-coding the list; it is deliberately narrower than a single-agent PATCH and may narrow further.

Changes

No recorded changes to this operation across all 1 revision of this API.