Skip to main content
Version: Current

Roles.DeleteRoleAsync

Description​

The API deletes an existing Role with a specified role ID from the connected AI Command Center.

Signature [C#]​

Task DeleteRoleAsync(int roleId);

Properties​

Input​

ParameterTypeRequired / defaultDescription
roleIdintRequiredSpecify the ID to delete a Role.

Remarks​

Use DeleteRoleAsync API to delete a Role from the connected AI Command Center.

Example​

C#
public async Task DeleteRole()
{
IControlRoomContext context = LoginControlRoom();
try
{
int roleId = 5;
await context.Roles.DeleteRoleAsync(roleId);
}
finally
{
context.Close();
}
}
Connection helper
public IControlRoomContext LoginControlRoom()
{
string RequiredSetting(string name) => Environment.GetEnvironmentVariable(name) ?? throw new InvalidOperationException($"Set {name} before running this example.");
string serverUrl = RequiredSetting("INTELLIBUDDIES_SERVER_URL");
string userName = RequiredSetting("INTELLIBUDDIES_USERNAME");
string password = RequiredSetting("INTELLIBUDDIES_PASSWORD");
string connectionString = $"ServerUrl={serverUrl};UserName={userName};Password={password}";
IControlRoomContext context = new ControlRoomContext(connectionString);
context.Open();
return context;
}

See Get started for namespaces, configuration, and context cleanup, and SDK usage for error handling.