# Atualizar gênero (categoria)

> Renomeia um gênero pelo id.

Fonte: https://api.viashopmoda.com.br/docs-api/?p=recursos/categoria/atualizar · Atualizado em 18/11/2026


## O que faz

Troca o nome de um gênero. Os produtos ligados a ele passam a mostrar o nome novo.

## Requisição

| | |
|---|---|
| **Método** | `POST` |
| **URL** | `https://api.viashopmoda.com.br/via/categoria/atualizar/{TOKEN}` |
| **Corpo** | Objeto JSON `{ ... }`, cabeçalho `Content-Type: application/json` |
| **Token** | Substitua `{TOKEN}` pelo token da loja. Ele vai no caminho da URL, não em cabeçalho. |


## Campos

| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `id` | número | **sim** | Id do gênero ([`categoria/consultar`](https://api.viashopmoda.com.br/docs-api/?p=recursos/categoria/consultar&formato=md)). |
| `nome` | texto | **sim** | Novo nome, 2 a 30 caracteres (gravado em MAIÚSCULAS). |

## Exemplo

```json
{ "id": 10, "nome": "Moda plus size" }
```

```json
{ "retorno": true, "nome": "MODA PLUS SIZE", "id": "10" }
```

Erros: `Parâmetros 'nome' e 'id' não encontrados.`, `Categoria não atualizada. 'ID' não encontrado ou 'nome' enviado é o mesmo.`

## Pode reenviar?

O reenvio com o mesmo nome devolve o erro "nome enviado é o mesmo" — pode tratar como já atualizado.
