---
title: "Rename your workspace"
method: PATCH
path: "/tenants/{id}"
tags: ["Tenancy"]
---

# Rename your workspace

`PATCH /tenants/{id}`

## Request

- Base URL: `https://api.customdomain.ai/v1`
- URL: `https://api.customdomain.ai/v1/tenants/{id}`
- Auth: HTTP bearer

The caller's own tenant only (admin and above); any other id is a `404`.

## Path parameters

- `id` string, required

## Request body

- object
  - `name` string, required

## Response `200`

Renamed

- object
  - `id` string
  - `name` string

## Other responses

- `400`: Error envelope: {code, title, details}.
- `401`: Error envelope: {code, title, details}.
- `403`: Error envelope: {code, title, details}.
- `404`: Error envelope: {code, title, details}.

---

[API](https://skmtc.dev/customdomain/apis/customdomain-control-plane-api.md) · [All operations](https://skmtc.dev/customdomain/apis/customdomain-control-plane-api/llms.txt) · [OpenAPI document](https://skmtc.dev/customdomain/apis/customdomain-control-plane-api/revisions/34d89cb7a7cd?raw)
