Bulk Enable

POST

/preorders/offers/bulk_enable

curl --request POST \
  --url https://app.stoqapp.com/api/v2/external/preorders/offers/bulk_enable \
  --header 'Content-Type: application/json' \
  --header 'X-Auth-Token: <X-Auth-Token>' \
  --data '{ "ids": "string", "update_inventory_policy": "2026-07-01T00:00:00Z" }'

• Production

Turn many preorder offers on at once, as the Offers list’s bulk Enable does. Optionally flip the attached variants’ inventory policy to CONTINUE.

Note: ids are offer ids. Each offer is turned on as the dashboard’s bulk Enable does: a scheduled offer starts now (its start date is cleared, an end date is kept). An offer that cannot be turned on (for example the plan’s offer limit) is counted in failed with its reason in failed_errors; the others still turn on. update_inventory_policy: true also sets every attached variant of the STOQ-inventory offers to “Continue selling when out of stock”, as the bulk Enable dialog’s Continue selling choice does; offers with more than 250 variants are flipped in the background.

Authorizations

• ApiKeyAuth

Request Body^required

Media typeapplication/json

object

ids

update_inventory_policy

Example

{
  "ids": "string",
  "update_inventory_policy": "2026-07-01T00:00:00Z"
}

Responses

200

Success — the updated resource.

Media typeapplication/json

object

Example ^generated

{}

202

Accepted — async/bulk work was queued. Poll the returned job.

Media typeapplication/json

Returned for async/bulk work — poll the job until it reaches a terminal state.

object

job_id

string

status_url

string

Example

{
  "job_id": "job_a1b2c3",
  "status_url": "/api/v2/external/jobs/job_a1b2c3"
}

401

Missing or invalid X-Auth-Token.

Media typeapplication/json

Error envelope returned by every failed request.

object

errors

required

Array<string>

Example

{
  "errors": [
    "Unauthorized"
  ]
}

422

The request failed validation.

Media typeapplication/json

Error envelope returned by every failed request.

object

errors

required

Array<string>

Example

{
  "errors": [
    "name is required"
  ]
}

429

Rate limited — cost-weighted per token (read 1, write 2; 360 points / 60s). Check Retry-After.

Media typeapplication/json

Error envelope returned by every failed request.

object

errors

required

Array<string>

Example

{
  "errors": [
    "Rate limit exceeded"
  ]
}