Send Command
Assets
Send Command
Dispatch a command to an asset. Returns a task that tracks execution status.
POST
Send Command
UUID of the kit.
UUID of the asset.
Name of the command to dispatch (e.g.
arm, ptz_move, reboot). Must match a command returned by List Commands.Body
Command-specific parameters. Must conform to the command’s
input_schema. Pass {} or omit for commands that take no parameters.Response
Returns a task object. The task is immediately dispatched to the connector via MQTT and also available for polling.Task UUID. Use this to poll for status.
UUID of the target asset.
The command that was dispatched.
The payload that was sent.
Initial status: always
pending.UUID of the user who issued the command.
ISO 8601 UTC timestamp.
Task lifecycle
Tasks move through these statuses as the connector processes them:| Status | Meaning |
|---|---|
pending | Created, waiting to be picked up by the connector |
running | Connector has started execution |
completed | Command succeeded. Check result for output. |
failed | Command failed. Check result.error for the reason. |
Example
Response
Common commands by asset type
Drone (MAVLink)| Command | Payload |
|---|---|
arm | — |
disarm | — |
return_home | — |
set_mode | { "mode": "GUIDED" | "AUTO" | "LOITER" | "RTL" | "LAND" } |
goto_waypoint | { "lat": 31.1234, "lon": -93.4567, "alt_m": 50.0 } |
| Command | Payload |
|---|---|
ptz_move | { "direction": "up" | "down" | "left" | "right" | "stop", "speed": 1–64 } |
ptz_preset | { "preset_id": 1 } |
set_motion_detection | { "enabled": true } |
reboot | — |
| Command | Payload |
|---|---|
ptz_move | { "direction": "up" | "down" | "left" | "right" | "stop", "speed": 0.0–1.0 } |
ptz_preset | { "preset_token": "1" } |