Send a prompt
Sends a natural-language prompt to update an existing design. Returns
immediately with a requestId; the AI generation runs in the
background.
Poll GET /v3/designs/{editorId}/status until isGenerating is
false. Generation typically takes 2–10 minutes; do not poll more
than once every 60 seconds.
Before calling, check GET /v3/designs/{editorId}/status to confirm
the design isn’t already generating.
Bills credits from the authenticated user’s normal credit balance.
Authorizations
Magic Patterns API key. The same key authenticates v3 REST and the MCP server. Create one at https://www.magicpatterns.com/settings/api-keys.
Path Parameters
The design's editor ID.
"abc123"
Body
Natural language description of the change to make.
"Add a footer with three columns of links."
Response
Prompt accepted. Generation runs in the background.
Opaque identifier for this generation run.