Platform

Patch every agent in a fleet

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.

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

Path parameters

appIdstring uuid required
template_idstring uuid required

Request body

patchobject required

Fields to set on every agent in the cohort.

Response

Patch applied

fields_appliedstring[]
agents_matchedinteger

Agents in the cohort the patch applied to.

agents_updatedinteger

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.

Changes

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