> ## 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.

# Actualizar categoría

> Actualiza los datos de una categoría existente.

Solo necesitas enviar los campos que deseas actualizar.

<ParamField path="app_id" type="string" required>
  ID de tu tienda en Jelou Shop.
</ParamField>

<ParamField path="category_id" type="integer" required>
  ID de la categoría a actualizar.
</ParamField>

<ParamField body="name" type="string">
  Nombre de la categoría (máx. 255 caracteres).
</ParamField>

<ParamField body="description" type="string">
  Descripción de la categoría (máx. 255 caracteres).
</ParamField>

<ParamField body="order" type="integer">
  Posición de ordenamiento (mín. 0, máx. 999999). Debe ser único dentro del mismo nivel (app + categoría padre + sucursal). El valor `0` se trata como "sin orden".
</ParamField>

<ParamField body="status" type="boolean">
  Estado de la categoría (activa/inactiva).
</ParamField>

<ParamField body="parent_id" type="integer">
  ID de la categoría padre (para jerarquía). Debe existir en la misma tienda. Una categoría no puede ser su propia padre. Envía `null` para convertirla en categoría raíz.
</ParamField>

<Note>
  El `name` debe ser único dentro del mismo nivel (misma tienda, categoría padre y sucursal). Si lo duplicas, recibirás un error `422`.
</Note>

<RequestExample>
  ```bash cURL theme={null}
  curl -X PATCH "https://gateway.jelou.ai/ecommerce/v2/apps/{app_id}/categories/{category_id}" \
    -H "x-api-key: TU_CLAVE_API" \
    -H "Content-Type: application/json" \
    -d '{
      "name": "Pizzas Artesanales",
      "description": "Nuestra selección premium de pizzas hechas al horno de leña"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "data": {
      "id": 1,
      "name": "Pizzas Artesanales",
      "image": "categories/664f1a2b3c4d5.jpg",
      "description": "Nuestra selección premium de pizzas hechas al horno de leña",
      "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"
    }
  }
  ```
</ResponseExample>