View Workflow Instances
get
/api/restapi/workflowInstance
Send a request to this endpoint to view workflow instances under a workspace.
Request
Query Parameters
-
workflowConfigurationName(required): string
User defined identifier of a workflow configuration.
This is a required field. -
workspaceCode: string
The user-specified identifier of a workspace.
-
workspaceId: integer(int64)
The system-generated identifier of a workspace.
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json
200 Response
Successful operation
Root Schema : List<ApiEntityWorkflowInstance>
Type:
array
Title:
Show Source
List<ApiEntityWorkflowInstance>
-
Array of:
object ApiEntityWorkflowInstance
Title:
ApiEntityWorkflowInstance
Nested Schema : ApiEntityWorkflowInstance
Type:
object
Title:
Show Source
ApiEntityWorkflowInstance
-
actualDuration: number
(double)
Actual Duration in days taken by the Workflow Instance to reach state of termination i.e status which is completed/stopped/failed.
-
configurationVersion: integer
(int64)
Version of the workflow configuration that was used to create the workflow instance.
-
context: string
Maximum Length:
0
The specific object that the workflow runs against. -
contextType: string
Allowed Values:
[ "APPLICATION_USER", "CAPITAL_PLAN", "CAPITAL_PLAN_PROJECT", "CAPITAL_PORTFOLIO", "COLUMN_DEFINTION", "NONE", "PROJECT", "PROJECT_CATEGORY_VALUE", "SEC_ROLE", "WORKFLOW_CONFIG", "WORKSPACE", "CONTRACT", "COMMITMENT", "RISK", "RISK_PROG", "SUBMITTAL", "CHANGEORDER", "BUDGET", "BUDGET_CHANGE", "BUDGET_TRANSFER", "PROGRAM_BUDGET", "PROGRAM_BUDGET_CHANGE", "PROGRAM_BUDGET_TRANSFER", "RFI", "IDEA", "PROGRAM", "POTENTIAL_CHANGE_ORDER", "CHANGE_EVENTS" ]
The kind of object that the workflow runs against or displays information about. -
dueDate: string
(date-time)
The date by which the workflow should be completed. If a workflow is not completed by its due date, then the system notifies the workflow manager and marks the workflow as overdue
-
managers: array
managers
User/s who were assigned to manage the workflow instance.
-
plannedDuration: number
(double)
Duration in days that was planned for the workflow instance to be completed. Post this duration the workflow instance will be marked as overdue.
-
startedBy: string
Maximum Length:
0
The user who started the workflow instance. -
startedDate: string
(date-time)
The date and time the workflow instance started.
-
status: string
Allowed Values:
[ "EXECUTING", "FINISHED", "HALTED", "PENDING", "STOPPED" ]
The status of the workflow instance. A workflow instance can have a status of In Progress, Finished, Overdue, Failed, Pending, or Stopped. -
workflowConfigurationName: string
Maximum Length:
255
The name of the workflow configuration. Task performers and workflow managers identify running workflows by the names of their configurations. -
workflowInstanceId: integer
(int64)
System generated unique identifier of the workflow instance.
-
workflowInstanceName: string
Maximum Length:
255
Name of the workflow instance within which the task is configured. -
workspaceCode: string
Maximum Length:
60
The user-specified identifier of a workspace. -
workspaceId: integer
(int64)
The unique identifier of a workspace.
-
workspaceName: string
Maximum Length:
255
Name of a workspace.
Nested Schema : managers
Type:
array
User/s who were assigned to manage the workflow instance.
Show Source
204 Response
Successful operation with no content.
400 Response
Invalid Input.