edut/web
1
0
Fork 0
Code Issues Pull Requests Actions 2 Packages Projects Releases Wiki Activity
d1c60fe44e
web/docs/api/examples/governance-installer.examples.md

3.4 KiB
Raw Blame History

Governance Installer API Examples

Create Install Token

Request

POST /governance/install/token
Authorization: Bearer <wallet-session>
Content-Type: application/json

{
  "wallet": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "org_root_id": "org.acme.root",
  "principal_id": "human.joshua",
  "principal_role": "org_root_owner",
  "device_id": "desktop-7f6f3a9b",
  "launcher_version": "0.2.0",
  "platform": "macos",
  "current_runtime_version": "0.0.0"
}

Response

{
  "install_token": "git_01J9B6A97WQG8GNYM4ZBX8E2NQ",
  "install_token_expires_at": "2026-02-18T01:05:00Z",
  "wallet": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "entitlement_id": "ent_governance_001",
  "package": {
    "runtime_version": "1.0.0",
    "package_url": "https://cdn.edut.ai/runtime/governance/1.0.0/macos-arm64.pkg",
    "package_hash": "sha256:09f6d64f...",
    "signature": "ed25519:8db9...",
    "signer_key_id": "governance-signer-2026-01",
    "policy_hash": "sha256:f10419ac...",
    "rollout_channel": "stable"
  }
}

Confirm Install

Request

POST /governance/install/confirm
Authorization: Bearer <wallet-session>
Content-Type: application/json

{
  "install_token": "git_01J9B6A97WQG8GNYM4ZBX8E2NQ",
  "wallet": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "device_id": "desktop-7f6f3a9b",
  "entitlement_id": "ent_governance_001",
  "package_hash": "sha256:09f6d64f...",
  "runtime_version": "1.0.0",
  "installed_at": "2026-02-18T01:01:48Z",
  "launcher_receipt_hash": "sha256:8102d437..."
}

Response

{
  "status": "governance_active",
  "wallet": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "device_id": "desktop-7f6f3a9b",
  "entitlement_id": "ent_governance_001",
  "runtime_version": "1.0.0",
  "activated_at": "2026-02-18T01:01:50Z"
}

Install Status

Request

GET /governance/install/status?wallet=0x742d35Cc6634C0532925a3b844Bc454e4438f44e&device_id=desktop-7f6f3a9b
Authorization: Bearer <wallet-session>

Response

{
  "wallet": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "org_root_id": "org.acme.root",
  "principal_id": "human.joshua",
  "principal_role": "org_root_owner",
  "membership_status": "active",
  "identity_assurance_level": "onramp_attested",
  "entitlement_status": "active",
  "access_class": "connected",
  "availability_state": "active",
  "activation_status": "active",
  "latest_runtime_version": "1.0.0",
  "policy_hash": "sha256:f10419ac..."
}

Error: Entitlement Inactive

{
  "error": "entitlement_inactive",
  "code": "entitlement_inactive",
  "correlation_id": "req_01J9B6BJBVKY3N6WQ7TQM2R2P5"
}

POST /governance/lease/heartbeat

Request:

{
  "wallet": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "org_root_id": "org.acme.root",
  "principal_id": "human.joshua",
  "device_id": "desktop-7f6f3a9b"
}

Success (200):

{
  "status": "lease_refreshed",
  "availability_state": "active",
  "lease_expires_at": "2026-03-19T01:05:00Z"
}

POST /governance/lease/offline-renew

Request:

{
  "wallet": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "org_root_id": "org.acme.root",
  "principal_id": "human.joshua",
  "renewal_bundle": {
    "bundle_id": "rb_01J9B6D4R0E4W8N6H2A1Q9V7PT",
    "signed_payload": "base64:ZXhhbXBsZQ=="
  }
}

Success (200):

{
  "status": "renewal_applied",
  "availability_state": "active",
  "renewed_until": "2027-02-18T00:00:00Z"
}