Skip to main content
POST
Edit a pattern

Authorizations

Authorization
string
header
required

An API key from Settings → API keys in Arcade Studio.

Body

application/json
requestId
string
required

Caller-chosen idempotency key; a replay returns the original result

Required string length: 1 - 128
patternId
string
required

The pattern to refine

Minimum string length: 1
instruction
string
required
Required string length: 1 - 1000
referenceId
string

A reference or another pattern to guide the edit

Minimum string length: 1
colors
string[]

#RRGGBB hex, or Arcade palette or Pantone color tokens

Maximum array length: 10
Minimum string length: 1

Response

200 - application/json

OK

jobId
string
required

Opaque job ID; read the job with jobs.get

Minimum string length: 1
kind
enum<string>
required

What the job makes: a pattern (patterns.create or a refine), a product (products.create) or a download (an upscale started in Arcade Studio)

Available options:
pattern,
product,
download
status
enum<string>
required

Jobs are created running; there is no queued state

Available options:
running,
succeeded,
failed
result
object
required

What a succeeded job made. Null while running, when it failed, when a deformity fix found nothing to repair, and once the pattern it made is deleted.

error
object | null
required

Why the job failed; set once it failed

createdAt
string<date-time>
required

When the job started; for a product with no recorded build (made by Create, or built before builds were kept), when the product was created

completedAt
string<date-time> | null
required

When the job finished; null while running and for a failed product job, which does not record it