> ## Documentation Index
> Fetch the complete documentation index at: https://www.posted.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# update_workspace

> Update a workspace with Posted MCP.

Update the workspace name and description.

## Workflow

```mermaid theme={"system"}
flowchart LR
  step0["Read available workspaces"] --> step1
  step1["Choose the workspace"] --> step2
  step2["Perform the action"]
```

## Access and behavior

Administrator consent and a current administrator team role are required. Tools are listed and callable only when the current grant and role permit them.

Additional workspaces require membership. Existing team roles apply. Default is available to everyone and cannot be deleted. Only an empty additional workspace can be deleted.

## Arguments

| Argument | Required | Type or meaning |
| - | - | - |
| `name` | Yes | The name to save for the target record. |
| `description` | No | string |
| `workspaceId` | Yes | Workspace UUID returned by list\_workspaces, including for Default. |

> **Complete input schema**
>
> ```json theme={"system"}
> {
>   "type": "object",
>   "properties": {
>     "name": {
>       "type": "string",
>       "minLength": 1,
>       "maxLength": 120
>     },
>     "description": {
>       "default": "",
>       "type": "string",
>       "maxLength": 2000
>     },
>     "workspaceId": {
>       "type": "string",
>       "format": "uuid",
>       "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
>     }
>   },
>   "required": ["name", "workspaceId"],
>   "additionalProperties": false
> }
> ```

## Example call

The client initializes the MCP connection before sending this JSON-RPC call. Example records are fictional.

```json theme={"system"}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "update_workspace",
    "arguments": {
      "workspaceId": "55555555-5555-4555-8555-555555555555",
      "name": "Marketing",
      "description": "Team campaigns"
    }
  }
}
```

## Example result

Posted returns this object in `structuredContent` and a JSON text content block. A tool failure sets `isError`; never treat an error as a completed mutation.

```json theme={"system"}
{
  "workspace": {
    "id": "55555555-5555-4555-8555-555555555555",
    "name": "Marketing",
    "description": "",
    "isDefault": false,
    "createdAt": "2027-01-18T09:30:00.000Z",
    "updatedAt": "2027-01-18T09:30:00.000Z"
  }
}
```

## Related reference

[HTTP operation](https://www.posted.cc/api-reference/patch_api_workspaces_by_workspaceId.md) · [Connect an MCP client](https://www.posted.cc/mcp-connections.md) · [Request conventions](https://www.posted.cc/api-reference/overview.md)


## Related topics

- [Update a workspace](https://www.posted.cc/api-reference/patch_api_workspaces_by_workspaceId.md)
- [update_team](https://www.posted.cc/mcp-reference/update_team.md)
- [update_post](https://www.posted.cc/mcp-reference/update_post.md)
- [Update team settings](https://www.posted.cc/api-reference/patch_api_workspace.md)
- [Update account preferences](https://www.posted.cc/api-reference/patch_api_auth_profile.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.