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
| Name | Type | Required | Description |
|---|---|---|---|
vehicle_id | number | required | Target vehicle id (positive). Missing or invalid returns action_value '1'.e.g. 591723 |
command_type | number | required | Command to send — must be 1 or 2. Any other value returns action_value '1'.e.g. 1 |
interval_seconds | number | optional | Seconds between repeats when transmission_count is greater than 1.e.g. 30 |
transmission_count | number | optional | How 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"
}
]
}
}
}