Activar / inhabilitar usuario
POST /api/users/{user_id}/toggle
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Activa o inhabilita un usuario. Un usuario inhabilitado no puede operar en la plataforma.
Quién puede usarlo: solo usuarios de tipo administrador (type = admin). Con el token de un vendedor responde 403.
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
active |
boolean | No | true activa, false inhabilita. Si no se envía, invierte el estado actual. |
Errores (409):
- No puedes inhabilitar tu propio usuario.
- No se puede inhabilitar al usuario principal de la empresa.
- Al activar, si se excede el límite de usuarios del plan.
422 si active no es booleano; 404 si no existe.
Parámetros
| Parámetro | Dónde | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
user_id |
ruta | sí | 2 |
Cuerpo
Content-Type: application/json
{
"active": false
}
Respuestas
200 — Inhabilitado
{
"success": true,
"data": {
"id": 5,
"name": "JUAN PEREZ (SUSPENDIDO)",
"email": "jperez@empresa.com",
"type": "seller",
"active": false,
"locked": false,
"establishment_id": 1,
"establishment_description": "Oficina Principal",
"document_id": "01",
"series_id": 1,
"identity_document_type_id": "1",
"number": "45678912",
"names": "JUAN",
"last_names": "PEREZ GOMEZ",
"personal_email": "juan.perez@gmail.com",
"corporate_email": "jperez@empresa.com",
"personal_cell_phone": "987654321",
"corporate_cell_phone": "912345678",
"position": "Vendedor",
"photo": null
},
"message": "Usuario inhabilitado con éxito."
}
409 — Propio usuario
{
"success": false,
"message": "No puedes inhabilitar tu propio usuario."
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.