Acknowledge Listing Variants

patchhttps://api.flxpoint.com/listing/variants

Use this when you want to update listing data through the API.

🔑 X-API-TOKEN⏱ 2 req/sToken: Account · Source · Channel

This page explains the endpoint. To send a live test request, use the interactive tester in Stoplight or your own Postman / HTTP client.

If you are leveraging the `sync` flag on `GET /listing/variants`, this endpoint allows you to respond to those interactions.

If a listing has a `changeToListingStatus` pending and you respond WITHOUT an `error`, Flxpoint will assume the status change worked as intended.

Request

Bodyapplication/json

array[ListingVariantAcknowledgement]

listingVariantIdintegerrequired

syncedAtstring (date-time)

Timestamp indicating when the listing was synced to the channel. Defaults to the current timestamp if not provided. This should typically be set to the timestamp you received the listing from the API for a sync at. By setting this value to the time you received the listing ensures that updates that occurred to the listing during the window you received the listing vs when you acknowledged it will not be lost. For example, you fetch a listing to sync at 12:00:00, and then acknowledge the listing at 12:00:30, but a quantity change happened to the listing at 12:00:15. If you were to pass a value of 12:00:30 (or none at all) here instead of 12:00:00 the update that occurred at 12:00:15 will not be able to accurately mark the listing as needing synced again.

errorstring

If this field is `null`, we will assume a successful interaction. If an interaction failed, please provide a reason by populating this field.

overrideStatusobject

idinteger

handlestringrequired

allowednot_listedlistedhiddendelistedpublishedbroken_linkoverwrite_data

namestring

isLinkedToRegularProductboolean

Example request

patch/listing/variants

curl -X PATCH "https://api.flxpoint.com/listing/variants" \
  -H "Accept: application/json" \
  -H "X-API-TOKEN: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '[
         {
           "listingVariantId": 0,
           "syncedAt": "2026-04-20T00:00:00Z",
           "error": "string",
           "overrideStatus": {
             "id": 0,
             "handle": "not_listed",
             "name": "string"
           },
           "isLinkedToRegularProduct": true
         }
       ]'

Example body · application/json

[
  {
    "listingVariantId": 0,
    "syncedAt": "2026-04-20T00:00:00Z",
    "error": "string",
    "overrideStatus": {
      "id": 0,
      "handle": "not_listed",
      "name": "string"
    },
    "isLinkedToRegularProduct": true
  }
]

Responses

200OK

No schema documented for this status.

401Unauthorized

No schema documented for this status.

OpenAPI fragment

{
  "patch": {
    "summary": "Acknowledge Listing Variants",
    "description": "If you are leveraging the `sync` flag on `GET /listing/variants`, this endpoint allows you to respond to those interactions. \n\nIf a listing has a `changeToListingStatus` pending and you respond WITHOUT an `error`, Flxpoint will assume the status change worked as intended.",
    "parameters": [],
    "requestBody": {
      "content": {
        "application/json": {
          "schema": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "$ref": "#/components/schemas/ListingVariantAcknowledgement"
            }
          }
        }
      }
    },
    "responses": {
      "200": {
        "description": "OK"
      },
      "401": {
        "description": "Unauthorized"
      }
    }
  }
}

Ready to run it? Send the curl from your terminal or Postman, or use the interactive tester in Stoplight.Open in Stoplight