Update Entity
Path parameters
Entity public ID (ent_...). A merged-away id resolves to its survivor.
Request body
Transition the entity's curation status. Only approved or rejected are accepted, and only from extracted or proposed (any other transition is rejected with 409).
The ety_... public ID of the type to assign (overriding the bem-inferred type). The empty string clears the assignment. Omit to leave unchanged.
Replace the entity's canonical surface form (re-derives its normalized form).
Surface forms to attach as customer_defined synonyms.
esn_... synonym IDs to soft-delete. Only customer_defined / sme_approved synonyms may be removed; an extracted synonym is rejected with 409.
Optional BCP 47 locale tag stamped on any added synonyms.
Response
The request has succeeded.
Public ID (ent_...).
The canonical (longest / most descriptive) surface form.
The entity's effective type name (assigned type if set, else inferred).
Free-form description.
Total mentions across parsed documents.
Distinct surface forms resolved to this entity.
Creation timestamp.
Last-update timestamp.
Curation lifecycle state.
ety_... public ID of the assigned type, when one is set.
When the entity was approved/rejected. Present only once validated.
usr_... public ID of the validating user (dashboard transitions only).