[comment]: # ({084d9051-084d9051})
# user.update

[comment]: # ({/084d9051-084d9051})

[comment]: # ({131691fb-dbc24bad})
### Descripción

`object user.update(object/array users)`

Este método permite actualizar usuarios existentes.

::: noteclassic
Este método está disponible para usuarios de cualquier tipo. Los permisos
para llamar al método pueden ser revocados en la configuración de roles de usuario. Consulte [Roles de usuario](/manual/web_interface/frontend_sections/users/user_roles)
para más información.
:::

::: noteclassic
La fortaleza de la contraseña del usuario se valida según las
reglas de la política de contraseñas definidas por la API de Autenticación. Consulte [API de Autenticación](/manual/api/reference/authentication) para más
información.
:::

[comment]: # ({/131691fb-dbc24bad})

[comment]: # ({7e3aeefe-3b478f18})
### Parámetros

`(object/array)` Propiedades del usuario que se van a actualizar.

La propiedad `userid` debe estar definida para cada usuario, todas las demás propiedades son opcionales. Sólo se actualizarán las propiedades pasadas, todas las demás permanecerán sin cambios.

Además de las [propiedades estándar del usuario](object#user), el método acepta los siguientes parámetros.

|Parámetro|[Tipo](/manual/api/reference_commentary#data-types)|Descripción|
|--|--|------|
|current_passwd|string|Contraseña actual del usuario.<br><br>El valor de este parámetro puede ser una cadena vacía si el usuario está vinculado a un [directorio de usuarios](/manual/api/reference/userdirectory/object).<br><br>[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):<br>- *sólo escritura*<br>- *obligatorio* si se establece `passwd` del [objeto Usuario](object#user) y el usuario cambia su propia contraseña|
|usrgrps|array|[Grupos de usuarios](/manual/api/reference/usergroup/object#user-group) para reemplazar los grupos de usuarios existentes.<br><br>Los grupos de usuarios sólo deben tener definida la propiedad `usrgrpid`.|
|medias|array|[Medios de usuario](/manual/api/reference/user/object#media) para reemplazar los medios existentes no aprovisionados. Los medios aprovisionados pueden omitirse al actualizar los medios.|

[comment]: # ({/7e3aeefe-3b478f18})

[comment]: # ({4c3fb877-4c3fb877})
### Valores de retorno

`(object)` Devuelve un objeto que contiene los IDs de los usuarios actualizados
bajo la propiedad `userids`.

[comment]: # ({/4c3fb877-4c3fb877})

[comment]: # ({b41637d2-b41637d2})
### Ejemplos

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({9e930c76-c0483e48})
#### Renombrar un usuario

Renombrar un usuario a John Doe.

[Solicitud](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "user.update",
    "params": {
        "userid": "1",
        "name": "John",
        "surname": "Doe"
    },
    "id": 1
}
```

Respuesta:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "userids": [
            "1"
        ]
    },
    "id": 1
}
```

[comment]: # ({/9e930c76-c0483e48})

[comment]: # ({d54d987f-7ae4c491})
#### Cambiar el rol de usuario

Cambiar el rol de un usuario.

[Petición](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "user.update",
    "params": {
        "userid": "12",
        "roleid": "6"
    },
    "id": 1
}
```

Respuesta:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "userids": [
            "12"
        ]
    },
    "id": 1
}
```

[comment]: # ({/d54d987f-7ae4c491})

[comment]: # ({1083dc26-1083dc26})
### Véase también

-   [Autenticación](/manual/api/reference/authentication)

[comment]: # ({/1083dc26-1083dc26})

[comment]: # ({bbd5a07f-bbd5a07f})
### Fuente

CUser::update() en *ui/include/classes/api/services/CUser.php*.

[comment]: # ({/bbd5a07f-bbd5a07f})