ghostAPIv1 beta
Definitions

Merge two enum values

POST/definitions/{definitionId}/merge-value
ScopeadminRoleOwner or adminBilling1 credit per call

Rewrites every assignment of one enum value onto another, preserves original values and evidence in history, links old rows to their successors, and archives the source option. Identical source and destination slugs are rejected.

Path parameters

definitionIduuidrequired
Definition id.

Headers

Idempotency-Keystringoptional
1–128 visible ASCII characters. Retrying with the same key returns the original response; reusing it for different input returns 409.

Body

fromSlugstringrequired
The value being retired.
intoSlugstringrequired
The value that absorbs it.
reasonstringrequired
Why this change is being made. 1–500 characters. Stored in the audit trail.

Response

rewritteninteger