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 |
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 |