De rol van een lid wijzigen
De rol en niets anders. Adressen zijn de andere as en hebben hun eigen aanroepen.
Voert de echte aanroep uit op je workspace, met je eigen sleutel.
PATCH /members/{userId}
De rol en niets anders. Adressen zijn de andere as en hebben hun eigen aanroepen.
Voorbeeld
Vereist members:write. roleId is het enige veld, en het is verplicht. Deze aanroep benoemt de gewenste toestand in plaats van een door te voeren wijziging, dus hem twee keer versturen eindigt bij dezelfde persoon met dezelfde rol.
curl -X PATCH "$OE/members/7fQ2mN8vBz1aRd4tYwKx7fQ2mN8vBz1a" -H "$AUTH" \ -H "Content-Type: application/json" \ -d '{ "roleId": "role_2b81de079c1f0a4b7e05d386" }'{ "object": "member", "userId": "7fQ2mN8vBz1aRd4tYwKx7fQ2mN8vBz1a", "email": "[email protected]", "name": null, "image": null, "role": { "id": "role_2b81de079c1f0a4b7e05d386", "name": "Support", "builtin": null }, "implied": false, "permissions": [ "emails:send", "emails:read", "threads:read", "threads:write", "labels:read", "labels:write", "contacts:read" ], "addresses": [ { "addressId": "c40a95f2-1cc6-4d31-82a8-9e075d31c2a8", "address": "[email protected]", "access": "viewer" } ], "createdAt": "2026-08-30T15:44:02.000Z"}Adressen zijn hier NIET te patchen, en die weglating is bewust: ze vormen een verzameling met per element een toegangsniveau, en een PATCH met een array zou vervang-alles moeten betekenen, wat een stille massale intrekking is elke keer dat een client een verouderde lijst stuurt. De twee adresaanroepen voegen er één tegelijk toe of halen er één tegelijk weg, zodat wat er gebeurde altijd is wat er gevraagd werd.
Zo houdt een houder van een oude toekenning ook op implied te zijn: diegene heeft geen ledenrij, dit doet er een upsert van, en vanaf dan zijn zijn permissies wat iemand heeft gekozen in plaats van wat zijn adrestoegang toevallig impliceerde. Let op hoe implied omslaat naar false en createdAt verschijnt in de respons hierboven. Aan zijn adressen verandert niets.
De owner-rol kan niet worden uitgedeeld (role_immutable, een 409), wat de aanroeper ook heeft. Iemand eigenaar maken is een overdracht van de workspace, wat andere gevolgen heeft en niet bestaat op deze API.
Hun nieuwe rol wordt van kracht bij hun volgende verzoek, en bij het volgende verzoek van elke API-sleutel die erdoor wordt begrensd.