Projects

Returns a task's comments, newest first.

Cursor-paginated. Filter from broadest to narrowest: send nothing for every comment; conversationType to select kinds; or a single conversationType together with conversationId for one specific conversation.

Attachment and inline-image links carry a time-limited access token that expires, so fetch the comment again rather than storing a url.

A comment that arrived by email stores its body outside the document, and this list does not fetch it: such a row carries BodyTruncated: true with an empty BodyHtml/BodyText. Read the single comment to get the full body.

GET

projects

{projectId}

tasks

{taskId}

comments

Returns a task's comments, newest first.

curl --request GET \
  --url https://api.usw.gorelo.io/v1/projects/{projectId}/tasks/{taskId}/comments \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://api.usw.gorelo.io/v1/projects/{projectId}/tasks/{taskId}/comments"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.usw.gorelo.io/v1/projects/{projectId}/tasks/{taskId}/comments', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.usw.gorelo.io/v1/projects/{projectId}/tasks/{taskId}/comments",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.usw.gorelo.io/v1/projects/{projectId}/tasks/{taskId}/comments"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.usw.gorelo.io/v1/projects/{projectId}/tasks/{taskId}/comments")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "StatusCode": 100,
  "IsSuccess": true,
  "Data": [
    {
      "BodyTruncated": true,
      "Id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "ConversationId": "<string>",
      "ConversationType": {
        "Id": 1,
        "Name": "<string>"
      },
      "Source": {
        "Id": 1,
        "Name": "<string>"
      },
      "BodyHtml": "<string>",
      "BodyText": "<string>",
      "Author": {
        "Type": "<string>",
        "Id": 123,
        "Name": "<string>",
        "Email": "<string>"
      },
      "EmailInfo": {
        "Status": {
          "Id": 1,
          "Name": "<string>"
        },
        "ErrorDetail": "<string>"
      },
      "Attachments": [
        {
          "Name": "<string>",
          "Url": "<string>"
        }
      ],
      "SentimentScore": 123,
      "Reactions": [
        {
          "UserId": 123,
          "ReactionId": 123
        }
      ],
      "CreatedOn": "2023-11-07T05:31:56Z",
      "UpdatedOn": "2023-11-07T05:31:56Z"
    }
  ],
  "DataContext": {
    "Pagination": {
      "NextCursor": "<string>",
      "PreviousCursor": "<string>",
      "HasMore": true,
      "HasPrevious": true,
      "TotalCount": 123
    }
  },
  "Notifications": [
    {
      "Code": "070101",
      "Message": "<string>",
      "PropertyName": "<string>",
      "ActionHint": "<string>",
      "DocUrl": "<string>"
    }
  ]
}

{
  "StatusCode": 100,
  "IsSuccess": true,
  "Data": null,
  "DataContext": {
    "TraceId": "<string>"
  },
  "Notifications": [
    {
      "Code": "070101",
      "Message": "<string>",
      "PropertyName": "<string>",
      "ActionHint": "<string>",
      "DocUrl": "<string>"
    }
  ]
}

{
  "StatusCode": 100,
  "IsSuccess": true,
  "Data": null,
  "DataContext": {
    "TraceId": "<string>"
  },
  "Notifications": [
    {
      "Code": "070101",
      "Message": "<string>",
      "PropertyName": "<string>",
      "ActionHint": "<string>",
      "DocUrl": "<string>"
    }
  ]
}

{
  "StatusCode": 100,
  "IsSuccess": true,
  "Data": null,
  "DataContext": {
    "TraceId": "<string>"
  },
  "Notifications": [
    {
      "Code": "070101",
      "Message": "<string>",
      "PropertyName": "<string>",
      "ActionHint": "<string>",
      "DocUrl": "<string>"
    }
  ]
}

{
  "StatusCode": 100,
  "IsSuccess": true,
  "Data": null,
  "DataContext": {
    "TraceId": "<string>"
  },
  "Notifications": [
    {
      "Code": "070101",
      "Message": "<string>",
      "PropertyName": "<string>",
      "ActionHint": "<string>",
      "DocUrl": "<string>"
    }
  ]
}

التفويضات

X-API-Key

string

header

مطلوب

Your Gorelo API key. See Generate API key. If your data is hosted in Australia, click the base URL at the top of this page and select https://api.aue.gorelo.io.

معلمات المسار

projectId

string<uuid>

مطلوب

Project the task belongs to.

taskId

string<uuid>

مطلوب

Task whose comments to return.

معلمات الاستعلام

Cursor

string

Cursor from a previous page.

PageSize

integer<int32>

افتراضي:50

Comments per page, 1-200. Defaults to 50.

SortBy

string

افتراضي:createdOn

Sort field: createdOn.

SortOrder

string

افتراضي:desc

desc (default, newest first) or asc.

ConversationType

string

Kinds to include: 1 Public, 2 Private, 3 Side Conversation, 4 Approval. Comma-separated on its own; a single value when paired with conversationId.

ConversationId

string

Identifier of the single conversation to read, from the conversations endpoint. Requires a single conversationType.

الاستجابة

StatusCode

enum<integer>

الخيارات المتاحة:

100,

101,

102,

103,

200,

201,

202,

203,

204,

205,

206,

207,

208,

226,

300,

301,

302,

303,

304,

305,

306,

307,

308,

400,

401,

402,

403,

404,

405,

406,

407,

408,

409,

410,

411,

412,

413,

414,

415,

416,

417,

421,

422,

423,

424,

426,

428,

429,

431,

451,

500,

501,

502,

503,

504,

505,

506,

507,

508,

510,

511

IsSuccess

boolean

Data

object[] | null

Show child attributes

DataContext

object

The DataContext of a cursor-paginated success response: carries the paging metadata for the returned page.

Show child attributes

Notifications

object[]

Show child attributes

⌘I

Returns a task's comments, newest first.

curl --request GET \
  --url https://api.usw.gorelo.io/v1/projects/{projectId}/tasks/{taskId}/comments \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://api.usw.gorelo.io/v1/projects/{projectId}/tasks/{taskId}/comments"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.usw.gorelo.io/v1/projects/{projectId}/tasks/{taskId}/comments', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.usw.gorelo.io/v1/projects/{projectId}/tasks/{taskId}/comments",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.usw.gorelo.io/v1/projects/{projectId}/tasks/{taskId}/comments"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.usw.gorelo.io/v1/projects/{projectId}/tasks/{taskId}/comments")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "StatusCode": 100,
  "IsSuccess": true,
  "Data": [
    {
      "BodyTruncated": true,
      "Id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "ConversationId": "<string>",
      "ConversationType": {
        "Id": 1,
        "Name": "<string>"
      },
      "Source": {
        "Id": 1,
        "Name": "<string>"
      },
      "BodyHtml": "<string>",
      "BodyText": "<string>",
      "Author": {
        "Type": "<string>",
        "Id": 123,
        "Name": "<string>",
        "Email": "<string>"
      },
      "EmailInfo": {
        "Status": {
          "Id": 1,
          "Name": "<string>"
        },
        "ErrorDetail": "<string>"
      },
      "Attachments": [
        {
          "Name": "<string>",
          "Url": "<string>"
        }
      ],
      "SentimentScore": 123,
      "Reactions": [
        {
          "UserId": 123,
          "ReactionId": 123
        }
      ],
      "CreatedOn": "2023-11-07T05:31:56Z",
      "UpdatedOn": "2023-11-07T05:31:56Z"
    }
  ],
  "DataContext": {
    "Pagination": {
      "NextCursor": "<string>",
      "PreviousCursor": "<string>",
      "HasMore": true,
      "HasPrevious": true,
      "TotalCount": 123
    }
  },
  "Notifications": [
    {
      "Code": "070101",
      "Message": "<string>",
      "PropertyName": "<string>",
      "ActionHint": "<string>",
      "DocUrl": "<string>"
    }
  ]
}

{
  "StatusCode": 100,
  "IsSuccess": true,
  "Data": null,
  "DataContext": {
    "TraceId": "<string>"
  },
  "Notifications": [
    {
      "Code": "070101",
      "Message": "<string>",
      "PropertyName": "<string>",
      "ActionHint": "<string>",
      "DocUrl": "<string>"
    }
  ]
}

{
  "StatusCode": 100,
  "IsSuccess": true,
  "Data": null,
  "DataContext": {
    "TraceId": "<string>"
  },
  "Notifications": [
    {
      "Code": "070101",
      "Message": "<string>",
      "PropertyName": "<string>",
      "ActionHint": "<string>",
      "DocUrl": "<string>"
    }
  ]
}

{
  "StatusCode": 100,
  "IsSuccess": true,
  "Data": null,
  "DataContext": {
    "TraceId": "<string>"
  },
  "Notifications": [
    {
      "Code": "070101",
      "Message": "<string>",
      "PropertyName": "<string>",
      "ActionHint": "<string>",
      "DocUrl": "<string>"
    }
  ]
}

{
  "StatusCode": 100,
  "IsSuccess": true,
  "Data": null,
  "DataContext": {
    "TraceId": "<string>"
  },
  "Notifications": [
    {
      "Code": "070101",
      "Message": "<string>",
      "PropertyName": "<string>",
      "ActionHint": "<string>",
      "DocUrl": "<string>"
    }
  ]
}