GET/root/identities
List identities
Operation root.identities.list
Description
Pages every registered identity, newest first, optionally filtered by signing key fingerprint prefix, exact user id, or root operators only. Only root operators may call it, and each request is recorded in the root audit trail.
Authentication
Requires a signed-in session: the client sends its session token as a bearer token in the Authorization header.
Parameters
| Name | In | Type | Details |
|---|---|---|---|
cursor | query | string | optional
|
fingerprint | query | string | optional
|
limit | query | integer | optional
|
rootOnly | query | boolean | optional |
userId | query | string | optional
|
Responses
200 OK
application/jsonRootIdentitiesResponse
A page of registered identities, newest first.
2 fields
nextCursorstringrequirednullableOpaque cursor for the next page, or null at the end.
Other fields are allowed.
Other responses
| Status | Meaning | Body |
|---|---|---|
| 400 | Bad Request |
|
| 401 | Unauthorized |
|
| 403 | Forbidden |
|
| 500 | Internal Server Error |
|
| 503 | Service Unavailable |
|