# users

## List all users in the organization

 - [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.

## Creates a user

 - [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 a specific user

 - [GET /admin/users/{id}](https://docs.blackbird.ai/admin/users/getuserbyid.md): Retrieves a specific user by ID within the organization.

## Update a user's active status

 - [PUT /admin/users/{id}](https://docs.blackbird.ai/admin/users/updateuserstatus.md): Updates a user's active status using json-merge-patch format.

## Get available user roles

 - [GET /admin/roles](https://docs.blackbird.ai/admin/users/getroles.md): Retrieves a list of available user roles that can be assigned to users.