Skip to main content
PATCH
Edit an offer

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string<uuid>
required

Body

application/json

Every field optional; absent means "leave unchanged". images and tags replace the whole list when present.

title
string
Required string length: 8 - 128
description
string
Maximum string length: 4096
price
integer<int64>
currency
string
attributes
object
images
string<uri>[]
tags
string[]
delivery_type
enum<string>

Changing this replaces the offer's unit pool.

Available options:
instant,
manual
units
object[]

The stock a switch to instant starts with.

manual_delivery_value
integer
manual_delivery_unit
enum<string>
Available options:
minutes,
hours,
days
manual_delivery_instructions
string
Maximum string length: 2048
seller_instructions
string
Maximum string length: 2048
delivery_method
string
price_per_unit
integer<int64>
stock_quantity
integer<int64>
min_order_quantity
integer<int64>

Response

OK

Your own listing, as the write calls answer with it.

id
string<uuid>
seller_id
string<uuid>
title
string
description
string
price
integer<int64>
currency
string
attributes
object
images
string<uri>[]
tags
string[]
delivery_type
enum<string>
Available options:
instant,
manual
manual_delivery_value
integer | null
manual_delivery_unit
string | null
manual_delivery_instructions
string | null
status
enum<string>
Available options:
draft,
pending_moderation,
active,
paused,
reserved,
sold,
rejected,
removed,
archived
created_at
string<date-time> | null
updated_at
string<date-time> | null
published_at
string<date-time> | null
rejection_reason_code
string | null

Why moderation refused it, when it did.

rejection_note
string | null
seller_instructions
string
delivery_method
string | null
price_per_unit
integer<int64> | null
stock_quantity
integer<int64> | null
min_order_quantity
integer<int64> | null
product_id
string<uuid> | null