List Agent Keys
List the agent keys of your active account, every member's, newest first. An agent key is a key an agent logs its tunnel in with, instead of an agent auth token. Nothing secret is returned.
Preview. A key logs in tunnels only. See Key authentication.
Requires the endpoints:read permission on the active account, as listing agent auth tokens does.
Response (200 OK)
items array
The keys, ordered by
created_at DESC. [] when there are none.items[].uuid string (uuid)
The key's id, for DELETE /v1/security/agent-keys/{uuid}. The agent doesn't need it.
items[].name string
The label given at registration, or a default such as
Agent key SHA256:MTaTK21Y.items[].key_type string
ssh-ed25519 | ssh-rsa.items[].fingerprint string
The key's fingerprint, e.g.
SHA256:B5UOOVg/OK1TzCZjPLdToX0T5CqKQgnF5QnsspIW1QM. The agent prints it at start (Using key SHA256:…), and ssh-keygen -lf agent_key.pub shows it too, so you can tell which key an agent uses.items[].user_uuid string (uuid)
The member the key logs in as: the one who registered it.
items[].user_name string
That member's full name. If they set none: their email for your own keys, or when you hold the
members:read permission (owners and Admin do); otherwise empty.items[].created_at datetime
RFC 3339 UTC timestamp.
items[].last_used_at datetime?
The last login with the key, kept current while an agent stays connected with it.
null until the first login. Keys don't expire.Errors
401 Unauthorized
Missing auth.
403 Forbidden
The caller lacks the
endpoints:read permission in the active account.Request
curl "https://api.ngris.com/v1/security/agent-keys" \
-H "X-API-KEY: <your_api_key>"
Response — 200 OK
{
"items": [
{
"uuid": "01a16821-d490-7359-a935-39a84a87074a",
"name": "build server",
"key_type": "ssh-ed25519",
"fingerprint": "SHA256:B5UOOVg/OK1TzCZjPLdToX0T5CqKQgnF5QnsspIW1QM",
"user_uuid": "019e23c8-7400-716b-abfe-ba4bd3a29ef1",
"user_name": "Alice Smith",
"created_at": "2026-10-23T09:40:10Z",
"last_used_at": "2026-10-23T09:41:02Z"
},
{
"uuid": "01a16808-b6e0-75fd-84ff-3cf88cc33c5a",
"name": "Agent key SHA256:MTaTK21Y",
"key_type": "ssh-rsa",
"fingerprint": "SHA256:MTaTK21YgkxytvVUCRmQE70an6+qxDiej16aN+Sdr30",
"user_uuid": "019e23c8-7400-716b-abfe-ba4bd3a29ef1",
"user_name": "Alice Smith",
"created_at": "2026-10-23T09:12:44Z",
"last_used_at": null
}
]
}
Was this helpful?