---
title: "Rename a workspace"
method: PATCH
path: "/workspace/{workspace_id}/update/"
tags: ["Workspaces"]
---

# Rename a workspace

`PATCH /workspace/{workspace_id}/update/`

## Request

- Base URL: `https://hovercode.com/api/v2`
- URL: `https://hovercode.com/api/v2/workspace/{workspace_id}/update/`
- Auth: API key in header `Authorization`

Owners and admins only.

## Path parameters

- `workspace_id` string, uuid, required

## Request body

- object
  - `name` string

## Response `200`

OK

- Workspace
  - `id` string, uuid
  - `name` string
  - `current` boolean
  - `plan` string
  - `paid` boolean
  - `dynamic_qr_used` integer, nullable
  - `dynamic_qr_limit` integer, nullable
  - `pages_used` integer, nullable

## Other responses

- `400`: Invalid name
- `401`: Missing or invalid API token.
- `404`: Not found, or you're not an owner or admin

---

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