Comments

List comments for an entity

GET /api/v1/comments

Parameters

Name	In	Type	Required	Description
`entityType`	query	string (project, space, asset, scout)	Yes	—
`entityId`	query	string	Yes	—
`limit`	query	integer	No	Maximum number of items to return.
`offset`	query	integer	No	Number of items to skip.

Example request

curl -X GET \
"https://api.getpilfer.com/api/v1/comments?entityType=<entityType>&entityId=<entityId>&limit=<limit>&offset=<offset>" \
-H "Authorization: Bearer <API_KEY>" \
-H "Content-Type: application/json"

Example response

Status: 200

{
  "data": [
    {
      "_id": "string",
      "entityType": "string",
      "entityId": "string",
      "body": "string",
      "parentCommentId": "string"
    }
  ]
}

Other statuses: 400, 401, 403, 404.

Response body type

{ data: Comment[] }

Create comment

POST /api/v1/comments

Example request

curl -X POST \
"https://api.getpilfer.com/api/v1/comments" \
-H "Authorization: Bearer <API_KEY>" \
-H "Content-Type: application/json"
-d '{"entityType":"project","entityId":"string","body":"string","parentCommentId":"string"}'

Example response

Status: 201

{
  "data": {
    "_id": "string",
    "entityType": "string",
    "entityId": "string",
    "body": "string",
    "parentCommentId": "string"
  }
}

Other statuses: 400, 401, 403, 404.

Response body type

{ data: Comment }