Retrieves a job by id, according to the Job interface in the engine.

Method

GET /job/{id}

Parameters

Path Parameters

Name Description
id The id of the job to be retrieved.

Result

A JSON object corresponding to the Job interface in the engine. Its properties are as follows:

Name Value Description
id String The id of the job.
jobDefinitionId String The id of the associated job definition.
dueDate String The date on which this job is supposed to be processed.
processInstanceId String The id of the process instance which execution created the job.
executionId String The specific execution id on which the job was created.
processDefinitionId String The id of the process definition which this job belongs to.
processDefinitionKey String The key of the process definition which this job belongs to.
retries Number The number of retries this job has left.
exceptionMessage String The message of the exception that occurred, the last time the job was executed. Is null when no exception occurred.
failedActivityId String The id of the activity on which the last exception occurred, the last time the job was executed. Is null when no exception occurred.
suspended Boolean A flag indicating whether the job is suspended or not.
priority Number The job's priority for execution.
tenantId String The id of the tenant which this job belongs to.
createTime String The date on which this job has been created.

Response Codes

Code Media type Description
200 application/json Request successful.
404 application/json Job with given id does not exist. See the Introduction for the error response format.

Example

Request

GET /job/aJobId

Response

{
  "id": "aJobId",
  "jobDefinitionId": "f9eec330-e3ff-11e8-8f7d-e4a7a094a9d6",
  "dueDate": "2018-07-17T17:00:00+0200",
  "processInstanceId": "aProcessInstanceId",
  "processDefinitionId": "timer:1:f9ee9c1f-e3ff-11e8-8f7d-e4a7a094a9d6",
  "processDefinitionKey": "timer",
  "executionId": "anExecutionId",
  "retries": 0,
  "exceptionMessage": "An exception Message",
  "failedActivityId": "anActivityId",
  "suspended": false,
  "priority": 10,
  "tenantId": null,
  "createTime": "2018-05-05T17:00:00+0200"
}

On this Page: