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

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

string

required

Identificador único da categoria a ser atualizada (ex: cat_123).

Parâmetros do Body

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

string

Novo nome da categoria.

string

Nova descrição da categoria.

number

Nova ordem de exibição da categoria no catálogo.

Exemplo de Requisição

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

{
  "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

string

Mensagem de confirmação da operação.

object

Objeto com os dados atualizados da categoria.

Show Propriedades da categoria

string

Identificador único da categoria.

string

Nome atualizado da categoria.

string

Descrição atualizada da categoria.

string

Data e hora da última atualização no formato ISO 8601.

Introdução à API

Cobranças PIX

Saques

Webhooks

Pedidos

Produtos

Categorias

Cupons

Loja

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

Método

Parâmetro de Rota

Parâmetros do Body

Exemplo de Requisição

Resposta

Campos da Resposta

​Método

​Parâmetro de Rota

​Parâmetros do Body

​Exemplo de Requisição

​Resposta

​Campos da Resposta

Método

Parâmetro de Rota

Parâmetros do Body

Exemplo de Requisição

Resposta

Campos da Resposta