# Bem Entity Types API

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

Bem Entity Types 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 Entity Types. The published artifact set on APIs.io includes an OpenAPI specification.

Entity Types are the customer-defined taxonomy for the knowledge graph, scoped to an account+environment. Each type has a unique, immutable name and can be organised into hierarchies via `parentTypeID`. A type may carry per-type structured attribute metadata in `attributeSchema` (for example `{"unit": "mg", "range": [0, 100]}`). Use these endpoints to create, list, fetch, update, and delete entity types: - **`POST /v3/entity-types`** creates a type, optionally under a parent. - **`GET /v3/entity-types`** lists types with cursor pagination (`startingAfter` / `endingBefore` over `typeID`) and an optional `parentTypeId` filter for direct children. - **`PATCH /v3/entity-types/{typeID}`** updates `description`, `parentTypeID`, and/or `attributeSchema`. The `name` is immutable. - **`DELETE /v3/entity-types/{typeID}`** soft-deletes a type. The request is rejected with `409 Conflict` while any live entity is assigned to the type or any live child type points at it.

## Machine-readable artifacts (1)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/bem/refs/heads/main/openapi/bem-entity-types-api-openapi.yml

## Other Bem APIs (12)

- [Bem Buckets API](https://apis.io/apis/bem/bem-buckets-api/)
- [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 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

Entity Types

---

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