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

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

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

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

Este método permite actualizar los usuarios existentes.

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

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

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

[comment]: # ({8ed69eee-3b478f18})
### Parámetros

`(objeto/matriz)` Propiedades del usuario que se actualizarán.

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

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

|Parámetro|[Tipo](/manual/api/reference_commentary#data_types)|Descripción|
|--|--|------|
|contraseña|cadena|Contraseña del usuario.<br><br>Puede ser una cadena vacía si el usuario pertenece o se mueve solo a grupos que tienen acceso LDAP.|
|usrgrps|array|Usuario [grupos](/manual/api/reference/user/create) para reemplazar los grupos de usuarios existentes.<br><br>Los grupos de usuarios deben tener la propiedad `usrgrpid` definida.|
|medias|array|[Medios de usuario](/manual/api/reference/user/object#media) para reemplazar los medios existentes.|
|user_medias<br>(deprecated)|array|Este parámetro está en desuso; utilice `medias` en su lugar.<br>Usuario [media](/manual/api/reference/user/object#media) para reemplazar los medios existentes.|

[comment]: # ({/8ed69eee-3b478f18})

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

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

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

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

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

[comment]: # ({ca60eb4e-c0483e48})
#### Cambiar el nombre de un usuario

Cambie el nombre de un usuario a John Doe.

Solicitud:

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

Respuesta:

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

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

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

Cambiar el rol de un usuario.

Solicitud:

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

Respuesta:

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

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

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

- [Authenticació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})