Grupos de Permisos

GET /api/auth/permission-groups

Devuelve todos los permisos disponibles agrupados por area funcional. Util para construir interfaces de asignacion de permisos.

Auth: Requerida — cualquier usuario autenticado

Ejemplo

curl https://api.reten.ai/api/auth/permission-groups \
  -H "Authorization: Bearer <token>"

const response = await fetch("https://api.reten.ai/api/auth/permission-groups", {
  headers: {
    "Authorization": "Bearer <token>",
  },
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.reten.ai/api/auth/permission-groups",
    headers={
        "Authorization": "Bearer <token>",
    },
)
data = response.json()

Respuesta `200 OK`

{
  "groups": [
    {
      "name": "Users",
      "permissions": [
        { "key": "create_user", "description": "Create new users" },
        { "key": "view_users", "description": "View user list" },
        { "key": "update_user", "description": "Update user details" },
        { "key": "delete_user", "description": "Delete users" },
        { "key": "reset_user_password", "description": "Reset other users passwords" }
      ]
    },
    {
      "name": "Tenants",
      "permissions": [
        { "key": "create_tenant", "description": "Create new tenants" },
        { "key": "view_tenants", "description": "View tenant list" },
        { "key": "update_tenant", "description": "Update tenant details" },
        { "key": "delete_tenant", "description": "Delete tenants" }
      ]
    },
    {
      "name": "Activities",
      "permissions": [
        { "key": "view_activities", "description": "View activities" },
        { "key": "create_activity", "description": "Create activities" },
        { "key": "cancel_activity", "description": "Cancel activities" },
        { "key": "dispatch_activity", "description": "Dispatch activities" },
        { "key": "manage_activity_config", "description": "Manage activity configuration" }
      ]
    }
  ]
}

Forma de la Respuesta

Campo	Tipo	Descripcion
`groups`	array	Lista de grupos de permisos
`groups[].name`	string	Nombre del grupo
`groups[].permissions`	array	Permisos en este grupo
`groups[].permissions[].key`	string	Identificador del permiso
`groups[].permissions[].description`	string	Descripcion legible

Grupos de Permisos

GET /api/auth/permission-groups

Ejemplo

Respuesta 200 OK

Forma de la Respuesta

Respuesta `200 OK`