Skip to main content
TaskFlow Pro uses three roles to control what each team member can see and do. Admins are responsible for managing the team: inviting members, assigning roles, and controlling account access.

​
Roles

Developer

Can view and update their own assigned tasks. Cannot create projects or tasks.

Project Manager (PM)

Can create and manage their own projects, create tasks, and assign work to Developers.

Admin

Full access. Can manage all projects, tasks, and users across the entire organization.
Roles are stored as numeric values internally: 1 = Developer, 2 = PM, 3 = Admin.

​
Listing all users

Admins can view the full list of team members from the admin panel. The list is paginated (10 users per page by default) and includes each user’s name, email, role, and active status. 
GET /usuario?page=1&limit=10

​
Searching for users

Admins and PMs can search for users by name or email. The search is case-insensitive and returns up to 10 matching active users. 
GET /usuario/buscar?q=alice
This is used, for example, when assigning a task — the task creation modal lets you search for a team member by name or email before selecting them.

​
Changing a user’s role

Only Admins can change a user’s role.
To give a user the Project Manager role, send their user ID to the PM role endpoint.
PUT /usuario/pm
{ "id_usuario": 15 }
The user’s role is updated to 2 (PM) immediately.
Role changes take effect on the user’s next login. There is currently no way to demote an Admin back to a lower role through the UI — this requires a direct database update.

​
Activating and deactivating users

Deactivating a user is a soft delete — the account is disabled but all their data (projects, tasks, history) is preserved. The user can be reactivated at any time by toggling their status again.
Only Admins can change a user’s active status. The toggle works both ways: calling it on an active user deactivates them, and calling it on a deactivated user reactivates them. 
PUT /usuario/estado
{ "id_usuario": 15 }
A deactivated user who tries to log in receives the error: “Usuario desactivado, comunicate con el administrador.”

​
Editing your own profile

Any logged-in user can update their own name and email address at any time. 
PUT /usuario/perfil
{
  "id_usuario": 42,
  "nombre": "Alice Smith",
  "email": "alice.smith@example.com"
}
You can also view your current profile (name, email, role) by fetching your own record: 
GET /usuario/me

​
Admin editing any user’s profile

Admins can update the name and email of any user in the organization without needing that user’s credentials. 
PUT /usuario/admin/editar
{
  "id_usuario": 15,
  "nombre": "Bob Jones",
  "email": "bob.jones@example.com"
}
Use this endpoint to correct typos in a user’s name or to update their email when it changes, without requiring them to log in and change it themselves.

Build docs developers (and LLMs) love

Get started for freeTalk to us