Query flow node instances (alpha)
POST/flownode-instances/search
Search for flow node instances based on given criteria.
Note that this endpoint is an alpha feature and not enabled on Camunda clusters out of the box. The Camunda 8 API (REST) Overview page provides further details.
This endpoint is an alpha feature and may be subject to change in future releases.
Request
- application/json
Body
- Array [
- ]
sort object[]
Default value: asc
page object
filter object
The assigned key, which acts as a unique identifier for this flow node instance.
The process instance key associated to this flow node instance.
The process definition key associated to this flow node instance.
The process definition ID associated to this flow node instance.
Possible values: [ACTIVE
, COMPLETED
, TERMINATED
]
State of flow node instance as defined set of values.
Possible values: [UNSPECIFIED
, PROCESS
, SUB_PROCESS
, EVENT_SUB_PROCESS
, START_EVENT
, INTERMEDIATE_CATCH_EVENT
, INTERMEDIATE_THROW_EVENT
, BOUNDARY_EVENT
, END_EVENT
, SERVICE_TASK
, RECEIVE_TASK
, USER_TASK
, MANUAL_TASK
, TASK
, EXCLUSIVE_GATEWAY
, INCLUSIVE_GATEWAY
, PARALLEL_GATEWAY
, EVENT_BASED_GATEWAY
, SEQUENCE_FLOW
, MULTI_INSTANCE_BODY
, CALL_ACTIVITY
, BUSINESS_RULE_TASK
, SCRIPT_TASK
, SEND_TASK
, UNKNOWN
]
Type of flow node as defined set of values.
The flow node ID for this flow node instance.
The flow node name.
The path of keys from process instance to this flow node instance separated by '/'.
Shows whether this flow node instance has an incident related to.
The key of incident if field incident is true.
The tenant ID.
Responses
- 200
- 400
- 500
The flow node instance search result.
- application/json
- Schema
- Example (from schema)
Schema
- Array [
- ]
page object
items object[]
The assigned key, which acts as a unique identifier for this flow node instance.
The process instance key associated to this flow node instance.
The process definition key associated to this flow node instance.
The process definition ID associated to this flow node instance.
Date when flow node instance started.
Date when flow node instance finished.
The flow node ID for this flow node instance.
The path from process instance leading to this flow node instance.
Possible values: [UNSPECIFIED
, PROCESS
, SUB_PROCESS
, EVENT_SUB_PROCESS
, START_EVENT
, INTERMEDIATE_CATCH_EVENT
, INTERMEDIATE_THROW_EVENT
, BOUNDARY_EVENT
, END_EVENT
, SERVICE_TASK
, RECEIVE_TASK
, USER_TASK
, MANUAL_TASK
, TASK
, EXCLUSIVE_GATEWAY
, INCLUSIVE_GATEWAY
, PARALLEL_GATEWAY
, EVENT_BASED_GATEWAY
, SEQUENCE_FLOW
, MULTI_INSTANCE_BODY
, CALL_ACTIVITY
, BUSINESS_RULE_TASK
, SCRIPT_TASK
, SEND_TASK
, UNKNOWN
]
Type of flow node as defined set of values.
Possible values: [ACTIVE
, COMPLETED
, TERMINATED
]
State of flow node instance as defined set of values.
Shows whether this flow node instance has an incident. If true also an incidentKey is provided.
Incident key associated with this flow node instance.
The tenant ID of the incident.
{
"items": [
{
"flowNodeInstanceKey": 0,
"processInstanceKey": 0,
"processDefinitionKey": 0,
"processDefinitionId": "string",
"startDate": "2024-11-14T15:06:47.121Z",
"endDate": "2024-11-14T15:06:47.121Z",
"flowNodeId": "string",
"treePath": "string",
"type": "UNSPECIFIED",
"state": "ACTIVE",
"hasIncident": true,
"incidentKey": 0,
"tenantId": "string"
}
],
"page": {
"totalItems": 0,
"firstSortValues": [
{}
],
"lastSortValues": [
{}
]
}
}
The Flow node instance search query failed. More details are provided in the response body.
- application/problem+json
- Schema
- Example (from schema)
Schema
Default value: about:blank
A URI identifying the problem type.
A summary of the problem type.
Possible values: >= 400
and <= 600
The HTTP status code for this problem.
An explanation of the problem in more detail.
A URI identifying the origin of the problem.
{
"type": "about:blank",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string"
}
An internal error occurred while processing the request.
- application/problem+json
- Schema
- Example (from schema)
Schema
Default value: about:blank
A URI identifying the problem type.
A summary of the problem type.
Possible values: >= 400
and <= 600
The HTTP status code for this problem.
An explanation of the problem in more detail.
A URI identifying the origin of the problem.
{
"type": "about:blank",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string"
}