API

Bir rolü getir

Bir rolün tamamı; tüm izin listesi ve şu anda onu neyin taşıdığıyla.

GETapi.openemail.uk/roles/{id}

Gerçek çağrıyı kendi anahtarınızla çalışma alanınıza karşı çalıştırır.

GET /roles/{id}

Bir rolün tamamı; tüm izin listesi ve şu anda onu neyin taşıdığıyla.

Örnek

roles:read gerektirir. Id'ler role_ önekini taşır.

curl

curl "$OE/roles/role_2b81de079c1f0a4b7e05d386" -H "$AUTH"

Yanıt

{  "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"}

Başka bir çalışma alanındaki bir rol 403 değil 404'tür; hiç var olmamış bir id ile aynı yanıttır. Çünkü bir anahtara, okuyamadığı bir çalışma alanında hangi id'lerin var olduğunu söylemek başlı başına sızıntıdır.

permissions yetkinin tamamıdır; düz ve önceden genişletilmiş. Getirilecek başka bir şey ve izin başına bir uç nokta yoktur: bir rol tek liste olarak okunur, çünkü denetlenen şey listedir.

Bu, rolü KİMİN taşıdığını söylemez. members ve apiKeys birer sayıdır; ilkinin ardındaki adlar GET /members ile alınır ve bir roldeki anahtarları listeleyen bir uç nokta yoktur.