Skip to main content

Upsert vehicles in a batch

POST 
/vehicles/batch

Creates or updates up to 500 vehicles in one request, with their photos. Scope: vehicles:write. Secret keys only.

Each item is matched, in order, by id, then external_id, then registration: a matched item updates that vehicle, an unmatched one creates a vehicle. An item's images replaces that vehicle's photos through a staged import, so the vehicle is never shown with half a gallery.

The request checks each item's shape and answers 202 at once; items that fail the check are already failed in the response. The rest are written in the background: poll GET /vehicle-batches/{id} for per-item results, or listen for the vehicle_batch.completed event. On the Free plan, created items beyond the stock cap fail with plan_stock_cap_reached; updates always go through.

Request​

Responses​

The batch, with a result for every item.

Response Headers
    X-Request-Id

    This request's id. Quote it to support.

    X-RateLimit-Limit

    Requests allowed per minute for this key.

    X-RateLimit-Remaining

    Requests left in the current minute.

    Idempotent-Replayed

    true when this is the stored response to an earlier request with the same Idempotency-Key.