GRGlobalRouter Docs
Console

API keys / DELETE

Delete API key

Revokes an API key.

Endpoints

Mobile only shows the endpoint list. View parameter details and examples on desktop.

MethodEndpointDescription
GET/api/v1/keyReads masked information for the API key used by the current request.
GET/api/v1/keysLists API keys owned by the current calling key's owner.
GET/api/v1/keys/{key_ref}Reads masked information for one API key by key reference.
POST/api/v1/keysCreates a new tenant API key.
PATCH/api/v1/keys/{key_ref}Updates an API key's name, scopes, model ranges, source IPs, or rate limit.
DELETE/api/v1/keys/{key_ref}Revokes an API key.
DELETE/api/v1/keys/{key_ref}

目标必须属于调用 Key 的所有者；撤销后该 Key 不应再用于业务请求。

Back to API keys endpoint list

Request parameters

FieldTypeRequiredDescription
key_refpathYesKey ID, prefix, or supported key reference.

Response fields

FieldTypeRequiredDescription
data.idstringYesRevoked API key record ID.
data.tenant_idstringNoKey 所属租户 ID。
data.namestringNoKey name.
data.key_prefixstringNoKey 前缀，用于识别与排查。
data.scopesstring[]NoScopes.
data.statusstringYesStatus after revocation.
data.allowed_modelsstring[]NoModel allowlist.
data.blocked_modelsstring[]NoModel blocklist.
data.allowed_ipsstring[]NoSource IP allowlist.
data.rate_limit_per_minuteintegerNoPer-minute rate limit.
data.expires_atstringNo过期时间。
data.last_used_atstringNo最近使用时间。

Notes

  • Responses only return masked data. Never expose plaintext keys in logs, issues, or screenshots.