# users

 - [GET /admin/users](https://docs.blackbird.ai/admin/users/getusers.md): Retrieves all users in the organization (Reconciliation endpoint). This endpoint allows organization administrators to reconcile their user list with internal identity management systems.
 - [POST /admin/users](https://docs.blackbird.ai/admin/users/createuser.md): Creates a user with the given email and in the caller's organization.
 - [GET /admin/users/{id}](https://docs.blackbird.ai/admin/users/getuserbyid.md): Retrieves a specific user by ID within the organization.
 - [PUT /admin/users/{id}](https://docs.blackbird.ai/admin/users/updateuserstatus.md): Updates a user's active status using json-merge-patch format.
 - [GET /admin/roles](https://docs.blackbird.ai/admin/users/getroles.md): Retrieves a list of available user roles that can be assigned to users.
 - [GET /admin/role-mappings](https://docs.blackbird.ai/admin/users/getapprolemappings.md): Retrieves IdP group to app role mappings for the authenticated organization. Requires superuser access. Superuser callers must pass organizationId as a query parameter.