Editar usuario
PATCH
/api/v1/users/:user_id Modifica los datos de un empleado (cuenta y perfil). Es parcial: solo cambia los campos que incluyas; lo que omites se mantiene, y enviar un campo con null lo borra. No cambia el email ni el estado (para dar de baja usa el método correspondiente). Cambiar el rol a "admin" requiere que la clave actúe como administrador. Devuelve la ficha del usuario ya actualizada.
Parámetros de ruta
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
user_id | string | Sí | Identificador del usuario dentro de tu empresa. |
Cuerpo (JSON)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
full_name | string | No | Nombre completo. |
role | string | No | "member" o "admin" (admin requiere clave admin). |
department_id | string | No | Departamento (id); null lo desasigna. |
work_center_id | string | No | Sede / centro de trabajo (id); null la desasigna. |
hire_date | string | No | Fecha de alta (YYYY-MM-DD) o null. |
vacation_days | integer | No | Días de vacaciones anuales o null. |
works_holidays | boolean | No | Si trabaja en festivos. |
remote_work_allowed | boolean | No | Si puede fichar en modalidad remota. |
iban | string | No | Campo de perfil. Cualquier campo del perfil se acepta igual (dni, ssn, address, city…). |
Ejemplo
Sustituye db_live_tu_clave por tu clave.
curl -s -X PATCH -H "Authorization: Bearer db_live_tu_clave" \
-H "Content-Type: application/json" \
-d '{"remote_work_allowed":true,"iban":"ES9121000418450200051332"}' \
"https://api.dutybeat.com/api/v1/users/u-estm1" | 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-estm1",
"full_name": "Andrés Molina Prieto",
"email": "[email protected]",
"role": "member",
"status": "active",
"hire_date": "2016-09-01",
"vacation_days": 23,
"works_holidays": false,
"remote_work_allowed": true,
"overtime_compensation": null,
"overtime_comp_expiry": null,
"created_at": "2016-09-01T00:00:00Z",
"has_photo": false,
"department": {
"id": "dept-estm",
"name": "Estructuras – Madrid"
},
"work_center": {
"id": "wc-madrid",
"name": "Madrid – Sede central"
},
"profile": {
"phone_company": "+34 910 100 010",
"phone_personal": "+34 600 100 010",
"personal_email": "[email protected]",
"birth_date": "1985-03-14",
"nationality": "Española",
"dni": "50223344B",
"dni_expiry": "2030-03-14",
"address": "Calle Mayor 12",
"city": "Madrid",
"postal_code": "28013",
"passport_number": null,
"passport_issue": null,
"passport_expiry": null,
"health_insurance": null,
"iban": "ES9121000418450200051332",
"swift": null,
"country": null,
"company_name": null,
"company_cif": null,
"ssn": null,
"qualifications": []
},
"folders": null
}
}