---
title: "Patch every agent in a fleet"
method: POST
path: "/v1/platform/apps/{appId}/fleets/{template_id}/bulk-patch"
tags: ["Platform"]
---

# Patch every agent in a fleet

`POST /v1/platform/apps/{appId}/fleets/{template_id}/bulk-patch`

## Request

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

Applies one patch to every agent in the cohort. The field allowlist is deliberately narrower than a single-agent PATCH: guardrails and capability flags (intents_api_enabled, execution_intents_enabled) cannot be changed here, because at cohort scale nobody reviews the change per agent. Read the allowlist from bulk_patchable_fields on the fleet summary rather than hard-coding it. A field outside it returns 400 naming the field.

## Path parameters

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

## Request body

- object
  - `patch` object, required: Fields to set on every agent in the cohort.

## Response `200`

Patch applied

- object
  - `fields_applied` string[]
  - `agents_matched` integer: Agents in the cohort the patch applied to.
  - `agents_updated` integer: Distinct agents written, not writes performed. Every field in one patch targets the same cohort, so this is the cohort size rather than fields x agents.

## Other responses

- `400`: A field outside the bulk-patch allowlist, or an empty patch
- `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/5fa0918f3b41?raw)