---
title: "Crear o editar una categoría"
method: POST
path: "/categories"
tags: ["Categorías"]
---

# Crear o editar una categoría

`POST /categories`

## Request

- Base URL: `https://api.pirpos.com`
- URL: `https://api.pirpos.com/categories`
- Auth: HTTP bearer

Crea una nueva categoría o actualiza una existente si se envía `_id`.
Permite subir imagen por multipart (campo `avatar`) o enviar `urlImage`.

**Autenticación requerida:** Bearer Token.

## Request body

- Category
  - `_id` string: ID único de la categoría
  - `business` string: ID del negocio al que pertenece la categoría
  - `name` string: Nombre de la categoría
  - `description` string: Descripción de la categoría
  - `urlImage` string: URL de la imagen de la categoría
  - `isActive` boolean: Si la categoría está activa
  - `deleted` boolean: Si la categoría está eliminada
  - `modifiedOn` string, date-time: Fecha de última modificación
  - `createdOn` string, date-time: Fecha de creación

## Response `200`

Categoría creada o actualizada

- Category
  - `_id` string: ID único de la categoría
  - `business` string: ID del negocio al que pertenece la categoría
  - `name` string: Nombre de la categoría
  - `description` string: Descripción de la categoría
  - `urlImage` string: URL de la imagen de la categoría
  - `isActive` boolean: Si la categoría está activa
  - `deleted` boolean: Si la categoría está eliminada
  - `modifiedOn` string, date-time: Fecha de última modificación
  - `createdOn` string, date-time: Fecha de creación

## Other responses

- `401`: No autorizado
- `500`: Error interno del servidor

---

[API](https://skmtc.dev/loggro/apis/restobar-servicios-del-m-dulo-de-restobar.md) - [All operations](https://skmtc.dev/loggro/apis/restobar-servicios-del-m-dulo-de-restobar/llms.txt) - [OpenAPI document](https://skmtc.dev/loggro/apis/restobar-servicios-del-m-dulo-de-restobar/revisions/9d4431a3cddc?raw)