easels.dev

generate_edits

Ask a design model to change what is on an artboard, by description: "make the CTA green and bigger", "add a testimonials row under the pricing", "rewrite the hero copy for a bakery". The model sees an outline of the artboard with every node id and answers with addressed operations (insert, replace, style, text, delete) that land through the same actions a person uses, as one undo step. Use this when the request refers to things already on the canvas; use generate_design for a new section from nothing, and set_style or set_text when you already know the exact change. Returns what was applied and the ids it touched.

Input schema

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "description": "The change, in words."
    },
    "artboardId": {
      "type": "string",
      "description": "Defaults to the artboard of the selection, then the first one."
    },
    "provider": {
      "type": "string",
      "description": "\"openai\", \"kimi\" or \"gemini\". Defaults to the first one with a key."
    }
  },
  "required": [
    "prompt"
  ]
}