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

---

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