---
title: "Fleet summary for a template"
method: GET
path: "/v1/platform/apps/{appId}/fleets/{template_id}"
tags: ["Platform"]
---

# Fleet summary for a template

`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

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.

## Path parameters

- `appId` string, uuid, required
- `template_id` string, uuid, required

## Response `200`

Fleet summary

- FleetSummaryResponse
  - `template_id` string, uuid
  - `template_name` string
  - `current_version` integer
  - `spec_hash` string, 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_agents` integer
  - `version_skew` object[]: How the cohort splits across the versions it was provisioned from.
    - `template_version` integer, nullable
    - `agents` integer
  - `agents_on_current_version` integer
  - `agents_behind` integer
  - `drifted_agents` integer: Agents a previous rollout declined to touch.
  - `bulk_patchable_fields` string[]: 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.

## Other responses

- `404`: Resource not found

---

[API](https://skmtc.dev/1claw/apis/1claw-api.md) · [All operations](https://skmtc.dev/1claw/apis/1claw-api/llms.txt) · [OpenAPI document](https://skmtc.dev/1claw/apis/1claw-api/revisions/ae109b496830?raw)