Pin an edge to a target version (staff)
Sets edges.target_version so the next manifest poll serves this version. The version must be published to a release channel first.
Authorization
bearer In: header
Path Parameters
Edge UUID
Query Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
curl -X POST "https://api.xentr.ai/api/edges/string/update?organizationId=string" \ -H "Content-Type: application/json" \ -d '{ "artifactName": "0.3.1" }'Start a staged rollout wave (platform owner)
Pushes a version to a deterministic cohort of an (edge_type, channel). Start at a low percent, watch, then promote. The version must be published.
OTA artifact download (edge-self, API-proxied stream)
Streams the release artifact for ?version back to the edge as 200 + application/octet-stream. The private GitHub credential never lands on the box: the API resolves the short-lived signed asset URL server-side and pipes the bytes. It does NOT 302-redirect — the on-box updater reads the body in place and does not follow redirects. 503 until GITHUB_OTA_TOKEN is configured.