Bulk-provision stores into a tier

Moves up to 1,000 stores into one tier in a single call. Safe to re-run: sending the same list again moves nothing further, so a retry after a timeout does not double-charge. Stores outside your partner account do not count rather than rejected — read skipped_out_of_scope in the response.

Auth

  • Bearer — partner token. The platform resolves the partner account your user belongs to, and only stores under that account can be moved.

Rate limit

  • No rate limit.

Body

FieldTypeRequiredNotes
tierstringRequiredOne of core, mgmt, plus, dormant. Ask your account manager which value matches each subscription.
store_idsinteger[]Required1–1000 store ids.
store_ids.*integerRequiredEach entry must be an integer.

Behaviour

  • 200 with { provisioned, skipped_out_of_scope } (arrays of store ids). Safe to re-run: repeating the call for a store already on the target tier clears only cancel_subscription_at marker.
  • 400 unknown tier slug · 403 partner scope unresolvable · 422 validation (missing tier / store_ids).
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
store_ids
array of integers
store_ids
Responses

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json