Sign in
Incident

Get List

Queries for incidents that fulfill given parameters. The size of the result set can be retrieved by using the Get Incident Count method.

get/incident

Request

  • Base URL: http://localhost:8080/engine-rest
  • URL: http://localhost:8080/engine-rest/incident
  • Auth: HTTP basic

Query parameters

incidentIdstring

Restricts to incidents that have the given id.

incidentTypestring

Restricts to incidents that belong to the given incident type. See the User Guide for a list of incident types.

incidentMessagestring

Restricts to incidents that have the given incident message.

incidentMessageLikestring

Restricts to incidents that incidents message is a substring of the given value. The string can include the wildcard character '%' to express like-strategy: starts with (string%), ends with (%string) or contains (%string%).

processDefinitionIdstring

Restricts to incidents that belong to a process definition with the given id.

processDefinitionKeyInstring

Restricts to incidents that belong to a process definition with the given keys. Must be a comma-separated list.

processInstanceIdstring

Restricts to incidents that belong to a process instance with the given id.

executionIdstring

Restricts to incidents that belong to an execution with the given id.

incidentTimestampBeforestring date-time

Restricts to incidents that have an incidentTimestamp date before the given date. By default, the date must have the format yyyy-MM-dd'T'HH:mm:ss.SSSZ, e.g., 2013-01-23T14:42:45.000+0200.

incidentTimestampAfterstring date-time

Restricts to incidents that have an incidentTimestamp date after the given date. By default, the date must have the format yyyy-MM-dd'T'HH:mm:ss.SSSZ, e.g., 2013-01-23T14:42:45.000+0200.

activityIdstring

Restricts to incidents that belong to an activity with the given id.

failedActivityIdstring

Restricts to incidents that were created due to the failure of an activity with the given id.

causeIncidentIdstring

Restricts to incidents that have the given incident id as cause incident.

rootCauseIncidentIdstring

Restricts to incidents that have the given incident id as root cause incident.

configurationstring

Restricts to incidents that have the given parameter set as configuration.

tenantIdInstring

Restricts to incidents that have one of the given comma-separated tenant ids.

jobDefinitionIdInstring

Restricts to incidents that have one of the given comma-separated job definition ids.

sortBy'incidentId' | 'incidentMessage' | 'incidentTimestamp' | 'incidentType' | 'executionId' | 'activityId' | 'processInstanceId' | 'processDefinitionId' | 'causeIncidentId' | 'rootCauseIncidentId' | 'configuration' | 'tenantId'

Sort the results lexicographically by a given criterion. Must be used in conjunction with the sortOrder parameter.

sortOrder'asc' | 'desc'

Sort the results in a given order. Values may be asc for ascending order or desc for descending order. Must be used in conjunction with the sortBy parameter.

firstResultinteger

Pagination of results. Specifies the index of the first result to return.

maxResultsinteger

Pagination of results. Specifies the maximum number of results to return. Will return less results if there are no more results left.

Response

Request successful.

idstring nullable

The id of the incident.

processDefinitionIdstring nullable

The id of the process definition this incident is associated with.

processInstanceIdstring nullable

The id of the process instance this incident is associated with.

executionIdstring nullable

The id of the execution this incident is associated with.

incidentTimestampstring date-time nullable

The time this incident happened. By default, the date must have the format yyyy-MM-dd'T'HH:mm:ss.SSSZ, e.g., 2013-01-23T14:42:45.000+0200.

incidentTypestring nullable

The type of incident, for example: failedJobs will be returned in case of an incident which identified a failed job during the execution of a process instance. See the User Guide for a list of incident types.

activityIdstring nullable

The id of the activity this incident is associated with.

failedActivityIdstring nullable

The id of the activity on which the last exception occurred.

causeIncidentIdstring nullable

The id of the associated cause incident which has been triggered.

rootCauseIncidentIdstring nullable

The id of the associated root cause incident which has been triggered.

configurationstring nullable

The payload of this incident.

tenantIdstring nullable

The id of the tenant this incident is associated with.

incidentMessagestring nullable

The message of this incident.

jobDefinitionIdstring nullable

The job definition id the incident is associated with.

annotationstring nullable

The annotation set to the incident.

Changes

No recorded changes to this operation across all 1 revision of this API.