Categorías

Crear o editar una categoría

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.

post/categories

Request

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

Request body

_idstring

ID único de la categoría

businessstring

ID del negocio al que pertenece la categoría

namestring

Nombre de la categoría

descriptionstring

Descripción de la categoría

urlImagestring

URL de la imagen de la categoría

isActiveboolean

Si la categoría está activa

deletedboolean

Si la categoría está eliminada

modifiedOnstring date-time

Fecha de última modificación

createdOnstring date-time

Fecha de creación

Example request

{
  "_id": "507f1f77bcf86cd799439011",
  "business": "507f1f77bcf86cd799439012",
  "name": "Bebidas",
  "description": "Bebidas frías y calientes",
  "urlImage": "https://ejemplo.com/bebidas.jpg",
  "isActive": true,
  "modifiedOn": "2025-08-04T10:30:00.000Z",
  "createdOn": "2025-08-01T09:15:00.000Z"
}

Response

Categoría creada o actualizada

_idstring

ID único de la categoría

businessstring

ID del negocio al que pertenece la categoría

namestring

Nombre de la categoría

descriptionstring

Descripción de la categoría

urlImagestring

URL de la imagen de la categoría

isActiveboolean

Si la categoría está activa

deletedboolean

Si la categoría está eliminada

modifiedOnstring date-time

Fecha de última modificación

createdOnstring date-time

Fecha de creación

Example response

{
  "_id": "507f1f77bcf86cd799439011",
  "business": "507f1f77bcf86cd799439012",
  "name": "Bebidas",
  "description": "Bebidas frías y calientes",
  "urlImage": "https://ejemplo.com/bebidas.jpg",
  "isActive": true,
  "modifiedOn": "2025-08-04T10:30:00.000Z",
  "createdOn": "2025-08-01T09:15:00.000Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.