Problems API - POST a comment

Adds a comments to the specified problem.

The request consumes and produces an application/json payload.

POST	Managed https://{your-domain}/e/{your-environment-id}/api/v1/problem/details/{problemId}/comments SaaS https://{your-environment-id}.live.dexp.ae/api/v1/problem/details/{problemId}/comments

Authentication

To execute this request, you need the Access problem and event feed, metrics, and topology permission assigned to your API token. See the Authentication page to learn how to obtain and use it.

Parameters

Parameter	Type	Description	In	Required
problemId	string	The ID of the problem where you want to add the comment.	path	required
body	PushProblemComment	JSON body of the request, containing the comment.	body	optional

Request parameters JSON model

The PushProblemComment object

A comment of a problem

Element	Type	Description	Required
comment	string	A comment on the problem.	required
user	string	The author of the comment.	required
context	string	The context of the comment. It can contain any additional information.	optional

This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request. See the Example expandable section for working sample request.

      
  {
  "comment": "This is a comment!",
  "user": "user1",
  "context": "Slack"
}

Response format

Response parameters JSON model

The ProblemComment object

The comment to the problem.

Element	Type	Description
id	string	The ID of the comment.
createdAtTimestamp	integer	The timestamp of the comment creation, in UTC milliseconds.
content	string	The text of the comment.
userName	string	The author of the comment.
context	string	The context of the comment. Could be any textual comment. You can only set it via REST API.

    
{
  "id": "string",
  "createdAtTimestamp": 0,
  "content": "string",
  "userName": "string",
  "context": "string"
}

Example

In this example, the request adds a new comment on the problem with ID 2307087411653364173_1538400720000V2.

The API token is passed in the Authorization header.

Curl

curl -X POST \
  https://mySampleEnv.live.dexp.ae/api/v1/problem/details/2307087411653364173_1538400720000V2/comments \
  -H 'Authorization: Api-Token abcdefjhij1234567890' \
  -H 'Content-Type: application/json' \  
  -d '{
  "comment": "This one is probably caused by network",
  "user": "john.smith",
  "context": "Slack"
}'

Request URL

https://mySampleEnv.live.dexp.ae/api/v1/problem/details/2307087411653364173_1538400720000V2/comments

Request body

{
  "comment": "This one is probably caused by network",
  "user": "john.smith",
  "context": "Slack"
}

Response body

{
    "id": "-6026872125973307382_1538400720000",
    "createdAtTimestamp": 1538559856030,
    "content": "This one is probably caused by network",
    "userName": "john.smith",
    "context": "Slack"
}

Response code

200