Skip to main content
PATCH
Preview. This endpoint is available to organisations in the Wordsmith MCP pilot. Other organisations receive 403 mcp_not_enabled. See the preview overview.
Changes a team’s name, parent or visibility. Send only the fields you want to change. Moving a team changes who can reach what. Anything shared with the new parent, and with every team above it, now reaches this team’s members. Anything shared with the old parent no longer does, unless it was also shared another way. Hiding a team also hides every team beneath it. Its members and the people who can manage it still see it, so they can unhide it later.

​
Authentication

Requires an API key, or an OAuth token with directory:admin. The caller must also be an organisation admin, or hold a role with the matching permission. directory:admin is never granted by default. It only narrows what the person who approved it can already do, so a team admin’s token can edit their own teams and nothing else. Admin changes are not available through the MCP server. An admin of the team can also update it. To move the team under a new parent, the caller must be able to manage that parent too.

​
Path parameters

​
string
required
The team id.

​
Body parameters

​
string
The new team name. It cannot be empty.
​
string | null
The team to nest this one under. null moves it to the top level. The parent cannot be this team, a team beneath it, or a team synced from a Slack channel.
​
boolean
true hides the team and every team beneath it. false unhides it, which fails while a team above it is still hidden. When you also send parent_team_id, Wordsmith moves the team first, so you can move a team out from under a hidden parent and unhide it in one call.

​
Response

Returns 200 with the updated team.

​
Errors