Ugrás a dokumentációra
API

Szerepkör lekérése

Egy szerepkör teljes egészében, a teljes jogosultságlistájával, és azzal, hogy jelenleg kik rendelkeznek vele.

GETapi.openemail.uk/roles/{id}

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

GET /roles/{id}

Egy szerepkör teljes egészében, a teljes jogosultságlistájával, és azzal, hogy jelenleg kik rendelkeznek vele.

Példa

roles:read szükséges. Az azonosítók role_ előtagot kapnak.

curl
curl "$OE/roles/role_2b81de079c1f0a4b7e05d386" -H "$AUTH"
Válasz
{  "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": 3,  "apiKeys": 1,  "createdAt": "2026-08-30T10:41:02.000Z",  "updatedAt": "2026-08-30T12:15:44.000Z"}

Egy másik munkaterület szerepköre 404, nem 403, ugyanaz a válasz, mint egy soha nem létezett azonosítóra, mert ha egy kulcsnak elárulnánk, milyen azonosítók léteznek egy általa nem olvasható munkaterületen, az maga lenne a szivárgás.

A permissions a teljes hozzáférés, laposan és már kibontva. Nincs mit még lekérni, és nincs jogosultságonkénti végpont: a szerepkört egy listaként olvassuk, mert egy listát auditálnak.

Ez nem mondja meg, KI rendelkezik vele. A members és az apiKeys számlálók; az előbbi mögötti nevek a GET /members útvonalon érhetők el, és nincs végpont, amely felsorolná egy szerepkör kulcsait.