# Users

Control user accounts and roles.

 - [GET /users](https://developers.signable.app/openapi/users/listusers.md): Retrieves a paginated list of all users in your account. You can control pagination using the `offset` and `limit` query parameters.
 - [POST /users](https://developers.signable.app/openapi/users/createuser.md): Adds a new user to your account. You must provide the user’s name, email address, and their role ID.
 - [GET /users/{user_id}](https://developers.signable.app/openapi/users/getuser.md): Retrieves the details of a single user by their unique `user_id`. The response includes the user's name, email, role, and timestamps.
 - [PUT /users/{user_id}](https://developers.signable.app/openapi/users/updateuser.md): Updates a user by `user_id`. Supports partial updates. You can send `user_name`, `user_email`, or both. You can also include `role_id`. You must provide at least one of `user_name` or `user_email`. If
 - [DELETE /users/{user_id}](https://developers.signable.app/openapi/users/deleteuser.md): Removes a user from your account using their `user_id`. The response confirms the deletion and includes the user's basic details.