HTTP Verb: GET

Available statuses: 200 OK, 204 No Content, 404 Not Found

Object: Comment

Location: n/a

Formats: XML, JSON

Returns a list of merge request comments from all versions.

Params

Param Description
page Parameter to specify which page to request, see per_page to determine how many items per page.
per_page Specify the number of comments fetched per one page, default is 10.

Examples

Request JSON, using cURL utility:

curl -i -H "Authorization: Bearer _token" https://api.assembla.com/v1/spaces/_space_id/space_tools/_space_tool_id/merge_requests/_merge_request_id/comments.json

Response

HTTP/1.1 200 OK
Server: nginx/0.7.68
Date: Tue, 24 Jul 2012 13:03:50 GMT
Content-Type: application/json; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Status: 200
...

[
  {
    "merge_request_id":1,
    "content":"Comment",
    "updated_at":"2012-08-08T10:54:43Z",
    "space_id":"c18Z_-ptqr4y87ab_q0pIh",
    "id":2,
    "created_at":"2012-08-08T10:54:43Z",
    "user_id":"aeF1CInHCr4ybVab_q0pIh"
  },
  ...
]

JSON is formatted here for readability, in a real response JSON body is inline with no indentation.

Request XML, using cURL utility:

curl -i -H "Authorization: Bearer _token" https://api.assembla.com/v1/spaces/_space_id/space_tools/_space_tool_id/merge_requests/[merge_request_id]/comments.xml

Response

HTTP/1.1 200 OK
Server: nginx/0.7.68
Date: Tue, 24 Jul 2012 13:21:38 GMT
Content-Type: application/xml; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Status: 200
...

<?xml version="1.0" encoding="UTF-8"?>
<comments type="array">
  <comment>
    <merge-request-id type="integer">1</merge-request-id>
    <content>Comment</content>
    <updated-at type="datetime">2012-08-08T10:54:43Z</updated-at>
    <space-id>c18Z_-ptqr4y87ab_q0pIh</space-id>
    <id type="integer">2</id>
    <created-at type="datetime">2012-08-08T10:54:43Z</created-at>
    <user-id>aeF1CInHCr4ybVab_q0pIh</user-id>
  </comment>
  ...
</comments>

Description for each field: comment object fields reference