curl --request PATCH \
--url https://api.dittowords.com/v2/components/unlink \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"textItemIds": [
"text-item-id-1"
]
}
'{
"success": true,
"unlinkedCount": 1
}{
"message": "Text items are not linked to a library component: text-item-id-1"
}Components
Unlink text items from a component
Unlinks one or more text items from their library component by developer ID.
Each unlinked text item keeps its current text but gets a freshly generated developer ID, and future edits to the library component no longer affect it. Every text item linked to a component shares that component’s developer ID with its sibling instances, so a given developer ID unlinks every text item that currently carries it, not just one. Pass projectId to scope the unlink to only the instances in one project, leaving instances elsewhere untouched.
PATCH
/
components
/
unlink
curl --request PATCH \
--url https://api.dittowords.com/v2/components/unlink \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"textItemIds": [
"text-item-id-1"
]
}
'{
"success": true,
"unlinkedCount": 1
}{
"message": "Text items are not linked to a library component: text-item-id-1"
}Authorizations
Body
application/json
Developer IDs of the text items to unlink from their library component. Each must currently be a library instance. Every text item linked to a component shares that component's developer ID with its sibling instances, so a given developer ID unlinks every text item that currently carries it, not just one — scope this with projectId to affect only the instances in one project.
Minimum array length:
1Developer ID of the project to scope the unlink to. If provided, only instances of the given developer IDs within this project are unlinked; instances in other projects are left untouched. If omitted, every instance of each given developer ID is unlinked, regardless of project.
Response
Returns success status of the unlink operation and the number of text items actually unlinked