Queue a bulk update of inventory policy for multiple variants

POST

/external/preorders/{id}/bulk_toggle_inventory_policy

curl --request POST \
  --url https://app.stoqapp.com/api/v1/external/preorders/example/bulk_toggle_inventory_policy \
  --header 'Content-Type: application/json' \
  --header 'X-Auth-Token: <X-Auth-Token>' \
  --data '{ "shopify_variant_ids": [ 43900910010503, 43900910010999 ], "inventory_policy": "CONTINUE" }'

• Production

Queues a background job to update the inventory policy for multiple variants. The operation is performed asynchronously to handle large numbers of variants efficiently. Updates are processed in batches of up to 1000 variants to stay within message size limits.

Authorizations

• ApiKeyAuth

Parameters

Path Parameters

id

required

string

Selling plan ID

Header Parameters

X-Auth-Token

required

string

API key for authentication

Request Body^required

Media typeapplication/json

object

shopify_variant_ids

required

Array of Shopify variant IDs to update

Array<integer>

inventory_policy

required

The inventory policy to set for the variants

string

Allowed values: CONTINUE DENY

Example

{
  "shopify_variant_ids": [
    43900910010503,
    43900910010999
  ],
  "inventory_policy": "CONTINUE"
}

Responses

200

Inventory policy update has been queued successfully

Media typeapplication/json

object

success

boolean

message

string

variants_queued

List of variant IDs that were queued for processing

Array<integer>

Example

{
  "success": true,
  "message": "Inventory policy update queued",
  "variants_queued": [
    43900910010503,
    43900910010999
  ]
}

400

Bad request - missing or invalid parameters

Media typeapplication/json

object

error

string

Example ^generated

{
  "error": "example"
}

401

Unauthorized

404

Selling plan not found

Media typeapplication/json

object

error

string

Example ^generated

{
  "error": "example"
}

422

Invalid inventory policy

Media typeapplication/json

object

error

string

Example ^generated

{
  "error": "example"
}