Skip to content

UpdateStatus updates the status of a listing

You call thisScope not enforced

POST
/v2/storefront/listing/variant/{sku}/status
curl --request POST \
--url https://api.zentail.com/v2/storefront/listing/variant/example/status \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "status": "STANDARD_STATUS_UNSPECIFIED", "channelStatus": "example", "channelId": "example", "listingUrl": "example", "buyable": true, "channelListingId": "example" }'
sku
required
string
Media typeapplication/json
UpdateStatusRequest provides the status of a SKU
object
status
StandardStatus is the standardized status of a listing as defined by Zentail
string
default: STANDARD_STATUS_UNSPECIFIED
Allowed values: STANDARD_STATUS_UNSPECIFIED STANDARD_STATUS_PUBLISHED STANDARD_STATUS_UNPUBLISHED STANDARD_STATUS_SUPPRESSED STANDARD_STATUS_RETIRED
channelStatus
string
channelId

The channel’s ID for this particular SKU. Should be more specific than Listing.

string
listingUrl
string
buyable
boolean
channelListingId

The channel’s listing-level id (Amazon ASIN, eBay ItemID, Walmart id), distinct from channel_id (the variant-level id).

string

A successful response.

Media typeapplication/json
UpdateStatusResponse is empty
object
Examplegenerated
{}

An unexpected error response.

Media typeapplication/json
object
code
integer format: int32
message
string
details
Array<object>
object
@type
string
key
additional properties
Examplegenerated
{
"code": 1,
"message": "example",
"details": [
{
"@type": "example"
}
]
}

Sourceapi-proto@afdb30cc via [email protected]

Built74a620a7

This page describes the source document as deployed: the version listing pinned in its release r2026.09.25.05. A change merged upstream shows up here once it has deployed and the pins are next refreshed.

API changelog