# Bem Buckets API

**Canonical:** https://apis.io/apis/bem/bem-buckets-api/  
**Provider:** Bem — https://apis.io/providers/bem/  
**Base URL:** https://api.bem.ai  
**Documentation:** https://docs.bem.ai

Bem Buckets API is one of 22 APIs that [Bem](https://apis.io/providers/bem/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Buckets. The published artifact set on APIs.io includes an OpenAPI specification.

Buckets are named partitions 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 — for example one per data source or workspace. Every account+environment has exactly one **default** bucket, used by unscoped flows. The default bucket can be renamed but never deleted. Use these endpoints to create, list, fetch, rename, and delete buckets: - **`POST /v3/buckets`** creates a non-default bucket. - **`GET /v3/buckets`** lists buckets with cursor pagination (`startingAfter` / `endingBefore` over `bucketID`). - **`PATCH /v3/buckets/{bucketID}`** updates `name` and/or `description`. - **`DELETE /v3/buckets/{bucketID}`** soft-deletes a bucket. A non-empty bucket is rejected with `409 Conflict` unless `?cascade=true` is passed; the default bucket can never be deleted.

## Machine-readable artifacts (2)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/bem/refs/heads/main/openapi/bem-buckets-api-openapi.yml
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/bem/refs/heads/main/apis.yml

## Other Bem APIs (12)

- [Bem Calls API](https://apis.io/apis/bem/bem-calls-api/)
- [Bem Collections API](https://apis.io/apis/bem/bem-collections-api/)
- [Bem Connectors API](https://apis.io/apis/bem/bem-connectors-api/)
- [Bem Entity Bulk Seed API](https://apis.io/apis/bem/bem-entity-bulk-seed-api/)
- [Bem Entity Curation API](https://apis.io/apis/bem/bem-entity-curation-api/)
- [Bem Entity Synonyms API](https://apis.io/apis/bem/bem-entity-synonyms-api/)
- [Bem Entity Type Reviewers API](https://apis.io/apis/bem/bem-entity-type-reviewers-api/)
- [Bem Entity Types API](https://apis.io/apis/bem/bem-entity-types-api/)
- [Bem Errors API](https://apis.io/apis/bem/bem-errors-api/)
- [Bem Feedback API](https://apis.io/apis/bem/bem-feedback-api/)
- [Bem File System API](https://apis.io/apis/bem/bem-file-system-api/)
- [Bem Function Accuracy API](https://apis.io/apis/bem/bem-function-accuracy-api/)

## Tags

Buckets

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/bem/bem-buckets-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/bem/.