# Bem Entity Synonyms API

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

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

Manage the human-readable surface forms (synonyms) attached to a canonical entity. Synonyms feed the matcher's exact-match path, so adding the right synonyms improves cross-document entity resolution. - **`POST /v3/entities/{id}/synonyms`** attaches a `customer_defined` synonym. If the same normalized form already exists as an `extracted` synonym, it is upgraded to `customer_defined` (so the matcher weights it higher); an existing customer/SME synonym is returned unchanged. - **`DELETE /v3/entities/{id}/synonyms/{synonymID}`** soft-deletes a synonym. Only `customer_defined` and `sme_approved` synonyms are deletable; `extracted` synonyms are resolver-owned and the request is rejected with `409 Conflict`. A merged-away entity id transparently resolves to its surviving canonical entity, so a synonym added to a stale id lands on the entity that persists.

## Machine-readable artifacts (1)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/bem/refs/heads/main/openapi/bem-entity-synonyms-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 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

Entity Synonyms

---

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