Switch feeds for many vehicles
POST/vehicles/feeds
Turns the named feeds on or off for up to 500 vehicles at once, as the
DMS stock list does. Feeds not named are left alone. All or nothing:
an id this key cannot see, or a feed the dealer cannot publish to,
refuses the whole request with 422 before anything changes.
Switching AutoTrader on sends the advert to AutoTrader. A dealer
whose plan has no stock feeds gets 403 stock_feeds_not_enabled.
Scope vehicles:write. Secret keys only.
Request
Responses
- 200
- 401
- 403
- 422
- 429
What a bulk feed change did.
Response Headers
This request's id. Quote it to support.
Requests allowed per minute for this key.
Requests left in the current minute.
No key, or one that cannot be used. Codes: missing_api_key,
invalid_api_key, api_key_revoked, api_key_expired,
key_owner_inactive.
Response Headers
This request's id. Quote it to support.
Bearer.
The key may not do this. Codes: insufficient_scope,
scope_not_permitted_for_owner, plan_not_entitled,
secret_key_required, publishable_key_required,
secret_key_in_browser, origin_not_allowed, ip_not_allowed,
branch_move_not_permitted, plan_stock_cap_reached,
sandbox_stock_cap_reached, not_available_in_sandbox,
theme_builder_not_enabled, agency_key_required,
agency_not_approved, agency_access_revoked.
Response Headers
This request's id. Quote it to support.
The request was not valid. Code validation_failed, with errors
keyed by field; also body_not_received (a multipart body that
never arrived), webhook_endpoint_limit_reached,
vehicle_not_created, request_refused and
theme_publish_blocked (with errors.routes and errors.findings).
Response Headers
This request's id. Quote it to support.
Too many requests. Code rate_limited; wait Retry-After seconds. On POST /theme-generations, also theme_generation_quota_exceeded, when the dealer's monthly theme generations are used up (no Retry-After).
Response Headers
This request's id. Quote it to support.
Requests allowed per minute for this key.
Requests left in the current minute.
Seconds to wait before retrying.