Commands API

These endpoints send and track device commands through the HXTP safety gateway and MQTT bridge.

Base URL: https://api.hestialabs.in/v1

Endpoints

Method	Path	Summary
GET	/device/{deviceId}/commands	Command History
POST	/device/{deviceId}/command	Send Command
POST	/device/{deviceId}/command/confirm	Confirm Command
POST	/devices/command	Batch Command

Command History

GET /device/{deviceId}/commands

Get command history for a device

Authentication: Bearer JWT required

Parameters

Name	In	Type	Required	Description
deviceId	path	string	Yes	—

Responses

Status	Description
200	Command history

Example 200 response

{
  "commands": [
    "value"
  ]
}

Send Command

POST /device/{deviceId}/command

Send a command to a device

Authentication: Bearer JWT required

Parameters

Name	In	Type	Required	Description
deviceId	path	string	Yes	—

Request body

Field	Type	Required	Description
action	string	Yes	Action name (e.g., toggle_led, set_pin)
params	object	No	Action parameters
dry_run	boolean	No	Dry-run mode (safety check only)

Example request

{
  "action": "string",
  "params": {},
  "dry_run": true
}

Responses

Status	Description
200	Dry run required
202	Command dispatched
403	Blocked

Example 200 response

{
  "status": "string",
  "reason": "string",
  "dry_run_token": "string"
}

Example 202 response

{
  "success": true,
  "command_id": "string",
  "message_id": "string"
}

Confirm Command

POST /device/{deviceId}/command/confirm

Confirm dry-run token to execute

Authentication: Bearer JWT required

Parameters

Name	In	Type	Required	Description
deviceId	path	string	Yes	—

Request body

Field	Type	Required	Description
token	string	No	—
dry_run_token	string	No	—

Example request

{
  "token": "string",
  "dry_run_token": "string"
}

Responses

Status	Description
200	Command executed
403	Confirmation failed

Example 200 response

{}

Batch Command

POST /devices/command

Send command to multiple devices

Authentication: Bearer JWT required

Parameters

None.

Request body

Field	Type	Required	Description
device_ids	array<string>	Yes	—
action	string	Yes	—
params	object	No	—

Example request

{
  "device_ids": [
    "string"
  ],
  "action": "string",
  "params": {}
}

Responses

Status	Description
200	Batch results

Example 200 response

{
  "results": [
    "value"
  ]
}