Listings

Update synchronization policy

Replaces a listing's effective policy.

PATCH
/v1/listings/{listingId}/sync-policy

Use it to accept or only observe external changes, authorize publication, and select automatic-inventory bindings. Updating the policy does not publish.

Authorization

api_key
headerAuthorizationBearer <token>

API key (mk_...)

Path Parameters

listingId*string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Request Body

application/json
  1. body

Independent inbound, outbound, and inventory synchronization decisions.

inbound*

Whether confirmed external changes update observed state locally.

outbound*

Whether normal publication commands may call the marketplace.

inventory*

Whether eligible bindings receive automatic quantity-only publication.

Response Body

The policy after replacement.

application/json
  1. response

Independent inbound, outbound, and inventory synchronization decisions.

inbound*

Whether confirmed external changes update observed state locally.

outbound*

Whether normal publication commands may call the marketplace.

inventory*

Whether eligible bindings receive automatic quantity-only publication.

curl -X PATCH "https://example.com/v1/listings/497f6eca-6276-4993-bfeb-53cbbbba6f08/sync-policy" \  -H "Content-Type: application/json" \  -d '{    "inbound": {      "mode": "active"    },    "outbound": {      "enabled": true    },    "inventory": {      "mode": "automatic",      "eligibleBindingIds": [        "cb064b64-2f63-4c3e-aa42-f11ea0f82b17"      ]    }  }'
{  "inbound": {    "mode": "active"  },  "outbound": {    "enabled": true  },  "inventory": {    "mode": "automatic",    "eligibleBindingIds": [      "cb064b64-2f63-4c3e-aa42-f11ea0f82b17"    ]  }}