Skip to content

Area: Developers

POST

Update product availability

Path
/products/availability
Auth
Secret key · server only
POST
/products/availability
curl --request POST \
--url https://releva.ai/api/v0/products/availability \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "products": [ { "id": "DEMO-1004", "available": false } ] }'

Changes only available (and updatedAt) on existing products. Every other stored field is left as it is. For a product with a single variant, the variant’s availability follows. Ids that are not in the catalog are skipped and no product is created. Asynchronous.

Media typeapplication/json
object
products
required
Array<object>
>= 1 items
object
id
required

The product id as sent to POST /products.

string
available
required
boolean

Example

{
"products": [
{
"id": "DEMO-1004",
"available": false
}
]
}

Accepted for asynchronous processing.

Media typeapplication/json
object
0

Example

{}

Authentication or validation error.

Media typeapplication/json
object
message
required

Human-readable error. Several validation errors are joined with a space.

string

Examples

{
"message": "The object 'products[0]' contains forbidden keys: 'listPrice'."
}

The domain is disabled.

Media typeapplication/json
object
message
required

Human-readable error. Several validation errors are joined with a space.

string

Example

{
"message": "Domain is disabled. Please reach out to support@releva.ai to enable it."
}

Request body larger than 800 KB.

Media typeapplication/json
object
message
required

Human-readable error. Several validation errors are joined with a space.

string

Example

{
"message": "request entity too large"
}

Unexpected server error.

Media typeapplication/json
object
message
required

Human-readable error. Several validation errors are joined with a space.

string

Example

{
"message": "An internal error occurred."
}