Lấy thông tin một vai trò
Một vai trò đầy đủ, với toàn bộ danh sách quyền và những gì đang giữ nó.
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.
GET /roles/{id}
Một vai trò đầy đủ, với toàn bộ danh sách quyền và những gì đang giữ nó.
Ví dụ
Cần roles:read. Id mang tiền tố role_.
curl "$OE/roles/role_2b81de079c1f0a4b7e05d386" -H "$AUTH"{ "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"}Một vai trò ở không gian làm việc khác trả về 404 thay vì 403, cùng câu trả lời với một id chưa bao giờ tồn tại, vì việc cho một khóa biết những id nào tồn tại trên một không gian làm việc mà nó không đọc được tự bản thân đã là rò rỉ.
permissions là toàn bộ quyền được cấp, phẳng và đã được mở rộng. Không còn gì khác cần tải và không có endpoint cho từng quyền: một vai trò được đọc như một danh sách vì danh sách là thứ được rà soát.
Lệnh này không cho biết AI giữ vai trò. members và apiKeys là số đếm; tên đằng sau số đầu tiên có ở GET /members, và không có endpoint nào liệt kê các khóa trên một vai trò.