List roles
GET
https://manage.kontent.ai/v2/projects/{environment_id}/roles
Retrieve a role
GET
https://manage.kontent.ai/v2/projects/{environment_id}/roles/{role_identifier}
Role object
Request
Path parameters
Response
Request
Path parameters
Response
Retrieve a list of all roles in the specified environment. All roles in the environment.
Retrieve information about a role. A single role object.
All roles within an environment.
The role's ID.
The role's display name.
Identifies the role by its internal ID (e.g., 7dedb656-aef7-40ae-8158-98bbf3542f4a), or codename (e.g., codename/project-manager).
The role's ID.
The role's display name.
The role's codename. The codename property is only applicable for the Project manager role.
Roles | Kontent.ai LearnThe role's codename. The codename property is only applicable for the Project manager role.
Request samples
Example responses
Request samples
Example responses
The role's ID.
The role's display name.
The role's codename. The codename property is only applicable for the Project manager role.
{
"roles": [
{
"id": "7dedb656-aef7-40ae-8158-98bbf3542f4a",
"name": "Project manager",
"codename": "project-manager"
},
{
"id": "ee483b59-5a24-4010-b277-ae224c34bc71",
"name": "Custom role"
}
]
}
{
"id": "7dedb656-aef7-40ae-8158-98bbf3542f4a",
"name": "Project manager",
"codename": "project-manager"
}
// Tip: Find more about .NET SDKs at https://kontent.ai/learn/net
using Kontent.Ai.Management;
var client = new ManagementClient(new ManagementOptions
{
ApiKey = "KONTENT_AI_MANAGEMENT_API_KEY",
EnvironmentId = "KONTENT_AI_ENVIRONMENT_ID"
});
var response = await client.ListProjectRolesAsync();
// Tip: Find more about .NET SDKs at https://kontent.ai/learn/net
using Kontent.Ai.Management;
var client = new ManagementClient(new ManagementOptions
{
ApiKey = "KONTENT_AI_MANAGEMENT_API_KEY",
EnvironmentId = "KONTENT_AI_ENVIRONMENT_ID"
});
var identifier = Reference.ById(Guid.Parse("a23d3727-3b16-4d94-9eb0-85225d29cfef"));
//var identifier = Reference.ByCodename("project-manager");
var response = await client.GetProjectRoleAsync(identifier);
{
"id": "7dedb656-aef7-40ae-8158-98bbf3542f4a",
"name": "Project manager",
"codename": "project-manager"
}