Use this tool to modify the properties of an existing workspace. You can rename it, update its description, change its kind (open, closed, or template), or move it to a different account product. Only the id is required—all other attributes are optional and only the fields you provide will be updated.

Note: You must have admin or owner permissions on the workspace to update it. Changing workspaceKind from open to closed will restrict visibility to current members only.

Parameters

Parameter	Type	Required	Description
id	`string`	Yes	The ID of the workspace to update. Use list_workspaces to find workspace IDs.
attributeName	`string`	No	The new name for the workspace.
attributeDescription	`string`	No	The new description for the workspace.
attributeKind	`string`	No	The new kind for the workspace. One of: `open`, `closed`, or `template`.
attributeAccountProductId	`number`	No	The target account product ID to move the workspace to.

Example

Rename a workspace and update its description:

{
  "id": "15420091",
  "attributeName": "Product Team Q3 (Archive)",
  "attributeDescription": "Archived workspace for Q3 product roadmap"
}

When tested, this returned: Workspace 15420091 updated with the new name reflected immediately. Unspecified fields were left unchanged.

Programmatic equivalent

Use the GraphQL API to achieve the same result:

mutation {
  update_workspace(
    id: 15420091
    attributes: {
      name: "Product Team Q3 (Archive)"
      description: "Archived workspace for Q3 product roadmap"
    }
  ) {
    id
    name
    description
    kind
  }
}

For full documentation, see Workspaces.