Dar de baja usuario
POST
/api/v1/users/:user_id/deactivate Desactiva un empleado (offboarding): deja de poder acceder y sus sesiones se cierran de inmediato. Es idempotente (dar de baja a quien ya está de baja también responde 200). No se puede desactivar al último administrador activo (409). Devuelve la ficha del usuario, ya con status "disabled".
Parámetros de ruta
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
user_id | string | Sí | Identificador del usuario dentro de tu empresa. |
Ejemplo
Sustituye db_live_tu_clave por tu clave.
curl -s -X POST -H "Authorization: Bearer db_live_tu_clave" \
"https://api.dutybeat.com/api/v1/users/u-nuevo/deactivate" | jqRespuesta de ejemplo
Lo que imprime cada snippet al ejecutarlo: cURL devuelve el JSON crudo; los snippets de Python y PowerShell piden campos concretos, así que su salida es la de cada uno.
{
"data": {
"id": "u-nuevo",
"full_name": "Lucía Prieto Vega",
"email": "[email protected]",
"role": "member",
"status": "disabled",
"hire_date": null,
"vacation_days": 23,
"works_holidays": false,
"remote_work_allowed": false,
"overtime_compensation": null,
"overtime_comp_expiry": null,
"created_at": "2026-07-11T10:00:00.000Z",
"has_photo": false,
"department": {
"id": "dept-estm",
"name": "Estructuras – Madrid"
},
"work_center": {
"id": "wc-madrid",
"name": "Madrid – Sede central"
},
"profile": {
"phone_company": null,
"phone_personal": null,
"personal_email": null,
"birth_date": null,
"nationality": null,
"dni": null,
"dni_expiry": null,
"address": null,
"city": null,
"postal_code": null,
"passport_number": null,
"passport_issue": null,
"passport_expiry": null,
"health_insurance": null,
"iban": null,
"swift": null,
"country": null,
"company_name": null,
"company_cif": null,
"ssn": null,
"qualifications": []
},
"folders": null
}
}