Skip to main content
PATCH
Edit one of your gift-card listings

Авторизации

Authorization
string
header
обязательно

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

Параметры пути

id
string<uuid>
обязательно

Тело

application/json

Every field optional; absent means "leave unchanged".

title
string
Required string length: 8 - 128
description
string
Maximum string length: 4096
price
integer<int64>

US cents.

images
string<uri>[]

Replaces the whole gallery.

Maximum array length: 10
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.

delivery_method
string

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

Ответ

OK

What every category's listing carries, whatever it sells.

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. paused and archived are yours too, through pause and DELETE. reserved and sold follow an order. removed is a takedown after publishing, which no call in this API performs.

Доступные опции:
draft,
active,
paused,
reserved,
sold,
removed,
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.

price
integer<int64>

US cents.

currency
string

Always USD.

Пример:

"USD"

images
string<uri>[]
delivery_method
string | null

The key this listing hands over by.