XentrDeveloper Docs
API ReferenceEdges

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.

POST
/api/edge/claim

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/edge/claim" \  -H "Content-Type: application/json" \  -d '{    "claimCode": "XR742Q"  }'
Empty
Empty
Empty
Empty
Empty

Edge config registry (edge-self pull)

Returns the cloud machine map + identity (site, tenant, mqttEndpoint, registryUrl, revision, machines[]) for this edge. ETag-cached; 304 on unchanged revision.

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.