Issue a generic device command (v3)

POST

projects

{project_id}

devices

{device_id}

commands

Error

A valid request URL is required to generate request examples

{
  "data": "<unknown>",
  "meta": "<unknown>",
  "ok": 1
}

{
  "detail": "<string>",
  "message": "<string>",
  "ok": 0
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

ORG-ID

string

header

required

Path Parameters

project_id

string<uuid>

required

device_id

string<uuid>

required

Body

application/json

command_type

string

required

channel

string

params

object

Response

Command accepted

Preferred shape for successful JSON responses is { ok, data, meta } with list metadata (e.g. pagination totals) in top-level meta, not nested under data.

data

any | null

required

Response payload; may be null for no-content successes.

meta

any | null

required

Top-level metadata (e.g. pagination); null when unused.

enum<integer>

required

Available options:

1

Write cloud-authoritative edge state rows to a device tablePersists cloud-originated state rows for one device table lineage (`table_id` is `edge_table_lineages.id`) and stages an MQTT downlink for the device. Handled by the edge worker (`WriteEdgeStateRows` RPC), not the integrations worker. Send `Idempotency-Key` on retries so duplicate submissions dedupe safely.

Error

A valid request URL is required to generate request examples

{
  "data": "<unknown>",
  "meta": "<unknown>",
  "ok": 1
}

{
  "detail": "<string>",
  "message": "<string>",
  "ok": 0
}

Overview

HTTP API

Issue a generic device command (v3)

Authorizations

Path Parameters

Body

Response