Skip to main content

GET /tasks/{job_id}/notes

Use this method to return the notes history for a specific job (task).

Authentication

Authentication with username and password is required.

Request URL

GET https://{management_server_IP}/tasks/{job_id}/notes

where {job_id} is the job ID To obtain the job IDs, use GET /tasks method.

Query parameters

None

Request body

None

Response codes

CodeDescriptionComments
200OKThe request completed successfully.
500Internal Server ErrorAn internal error occurred. A descriptive error message is returned in the response body.

Response body

AttributesTypeDescription
createdByStringName of the user that added the note or changed the state
idStringNote ID
jobUIDStringJob ID
newStateStringCurrent Job state. This can be one of the following values.
  • Aborted
  • Investigating
  • Resolved
previousStateStringPrevious state of the job
  • Aborted
  • CancelledWithErrors
  • CompleteWithErrors
  • InterruptedWithError
  • Investigating
  • Resolved
  • StoppedWithError
textStringNote text
timeStampStringTimestamp when the note was entered or the state was changed
translatedNewStateStringTranslated current state
translatedPrevStateStringTranslated previous state
The following example is returned if the request is successful.
[{
"createdBy": "USERID",
"id": "1",
"jobUID": "4778",
"newState": "Working",
"previousState": "StoppedWithError",
"text": " Investigating the problem.",
"timeStamp": "2017-12-14T12:00:56Z",
"translatedNewState": "Working",
"translatedPrevState": "StoppedWithError"
}
{
"createdBy": "USERID",
"id": "2",
"jobUID": "4778",
"newState": "Resolved",
"previousState": " Working",
"text": "The issue was fixed.",
"timeStamp": "2017-12-14T12:59:56Z",
"translatedNewState": "Resolved",
"translatedPrevState": "Working"
}]