Roles

Roles

Roles personalizados y permisos por empresa.

POST /api/companies/{companyId}/roles/v1

Crear rol personalizado

Parámetros

Nombre	Tipo	Requerido	Descripción
companyId	string	✅

Request Body (requerido ✅)

{
    "name": "supervisor",
    "permissions": ["employees.view","attendance.view.all"]
  }

Respuestas

201

Rol creado exitosamente

{
    "id": "00000000-0000-0000-0000-000000000000",
    "companyId": "00000000-0000-0000-0000-000000000000",
    "name": "name",
    "isPredefined": true,
    "permissions": [],
    "createdAt": "2024-01-15T10:00:00Z",
    "updatedAt": "2024-01-15T10:00:00Z"
  }

---

GET /api/companies/{companyId}/roles/v1

Listar roles de la empresa

Parámetros

Nombre	Tipo	Requerido	Descripción
companyId	string	✅

Respuestas

200

Lista de roles

{
    "id": "00000000-0000-0000-0000-000000000000",
    "companyId": "00000000-0000-0000-0000-000000000000",
    "name": "name",
    "isPredefined": true,
    "permissions": [],
    "createdAt": "2024-01-15T10:00:00Z",
    "updatedAt": "2024-01-15T10:00:00Z"
  }

---

PATCH /api/companies/{companyId}/roles/v1/{roleId}

Actualizar rol

Roles predefinidos no pueden renombrarse. Los permisos se sobreescriben completamente (no se agregan).

Parámetros

Nombre	Tipo	Requerido	Descripción
companyId	string	✅
roleId	string	✅

Request Body (requerido ✅)

{
    "name": "name",
    "permissions": []
  }

Respuestas

200

Rol actualizado

{
    "id": "00000000-0000-0000-0000-000000000000",
    "companyId": "00000000-0000-0000-0000-000000000000",
    "name": "name",
    "isPredefined": true,
    "permissions": [],
    "createdAt": "2024-01-15T10:00:00Z",
    "updatedAt": "2024-01-15T10:00:00Z"
  }

---

DELETE /api/companies/{companyId}/roles/v1/{roleId}

Eliminar rol

Rol eliminado

Parámetros

Nombre	Tipo	Requerido	Descripción
companyId	string	✅
roleId	string	✅

Respuestas

204

Rol eliminado exitosamente

---

Schemas

CreateRoleRequest

Campo	Tipo	Requerido	Descripción
name	string ej: “supervisor”	✅
permissions	array ej: [“employees.view”,“attendance.view.all”]	❌

RoleResponse

Campo	Tipo	Requerido	Descripción
id	string (uuid)	❌
companyId	string (uuid)	❌
name	string	❌
isPredefined	boolean	❌
permissions	array	❌
createdAt	string (date-time)	❌
updatedAt	string (date-time)	❌

UpdateRoleRequest

Campo	Tipo	Requerido	Descripción
name	string	❌
permissions	array	❌