curl https://grail-stack-dev.onrender.com/v1/partner/api-keys \
-H "x-api-key: grail_partner_<hex>"
{
"api_keys": [
{
"key_id": "0c9bd7e4-6b2e-4f3a-a9a7-1f6e5d4c3b2a",
"key_name": "integration test",
"scope": "PARTNER",
"status": "active",
"wallet_address": "Fd31QxW7RRZwvMfNnhNaPvczJpMh7wyzBTWvtMA66wjN",
"last_used_at": "2026-04-19T12:45:10.002Z",
"created_at": "2026-04-19T12:30:45.123Z",
"revoked_at": null
}
]
}
Partner
List API Keys
Returns metadata for every API key minted against the authenticated partner’s wallet.
GET
/
v1
/
partner
/
api-keys
curl https://grail-stack-dev.onrender.com/v1/partner/api-keys \
-H "x-api-key: grail_partner_<hex>"
{
"api_keys": [
{
"key_id": "0c9bd7e4-6b2e-4f3a-a9a7-1f6e5d4c3b2a",
"key_name": "integration test",
"scope": "PARTNER",
"status": "active",
"wallet_address": "Fd31QxW7RRZwvMfNnhNaPvczJpMh7wyzBTWvtMA66wjN",
"last_used_at": "2026-04-19T12:45:10.002Z",
"created_at": "2026-04-19T12:30:45.123Z",
"revoked_at": null
}
]
}
Overview
Lists all API keys (active and revoked) minted against the authenticated partner’s wallet. Only metadata is returned — raw API key values are never retrievable after creation.Headers
string
required
A valid
PARTNER scope key for the partner whose keys you want to list.Response
array
Show entry properties
Show entry properties
string
UUID of the key record. Pass to Revoke API Key to revoke.
string
Human-readable label supplied at creation.
string
Scope granted to the key. Always
"PARTNER" for partner-minted keys.string
"active" or "revoked".string
Partner wallet that signed the challenge when the key was minted.
string | null
ISO-8601 timestamp of the most recent request authenticated with this key, or
null if the key has never been used.string
ISO-8601 timestamp of key creation.
string | null
ISO-8601 timestamp of revocation, or
null if the key is still active.Errors
| HTTP | error | When |
|---|---|---|
| 401 | unauthorized | Missing or invalid x-api-key |
curl https://grail-stack-dev.onrender.com/v1/partner/api-keys \
-H "x-api-key: grail_partner_<hex>"
{
"api_keys": [
{
"key_id": "0c9bd7e4-6b2e-4f3a-a9a7-1f6e5d4c3b2a",
"key_name": "integration test",
"scope": "PARTNER",
"status": "active",
"wallet_address": "Fd31QxW7RRZwvMfNnhNaPvczJpMh7wyzBTWvtMA66wjN",
"last_used_at": "2026-04-19T12:45:10.002Z",
"created_at": "2026-04-19T12:30:45.123Z",
"revoked_at": null
}
]
}