Vehicles/send_unit_command_tech

send_unit_command_techtoken required

Sends a technician/remote command to a single vehicle's unit. Write action — returns one row echoing the command status.

POST/api— body field action.name = "send_unit_command_tech"

Parameters

NameTypeRequiredDescription
vehicle_idnumberrequiredTarget vehicle id (positive). Missing or invalid returns action_value '1'.e.g. 591723
command_typenumberrequiredCommand to send — must be 1 or 2. Any other value returns action_value '1'.e.g. 1
interval_secondsnumberoptionalSeconds between repeats when transmission_count is greater than 1.e.g. 30
transmission_countnumberoptionalHow many times to send the command. Defaults to 1.e.g. 3

Notes

action_value '1' = missing/invalid vehicle_id or command_type; '999' = session error, no unit found for the vehicle, or internal error. On success, action_value is '0' and data is an empty array The interval_seconds / transmission_count / session_seconds trio is echoed back only when a cyclic plan was requested; a one-shot command returns user_message, dry_run and status alone.

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":"send_unit_command_tech","parameters":[{"vehicle_id":591723,"command_type":1,"interval_seconds":30,"transmission_count":3}]}}'
Body
{
  "action": {
    "name": "send_unit_command_tech",
    "parameters": [
      {
        "vehicle_id": 591723,
        "command_type": 1,
        "interval_seconds": 30,
        "transmission_count": 3
      }
    ]
  }
}

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": "send_unit_command_tech",
      "action_value": "0",
      "description": "success",
      "data": [
        {
          "user_message": "Command queued",
          "dry_run": false,
          "status": "sent",
          "interval_seconds": "30",
          "transmission_count": "3",
          "session_seconds": "90"
        }
      ]
    }
  }
}