What is making now
- Credentials
- OAuth access token
- Scopes
store:read
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.
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.
cursor?stringThe nextCursor of the previous page, unchanged. A cursor that is not one we gave you is 400 bad_request.
limit?integerPage size: default 30, at most 100 (more is 100; a missing or unusable value is 30).
1 <= value <= 10030OK
application/json- response
data*curl -X GET 'https://api.shopeazy.co/v1/merchant/stores/<storeId>/studio/makes' \ -H 'Authorization: Bearer <access_token>'{ "data": { "items": [], "nextCursor": null }}How a make is going GET
Running, done (with the result and files) or failed (nothing charged). Access: OAuth scope `store:read`; not write-gated.
Start a Studio make in the background POST
Answers at once with a running job; follow it with `getStudioJob`. Credits are charged only when the make comes out (a video or promo is charged at the start and given back if it fails). `kind` picks the make: `adset`, `listing` and `translate` and `week` write words (the job's `result`); `logo`, `edit`, `voice` and `music` add a file to the Library. A photo is a Library id, or the URL of one of the business's own stored photos. `video` (8 seconds from one photo) and `promo` (a storyboard written from the shop's listings and reviews, with voice and music) take a few minutes: follow them with `getStudioJob`. Owner or admin. Storage: refused with 403 `plan_limit` when it would take the Library over the plan's storage. What is already stored stays. Access: OAuth scope `ai:spend`; write-gated by the subscription.