Listings

Restarts an ended item, listing it again as a new item. The restart is processed asynchronously: on success the response carries the id reserved for the new item, which becomes retrievable once the restart completes. An item can only be restarted while it is ended, unsold and has restarts left; when it does not qualify the response is returned with `isSuccessful` false and a `validationError` describing why. Returns 404 if the item does not exist or does not belong to the seller.

post/v4/listings/items/{itemId}/restart

Path parameters

itemIdinteger required

Response

isSuccessfulboolean

Whether the restart was accepted. A restart runs asynchronously, so a successful response means the restart was queued, not that the new item is listed yet.

oldItemIdinteger

The item that was restarted.

newItemIdinteger nullable

The id reserved for the restarted item. Null when the restart was rejected. The item becomes available under this id once the restart completes.

validationErrorstring nullable

Why the restart was rejected, for example "Item is not ended" or "Item has already been restarted". Null when the restart was accepted.

Changes

No recorded changes to this endpoint across all 1 revision of this API.