---
title: "List the agents in a fleet"
method: GET
path: "/v1/platform/apps/{appId}/fleets/{template_id}/agents"
tags: ["Platform"]
---

# List the agents in a fleet

`GET /v1/platform/apps/{appId}/fleets/{template_id}/agents`

## Request

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

## Path parameters

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

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Agents in the fleet

- ListFleetAgentsResponse
  - `agents` FleetAgent[]
    - `agent_id` string, uuid
    - `name` string
    - `org_id` string, uuid
    - `platform_connection_id` string, uuid, nullable
    - `provisioned_from_version` integer, nullable
    - `last_fleet_sync_at` string, date-time, nullable
    - `drift_fields` string[]: Fields a rollout skipped because they were changed outside fleet control. The standing answer to "why is this agent behind?".
    - `is_active` boolean
    - `is_current` boolean
  - `limit` integer
  - `offset` integer
  - `current_version` integer

## 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)