# Users

Manage the people working in your Flownally workspace.

7 operations in the Users resource group.

## Operations

- [Get users](/reference/users/get-users.md) - GET `/users` - Returns people who can work in the current Flownally workspace.
- [Get current user profile](/reference/users/get-users-me.md) - GET `/users/me` - Returns the authenticated user's profile.
- [Update current user profile](/reference/users/patch-users-me.md) - PATCH `/users/me` - Updates the authenticated user's name or avatar URL.
- [Get current user's global unread message count](/reference/users/get-users-me-unread-count.md) - GET `/users/me/unread-count` - Returns the total number of unread messages across all sessions for the
authenticated user. This is the authoritative value used to hydrate the
inbox badge on page load and on WebSocket reconnect; WebSocket deltas
update the badge between requests.
- [Authoritative unread summary with monotonic version](/reference/users/get-users-me-unread-summary.md) - GET `/users/me/unread-summary` - Returns the unread messages count for the authenticated user plus a
monotonically-increasing `version`. Clients use `version` to discard
stale WebSocket `unread_count_update` / `conversation_read` events.
Called by the web client on WebSocket (re)connect to bootstrap the
unread badge.
- [Get user](/reference/users/get-user.md) - GET `/users/{userId}` - Returns one workspace member, including role and team membership.
- [Update a member's role](/reference/users/put-user-role.md) - PUT `/users/{userId}/role` - Changes the role of a tenant member. The caller must hold a role with
authority over the requested role transition. Admins can shuffle
members between admin and agent; only Owners can mint or demote
Owners. A tenant must retain at least one Owner — demoting the last
one is rejected.

## Schemas

- [ProblemDetails](/reference/schemas/problem-details.md) - object - RFC 9457 Problem Details response with a stable Flownally error code.
- [FieldViolation](/reference/schemas/field-violation.md) - object
- [Window](/reference/schemas/messaging-window.md) - object - Tells a client whether the current actor can send in this conversation right now.
- [Response](/reference/schemas/users-response.md) - object - Workspace members.
- [User](/reference/schemas/user.md) - object - Person who can work in the Flownally workspace.
- [UpdateProfileRequest](/reference/schemas/update-profile-request.md) - object - Profile fields to update for the authenticated user.
- [UnreadCountResponse](/reference/schemas/unread-count-response.md) - object
- [UnreadSummaryResponse](/reference/schemas/unread-summary-response.md) - object
- [UpdateUserRoleRequest](/reference/schemas/update-user-role-request.md) - object - Role assignment for a workspace member.