Ndryshoni rolin e një anëtari
Roli dhe asgjë tjetër. Adresat janë boshti tjetër dhe kanë thirrjet e veta.
Ekzekuton thirrjen reale kundrejt hapësirës suaj të punës, me çelësin tuaj.
PATCH /members/{userId}
Roli dhe asgjë tjetër. Adresat janë boshti tjetër dhe kanë thirrjet e veta.
Shembull
Kërkon members:write. roleId është e vetmja fushë dhe është e detyrueshme. Kjo thirrje emërton gjendjen që dëshiron e jo një ndryshim për t’u zbatuar, ndaj dërgimi i saj dy herë përfundon te i njëjti person me të njëjtin 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"}Adresat NUK mund të ndryshohen që këtu, dhe mungesa është e qëllimshme: ato janë një bashkësi me një nivel qasjeje për secilin element, dhe një PATCH që mbart një varg do të duhej të nënkuptonte zëvendësim të plotë — pra një revokim masiv në heshtje sa herë që një klient dërgon një listë të vjetruar. Të dyja thirrjet e adresave shtojnë dhe heqin nga një herë, ndaj ajo që ndodhi është gjithmonë ajo që u kërkua.
Kjo është gjithashtu mënyra si një mbajtës i të drejtave të vjetra pushon së qeni implied: ai nuk ka rresht anëtari, kjo thirrje e krijon, dhe që atëherë lejet e tij janë ato që zgjodhi dikush e jo ato që nënkuptonte rastësisht qasja e tij mbi adresa. Vini re implied që kthehet në false dhe createdAt që shfaqet te përgjigjja më sipër. Asgjë te adresat e tij nuk ndryshon.
Roli i pronarit nuk mund t’i jepet askujt (role_immutable, një 409), pavarësisht se çfarë mban thirrësi. Ta bësh dikë pronar është një transferim i hapësirës së punës, që ka pasoja të tjera dhe nuk ekziston te ky API.
Roli i tij i ri hyn në fuqi te kërkesa e tij e radhës, dhe te kërkesa e radhës e çdo çelësi API të kufizuar prej tij.