Cập nhật vai trò
Mọi trường đều tùy chọn, và `permissions` thay thế toàn bộ danh sách.
Chạy lệnh gọi thật với không gian làm việc của bạn, bằng khóa của chính bạn.
PATCH /roles/{id}
Mọi trường đều tùy chọn, và permissions thay thế toàn bộ danh sách.
Ví dụ
Cần roles:write. Bỏ qua một trường sẽ giữ nguyên nó, đó là ý nghĩa của PATCH.
curl -X PATCH "$OE/roles/role_2b81de079c1f0a4b7e05d386" -H "$AUTH" \ -H "Content-Type: application/json" \ -d '{ "permissions": ["emails:read", "threads:read", "labels:read", "contacts:read"] }'{ "object": "role", "id": "role_2b81de079c1f0a4b7e05d386", "name": "Support", "description": "Answers the shared inboxes and nothing else.", "permissions": ["emails:read", "threads:read", "labels:read", "contacts:read"], "builtin": null, "editable": true, "deletable": true, "members": 3, "apiKeys": 1, "createdAt": "2026-08-30T10:41:02.000Z", "updatedAt": "2026-08-30T13:02:19.000Z"}permissions THAY THẾ toàn bộ danh sách. Không có lệnh cấp từng quyền và sẽ không có: danh sách là thứ được rà soát, và một bản patch theo chỉ số sẽ gây mất cập nhật ngay khi có hai tab đang mở. Hãy đọc vai trò, thay đổi mục bạn muốn, rồi gửi lại tất cả. Gửi một quyền không thêm một quyền. Nó khiến vai trò chỉ giữ đúng quyền đó, cộng với những gì quyền đó ngụ ý.
description vừa nullable vừa tùy chọn, và sự khác biệt đó là toàn bộ ý nghĩa của một bản patch: bỏ qua nó sẽ giữ câu mô tả đã lưu, gửi null sẽ xóa nó. Nếu không nullable, sẽ không có cách nào xóa mô tả ngoài việc thay nó bằng một dấu cách.
Owner là vai trò duy nhất mà PATCH từ chối, và từ chối mọi trường của nó: role_immutable, mã 409 với param: "roleId". Mọi vai trò khác đều chấp nhận tên mới dễ dàng như danh sách quyền mới, kể cả các vai trò được seed. builtin ghi lại nguồn gốc của vai trò, chứ không phải những gì có thể làm với nó. Một tên mà vai trò khác đã dùng sẽ nhận role_name_taken, mã 409 với param: "name".
Thay đổi có hiệu lực ở yêu cầu TIẾP THEO của bất kỳ ai giữ vai trò, kể cả khóa API, vì mức trần được phân giải cho từng yêu cầu thay vì được lưu cache. Do đó, thu hẹp một vai trò là thu hồi trực tiếp, có hiệu lực mà không cần xoay vòng các khóa bên dưới. Mở rộng một vai trò cũng có hiệu lực ngay, và đó là nửa đáng ghi nhớ.