Adds and removes several saved vehicles in one vehicle group of the application's organization, with a result for each vehicle, so one bad id does not fail the whole request.

Input. groupId in the path. The body holds add and remove, arrays of numeric vehicle ids, each optional, at most 500 ids per array and no id twice. At least one id is required, and an id may not be in both arrays.

Response. 200 with { groupId, memberCount, results }: one entry per id, the additions first and then the removals, each in the order sent. status is added or removed when the call changed the group, unchanged when the vehicle was already in that state, notFound when the vehicle does not exist or is not visible to the access token, unsaved when it is an unsaved vehicle, and conflict (with a message) when a private vehicle cannot join a group that is not private. memberCount counts the vehicles of the group after the change that the access token may see.

Notes. A missing group is a 404 for the whole request. A rule about the group as a whole refuses the whole request with 409 before anything changes: removing the last vehicles of a group an alert uses, or adding vehicles hidden from users of an alert that uses the group.

Side effects. The updated group is sent to the Cores that use it, once for the additions and once for the removals.

Request examples

POST /v3/vehicle-api/groups/6512bd43d9caa6e02c990b0a/vehicles/batch

{ "add": [1093527491036451] }

POST /v3/vehicle-api/groups/6512bd43d9caa6e02c990b0a/vehicles/batch

{ "add": [1093527491036451, 1093527491036452], "remove": [1093527491036453] }

Required scope: write:vehicles