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
Response
Show entry properties
Show entry properties
UUID of the key record. Pass to Revoke API Key to revoke.
ISO-8601 timestamp of the most recent request authenticated with this key, or
null if the key has never been used.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
}
]
}