How a make is going
- Credentials
- OAuth access token
- Scopes
store:read
Running, done (with the result and files) or failed (nothing charged).
Access: OAuth scope store:read; not write-gated.
merchantOAuth store:readAuthorizationBearer <token>OAuth 2.1 (authorization code + PKCE S256, public clients, dynamic registration) for connected AI apps. Effective power is scopes granted AND the person's role today AND the plan. orders:refund, billing:write and team:write are opt-in on the consent screen. Write implies read for marketing:read and messages:read, so a grant holding marketing:write passes a marketing:read check, and messages:send passes messages:read.
Scope: store:read
storeId*stringA store the person can reach. Any other id answers 404, never 403.
jobId*stringA make's job id, from POST /studio/makes.
OK
application/json- response
data*curl -X GET 'https://api.shopeazy.co/v1/merchant/stores/<storeId>/studio/jobs/<jobId>' \ -H 'Authorization: Bearer <access_token>'{ "data": { "id": "string", "kind": "string", "status": "running", "label": "string", "result": null, "files": [ { "id": "string", "kind": "string", "media": "image", "category": "string", "url": "string", "posterUrl": "string", "about": "string", "versionOf": "string", "usedIn": [ { "kind": "string", "id": "string" } ], "uses": 0, "createdAt": 0 } ], "error": "string", "createdAt": 0 }}Change one thing about a shot you already have POST
Product photography is six attempts, not one: this keeps what worked and changes only what was asked. The result is a CHILD of the shot (`versionOf`, the same shoot and recipe), never an overwrite, and costs one shot (`studio.mockup` in `getStudioCosts`), charged only when it comes out. 422 `validation_error` for an empty instruction or a shot that is gone. The `Idempotency-Key` keeps a retry from paying twice. Access: OAuth scope `ai:spend`; write-gated by the subscription.
What is making now GET
The Making tray: every make that is running, and the ones that finished in the last few minutes, so a client that was closed can find them again. `getStudioJob` follows one job by id. Paged: `{ items, nextCursor }`, `limit` (default 30, at most 100) and an opaque `cursor`. Access: OAuth scope `store:read`; not write-gated.