Update commentedit

Updates an existing comment.

Request URLedit

PATCH <kibana host>:<port>/api/cases/<case ID>/comments

URL partsedit

The URL must include the case ID of the comment’s associated case. Call Find cases to retrieve case IDs.

Request bodyedit

A JSON object with the updated comment:

Name Type Description Required

type

String

The comment type, which can be user or alert.

Yes

comment

String

The updated comment.

Yes, only when type is user.

alertId

String

The updated alert id.

Yes, only when type is alert.

index

String

The updated alert index.

Yes, only when type is alert.

id

String

The comment’s ID.

Yes

version

String

The current comment version.

Yes

Call Get all case comments to retrieve comment IDs and version values.

Comment type cannot be updated.

Example requestedit

Updates comment ID 8af6ac20-74f6-11ea-b83a-553aecdb28b6 (associated with case ID 293f1bc0-74f6-11ea-b83a-553aecdb28b6):

PATCH api/cases/293f1bc0-74f6-11ea-b83a-553aecdb28b6/comments
{
  "id": "8af6ac20-74f6-11ea-b83a-553aecdb28b6",
  "type": "user",
  "comment": "That is nothing - Ethan Hunt answered a targeted social
  media campaign promoting phishy pension schemes to IMF operatives.
  Even worse, he likes baked beans.",
  "version": "Wzk1LDFd"
}

Response codeedit

200
Indicates a successful call.

Response payloadedit

The updated JSON case object with the updated comment, the user who updated the comment, and the comment’s ID, version, and update time.

Example responseedit

{
  "id": "293f1bc0-74f6-11ea-b83a-553aecdb28b6",
  "version": "WzIwNjM2LDFd",
  "comments": [
    {
      "id": "8af6ac20-74f6-11ea-b83a-553aecdb28b6",
      "version": "WzIwNjM3LDFd",
      "type": "user",
      "comment": "That is nothing - Ethan Hunt answered a targeted social media campaign promoting phishy pension schemes to IMF operatives.",
      "created_at": "2020-04-02T15:28:03.034Z",
      "created_by": {
        "email": "moneypenny@hms.gov.uk",
        "full_name": "Ms Moneypenny",
        "username": "moneypenny"
      },
      "pushed_at": null,
      "pushed_by": null,
      "updated_at": "2020-04-02T15:34:01.118Z",
      "updated_by": {
        "email": "jbond@hms.gov.uk",
        "full_name": "James Bond",
        "username": "_007"
      }
    }
  ],
  "totalComment": 1,
  "title": "This case will self-destruct in 5 seconds",
  "tags": [
    "phishing",
    "social engineering"
  ],
  "description": "James Bond clicked on a highly suspicious email banner advertising cheap holidays for underpaid civil servants.",
  "closed_at": null,
  "closed_by": null,
  "created_at": "2020-04-02T15:25:19.088Z",
  "created_by": {
    "email": "ahunley@imf.usa.gov",
    "full_name": "Alan Hunley",
    "username": "ahunley"
  },
  "external_service": null,
  "status": "open",
  "updated_at": "2020-04-02T15:34:01.118Z",
  "updated_by": {
    "email": "jbond@hms.gov.uk",
    "full_name": "James Bond",
    "username": "_007"
  }
}