External API
Docs & Playground
Admin/Lookup/set_vehicles_group

set_vehicles_grouptoken required

Bulk-reassigns vehicles to a target group. Write action — returns an empty data array on success.

Try in playground
POST/api— body field action.name = "set_vehicles_group"

Parameters

NameTypeRequiredDescription
vehicle_idsstringrequiredComma-separated list of positive vehicle ids (deduplicated server-side). Empty or unparseable returns action_value '2'.e.g. 591723,591724
group_idnumberrequiredTarget group id (positive). Empty, zero, or non-positive returns action_value '3'.e.g. 39201

Notes

action_value '1' = session / user not found; '2' = vehicle_ids empty or unparseable; '3' = group_id empty/zero/non-positive; '6' = the user is not allowed for the target group_id. On success, action_value is '0' and data is an empty array.

Request

curl
curl -X POST 'https://private.develop-1.questar.io/v2/private-questar-units/api' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  --data '{"action":{"name":"set_vehicles_group","parameters":[{"vehicle_ids":"591723,591724","group_id":39201}]}}'
Body
{
  "action": {
    "name": "set_vehicles_group",
    "parameters": [
      {
        "vehicle_ids": "591723,591724",
        "group_id": 39201
      }
    ]
  }
}

Response

Successful responses always wrap the action's payload in response.properties. The action_value field reports the handler outcome: "0" for success, "1" for invalid params, "2" for not allowed, "3" for limit-exceeded /pagination-session-expired, "999" for general error.

200 OK
{
  "response": {
    "properties": {
      "action_name": "set_vehicles_group",
      "action_value": "0",
      "description": "success",
      "data": [
        {}
      ]
    }
  }
}