Skip to main content
GET
Get a user

Authorizations

Authorization
string
header
required

A machine-client token from POST /v1/auth/client-token. Reads need the pulse.read scope; provisioning and tenant updates need pulse.write, which the token only carries when requested_scopes asks for it. Creating, changing, disabling and resetting MFA for users, and the tenant sign-in policy, need a signed-in user's token instead: they reject API-key tokens.

Path Parameters

userId
string<uuid>
required

The user: a user_id from List users (GET /v1/msp/admin/users).

Query Parameters

tenant_id
string<uuid>

Look for the user within this tenant and the tenants beneath it. Defaults to your own tenant.

Response

OK

A user and their access to one tenant.

user_id
string<uuid>
required

The user's id. Use it as userId in the other user endpoints.

first_name
string
required

The user's first name.

last_name
string
required

The user's last name. An empty string when none is set.

display_name
string
required

The user's full name, or their email when no name is set.

email
string
required

The user's email, which is also their login id.

tenant_id
string<uuid>
required

The tenant this access applies to (including the tenants beneath it).

tenant_name
string
required

The name of tenant_id.

roles
string[]
required

The user's role on this tenant: a key from List assignable user roles.

scopes
string[]
required

What the role allows: pulse.login, pulse.read, and pulse.write for admin roles.

status
string
required

active when the user can sign in; disabled when they have been disabled or are locked out.

last_login_at
null | string<date-time>
required

When the user last signed in: an ISO 8601 timestamp in UTC (offset +00:00). Null if they never have.

selected_mfa_method
null | enum<string>
required

The MFA method the user chose: email or totp. Null when none is chosen.

Available options:
email,
totp
enrolled_mfa_methods
enum<string>[]
required

The MFA methods the user has set up: email, totp, both, or none.

Available options:
email,
totp