Asignar roles a un usuario

POST

https://api-pruebas.phoqo.cl/pruebas/v2/settings/users/{user_id}/roles

Asigna uno o más roles a un usuario dentro de la empresa (tenant) actual. Idempotente: los roles ya asignados se devuelven en skipped y no se duplican.

Comportamiento:

Requiere rol_ids: array no vacío de IDs de rol. Si falta o está vacío → 400.

Resuelve la relación usuario-empresa (user_company) del user_id en el tenant actual. Si el usuario no pertenece a la empresa → 404.

Para cada rol: valida que exista (404 si no). Si el rol tiene required_permission y el solicitante no es super admin, valida que el solicitante posea ese permiso; si no → 403.

Inserta las asignaciones nuevas (MySQL user_rol) y hace dual-write best-effort a DynamoDB (tabla RBAC y phoqo-users-roles).

El tenant se toma del contexto (header empresa), no del body. Persiste en MySQL + DynamoDB.

Solicitud

Autorización

Agregar parámetro en header

Authorization

Ejemplo:

Authorization: ********************

Parámetros de ruta

Parámetros de Header

Parámetros del Body application/jsonRequerido

Ejemplos

Respuestas

🟢200OK

application/json

Bodyapplication/json

🟠400Bad Request (rol_ids requerido)

🟠403Forbidden (sin permiso para el rol)

🟠404Not Found (usuario/rol)

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

curl --location 'https://api-pruebas.phoqo.cl/pruebas/v2/settings/users/9cfb6cc6-aed6-45a1-976c-a0afab1b274a/roles' \
--header 'empresa: d6baef78-d4f0-457a-a119-7ebbbd4cdee8' \
--header 'empresa: ' \
--header 'grupo: 8561c7f0-111a-47d1-8efe-a50355778ab6' \
--header 'grupo: ' \
--header 'x-application: PHOQO' \
--header 'x-application: PHOQO' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "rol_ids": [
        "string"
    ]
}'

Ejemplo de Respuesta

200 - Ejemplo 1

{
    "assigned": [
        "string"
    ],
    "skipped": [
        "string"
    ],
    "userId": "string"
}

Modificado en 2026-09-10 14:19:10

Company

Listar roles de un usuario