Bulk Disable

POST

/preorders/offers/bulk_disable

curl --request POST \
  --url https://app.stoqapp.com/api/v2/external/preorders/offers/bulk_disable \
  --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 off at once, as the Offers list’s bulk Disable does. Optionally flip the attached variants’ inventory policy back to DENY.

Note: ids are offer ids. Each offer is turned off as the dashboard’s bulk Disable does: a dated offer has its schedule removed. update_inventory_policy: true also sets every attached variant of the STOQ-inventory offers back to “Stop selling when out of stock” (DENY), as the bulk Disable dialog 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"
  ]
}