API ReferenceEdges

Deploy a Mender artifact to this edge

Triggers a single-device deployment via Mender REST. Respects `edges.isFrozen` unless `force=true` is passed (requires xentr_platform_owner).

Authorization

bearer

AuthorizationBearer <token>

In: header

Path Parameters

id*string

Edge UUID

Query Parameters

organizationId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

artifactName*string

Mender artifact name (matches the --artifact-name passed to mender-artifact write).

force?boolean

Override the isFrozen guard. Use only when responding to a confirmed incident.

Defaultfalse

Response Body

curl -X POST "https://api.xentr.ai/api/edges/string/update?organizationId=string" \  -H "Content-Type: application/json" \  -d '{    "artifactName": "xentr-edge-arm64-sha-a1b2c3d"  }'

Empty

Create a new edge gateway

Creates a pending edge record + issues a single-use claim code. Returns the plaintext claim code ONCE — it is immediately hashed at rest.

Enroll a machine on this edge with a protocol + poll config