Quickstart

curl -X POST https://api.platformdtc.com/api/v1/agent/v1/keys \
  -H "Authorization: Bearer $USER_JWT" \
  -H "Content-Type: application/json" \
  -d '{"name":"my-agent","scopes":["store:write","catalog:write","analytics:read"]}'
# -> { "success": true, "data": { "id": "...", "key": "sq_agt_xxx", ... } }

curl https://api.platformdtc.com/api/v1/agent/v1/whoami \
  -H "X-Agent-Key: sq_agt_xxx"
# -> { "data": { "kind":"api_key", "merchant_id":"…", "store_id":"…", "scopes":[…] } }

curl -X POST https://api.platformdtc.com/api/v1/agent/v1/projects \
  -H "X-Agent-Key: sq_agt_xxx" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"name":"Aurora Skincare","brief":"Minimalist sage skincare, hero on the vitamin-C serum, 6 products"}'
# -> 202 { "data": { "job_id":"…", "status":"queued", "poll":"/agent/v1/jobs/…" } }

curl "https://api.platformdtc.com/api/v1/agent/v1/jobs/$JOB_ID/wait?timeout_seconds=180" \
  -H "X-Agent-Key: sq_agt_xxx"
# -> { "data": { "status":"succeeded", "result": { "project_id":"…", "preview_ready":true } } }