Gérer les utilisateurs administrateurs d’un rôle

Lister les utilisateurs administrateurs d’un rôle

Connaissant l’UUID d’un rôle, vous pouvez obtenir la liste des utilisateurs administrateurs de ce rôle en émettant une requête GET  l’adresse

/api/roles/<UUID du rôle>/admin/users/

(vous devez bien sûr vous authentifier et disposer des droits de modification de rôles, nécessaires à l’appel de cet endpoint).

TODO reste à venir

Par exemple, pour un rôle d’UUID "abc" ayant deux utilisateurs administrateurs, l’appel

/api/roles/abc/admin/users/

/api/roles/abc/relationships/parents/

renvoie les données JSON suivantes

{
    "err": 0,
    "data": [
        {
            "id": 1,
            "ou": null,
            "full_name": "user",
            "date_joined": "2025-11-05T16:32:05.199726+01:00",
            "last_login": null,
            "uuid": "e3120021fb8e4abdb3a4faf786f2b7dc",
            "username": "user",
            "first_name": "",
            "last_name": "",
            "email": "",
            "email_verified": false,
            "email_verified_date": null,
            "email_verified_sources": [],
            "is_superuser": false,
            "phone_verified_on": null,
            "is_staff": false,
            "is_active": true,
            "modified": "2025-11-05T16:32:05.213355+01:00",
            "last_account_deletion_alert": null,
            "deactivation": null,
            "deactivation_reason": null,
            "first_name_verified": false,
            "last_name_verified": false
        },
        {
            "id": 4,
            "ou": "ou1",
            "full_name": "J\u00f4hn D\u00f4e",
            "date_joined": "2025-11-05T16:32:05.606836+01:00",
            "last_login": null,
            "uuid": "58e9bc50ad554bb6a9fae8a0a910c0ff",
            "username": "john.doe",
            "first_name": "J\u00f4hn",
            "last_name": "D\u00f4e",
            "email": "john.doe@example.net",
            "email_verified": false,
            "email_verified_date": null,
            "email_verified_sources": [],
            "is_superuser": false,
            "phone_verified_on": null,
            "is_staff": false,
            "is_active": true,
            "modified": "2025-11-05T16:32:05.614384+01:00",
            "last_account_deletion_alert": null,
            "deactivation": null,
            "deactivation_reason": null,
            "first_name_verified": false,
            "last_name_verified": false
        }
    ],
    "err": 0
}

Ajouter des utilisateurs à la liste des administrateurs d’un rôle
 
Pour l’ajout à un rôle d’UUID "abc" de deux utilisateurs ayant pour UUID "def" et "ghi" respectivement :
 
POST /api/roles/abc/admin/users/
{"data": [{"uuid": "def, "uuid": "ghi"}]}
 
Supprimer des utilisateurs de la liste des administrateurs d’un rôle
 
Pour la suppression de la liste d’un rôle d’UUID "abc" de deux utilisateurs ayant pour UUID "def" et "ghi" respectivement :
 
DELETE /api/roles/abc/admin/users/
{"data": [{"uuid": "def, "uuid": "ghi"}]}
 
Définir la liste des administrateurs d’un rôle
 
Pour la définition de la liste des administrateurs d’un rôle d’UUID "abc" en tant que deux utilisateurs ayant pour UUID "def" et "ghi" respectivement :
 
PUT /api/roles/abc/admin/users/
{"data": [{"uuid": "def, "uuid": "ghi"}]}
 
 "parent": {
                "uuid": "def",
                "name": "Role 1",
                "slug": "role-1",
                "ou": null,
                "service": null
            },
            "direct": true
        },
        {
            "parent": {
                "uuid": "ghi",
                "name": "Role 2",
                "slug": "role-2",
                "ou": null,
                "service": null
            },
            "direct": true
        }
    ]
}
Un paramètre de querystring ‘all’ permet par ailleurs d’obtenir la liste de tous les parents (directs ou indirects).
 
Lister les rôles enfants
 
Connaissant l’UUID d’un rôle, vous pouvez obtenir la liste de ses rôles enfants en appelant l’URI
 
/api/roles/<UUID du rôle>/children/