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.

Authorization

bearer

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

organizationId*string

The organization this edge belongs to

factoryId?string

Factory slug the edge is deployed to (optional — can be assigned later)

name*string

Human-readable edge name shown in the UI

Length1 <= length <= 120

region?string

Data residency region for this edge

Default"sg"

Value in"sg" | "my" | "eu" | "us"

notes?string

Internal notes about this edge

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

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.

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

Create a new edge gateway

Authorization

Request Body

Response Body

201

403