Publish a draft listing
Publishing requires available stock (quantityTotal - quantityReserved > 0) for both unique and multi-quantity inventory. Otherwise returns HTTP 400 with code out_of_stock and message All units are held by open orders. when quantityTotal > 0, or Active listings require stock. when quantityTotal is 0.
Publishing requires available stock (quantityTotal - quantityReserved > 0) for both unique and multi-quantity inventory. Otherwise returns HTTP 400 with code out_of_stock and message All units are held by open orders. when quantityTotal > 0, or Active listings require stock. when quantityTotal is 0.
Authorization
apiKey API key created in your Marka account settings, sent as an x-api-key header (an Authorization: Bearer mk_… header is accepted as an equivalent spelling). Key-authenticated writes additionally require the api_write entitlement, which the Pro plan and above carry. A signed-in browser session cookie is also accepted for interactive exploration from the Marka web app; SDK and server-to-server clients always use a key.
In: header
Path Parameters
Listing id.
1 <= lengthResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/listings/string/publish"{ "listing": { "acceptsOffers": true, "attributes": "string", "authority": "MARKA", "autoAcceptOfferAmount": 0, "brand": "string", "categoryPath": "string", "checkoutEnabled": true, "condition": "new", "createdAt": "2019-08-24T14:15:22Z", "currency": "string", "description": "string", "directEnabled": true, "gtin": "string", "id": "string", "imageUrls": [ "string" ], "inventoryType": "unique", "location": { "addressLine1": "string", "addressLine2": "string", "city": "string", "country": "string", "latitude": -90, "longitude": -180, "postalCode": "string", "region": "string" }, "madeInCountry": "string", "packageDimensionsMm": { "heightMm": 0, "lengthMm": 0, "widthMm": 0 }, "packageWeightGrams": 0, "pickupEnabled": true, "price": 0, "quantityReserved": 0, "quantityTotal": 0, "riskCategory": "general", "sellerAccountId": "string", "shippingEnabled": true, "shippingFlatAmount": 0, "shippingProfileId": "string", "status": "draft", "title": "string", "updatedAt": "2019-08-24T14:15:22Z", "visibilityRadiusKm": 1 }}