Skip to content

Admin API

All /v1/admin/* endpoints need the admin key (AIGW_ADMIN_KEY). The dashboard at /admin offers the same.

Method Path Notes
GET /v1/admin/keys active keys (?all=1 includes revoked)
POST /v1/admin/keys {"name","kind":"client"|"node","scopes":[…],"ratePerMinute","dailyQuota"} → 201 with the secret, shown once
DELETE /v1/admin/keys/{id} revoke (also POST …/{id}/revoke); a node key’s sessions close at once (4401)
GET /v1/admin/usage requests per key per day
GET /v1/admin/audit paged audit entries, filter by key or model
Terminal window
curl -H "Authorization: Bearer $ADMIN" \
-d '{"name":"homeassistant","scopes":["clip-*"],"ratePerMinute":30,"dailyQuota":5000}' https://<hub-host>/v1/admin/keys
Field Meaning
name [A-Za-z0-9._-]{1,64}, unique among active keys; shown in audit and usage; a node key’s name is the node’s name
kind client or node
scopes model globs (*, clip-*, openai/*); nodes:read also shows full node details
ratePerMinute sliding one-minute window; 0 = the default (120)
dailyQuota requests per UTC day; 0 = unlimited