> ## 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 a workspace

> Update the workspace name and description.

Administrator access with explicit administrator permission on API keys or MCP credentials, or a signed-in administrator.

Update the workspace name and description.

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.

MCP clients can use [`update_workspace`](https://www.posted.cc/mcp-reference/update_workspace) for this operation.

[Request conventions](https://www.posted.cc/api-reference/overview.md) · [API keys](https://www.posted.cc/api-keys.md) · [MCP connections](https://www.posted.cc/mcp-connections.md)


## OpenAPI

````yaml api-reference/openapi.json PATCH /api/workspaces/{workspaceId}
openapi: 3.1.0
info:
  title: Posted HTTP API
  version: 0.2.6
  description: >-
    All registered application, account, OAuth, MCP transport and health
    endpoints. Publishing and draft request schemas come from the shared runtime
    validators. Replace the example server with your installation. Documentation
    uses simple request examples and does not execute live publishing requests.
servers:
  - url: https://posted-api.example.com
security: []
paths:
  /api/workspaces/{workspaceId}:
    patch:
      tags:
        - Workspaces
      summary: Update a workspace
      description: >-
        Update the workspace name and description.


        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.


        Administrator access with explicit administrator permission on API keys
        or MCP credentials, or a signed-in administrator.
      operationId: patch_api_workspaces_by_workspaceId
      parameters:
        - name: workspaceId
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: >-
            The workspaceId from the corresponding list, record or authorization
            response.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  minLength: 1
                  maxLength: 120
                description:
                  default: ''
                  type: string
                  maxLength: 2000
              required:
                - name
              additionalProperties: false
            example:
              name: Marketing
              description: Team campaigns
      responses:
        '200':
          description: >-
            Successful response. Examples are illustrative; field values vary by
            record.
          content:
            application/json:
              schema:
                type: object
                properties:
                  workspace:
                    type: object
                    properties:
                      id:
                        type: string
                      name:
                        type: string
                      description:
                        type: string
                      isDefault:
                        type: boolean
                      createdAt:
                        type: string
                      updatedAt:
                        type: string
                    additionalProperties: true
                additionalProperties: true
              example:
                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'
        default:
          description: >-
            Request failure. Inspect code, message and requestId; respect
            Retry-After on HTTP 429.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - bearerAuth: []
        - sessionCookie: []
components:
  schemas:
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
            - requestId
          properties:
            code:
              type: string
            message:
              type: string
            requestId:
              type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Personal or workspace Posted REST API key
    sessionCookie:
      type: apiKey
      in: cookie
      name: posted_session
      description: >-
        Signed-in human browser session; mutation requests also need the exact
        UI Origin

````

## Related topics

- [update_workspace](https://www.posted.cc/mcp-reference/update_workspace.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.