Roles

Obtener todos los roles del negocio

Retorna la lista de todos los roles activos asociados al negocio del usuario autenticado, ordenados alfabéticamente por nombre. Los roles eliminados (deleted: true) no se incluyen.

Permiso requerido: RO_GET_ALL

get/roles

Request

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

Response

Lista de roles del negocio

_idstring

ID único del rol

businessstring

ID del negocio al que pertenece el rol (asignado automáticamente desde el token)

namestring

Nombre del rol

deletedboolean

Indica si el rol fue eliminado lógicamente (soft delete)

modifiedOnstring date-time

Fecha de última modificación (se actualiza automáticamente al guardar)

createdOnstring date-time

Fecha de creación del rol

Example response

[
  {
    "_id": "507f1f77bcf86cd799439050",
    "business": "507f1f77bcf86cd799439012",
    "name": "Administrador",
    "permissions": [
      {
        "code": "RO_GET_ALL",
        "name": "Ver todos"
      },
      {
        "code": "RO_POST",
        "name": "Crear/Editar"
      },
      {
        "code": "PR_GET_ALL",
        "name": "Ver productos"
      }
    ],
    "modifiedOn": "2025-08-04T10:30:00.000Z",
    "createdOn": "2025-01-15T08:30:00.000Z"
  }
]

Changes

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