---
title: "Create a Bucket"
method: POST
path: "/v3/buckets"
tags: ["Buckets"]
---

# Create a Bucket

`POST /v3/buckets`

## Request body

- BucketCreateRequestV3 — Request body to create a (non-default) bucket.
  - `name` string, required — Bucket name. Required and unique within the account+environment.
  - `description` string — Optional description.

## Response `201`

The request has succeeded and a new resource has been created as a result.

- 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).

## Changes

- **2026-06-17** `d7092283f192` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/bem-team/apis/bem-api/changes/v3/buckets/post.md)

---

[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/643398900e5d/schema)