Bir rol oluştur
Bir ad ve bir izin listesi. Geri gelen, gönderdiğinizden daha uzundur.
Gerçek çağrıyı kendi anahtarınızla çalışma alanınıza karşı çalıştırır.
POST /roles
Bir ad ve bir izin listesi. Geri gelen, gönderdiğinizden daha uzundur.
Örnek
roles:write gerektirir. 201 döner. Özel bir rol builtin: null, editable: true ve deletable: true değerlerine sahiptir ve biri ona taşınana kadar kimsede değildir.
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"}Dört izin girdi, yedi izin geri geldi. emails:send, emails:read iznini; threads:write, threads:read iznini; labels:write, labels:read iznini ima eder. Açamadığı bir yazışmayı arşivleyebilen bir rol, kimsenin kastettiği bir politika değil birinin unuttuğu bir onay kutusudur; bu yüzden ima edilen izin reddedilmek yerine saklanır. Liste ayrıca kanonik sırada döner; bir istemcinin iki rolü JSON olarak karşılaştırıp Kaydet düğmesinin etkin olup olmayacağına karar verebilmesini sağlayan da budur.
Bilinmeyen bir izin burada atılmaz, REDDEDİLİR: templates:writ, ilgili dizgeyi adlandıran bir invalid_parameter, yani 422'dir. Servis sessizce normalleştirir, çünkü aynı zamanda ilk oluşturma yolu ve MCP yoludur; orada tanınmayan tek bir sözcük yüzünden bütün bir rolü başarısız kılmak daha kötü olurdu. Birinin bilerek yaptığı bir çağrıda ise bu yanlıştır. Şablonları düzenleyemeyen bir rol taşıyan bir 200 onlara hiçbir şey söylememiştir ve bütün öğleden sonrayı buna harcarlar.
Aynı çalışma alanında yinelenen bir ad role_name_taken, bir 409'dur. 25. özel rol role_limit_reached, bir 422'dir. Bu, bir matrisin kimsenin denetleyemeyeceği kadar büyümesine karşı bir korumadır, bir plan sınırı değildir.
Bir rol oluşturmak onu kimseye vermez. İnsanları ona taşımak PATCH /members/{userId} ile yapılır; bir anahtarı ona yöneltmek ise anahtarın üretildiği yerde yapılır.