Skip to main content
PATCH
Edit one of your currency listings

Autorisierungen

Authorization
string
header
erforderlich

Your API key, from the cabinet under Seller → API keys.

Pfadparameter

id
string<uuid>
erforderlich

Body

application/json

Every field optional; absent means "leave unchanged". Repricing and restocking here are ordinary edits.

title
string
Required string length: 8 - 128
description
string
Maximum string length: 4096
tags
string[]

Replaces the whole list. Same limits as on create.

attributes
object

Replaces the whole map — send every field, not only the changed one.

price_per_unit
integer<int64>

US cents per one of the product's scale.

stock_quantity
integer<int64>

What you have left, in the product's scale — restocking is this field.

min_order_quantity
integer<int64>

The smallest order you will take.

delivery_method
string

A key from GET /v1/offers/delivery-methods.

delivery_instructions
string

What the buyer is told to do at handover.

Maximum string length: 2048
manual_delivery_value
integer<int32>

The handover time you promise.

manual_delivery_unit
enum<string>

What the value counts.

Verfügbare Optionen:
minutes,
hours,
days

Antwort

OK

How a listing sold by hand promises to hand over.

id
string<uuid>
title
string
description
string
attributes
object

The category's own fields, keyed by the schema's key.

tags
string[]
status
enum<string>

draft on create, then active once you publish it; unpublish takes it back to draft. archived is yours too, through DELETE. sold follows an order: the last unit went to a closed one. changes_requested is moderation sending a live listing back: it is off the marketplace, moderation_reason_code says why, and your next PATCH makes it a draft to publish again.

Verfügbare Optionen:
draft,
active,
changes_requested,
sold,
archived
created_at
string<date-time> | null
updated_at
string<date-time> | null
published_at
string<date-time> | null

When publish put it on the marketplace. null while it is a draft, and written once — pausing and unpausing leave it alone.

moderation_reason_code
enum<string> | null

Why moderation asked for changes. Kept through the PATCH that makes the listing a draft, null once it is published again.

Verfügbare Optionen:
prohibited_item,
misleading_description,
stolen_images,
invalid_price,
insufficient_details,
other,
null
moderation_note
string | null

What moderation wrote to you along with the reason, if anything.

manual_delivery_value
integer<int32> | null

The handover time promised, read together with the unit — 2 and hours.

manual_delivery_unit
enum<string> | null

What the value counts. Both are null on a listing delivered instantly.

Verfügbare Optionen:
minutes,
hours,
days,
null
currency
string

Always USD.

Beispiel:

"USD"

product_id
string<uuid> | null

The product this listing sells, from GET .../products.

price_per_unit
integer<int64> | null

US cents per one of the product's scale.

stock_quantity
integer<int64> | null

What is left, in that same scale.

min_order_quantity
integer<int64> | null

The smallest order this listing takes.

delivery_method
string | null

The key this listing hands over by.

delivery_instructions
string

What the buyer is told to do at handover.