알러트 댓글

알러트 댓글에 대한 REST API 작업

개요

다음 API 작업을 사용하여 상호작용하세요 알러트 댓글 Panther에서.

API를 호출하려면, Panther REST API 사용 방법 지침을 참조하세요— 이 문서 페이지에서 직접 호출하는 방법에 대한 지침을 포함합니다.

필요 권한

• 에 대해 GET 작업의 경우, API 토큰에는 알러트 읽기 권한이 있어야 합니다.

• 에 대해 POST 작업의 경우, API 토큰에는 알러트 관리 권한이 있어야 합니다.

작업

Create a comment for an alert

post

Authorizations

ApiKeyAuth

X-API-KeystringRequired

Body

application/json

alertIdstringRequired

The alert ID the comment is associated with

bodystringRequired

The body of the comment

formatstring · enumRequired

The format of the comment

Possible values:

Responses

200

OK response.

application/json

alertIdstringOptional

The alert ID the comment is associated with

bodyanyOptional

The body of the comment

createdAtstringOptional

The date the comment was created

formatstring · enumOptional

The format of the comment

Possible values:

idstringOptional

The comment ID

updatedAtstringOptional

The date the comment was updated

400

bad_request: Bad Request response.

application/json

404

not_found: Not Found response.

application/json

post

/alert-comments

HTTPcURLJavaScriptPython

POST /alert-comments HTTP/1.1
Host: your-api-host
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 54

{
  "alertId": "text",
  "body": "text",
  "format": "PLAIN_TEXT"
}

{
  "alertId": "text",
  "body": null,
  "createdAt": "text",
  "createdBy": {
    "id": "user",
    "type": "text"
  },
  "format": "PLAIN_TEXT",
  "id": "text",
  "updatedAt": "text",
  "updatedBy": {
    "id": "user",
    "type": "text"
  }
}

Get a comment for an alert

get

Authorizations

ApiKeyAuth

X-API-KeystringRequired

Path parameters

idstringRequired

ID of the comment

Responses

200

OK response.

application/json

alertIdstringOptional

The alert ID the comment is associated with

bodyanyOptional

The body of the comment

createdAtstringOptional

The date the comment was created

formatstring · enumOptional

The format of the comment

Possible values:

idstringOptional

The comment ID

updatedAtstringOptional

The date the comment was updated

400

bad_request: Bad Request response.

application/json

404

not_found: Not Found response.

application/json

get

/alert-comments/{id}

HTTPcURLJavaScriptPython

GET /alert-comments/{id} HTTP/1.1
Host: your-api-host
X-API-Key: YOUR_API_KEY
Accept: */*

{
  "alertId": "text",
  "body": null,
  "createdAt": "text",
  "createdBy": {
    "id": "user",
    "type": "text"
  },
  "format": "PLAIN_TEXT",
  "id": "text",
  "updatedAt": "text",
  "updatedBy": {
    "id": "user",
    "type": "text"
  }
}

Update a comment for an alert

post

Authorizations

ApiKeyAuth

X-API-KeystringRequired

Path parameters

idstringRequired

ID of the comment

Body

application/json

alertIdstringRequired

The alert ID the comment is associated with

bodystringRequired

The body of the comment

formatstring · enumRequired

The format of the comment

Possible values:

Responses

200

OK response.

application/json

alertIdstringOptional

The alert ID the comment is associated with

bodyanyOptional

The body of the comment

createdAtstringOptional

The date the comment was created

formatstring · enumOptional

The format of the comment

Possible values:

idstringOptional

The comment ID

updatedAtstringOptional

The date the comment was updated

400

bad_request: Bad Request response.

application/json

404

not_found: Not Found response.

application/json

post

/alert-comments/{id}

HTTPcURLJavaScriptPython

POST /alert-comments/{id} HTTP/1.1
Host: your-api-host
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 54

{
  "alertId": "text",
  "body": "text",
  "format": "PLAIN_TEXT"
}

{
  "alertId": "text",
  "body": null,
  "createdAt": "text",
  "createdBy": {
    "id": "user",
    "type": "text"
  },
  "format": "PLAIN_TEXT",
  "id": "text",
  "updatedAt": "text",
  "updatedBy": {
    "id": "user",
    "type": "text"
  }
}

List alert comments

get

Authorizations

ApiKeyAuth

X-API-KeystringRequired

Query parameters

alert-idstringRequired

The alert ID the comments are associated with

cursorstringOptional

the pagination token

limitinteger · int64 · max: 50Optional

the maximum results to return

Default: 25

Responses

200

OK response.

application/json

nextstringOptional

Pagination token for the next page of results

400

bad_request: Bad Request response.

application/json

get

/alert-comments

HTTPcURLJavaScriptPython

GET /alert-comments?alert-id=text HTTP/1.1
Host: your-api-host
X-API-Key: YOUR_API_KEY
Accept: */*

{
  "next": "text",
  "results": [
    {
      "alertId": "text",
      "body": null,
      "createdAt": "text",
      "createdBy": {
        "id": "user",
        "type": "text"
      },
      "format": "PLAIN_TEXT",
      "id": "text",
      "updatedAt": "text",
      "updatedBy": {
        "id": "user",
        "type": "text"
      }
    }
  ]
}