XentrDeveloper Docs
API ReferenceEdges

Rotate an OpCert before expiry (edge-self)

Called by the edge agent ~7 days before OpCert expiry. Must present current cert fingerprint + a fresh CSR.

POST
/api/edge/rotate

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/rotate" \  -H "Content-Type: application/json" \  -d '{    "csr": "string",    "currentFingerprint": "a3f2e9d1..."  }'
Empty
Empty
Empty

Revoke a device (staff only)

Marks the device as decommissioned / stolen / compromised / rotated and revokes all active OpCerts. CRL picks up the revocation within 5 min.

Trigger a LAN scan from this edge

Kicks off an asynchronous scan job. The edge receives the command via MQTT and streams hits back. Use GET /api/edges/:id/scan/:job_id to poll results.