Skip to content

Bulk update products and attributes

POST
/api/v3/item/modify/stores/{storeId}/bulk
curl --request POST \
--url https://prod.store-management.glovo.alb.app.onlineservice.io/api/v3/item/modify/stores/example/bulk \
--header 'Authorization: <Authorization>' \
--header 'Content-Type: application/json' \
--data '{ "products": [ { "id": "burger1", "name": "Burger Large", "price": 10, "image_url": "https://server.com/image", "extra_image_urls": [ "https://i.imgur.com/Tsj3NOK.png", "https://i.imgur.com/Qj5DlEH.png", "https://i.imgur.com/Qj5MlEH.png" ], "restrictions": { "is_alcoholic": true }, "available": true } ], "attributes": [ { "id": "side1", "name": "French fries", "price_impact": 1.5, "available": true } ] }'
storeId
required
string
Media typeapplication/json
object
products

Products to be updated.

Array<object>

Products to be updated.

object
id

Unique identifier of the product within a store

string
Example
burger1
name

Product name

string
Example
Burger Large
price

Product price

number format: double
Example
10
image_url

Url of the main product image. Must use HTTPS protocol.

string
Example
https://server.com/image
extra_image_urls

The array of URLs for additional images of the product. These URLs must use the HTTPS protocol. These images will be displayed on the product detail page in the same order as in the array, always following the main product image. Up to 9 images are supported (if more images are sent, only the first 9 will be processed).

Array<string>
Example
[
"https://i.imgur.com/Tsj3NOK.png",
"https://i.imgur.com/Qj5DlEH.png",
"https://i.imgur.com/Qj5MlEH.png"
]
restrictions

This is a description of an optional field in the Glovo system that indicates whether a product has an alcohol restriction.

object
is_alcoholic

The indicator that shows whether the product is an alcoholic beverage. It will trigger a user flow according to the restrictions in the case of stores in Poland and Romania.

boolean
available

Specifies if the product is available to be purchased

boolean
Example
true
attributes

Attributes to be updated.

Array<object>

Attributes to be updated.

object
id

Unique identifier of the attribute within a store

string
Example
side1
name

Attribute name

string
Example
French fries
price_impact

Attribute price

number format: double
Example
1.5
available

Specifies if the product is available to be purchased

boolean
Example
true

Bulk update success

Media typeapplication/json
object
error
string
message
string
transaction_id

Unique identifier of the asynchronous operation

string
status

Current status of the bulk update

string
Allowed values: SUCCESS PROCESSING PARTIALLY_PROCESSED NOT_PROCESSED GLOVO_ERROR
last_updated_at

Timestamp of the latest menu status update

string
details

Details for the current menu status

Array<object>

Details for the current menu status

object
Example
{
"transaction_id": "a946a2c7-f4e7-46ac-ae63-8a5497cb0ad9",
"status": "SUCCESS",
"last_updated_at": "2020-03-24T10:03:49.614Z",
"details": [
"Products updated: [11111, 22222]",
"Products not updated: [12345, 56789]",
"Attributes updated: [33333, 44444]",
"Attributes not updated: [67890, 45678]"
]
}

Invalid payload or parameters

Media type*/*
object
error
string
message
string
transaction_id

Unique identifier of the asynchronous operation

string
Example
a946a2c7-f4e7-46ac-ae63-8a5497cb0ad9
status

Current status of the bulk update

string
Allowed values: SUCCESS PROCESSING PARTIALLY_PROCESSED NOT_PROCESSED GLOVO_ERROR
Example
PARTIALLY_PROCESSED
last_updated_at

Timestamp of the latest menu status update

string
Example
2020-03-24T10:03:49.614Z
details

Details for the current menu status

Array<object>

Details for the current menu status

object
Example
[
"Products updated: [11111, 22222]",
"Products not updated: [12345, 56789]",
"Attributes updated: [33333, 44444]",
"Attributes not updated: [67890, 45678]"
]
Example
[
"Products updated: [11111, 22222]",
"Products not updated: [12345, 56789]",
"Attributes updated: [33333, 44444]",
"Attributes not updated: [67890, 45678]"
]

Unauthorized

Media type*/*
object
error
string
message
string
transaction_id

Unique identifier of the asynchronous operation

string
Example
a946a2c7-f4e7-46ac-ae63-8a5497cb0ad9
status

Current status of the bulk update

string
Allowed values: SUCCESS PROCESSING PARTIALLY_PROCESSED NOT_PROCESSED GLOVO_ERROR
Example
PARTIALLY_PROCESSED
last_updated_at

Timestamp of the latest menu status update

string
Example
2020-03-24T10:03:49.614Z
details

Details for the current menu status

Array<object>

Details for the current menu status

object
Example
[
"Products updated: [11111, 22222]",
"Products not updated: [12345, 56789]",
"Attributes updated: [33333, 44444]",
"Attributes not updated: [67890, 45678]"
]
Example
[
"Products updated: [11111, 22222]",
"Products not updated: [12345, 56789]",
"Attributes updated: [33333, 44444]",
"Attributes not updated: [67890, 45678]"
]

Internal server error

Media type*/*
object
error
string
message
string
transaction_id

Unique identifier of the asynchronous operation

string
Example
a946a2c7-f4e7-46ac-ae63-8a5497cb0ad9
status

Current status of the bulk update

string
Allowed values: SUCCESS PROCESSING PARTIALLY_PROCESSED NOT_PROCESSED GLOVO_ERROR
Example
PARTIALLY_PROCESSED
last_updated_at

Timestamp of the latest menu status update

string
Example
2020-03-24T10:03:49.614Z
details

Details for the current menu status

Array<object>

Details for the current menu status

object
Example
[
"Products updated: [11111, 22222]",
"Products not updated: [12345, 56789]",
"Attributes updated: [33333, 44444]",
"Attributes not updated: [67890, 45678]"
]
Example
[
"Products updated: [11111, 22222]",
"Products not updated: [12345, 56789]",
"Attributes updated: [33333, 44444]",
"Attributes not updated: [67890, 45678]"
]