Scopes and limits
- Tokens now have one scope per resource and action:
store:read,orders:read,orders:buyer:read,orders:write,orders:approve,orders:cancel,commands:read,commands:write,commands:execute,servers:read,servers:write,webhooks:read, andwebhooks:write. Existing tokens keeporders:readandorders:buyer:read. - Rate limits count per token and route template, with
X-RateLimit-LimitandX-RateLimit-Remainingon every authenticated response andRetry-Afteron429. - Missing resources answer
404with a typed code, and state conflicts answer409.
Orders
GET /v1/seller/orderslists every order, without the 30-day window, and filters by status, gateway, time range, e-mail, identifier, product, coupon, and free text.- The order object carries
number, items with variables, coupons, discounts, checkout fields, delivery status, the custom gateway, and buyer billing details. - New actions: approve, cancel, mark as refunded, correct the delivery identifier, resend commands, and manage notes.
Commands and servers
- List, read, retry, edit, and delete queued commands.
- Pull, done, and fail on a server with the store’s API token.
- Create, read, and delete servers, and regenerate connector tokens.
Webhooks
- The payload moved the order under
data.order, which now holds the full order with the buyer.createdAtis in UTC withZ. - Send a
webhook.testevent from the dashboard or the API, and read the payload of any delivery. - Manage endpoints and deliveries through the API.
- Finished deliveries are deleted after 30 days.
