---
title: "Update a Bucket"
method: PATCH
path: "/v3/buckets/{bucketID}"
tags: ["Buckets"]
---

# Update a Bucket

`PATCH /v3/buckets/{bucketID}`

## Path parameters

- `bucketID` string, required

## Request body

- BucketUpdateRequestV3 — Request body to update a bucket. Only the fields present are changed; the default bucket is renameable.
  - `name` string — New name.
  - `description` string — New description.

## Response `200`

The request has succeeded.

- BucketV3 — A Bucket is a named partition of the knowledge graph within an account+environment. Entities, mentions, and relations are scoped to a bucket so a single account+environment can host multiple isolated graphs. Every account+environment has exactly one default bucket. The default bucket can be renamed but never deleted.
  - `bucketID` string, required — Stable public identifier for the bucket (`bkt_...`).
  - `name` string, required — Human-facing bucket name. Unique within an account+environment.
  - `description` string, required — Optional human-facing note about the bucket.
  - `isDefault` boolean, required — Whether this is the account+environment's default bucket.
  - `createdAt` string, date-time, required — Creation timestamp (RFC 3339).
  - `updatedAt` string, date-time, required — Last-update timestamp (RFC 3339).

---

[API](https://skmtc.dev/bem-team/apis/bem-api.md) · [All operations](https://skmtc.dev/bem-team/apis/bem-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bem-team/bem-api/revisions/a6e4624117c6/schema)