markaDocs

Update listing fields

PATCH
/v1/listings/{id}
x-api-key<token>

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

id*string

Listing id.

Length1 <= length

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/v1/listings/string" \  -H "Content-Type: application/json" \  -d '{}'
{  "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  }}