Sinds kort ondersteunt de Studytube API het instellen van teamspecifieke permissies bij gebruikers. Hiermee kun je per team bepalen welke rechten een gebruiker krijgt, zoals het beheren van gebruikersgegevens of het inzien van onderliggende teams.
Deze functionaliteit is handig voor organisaties die automatisch rollen willen toekennen bij het aanmaken of bijwerken van gebruikers via de API.
Wat zijn teampermissions?
Teampermissions zijn rechten die bepalen wat een gebruiker binnen een specifiek team mag doen. Je stelt deze rechten in op het moment dat je een gebruiker toevoegt of bijwerkt via de API.
Elke permissie is een boolean-waarde (true of false) die expliciet moet worden meegegeven per team.
Beschikbare permissies
| Permissie | Beschrijving |
|---|---|
access_subteams | Geeft de gebruiker toegang tot onderliggende (sub)teams |
manage_user_data | Gebruiker mag teamleden beheren (zoals bewerken of deactiveren) |
manage_user_learnings_content | Mag leeractiviteiten beheren binnen het team |
manage_user_qualifications | Mag kwalificaties van teamleden beheren |
view_user_data | Mag gegevens van teamleden bekijken |
Let op: alle velden zijn verplicht in de API-aanroep. Je moet dus bij elke permissie
trueoffalsemeegeven – ook als je geen rechten wilt toekennen.
Voorbeeld van JSON-payload
Hieronder zie je een voorbeeld van hoe je teampermissions meestuurt in een POST of PATCH-verzoek naar het gebruikersendpoint:
{
"email": "gebruiker@example.com",
"first_name": "Anna",
"last_name": "Jansen",
"teams": [
{
"id": 12345,
"team_permissions": {
"access_subteams": true,
"manage_user_data": false,
"manage_user_learnings_content": true,
"manage_user_qualifications": false,
"view_user_data": true
}
}
]
}
Veelgestelde vragen
Zijn alle permissies verplicht?
Ja, je moet alle vijf de velden expliciet meegeven – ook als je false gebruikt.
Wat gebeurt er als je niets invult?
De API-call zal falen, omdat alle vijf de permissies als required zijn ingesteld.
Kan ik meerdere teams met verschillende rechten instellen?
Ja, je kunt meerdere teamblokken toevoegen aan de teams array, elk met eigen permissies.
Vragen of hulp nodig?
Heb je vragen over het gebruik van teampermissions in de API, of loop je tegen foutmeldingen aan?
Neem gerust contact op via service@studytube.nl. We helpen je graag verder.