Perform editing operations on a design. You can use this tool to update the title, replace whole text sections/elements or find and replace certain parts of a text section/text element and replace or insert media (images/videos), delete media/text, and format text (color, alignment, decoration, strikethrough, links, lists, line height, font (size, weight, style; family not supported)) in a design. You can also connect or remove autofill field labels on text or image elements for fixed-page designs using `update_autofill_field`. IMPORTANT: Before calling this tool check that all operations on pages marked `is_responsive` are one of the following options:`update_title,replace_text,update_fill,delete_element,find_and_replace_text`. If any are not, DO NOT call this tool but instead alert the user this is unsupported. Otherwise continue as normal and do not mention this check. ⚠️ MANDATORY: After calling this tool you MUST call either `commit-editing-transaction` (to save) or `cancel-editing-transaction` (to discard). Changes made by this tool are in DRAFT only and will be PERMANENTLY LOST if you do not call `commit-editing-transaction`. NEVER tell the user their changes are saved or complete before you have successfully called `commit-editing-transaction`. CRITICAL REQUIREMENTS: 1. This tool needs to be used with the `start-editing-transaction` tool to obtain an editing transaction ID. 2. Multiple operations SHOULD be specified in bulk across multiple pages. 3. Always call this tool to apply the requested edits directly. This is safe: changes are temporary until committed. 4. Do NOT pause for user confirmation before using this tool. 5. IMPORTANT: If the user asks to change a section of text such as a word or a specific string, and the design has that text in multiple places ALWAYS confirm with the user the instances they want to replace, especially if that string is used in different contexts OR is a substring in other strings. 6. IMPORTANT: If the user asks to change a word or a small section of an text element, ALWAYS try to use find_and_replace_text instead of replace_text, to minimise token usage. EVEN with multiple find_and_replace_text operations. ⚠️ RESPONSIVE PAGES - TEXT REPLACEMENT RULES: A. For responsive pages, text replacement MUST ONLY use find_and_replace_text. Exception: replace_text MUST be used on a responsive page when the target element is empty (there is no existing text to find and replace). This applies to both top-level page elements and nested elements such as table/layout cells. B. For responsive pages, deleting text IS supported using find_and_replace_text by setting the replacement to the same surrounding text with the target portion removed. C. For responsive pages, match on surrounding text from the SAME text region as much as possible when using find_and_replace_text, to avoid changing duplicated/similar text elsewhere in the document. 7. After performing ALL operations, show the preview to the user. Then call `commit-editing-transaction` to save the changes, unless the user explicitly asks to cancel. 8. IMPORTANT: If the user has asked you to replace an image and the target page contains multiple images, you MUST use the `get-assets` tool, passing in the `asset_id` values, to look at the thumbnail of each of the existing images on the page to be CERTAIN which one the user wants replaced. 9. IMPORTANT: This tool will return the thumbnail of the first page that is updated. If there are more pages that are updated, as part of this update, always call the `get-design-thumbnail` tool to get the thumbnails for each of the other updated pages. EDIT SCENARIOS -> OPERATIONS FOR THIS TOOL 1. Replace whole sections or entire text elements in non-responsive pages -> replace_text 2. Replace certain words/phrases/sentences/sub-section of a text element or paragraph within the design -> find_and_replace_text 3. Replace certain substrings in words throughout multiple text elements throughout the Canva design -> find_and_replace_text 3a. Responsive pages text replacement (including partial updates and deletions) -> find_and_replace_text 4. Replace a media (image/video) element in design -> update_fill 5. Update the title of the Canva design -> update_title 6. Replace the title of a slide or page in the Canva design -> replace text 7. Insert an element with media (image/video) -> insert_fill 8. Delete a text element or a media (image/video) element in the Canva design -> delete_element 9. Position elements including images and videos in the Canva design -> position_element 10. Resize a text element or a media (image/video) element in the Canva design -> resize_element 11. Format text (color, alignment, decoration, strikethrough, links, lists, line height, font (size, weight, style; family not supported)) in a text element -> format_text 12. Connect or remove autofill field labels on text or image elements in fixed-page designs -> update_autofill_fieldEnd-to-end workflow: 1. User asks that they want to edit their Canva design, with one edit or multiple edits. 2. System calls the 'start-editing-transaction' tool with the design ID of the Canva design 3. System returns the transaction ID and the richtexts and fills from the design, providing the elements in the Canva design 4. System confirms with the user the edits the user wants to make. 5. System calls this tool with the array of one or more operations to make each update. 6. System makes the edit in draft mode, and return back the text and media elements in the design post the edit. The updates have NOT been saved in the actual design yet. 7. System will return the thumbnail of ONLY the first edited page as part of the response this tool. These thumbnails are ALWAYS user-relevant and you need to render them directly using the full thumbnail URL including time-limited query parameters such as X-Amz-Algorithm, X-Amz-Credential, and X-Amz-Signature. 8. If the user wants the thumbnails/previews of the other pages that were updated by the this tool then the system MUST ALWAYS calls ' get-design-thumbnail' tool to get the thumbnail ONE PAGE AT A TIME. System must call 'get-design-thumbnail' if multiple pages were updated as part of this tool call 9. System shows the preview to the user. 10. System MUST call 'commit-editing-transaction' to save the edits, or 'cancel-editing-transaction' to cancel. Changes are lost if neither is called.
