API de Usuarios
Endpoints para consultar y gestionar usuarios, equipos y sus permisos en SalesOS.
Usuarios
Listar usuarios
Parámetros de consulta:
| Parámetro | Tipo | Descripción |
|---|
page | number | Número de página |
per_page | number | Registros por página |
role | string | Filtrar por rol: admin, manager, seller, viewer |
team_id | string | Filtrar por equipo |
status | string | active, inactive, pending |
{
"data": [
{
"id": "user_xyz789",
"name": "Carlos Rodríguez",
"email": "carlos@empresa.com",
"role": "seller",
"team_id": "team_001",
"status": "active",
"avatar_url": "https://...",
"created_at": "2026-01-15T08:00:00Z",
"last_login_at": "2026-03-15T09:30:00Z"
}
]
}
Obtener un usuario
Obtener el usuario actual
Devuelve los datos del usuario autenticado.
Actualizar un usuario
{
"name": "Carlos A. Rodríguez",
"role": "manager",
"team_id": "team_002"
}
Solo los administradores pueden cambiar roles y asignaciones de equipo de otros usuarios.
Equipos
Listar equipos
Ejemplo de respuesta:
{
"data": [
{
"id": "team_001",
"name": "Ventas LATAM",
"leader_id": "user_abc123",
"member_count": 8,
"created_at": "2026-01-01T00:00:00Z"
}
]
}
Obtener miembros de un equipo
GET /v1/teams/:id/members
Crear un equipo
{
"name": "Ventas Enterprise",
"leader_id": "user_abc123",
"member_ids": ["user_xyz789", "user_def456"]
}
Agregar miembro a un equipo
POST /v1/teams/:id/members
{
"user_id": "user_new001"
}
Remover miembro de un equipo
DELETE /v1/teams/:id/members/:user_id
Invitaciones
Enviar invitación
{
"email": "nuevo@empresa.com",
"name": "Ana López",
"role": "seller",
"team_id": "team_001"
}
Listar invitaciones pendientes
GET /v1/invitations?status=pending
Los endpoints de gestión de usuarios y equipos requieren permisos de administrador. Asegúrate de que tu token tenga el scope admin o write:users.
Próximos pasos
