Users
Fetch multiple users by ID
Returns the user accounts for a list of IDs in a single call. IDs that do not match a user are reported separately so the caller can tell which were missing.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://loading/accounts.v1.Accounts/GetUsers" \ -H "Content-Type: application/json" \ -d '{ "userIds": [ "EjRWeBI0VniQEjRWeBI0Vg==", "q83vq83vEjRWeBI0VniQqg==" ] }'{
"users": [
{
"id": "EjRWeBI0VniQEjRWeBI0Vg==",
"name": "Jordan Hale",
"email": "jordan@acme.example",
"status": "active",
"createdAt": "2026-01-15T10:00:00Z",
"updatedAt": "2026-03-02T14:22:30Z"
}
],
"notFoundIds": [
"q83vq83vEjRWeBI0VniQqg=="
]
}{
"code": "invalid_argument",
"message": "The request was malformed, such as a missing required field or an unparseable cursor."
}{
"code": "unauthenticated",
"message": "The request lacks a valid API key in the Authorization header."
}{
"code": "permission_denied",
"message": "The API key is not allowed to perform this action on this workspace."
}{
"code": "resource_exhausted",
"message": "The request was rate limited. Slow down and retry later."
}{
"code": "internal",
"message": "An internal server error occurred."
}GetUser
Returns the user account identified by the given ID, including display name, email, and account status.
UpdateUser
Updates the caller's own display name or login email address. The target is always the caller resolved from the session or API key, never a request field, so a caller can never name a different user to update. Only the fields you supply are changed.