Get user detail
get_userFetch a user's profile to verify account status, admin flag, and contact details before assigning work or checking administrator privileges.
Instructions
Read one user's profile: name, login, email, admin flag and status.
Use it after search_principals when you need more than a name — to
confirm an account is active before assigning work, to check whether
somebody is an instance administrator, or to learn which account the
server itself is acting as (id_or_me='me').
Returns {id, name, login, email, admin, status, language, created_at, updated_at}. The avatar URL is deliberately dropped: it costs tokens
and cannot be rendered here.
Pitfalls. email, login and admin are visibility-dependent — a null
means the authenticated account may not see that field, never that the
value is empty. admin=true says nothing about project permissions; use
list_permissions for what the current user may actually do. A group or
placeholder-user id returns 404 from this endpoint; those principals only
appear in search_principals.
Cross-references: search_principals to find the id;
list_memberships(principal_id=...) for the projects and roles this
person holds; get_instance_info also reports the current user.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id_or_me | Yes | Numeric user id from search_principals, or the literal string 'me' for the account this server authenticates as. Group and placeholder ids are not accepted here — this endpoint serves users only. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Numeric user id. | |
| name | No | Display name, e.g. 'Grace Hopper'. | |
| admin | No | True for instance administrators. Null when the field is not visible to the caller — treat null as 'unknown', never as 'not an admin'. | |
| No | Email address; null when the authenticated account may not see it. | ||
| login | No | Login name used to sign in. | |
| status | No | Account status, one of: active, invited, registered, locked. | |
| language | No | Interface language code, e.g. 'en'. Absent on some instances. | |
| created_at | No | ISO 8601 UTC timestamp. | |
| updated_at | No | ISO 8601 UTC timestamp. |