curl --request PATCH \
--url https://api.dittowords.com/v2/components/staged \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"updates": [
{
"developerId": "component-id-1",
"text": "Place order"
}
]
}
'{
"success": true
}{
"message": "Component with developer ID component-id-1 not found"
}{
"message": "This workspace hasn't opted into library component versioning"
}Save unpublished component changes
Saves changes to library components without publishing them. The changes are not available to instances until they’re published.
The operation is all-or-nothing: if any update is invalid, nothing is saved.
Only available in workspaces that have opted into library component versioning.
curl --request PATCH \
--url https://api.dittowords.com/v2/components/staged \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"updates": [
{
"developerId": "component-id-1",
"text": "Place order"
}
]
}
'{
"success": true
}{
"message": "Component with developer ID component-id-1 not found"
}{
"message": "This workspace hasn't opted into library component versioning"
}Authorizations
Body
Array of changes to save on components without publishing them. Not every component field can be saved as an unpublished change.
1Show child attributes
Show child attributes
Developer ID of the target variant. If a component does not already have the target variant, it will be added. Omit if targeting base text.
If true, and the provided variantId is not found, create the variant. A variant name will be generated based on the passed in ID.
When set to 'html', all text values in this request (including plural text) are parsed as HTML and saved as rich text. Supported formatting: <strong>/<b>, <em>/<i>, <u>, <s>, and <br> for line breaks. <sup> and <sub> are only supported for workspaces with superscript and subscript enabled. Unsupported markup (for example links, lists, or headings) is dropped and its text content kept.
Note: Fully-bolded strings will have that bold styling stripped, as Figma does not support bolding an entire text layer this way.
When omitted, text is saved as plaintext and any markup is stored literally.
html Response
Returns success status of the save operation
Indicates whether the changes were saved