Saltar al contenido principal
PATCH
Actualizar rol de un miembro del grupo

Autorizaciones

x-api-key
string
header
requerido

Clave de API para autenticarse. Puedes crear una aquí.

Parámetros de ruta

group_id
string<uuid>
requerido

Identificador único del grupo

user_id
string<uuid>
requerido

Identificador único del usuario de destino

Cuerpo

application/json

Cuerpo de la solicitud para actualizar el rol de un miembro de un grupo. Indica exactamente uno de role o role_id.

role
enum<string>

Rol general que se asignará. Mutuamente excluyente con role_id.

Opciones disponibles:
admin,
viewer
Ejemplo:

"viewer"

role_id
string

Asigna cualquier rol por ID, del sistema o personalizado de tu organización (consulta GET /api/v1/roles). Excluyente con role. Devuelve 404 si no existe o es de otra organización. Los ID del sistema son centinelas con formato GUID (p. ej., 00000000-0000-0000-0000-000000000001), no UUID RFC 4122. En grupos, los roles distintos de Admin y Viewer se respetan para el acceso, pero se muestran como "Lector" en la lista de miembros del panel.

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
Ejemplo:

"789e0123-e89b-12d3-a456-426614174000"

Respuesta

Rol del miembro actualizado correctamente

success
boolean
requerido
Ejemplo:

true

member
object
requerido