GET /v1/groups/:id
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://api.assembla.com/v1/groups/_id.xml?portfolio=_portfolio_subdomain
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://api.assembla.com/v1/groups/_id.json?portfolio=_portfolio_subdomain
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