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

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

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

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

Aquest mètode permet actualitzar usuaris.

::: noteclassic
Aquest mètode és disponible per als usuaris de qualsevol tipus. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles).
:::

::: noteclassic
La fortalesa del mot de pas de l'usuari es valida d'acord amb les regles de la política de mots de pas definida per l'API d'autenticació. Veieu [API d'autenticació](/manual/api/reference/authentication) per obtindre més informació.
:::

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

[comment]: # ({8ed69eee-3b478f18})
### Paràmetres

`(object/array)` Propietats de l'usuari a actualitzar.

La propietat `userid` s'ha d'establir per a cada usuari, totes les altres propietats són opcionals. Només s'actualitzaran les propietats aprovades, totes les altres romandran sense canvis.

A més de les [propietats d'usuari estàndard](object#user), el mètode admet els paràmetres següents.

|Paràmetre|[Tipus](/manual/api/reference_commentary#data-types)|Descripció|
|--|--|------|
|passwd|string|Mot de pas de l'usuari.<br><br>Pot ésser una cadena buida si l'usuari pertany a grups amb accés LDAP o es mou només a ells.|
|usrgrps|array|[Grups d'usuaris](/manual/api/reference/user/create) substituint els grups existents.<br><br>Els grups d'usuaris han de tindre la propietat `usrgrpid` establerta.|
|medias|array|[Suports de l'usuari](/manual/api/reference/user/object#media) existents.|
|user_medias<br>(obsolet)|array|Aquest paràmetre és obsolet; si us plau, empreu `medias`.<br>[Suport](/manual/api/reference/user/object#media) de l'usuari per substituir els suports existents.|

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

[comment]: # ({4c3fb877-4c3fb877})
### Valors de retorn

`(object)` Torna un objecte que contingui els IDs dels usuaris actualitzats sota la propietat `userids`.

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

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

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

[comment]: # ({ca60eb4e-c0483e48})
#### Reanomenar un usuari

Reanomena un usuari a "Josep Perarnau".

Petició:

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

Resposta:

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

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

[comment]: # ({2a24dd67-7ae4c491})
#### Canvia el rol d'usuari

canvia el rol d'un usuari.

Petició:

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

Resposta:

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

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

[comment]: # ({1083dc26-1083dc26})
### Veieu també

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

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

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

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

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