HTTP Verb: GET

Available statuses: 200 OK, 404 Not Found

Object: Group

Location: n/a

Formats: XML, JSON

Returns a group by id.

Params

Not available

Examples

Request XML, using cURL utility:

curl -i -H "Authorization: Bearer _token" https://_portfolio_subdomain.api.assembla.com/v1/groups/_id.xml

Response:

HTTP/1.1 200 OK
Server: nginx/0.8.55
Date: Fri, 07 Sep 2012 13:08:42 GMT
Content-Type: application/xml; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Status: 200
...

<?xml version="1.0" encoding="UTF-8"?>
<group>
  <id type="integer">19</id>
  <name>Active Spaces</name>
  <portfolio-id>cJiq3KDNyr4PMj5bfBjDYC</portfolio-id>
  <type>space</type>
  <items type="array">
    <item>dCDf9QDNyr4PMj5bfBjDYC</item>
    <item>deug5QDNyr4PMj5bfBjDYC</item>
  </items>
</group>

Request JSON, using cURL utility:

curl -i -H "Authorization: Bearer _token" https://_portfolio_subdomain.api.assembla.com/v1/groups/_id.json

Response:

HTTP/1.1 200 OK
Server: nginx/0.8.55
Date: Fri, 07 Sep 2012 13:12:30 GMT
Content-Type: application/json; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Status: 200
...

{
  "id": 19,
  "name": "New Group Name",
  "portfolio_id": "cJiq3KDNyr4PMj5bfBjDYC",
  "type": "space",
  "items": [
    "dCDf9QDNyr4PMj5bfBjDYC",
    "deug5QDNyr4PMj5bfBjDYC"
  ]
}

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

Description for each field: Group object fields reference