Skip to main content

POST /tasks/{job_id}/notes

Use this method to create a note and change the state of a specific job (task).

Authentication

Authentication with username and password is required.

Request URL

POST 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

AttributesRequired / OptionalTypeDescription
newStateRequired if text is not specified; otherwise, optional.StringsJob state. This can be one of the following values:
  • Aborted
  • Investigating
  • Resolved
textRequired if newState is not specified; otherwise, optional.StringsNote text
The following example creates a note.
{
"newState": "Working",
"text": "Investigating the problem."
}

Response codes

CodeDescriptionComments
200OKThe request completed successfully.
400Bad RequestA query parameter or request attribute is missing or not valid, or the operation is not supported. A descriptive error message is returned in the response body.
500Internal Server ErrorAn internal error occurred. A descriptive error message is returned in the response body.

Response body

None