Update listing texts / resync
PATCH /rest/v1/listings/{id}
Sets this channel's own title and description (overrides.title, overrides.description; null or "" = back to the product's text) and pushes them to the channel when the listing is live AND the account sends product edits (sync.product_edits). When pushed, the answer carries operation_id: that operation has one result for this channel, pending until the channel answers, then succeeded or failed with the channel's message (e.g. a title the channel refuses). Watch operation.completed or GET /operations/{id}. When not pushed, push_skipped_reason says why. The change is logged and can be undone (POST /actions/{id}/undo). Other overrides (category_id) and attributes are not available yet and return 422 overrides_not_supported. Sending an empty body triggers a plain resync. Texts the leader channel edits (content sync from a channel) replace the texts of every listing.
Required scope: listings:write.
Authorization
apiKey Authorization: Bearer nbl_live_... (or nbl_test_... for test mode). Test-mode writes are validated and simulated but never persisted and never touch channels; simulated results are marked simulated.
In: header
Path Parameters
Header Parameters
Unique client-generated key (max 255 chars), stored 24h.
length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X PATCH "https://example.com/listings/string" \ -H "Content-Type: application/json" \ -d '{}'{ "id": "list_9ac2e", "object": "listing", "product_id": "string", "channel_account_id": "string", "channel": "string", "status": "listed", "id_on_channel": "string", "url_on_channel": "http://example.com", "site": "string", "overrides": { "title": "string", "description": "string", "category_id": "string" }, "content": { "title": "string", "description": "string" }, "attributes": {}, "variants": [ { "variant_id": "var_66a1f1", "sku": "string", "id_on_channel": "string" } ], "issues": [ { "code": "photo_required_for_channel", "severity": "error", "message": "string", "attribute_names": [ "string" ] } ], "operation_id": "string", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "pushed": true, "push_skipped_reason": "no_changes"}Last updated on October 18, 2026
Need help?
Email us and a human replies, usually within one business day.