External API
Docs & Playground
Admin/Lookup/set_vehicles_services_date

set_vehicles_services_datetoken required

Bulk-updates the service-date window (`start_service` / `end_service`) for up to 200 vehicles in one call. Write action — returns an empty `data` array on success.

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

Parameters

NameTypeRequiredDescription
vehicle_idsstringrequiredComma-separated list of positive decimal vehicle ids (deduplicated server-side). Empty or non-numeric tokens return errorcode '2'.e.g. 591723
start_servicedaterequiredISO date marking the start of the service window. Unparseable / missing values return errorcode '3'.e.g. 2025-01-01
end_servicedaterequiredISO date marking the end of the service window. Must be on or after `start_service` (errorcode '7' otherwise). Unparseable / missing values return errorcode '4'.e.g. 2025-12-31

Notes

Hard cap of 200 vehicles per call (errorcode '5'). Per-user vehicle scoping is enforced — any input vehicle outside the caller's scope fails the entire batch (errorcode '6'). On success, `data` is an empty array and `action_value` is '0'.

Request

curl
curl -X POST 'https://private.stage.questar.io/v2/private-questar-units/api' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  --data '{"action":{"name":"set_vehicles_services_date","parameters":[{"vehicle_ids":"591723","start_service":"2025-01-01","end_service":"2025-12-31"}]}}'
Body
{
  "action": {
    "name": "set_vehicles_services_date",
    "parameters": [
      {
        "vehicle_ids": "591723",
        "start_service": "2025-01-01",
        "end_service": "2025-12-31"
      }
    ]
  }
}

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_services_date",
      "action_value": "0",
      "description": "success",
      "data": [
        {}
      ]
    }
  }
}