XentrDeveloper Docs
API ReferenceEdges

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.

POST
/api/edges

Authorization

bearer
AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

curl -X POST "https://api.xentr.ai/api/edges" \  -H "Content-Type: application/json" \  -d '{    "organizationId": "12345678-1234-1234-1234-123456789012",    "name": "Acme Edge 01"  }'
Empty
Empty

Claim an edge with a single-use code (public, rate-limited)

Called by the edge agent on first boot. Public endpoint — no bearer token required because the edge has none yet. Rate limit: 5/min per IP.

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).