[comment]: # ({b7611ecd-b7611ecd})
# iconmap.update

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

[comment]: # ({f9eb2b72-15ec7450})
### Descrição

`object iconmap.update(object/array iconMaps)`

Este método permite atualizar mapas de ícones existentes.

::: noteclassic
Este método está disponível apenas para o tipo de usuário *Super admin*.
As permissões para chamar o método podem ser revogadas nas configurações de função de usuário. Consulte
[Funções de usuário](/manual/web_interface/frontend_sections/users/user_roles)
para mais informações.
:::

[comment]: # ({/f9eb2b72-15ec7450})

[comment]: # ({d8cf96e2-6f92ef73})
### Parâmetros

`(object/array)` Propriedades do mapa de ícones a serem atualizadas.

A propriedade `iconmapid` deve ser definida para cada mapa de ícones, todas as outras propriedades são opcionais. Somente as propriedades passadas serão atualizadas, todas as outras permanecerão inalteradas.

Além das [propriedades padrão do mapa de ícones](object#icon-map), o método aceita os seguintes parâmetros.

|Parâmetro|[Tipo](/manual/api/reference_commentary#data-types)|Descrição|
|--|--|------|
|mappings|array|[Mapeamentos de ícones](/manual/api/reference/iconmap/object#icon-mapping) para substituir os mapeamentos de ícones existentes.|

[comment]: # ({/d8cf96e2-6f92ef73})

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

`(object)` Retorna um objeto contendo os IDs dos mapas de ícones atualizados
na propriedade `iconmapids`.

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

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

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

[comment]: # ({54ff8f7c-7013c996})
#### Renomear mapa de ícones

Renomear um mapa de ícones para "OS icons".

[Requisição](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "iconmap.update",
    "params": {
        "iconmapid": "1",
        "name": "OS icons"
    },
    "id": 1
}
```

Resposta:

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

[comment]: # ({/54ff8f7c-7013c996})

[comment]: # ({ab16f1c6-8df05cf6})
### Veja também

-   [Mapeamento de ícones](object#icon-mapping)

[comment]: # ({/ab16f1c6-8df05cf6})

[comment]: # ({f35a7b0b-f35a7b0b})
### Origem

CIconMap::update() em *ui/include/classes/api/services/CIconMap.php*.

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