# Update bucket (/docs/rest-api/endpoints/buckets/patch-buckets-by-bucket-id)

> For the complete Prisma documentation index, see [llms.txt](https://www.prisma.io/docs/llms.txt). A markdown version of any docs page is available by appending `.md` to its URL.

Updates the display name, logical id, or branch of the bucket with the given ID. The display name is a label only: the provider bucket name, the objects, and the access keys do not change. `logicalId` cannot be combined with `branchId` or `branchGitName` in one request; move the bucket first, then set its `logicalId`.

Location: REST API > Endpoints > Buckets > Update bucket



## Related pages

- [`Create bucket`](https://www.prisma.io/docs/rest-api/endpoints/buckets/post-buckets): Creates a new object-store bucket in the specified project.
- [`Create bucket key`](https://www.prisma.io/docs/rest-api/endpoints/buckets/post-buckets-by-bucket-id-keys): Creates a new access key for the given bucket. The `secretAccessKey` field is returned exactly once in this response and is never stored — copy it immediately.
- [`Delete bucket`](https://www.prisma.io/docs/rest-api/endpoints/buckets/delete-buckets-by-bucket-id): Permanently deletes the bucket with the given ID, all objects stored in it, and all its access keys. This action cannot be undone.
- [`Delete bucket key`](https://www.prisma.io/docs/rest-api/endpoints/buckets/delete-buckets-by-bucket-id-keys-by-key-id): Revokes and deletes the bucket key with the given ID.
- [`Get bucket`](https://www.prisma.io/docs/rest-api/endpoints/buckets/get-buckets-by-bucket-id): Returns the bucket with the given ID.