---
title: "Update Workforce"
method: PATCH
path: "/api/workforces/{workforce_id}"
tags: ["workforces"]
---

# Update Workforce

`PATCH /api/workforces/{workforce_id}`

## Path parameters

- `workforce_id` integer, required

## Request body

- WorkforceUpdateRequest
  - `name` string, nullable
  - `description` string, nullable
  - `manager_agent_id` integer, nullable
  - `manager_instructions` string, nullable
  - `canvas_layout` object, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

## Changes

- **2026-06-13** `33e4ba4936ad` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/xorbitsai/apis/xagent/changes/api/workforces/:workforce_id/patch.md)

---

[API](https://skmtc.dev/xorbitsai/apis/xagent.md) · [All operations](https://skmtc.dev/xorbitsai/apis/xagent/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/xorbitsai/xagent/revisions/33e4ba4936ad/schema)