v1

latestOpenAPI 3.0.0Proprietary2026-07-26316155742.7 KB
Linked Keys

Unlink a child key from a parent key

Removes a single child key from a parent key's link group. A link group is the relationship model that keeps child keys synchronized with a parent: while linked, a child key's translations are derived from the parent's content. When you call this endpoint, the child key leaves the group and becomes independent — its existing translations are updated with the parent's current content and then marked unverified, signalling that reviewers should confirm the content is still appropriate for the child's context.

Use this endpoint when you need to detach one specific child key while keeping other children linked. To detach multiple children at once, use the batch unlink endpoint. This operation is only available on main projects.

It returns 422 when the child key is not currently linked to the specified parent key, or when a translation update fails during the unlink process.

delete/projects/{project_id}/keys/{id}/key_links/{child_key_id}

Path parameters

project_idstring required

Project ID

idstring required

Parent Translation Key ID

child_key_idstring required
Example:1234abcd1234cdef1234abcd1234cdef

The ID of the child translation key to unlink from the parent.

Headers

X-PhraseApp-OTPstring

Two-Factor-Authentication token (optional)

Response

The child key was successfully unlinked from the parent key. The response body is empty.