---
title: "Update a database's name or memory"
method: PATCH
path: "/v2/databases/{databaseId}"
tags: ["DB Lifecycle"]
---

# Update a database's name or memory

`PATCH /v2/databases/{databaseId}`

Updates the database's display name or allocated memory. At least one of `name` or `ram` must be present in the request body.

Rate limited to 1 update every 5 seconds per user.

## Path parameters

- `databaseId` string, required

## Request body

- object
  - `name` string — Display name (1-32 chars, letters/numbers/space/hyphen/underscore).
  - `ram` integer — Allocated memory in MB.

## Response `200`

Database updated.

- object
  - `status` 'success', required

## Other responses

- `400` — No fields were provided, or the new value failed validation.
- `401` — The Authorization header is missing, malformed, or the credentials are not valid.
- `404` — The database does not exist or is not owned by the caller.
- `413` — The request body is larger than the maximum allowed size (100MB).
- `429` — The endpoint enforces its own rate limit and the caller hit the cooldown.
- `500` — The memory update could not be applied.

---

[API](https://skmtc.dev/squarecloud/apis/square-cloud-api.md) · [All operations](https://skmtc.dev/squarecloud/apis/square-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/squarecloud/square-cloud-api/revisions/54b7733a6b95/schema)