Listing apply jobs

Use a listing-apply job whenever you need to publish more than a few listings to one or more channels. The job runs asynchronously and emits events as it progresses.

1. Start the job

POST /v1/listings/listing_apply_jobs
{
  "listing_ids": ["lst_..."],
  "channels": ["amazon-us", "ebay-us"]
}

Response: 202 Accepted with a job resource (id, state=queued, poll_url).

2. Poll or subscribe

Poll GET /v1/jobs/{id} every 2-5 seconds, or subscribe to the listings.listing_apply.* event family for push notifications.

3. Read results

When state is completed (or failed), the job carries a per-listing result map: { listing_id, channel, ok, error? }. Inspect failures without re-running the entire batch.