POST
Create a store/landing project from a natural-language brief (async).

Authorizations

X-Agent-Key
string
header
required

Service-account key, format sq_agt_*. Carries least-privilege scopes.

Headers

Idempotency-Key
string
required

Unique per logical operation; identical key+body returns the cached response, different body → 409.

Maximum string length: 200
X-Store-ID
string

Target store; required when the key is bound to multiple stores.

Body

application/json
name
string
required
Example:

"Aurora Skincare"

brief
string
required
Example:

"Minimalist sage skincare, hero on the serum, 6 products."

init_agent_type
enum<string>
default:store_template
Available options:
store_template,
landing_page,
page_builder
product_ids
string[]

Response

Async operation queued.

success
boolean
required
message
string
data
object
meta
object