Platform

Roll the current template version out to its fleet

Brings every agent in the cohort up to the template's current version. An agent changed outside fleet control is skipped rather than corrected, and the fields that caused the skip are recorded on it. force=true overrides that skip but still cannot carry a guardrail or a capability flag. dry_run=true reports what would happen and claims nothing, so it never blocks a real rollout. Only one rollout may run per template at a time; a second returns 409.

post/v1/platform/apps/{appId}/fleets/{template_id}/rollout

Request

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

Path parameters

appIdstring uuid required
template_idstring uuid required

Request body

forceboolean

Overwrite hand edits. Cannot carry guardrails.

dry_runboolean

Report the plan without applying it.

Response

Rollout result

job_idstring uuid nullable

Null for a dry run, which claims no job.

to_versioninteger
dry_runboolean
forcedboolean
total_agentsinteger
syncedinteger
already_currentinteger
skipped_driftedinteger

Changes

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