Skip navigation

Skip to main content

Tools
Tools

create-design-from-candidate

Turn a chosen candidate into a real, editable design.

Use create-design-from-candidate after the user picks a candidate from generate-design.

Example prompt

"Use the second option."

Pass the chosen candidate_id and the top-level job.id from generate-design.

Example response

IDs, URLs, and tokens below are placeholders; field names and structure are exactly as returned.

{
  "design_summary": {
    "id": "DAF_EXAMPLE",
    "title": "AI Editing Feature Announcement in Electric Blue",
    "urls": { "edit_url": "https://www.canva.com/d/EXAMPLE_EDIT", "view_url": "https://www.canva.com/d/EXAMPLE_VIEW" },
    "created_at": 1784078449,
    "updated_at": 1784078449,
    "page_count": 1
  }
}
JSON

Returns a design_summary with the new design's id, title, edit_url, view_url, and page_count. Give the user the edit link.

Learn more