Skip to main content

Tenant Management

Administrative endpoints for managing multi-tenant isolation and security flags.

List Tenants​

Retrieve a full list of all tenants registered in the HxTP system.

Endpoint​

GET /api/v1/admin/tenants

Response​

[
  {
    "id": "hxtp:21e02264fdeb",
    "name": "devopsanju's Workspace",
    "slug": "devopsanju",
    "created_at": { "_seconds": 1777973470, "_nanoseconds": 128000000 }
  }
]

Suspend Tenant​

Immediately lock a tenant account, preventing any further device communication or API access.

Endpoint​

POST /api/v1/admin/tenants/:id/suspend

Response​

{
  "status": "suspended",
  "tenant_id": "hxtp:21e02264fdeb"
}

Update System Flags​

Toggle global feature flags (e.g., maintenance mode, registration lock).

Endpoint​

POST /api/v1/admin/flags/:flag

Body​

{
  "state": true
}

Response​

{
  "flag": "maintenance_mode",
  "state": true
}