Get project-role mappings | Unleash Documentation

Enterprise feature

For the provided role, retrieves a list of projects that use this role. For each project it also contains information about how the role used in that project, such as how many users, groups, or service accounts that use the role.

Authentication

Authorizationstring

API key needed to access this API

AuthorizationBearer

API key needed to access this API, in Bearer token format

Path parameters

roleIdstringRequired

Response

projectRoleUsageSchema

projectslist of objects or null

A collection of projects with counts of users and groups mapped to them with specified roles.

1	{
2	"projects": [
3	{
4	"project": "mobile-app",
5	"role": 5,
6	"userCount": 12,
7	"serviceAccountCount": 3,
8	"groupCount": 2
9	},
10	{
11	"project": "web-portal",
12	"role": 5,
13	"userCount": 8,
14	"serviceAccountCount": 1,
15	"groupCount": 4
16	},
17	{
18	"project": "internal-tools",
19	"role": 5,
20	"userCount": 5,
21	"serviceAccountCount": 0,
22	"groupCount": 1
23	}
24	]
25	}

1	curl https://app.unleash-instance.example.com/api/admin/projects/roles/roleId/access \
2	-H "Authorization: <apiKey>"

Authentication

Path parameters

Response

Errors