Platitun · API · Listings · Update a listing

Update a listing

PATCH /api/v1/listings/{number}

Key scope: listings · changes data, the Idempotency-Key header is required

Send the WHOLE body, all fields. Listing rules are interlocked — the delivery method depends on the product type, rate and amount on the credits type — and a single field cannot be validated in isolation. The service and the plan cannot be changed by an update: that would be a different listing.

Updating a SWITCHED ON listing changes the public offer immediately. If the price goes down, that is your business; if up, a buyer who already pressed “buy” pays the previous one: the order takes a price snapshot.

Request fields

Field	Type	What it is
`priceRub` required	`integer`	The price in roubles.
`productType` required	`string`	The product type — the same as before.
`deliveryMethod` required	`string`	The delivery method.
`slaMinutes` required	`integer`	The promised delivery time.
`guaranteeDays` required	`integer`	The guarantee period.
`description`	`string`	The product description.

Response fields

Field	Type	What it is
`number`	`integer`	The public number.
`isActive`	`boolean`	The state after the update.

Refusal reasons

A rule refusal arrives as {"error":"rejected","refusal":{"kind":"…"}} with status 409. Refusals common to all endpoints are in the rules section.

Code	What happened and what to do
`not_found`	The record does not exist or is not yours. The ownership condition is in the database query itself, so someone else’s record looks like a missing one.
`complaint`	The listing rules did not match: for instance the delivery method does not fit the product type, or a period is outside the allowed list. The allowed values come from the catalogue position endpoint.
`contacts`	Contact details were found in the text — an email, a phone number, a messenger link. Taking the deal off the marketplace strips the buyer of protection and the seller of the guarantee. Remove them and send again.
`type_not_available`	This position does not have such a product type. The possible types are in the catalogue position response.
`self_employed_forbidden`	A self-employed seller may only sell a subscription issued to the buyer’s own email: ready accounts and credits are resale, which the law forbids to the self-employed.

Nearby in this section

GET /api/v1/listings — My listings
POST /api/v1/listings — Create a listing
GET /api/v1/listings/{number} — One of my listings
DELETE /api/v1/listings/{number} — Remove a listing
POST /api/v1/listings/{number}/state — Switch on, switch off, auto-delivery
POST /api/v1/listings/{number}/copy — Copy a listing
POST /api/v1/listings/{number}/test — Mark a listing as test
PUT /api/v1/listings/{number}/image — The listing image
DELETE /api/v1/listings/{number}/image — Remove the image
GET /api/v1/questions — Questions about my listings
POST /api/v1/questions/{id}/answer — Answer a question