Skip to main content
POST
/
v2
/
pattern
Create a new design (V2)
curl --request POST \
  --url https://api.magicpatterns.com/api/v2/pattern \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-mp-api-key: <api-key>' \
  --form 'prompt=Create a login page' \
  --form mode=fast \
  --form presetId=html-tailwind \
  --form modelSelector=auto \
  --form 'images=<string>' \
  --form images.items='@example-file'
{
  "id": "abc123",
  "sourceFiles": [
    {
      "id": "<string>",
      "name": "<string>",
      "code": "<string>",
      "type": "javascript"
    }
  ],
  "compiledFiles": [
    {
      "id": "<string>",
      "fileName": "<string>",
      "hostedUrl": "<string>",
      "type": "javascript"
    }
  ],
  "editorUrl": "https://www.magicpatterns.com/c/abc123",
  "previewUrl": "https://abc123-preview.magicpatterns.app",
  "chatMessages": [
    {
      "role": "assistant",
      "content": "I will create a login page with a centered layout."
    }
  ]
}

Authorizations

​
x-mp-api-key
string
header
required

Body

multipart/form-data
​
prompt
string
required

The prompt for the new design.

Example:

"Create a login page"

​
mode
enum<string>
default:fast

The mode to use for the new design, either 'fast' for quicker generation or 'best' for higher quality. Defaults to 'fast'.

Available options:
fast,
best
Example:

"fast"

​
presetId
string

If nothing is provided, then html-tailwind is used. Can be either a default combination ('html-tailwind', 'shadcn-tailwind', 'chakraUi-inline', 'mantine-inline') or a custom configuration ID.

Example:

"html-tailwind"

​
modelSelector
enum<string>
default:auto

The model to use for generation. Defaults to 'auto'.

Available options:
auto,
claude_sonnet,
gemini
Example:

"auto"

​
images
file[]

Optional images to inspire or guide the design creation. Maximum file size is 5MB per image.

Response

Successfully created a new design.

​
id
string

The unique ID of the created design.

Example:

"abc123"

​
sourceFiles
object[]

The source files for the design.

​
compiledFiles
object[]

The compiled/processed files for the design.

​
editorUrl
string

URL to access the editor interface.

Example:

"https://www.magicpatterns.com/c/abc123"

​
previewUrl
string

URL to preview the generated design.

Example:

"https://abc123-preview.magicpatterns.app"

​
chatMessages
object[]

The conversation history for this design.