Ugrás a dokumentációra
API

Tag szerepkörének módosítása

A szerepkör, és semmi más. A címek a másik tengely, és saját hívásaik vannak.

PATCHapi.openemail.uk/members/{userId}

A valódi hívást futtatja le a munkaterületén, a saját kulcsával.

PATCH /members/{userId}

A szerepkör, és semmi más. A címek a másik tengely, és saját hívásaik vannak.

Példa

members:write szükséges. A roleId az egyetlen mező, és kötelező. Ez a hívás a kívánt állapotot nevezi meg, nem egy alkalmazandó változást, így kétszer elküldve is ugyanoda jut: ugyanaz a személy ugyanazzal a szerepkörrel.

curl
curl -X PATCH "$OE/members/7fQ2mN8vBz1aRd4tYwKx7fQ2mN8vBz1a" -H "$AUTH" \  -H "Content-Type: application/json" \  -d '{ "roleId": "role_2b81de079c1f0a4b7e05d386" }'
Válasz
{  "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"}

A címek innen NEM módosíthatók, és a kihagyás szándékos: egy halmazt alkotnak elemenkénti hozzáférési szinttel, és egy tömböt tartalmazó PATCH-nek teljes cserét kellene jelentenie, ami csendes tömeges visszavonás minden alkalommal, amikor egy kliens elavult listát küld. A két címhívás egyenként ad hozzá és távolít el, így mindig az történik, amit kértek.

Így szűnik meg egy régi hozzáférés-birtokos implied állapota is: nincs tagsoruk, ez létrehoz egyet, és onnantól a jogosultságaik azok, amelyeket valaki kiválasztott, nem azok, amelyek a címhozzáférésükből véletlenül következtek. Figyeld meg a fenti válaszban, hogy az implied false-ra vált és megjelenik a createdAt. A címeikben semmi nem változik.

A tulajdonosi szerepkör nem osztható ki (role_immutable, 409), bármivel rendelkezik is a hívó. Valakit tulajdonossá tenni munkaterület-átadás, amelynek más következményei vannak, és ezen az API-n nem létezik.

Az új szerepkörük a következő kérésüktől érvényes, és minden általa korlátozott API kulcs következő kérésétől.