Skip to main content
Version: Current

ProcessInstances.GetInstanceStatusByIdAsync

Description​

The API gets the process instance status of the specified process instance ID inside the connected AI Command Center.

Signature [C#]​

Task<string> GetInstanceStatusByIdAsync(string instanceId);

Properties​

Input​

ParameterTypeRequired / defaultDescription
instanceIdstringRequiredThe process instance ID for which the process instance status has to be retrieved.

Output​

PropertyDescription
Task<ProcessInstance>Returns process instance status.

Remarks​

Use GetInstanceStatusByIdAsync API to get process instance status using process instance id inside the connected AI Command Center.

Example​

C#
public async Task GetInstanceStatusById()
{
IControlRoomContext context = LoginControlRoom();
try
{
string instanceId = "e42a93f5d53245d788909fd655b41cfe";
string status = await context.ProcessInstances.GetInstanceStatusByIdAsync(instanceId);
System.Console.WriteLine("Status: " + status);
}
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.