v19

latestOpenAPI 3.1.1raw.githubusercontent.com2026-08-017489931.2 KB

Merge two custom object records

Merges two records of the specified custom object type into one. The primary record retains its ID; the duplicate is soft-deleted. Both records must belong to the custom object type named in the path.

Required scopes: custom_objects:update + custom_objects:delete

Rate limit category: Write

post/v1/objects/{entitySlug}/merge

Path parameters

entitySlugstring required

The slug of the custom object type.

Headers

Lightfield-Version'2026-03-01' required

Required API version header. Requests may error without it.

Request body

primaryIdstring required

ID of the record to keep.

duplicateIdstring required

ID of the duplicate record to merge into the primary and then discard.

fieldResolutionsobject

Per-field resolution overrides keyed by attribute slug.

Response

OK