curl --request PATCH \
--url https://api.dittowords.com/v2/components \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"updates": [
{
"developerId": "component-id-1",
"text": "Hello!"
}
]
}
'{
"success": true
}{
"message": "Component with developer ID \"component-id-1\" not found"
}Update components
Updates a set of components’ base or variant text, plural forms, tags, status, assignee, notes, character limit, integrated, and variables.
Each component is identified by its Developer ID. Only provided fields are modified — omitted fields remain unchanged.
A Developer ID can appear at most once in updates. A request that repeats a Developer ID is rejected with a 400 rather than silently applying the last write and discarding the rest — combine the changes into a single update instead.
In workspaces that have opted into library component versioning, a component with unpublished changes can’t have its text, plurals, tags, notes, or characterLimit updated directly, because publishing those changes would overwrite the unpublished updates.
curl --request PATCH \
--url https://api.dittowords.com/v2/components \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"updates": [
{
"developerId": "component-id-1",
"text": "Hello!"
}
]
}
'{
"success": true
}{
"message": "Component with developer ID \"component-id-1\" not found"
}Authorizations
Body
Array of updates to components.
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 update operation
Indicates whether the update was successful