Roles

Obtener un rol por ID

Retorna un rol específico del negocio autenticado buscado por su ID. Solo se retorna el rol si pertenece al negocio del usuario.

Permiso requerido: RO_POST

get/roles/{id}

Request

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

Path parameters

idstring required

ID del rol a consultar

Response

Rol encontrado

_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.