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

# PUT /api/v1/categories/:id: Editar Dados da Categoria

> Atualiza nome, descrição ou ordem de exibição de uma categoria existente. Envie apenas os campos que deseja modificar — os demais permanecem inalterados.

Use este endpoint para modificar os dados de uma categoria já existente na sua loja. Você pode atualizar o nome, a descrição e a ordem de exibição individualmente ou em conjunto — apenas os campos enviados no body serão alterados.

## Método

`PUT /api/v1/categories/:id` — Requer autenticação.

## Parâmetro de Rota

<ParamField path="id" type="string" required>
  Identificador único da categoria a ser atualizada (ex: `cat_123`).
</ParamField>

## Parâmetros do Body

Todos os campos do body são opcionais. Envie apenas os campos que deseja alterar.

<ParamField body="name" type="string">
  Novo nome da categoria.
</ParamField>

<ParamField body="description" type="string">
  Nova descrição da categoria.
</ParamField>

<ParamField body="order" type="number">
  Nova ordem de exibição da categoria no catálogo.
</ParamField>

## Exemplo de Requisição

```bash theme={null}
curl -X PUT 'https://api.bukiopay.com/api/v1/categories/cat_123' \
  --header 'Authorization: Bearer sk_live_sua_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Categoria Atualizada",
    "description": "Nova descrição"
  }'
```

## Resposta

```json theme={null}
{
  "message": "Categoria atualizada com sucesso",
  "category": {
    "id": "cat_123",
    "name": "Categoria Atualizada",
    "description": "Nova descrição",
    "updatedAt": "2026-05-07T10:30:00.000Z"
  }
}
```

## Campos da Resposta

<ResponseField name="message" type="string">
  Mensagem de confirmação da operação.
</ResponseField>

<ResponseField name="category" type="object">
  Objeto com os dados atualizados da categoria.

  <Expandable title="Propriedades da categoria">
    <ResponseField name="id" type="string">
      Identificador único da categoria.
    </ResponseField>

    <ResponseField name="name" type="string">
      Nome atualizado da categoria.
    </ResponseField>

    <ResponseField name="description" type="string">
      Descrição atualizada da categoria.
    </ResponseField>

    <ResponseField name="updatedAt" type="string">
      Data e hora da última atualização no formato ISO 8601.
    </ResponseField>
  </Expandable>
</ResponseField>


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