> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Atualizar categoria

> Atualize os dados de uma categoria existente.

Você só precisa enviar os campos que deseja atualizar.

**app\_id** `string` *required*

O ID da sua loja no Jelou Shop.

**category\_id** `integer` *required*

ID da categoria a atualizar.

**name** `string`

Nome da categoria (máx. 255 caracteres).

**description** `string`

Descrição da categoria (máx. 255 caracteres).

**order** `integer`

Posição de ordenação (mín. 0, máx. 999999). Deve ser único dentro do mesmo nível (app + categoria pai + filial). O valor `0` é tratado como "sem ordem".

**status** `boolean`

Status da categoria (ativa/inativa).

**parent\_id** `integer`

ID da categoria pai (para hierarquia). Deve existir na mesma loja. Uma categoria não pode ser pai de si mesma. Envie `null` para torná-la categoria raiz.

> [!NOTE]
>
> O `name` deve ser único dentro do mesmo nível (mesma loja, categoria pai e filial). Se duplicá-lo, receberá um erro `422`.

```bash cURL theme={null}
curl -X PATCH "https://gateway.jelou.ai/ecommerce/v2/apps/{app_id}/categories/{category_id}" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Pizzas Artesanais",
    "description": "Nossa seleção premium de pizzas assadas em forno a lenha"
  }'
```

```json 200 OK theme={null}
{
  "data": {
    "id": 1,
    "name": "Pizzas Artesanais",
    "image": "categories/664f1a2b3c4d5.jpg",
    "description": "Nossa seleção premium de pizzas assadas em forno a lenha",
    "order": 1,
    "status": true,
    "app_id": "8af29efb-9864-4f29-888c-b2dd0d7ac1dd",
    "branch_id": "9e3f2c1a-8b7d-4e6f-a5c4-d3b2a1e0f9c8",
    "parent_id": null,
    "created_at": "2026-02-19T15:30:00.000000Z",
    "updated_at": "2026-02-19T16:00:00.000000Z"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.