---
title: "Rename the workspace"
method: PATCH
path: "/api/v1/account/workspace"
tags: ["Account"]
---

# Rename the workspace

`PATCH /api/v1/account/workspace`

## Request

- Base URL: `https://api.dotsy.ai`
- URL: `https://api.dotsy.ai/api/v1/account/workspace`
- Auth: HTTP bearer

Renames the active workspace. Only a workspace Owner or Admin can.

## Headers

- `X-Dotsy-Workspace` string

## Request body

- UpdateWorkspaceRequest
  - `name` string, required: The new workspace name, 1 to 120 characters.

## Response `200`

The workspace was renamed.

- object
  - `ok` true, required
  - `name` string, required: The saved name, trimmed.

## Other responses

- `400`: `invalid_body`: send a name of 1 to 120 characters.
- `401`: Missing or invalid credentials.
- `403`: `workspace_admin_required`: only a workspace Owner or Admin can rename the workspace.

---

[API](https://skmtc.dev/dotsy/apis/dotsy-api.md) · [All operations](https://skmtc.dev/dotsy/apis/dotsy-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dotsy/apis/dotsy-api/revisions/4272ed3b85d7?raw)
