HTTP Verb: GET

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

Object: Milestone

Location: n/a

Formats: XML, JSON

Returns a list of milestones that are considered releases, these milestones have release notes field filed.

Params

Param Description
page Milestones are paginated, by default 10 milestones per page, to access pages set the page=_page_number parameter.
per_page To change the size of a page, change this parameter to corresponding size.
due_date_order Two values are available ASC(default) and DESC, set the sorting order by due date for milestones.

Examples

Request JSON, using cURL utility:

curl -i -H "Authorization: Bearer _token" https://api.assembla.com/v1/spaces/_space_id/milestones/release_notes.json

Response

HTTP/1.1 200 OK
Server: nginx/0.8.55
Date: Thu, 19 Jul 2012 11:46:28 GMT
Content-Type: application/json; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Status: 200
...

[
  {
    "planner_type":0,
    "pretty_relese_level":"None",
    "release_notes":null,
    "description":"sdfsd",
    "release_level":null,
    "completed_date":null,
    "created_by":"bRxpnOMYWr4id7adbNA33N",
    "due_date":null,
    "is_completed":false,
    "updated_by":"bgnP_qA1Gr2QjIaaaHk9wZ",
    "updated_at":"2012-05-30T09:12:14Z",
    "created_at":"2011-07-26T08:09:25Z",
    "title":"dsa",
    "user_id":null,
    "id":3,
    "space_id":"b89TL8MYWr4id7adbNA33N"
  },
  ...
]

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/milestones/release_notes.xml

Response

HTTP/1.1 200 OK
Server: nginx/0.8.55
Date: Thu, 19 Jul 2012 11:44:49 GMT
Content-Type: application/xml; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Status: 200
...

<?xml version="1.0" encoding="UTF-8"?>
<milestones type="array">
  <milestone>
    <planner-type type="integer">0</planner-type>
    <pretty-relese-level>None</pretty-relese-level>
    <release-notes nil="true"></release-notes>
    <description>sdfsd</description>
    <release-level nil="true"></release-level>
    <completed-date nil="true"></completed-date>
    <created-by>bRxpnOMYWr4id7adbNA33N</created-by>
    <due-date nil="true"></due-date>
    <is-completed type="boolean">false</is-completed>
    <updated-by>bgnP_qA1Gr2QjIaaaHk9wZ</updated-by>
    <updated-at type="datetime">2012-05-30T09:12:14Z</updated-at>
    <created-at type="datetime">2011-07-26T08:09:25Z</created-at>
    <title>dsa</title>
    <user-id nil="true"></user-id>
    <id type="integer">3</id>
    <space-id>b89TL8MYWr4id7adbNA33N</space-id>
  </milestone>
  ...
</milestones>

Description for each field: milestone object fields reference