---
title: "Rename a server"
method: PATCH
path: "/v1/servers/{id}"
tags: ["Servers"]
---

# Rename a server

`PATCH /v1/servers/{id}`

## Request

- Base URL: `https://api.sendora.se`
- URL: `https://api.sendora.se/v1/servers/{id}`
- Auth: HTTP bearer

The id, the keys, the mode and everything the server holds stay. The new name must be free within the account. A body that names a mode is refused: a server is live or test from its creation.

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `name` string, required: 1 to 100 characters.

## Response `200`

A server of the account: an isolation boundary with its own keys, streams, log, suppressions and webhooks.

- object: A server of the account: an isolation boundary with its own keys, streams, log, suppressions and webhooks.
  - `serverId` string, uuid, required: The id every server key, stream and message of the server refers to.
  - `name` string, required: The name given at creation, unique within the account.
  - `mode` 'live' | 'test', required: live delivers; test goes through everything but delivery, so nothing reaches a recipient. Fixed when the server is created.
  - `createdAt` string, date-time, required

## Other responses

- `400`: The body does not match what the route takes, or it asks to change the server's mode.
- `401`: The key is missing, malformed or revoked.
- `403`: The key is of the other kind, or a connected app may not do this here: it is not for connections, the connection may only read here, or it is for test servers only.
- `404`: No such server of this account.
- `409`: The account already has a server with that name, or the server is Sendora's own.

---

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