Szerepkör létrehozása
Egy név és a jogosultságok listája. Ami visszajön, hosszabb annál, amit elküldtél.
A valódi hívást futtatja le a munkaterületén, a saját kulcsával.
POST /roles
Egy név és a jogosultságok listája. Ami visszajön, hosszabb annál, amit elküldtél.
Példa
roles:write szükséges. 201-et ad vissza. Egy egyéni szerepkör builtin: null, editable: true és deletable: true, és senki nem rendelkezik vele, amíg valakit át nem helyeznek rá.
curl -X POST "$OE/roles" -H "$AUTH" -H "Content-Type: application/json" \ -d '{ "name": "Support", "description": "Answers the shared inboxes and nothing else.", "permissions": ["emails:send", "threads:write", "labels:write", "contacts:read"] }'{ "object": "role", "id": "role_2b81de079c1f0a4b7e05d386", "name": "Support", "description": "Answers the shared inboxes and nothing else.", "permissions": [ "emails:send", "emails:read", "threads:read", "threads:write", "labels:read", "labels:write", "contacts:read" ], "builtin": null, "editable": true, "deletable": true, "members": 0, "apiKeys": 0, "createdAt": "2026-08-30T10:41:02.000Z", "updatedAt": "2026-08-30T10:41:02.000Z"}Négy jogosultság ment be, és hét jött vissza. Az emails:send magában foglalja az emails:read-et, a threads:write a threads:read-et, a labels:write a labels:read-et. Egy szerepkör, amely archiválhat egy szálat, amelyet nem nyithat meg, egy elfelejtett jelölőnégyzet, nem pedig olyan szabályzat, amelyet bárki komolyan gondolna, ezért a következmény eltárolásra kerül, nem elutasításra. A lista kanonikus sorrendben is jön vissza, ami lehetővé teszi, hogy egy kliens két szerepkört JSON-ként összevessen, és eldöntse, aktív-e a Mentés gomb.
Az ismeretlen jogosultságot itt ELUTASÍTJA, nem hagyja el: a templates:writ invalid_parameter, 422, a stringet megnevezve. A szolgáltatás csendben normalizál, mert egyben ez a kezdeti feltöltés és az MCP útvonala is, ahol egy teljes szerepkör elbuktatása egyetlen fel nem ismert szó miatt rosszabb lenne. Egy szándékosan indított hívásnál ez helytelen. Egy 200, amely sablonokat nem szerkeszthető szerepkört ad vissza, semmit nem mondott el, és a hívó egész délután ezzel fog foglalkozni.
Ugyanazon a munkaterületen egy ismétlődő név role_name_taken, 409. A 25. egyéni szerepkör role_limit_reached, 422. Azt korlátozza, mekkorára nőhet egy mátrix, mielőtt már senki nem auditálja, és nem csomaghatár.
Egy szerepkör létrehozása senkinek nem adja meg. Emberek áthelyezése rá a PATCH /members/{userId} hívással történik, egy kulcs ráirányítása pedig ott, ahol a kulcsot kiállítják.