Skip to content

List SSH keys

List your active SSH public keys with their IDs, fingerprints and access limits. The list also includes public keys for peer integrations in the selected account.

Returns

#
dataobjectAlways present
Your registered SSH keys.
Show 1 attributeHide attributes
keysobject[] | nullAlways present
Each key's identity and any Computer or tag restriction.
Show 1 attributeHide attributes
itemsobject
A registered SSH public key and its access restrictions.
Show 8 attributesHide attributes
computerobject
Single Computer this key can reach, when it is limited to one. May be omitted.
Show 2 attributesHide attributes
idstringAlways present
Selected Computer's ID.
namestringAlways present
Current name; empty during deletion or after you lose access.
created_atstring (date-time)
Time the key was added. May be omitted.
fingerprintstringAlways present
Public key fingerprint.
idstringAlways present
Registered key's ID.
labelstringAlways present
User-assigned label.
last_used_atstring (date-time) | nullAlways present
Last recorded SSH sign-in; null if none is recorded. Updates can take five minutes.
public_keystringAlways present
SSH public key.
tagstring
Tag limiting the key to matching Computers, when set. May be omitted.

Errors

#
CodeStatusWhat happened
invalid400An input is missing or invalid.
unauthenticated401The credential is missing, invalid, expired or revoked.
denied403The caller lacks permission for this action.
not_found404The resource is absent or inaccessible to this caller.
conflict409The request conflicts with the current resource state or an earlier request.
over_capacity409The request exceeds a resource or credential allowance.
access_list_full409The change would exceed the access-list allowance.
rate_limited429The caller's request rate exceeds its limit.
busy429Too much work is in progress to accept this request.
unknown503The outcome is unconfirmed; a change may have happened.
unavailable503The service or requested feature is unavailable.

Notes

#
  • API key permission: ssh-key view.