GET /v1/groups

Returns a list of groups.

Params

Param	Description
type	Specify group type. Valid group types include space and user.

Examples

Request XML, using cURL utility:

curl -i -H "Authorization: Bearer _token" https://api.assembla.com/v1/groups.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"?>
<groups type="array">
  <group>
    <id type="integer">19</id>
    <name>Group Name</name>
    <portfolio-id>cJiq3KDNyr4PMj5bfBjDYC</portfolio-id>
    <type>space</type>
    <items type="array">
      <item>dCDf9QDNyr4PMj5bfBjDYC</item>
      <item>deug5QDNyr4PMj5bfBjDYC</item>
    </items>
  </group>
  ...
</groups>

Request JSON, using cURL utility:

curl -i -H "Authorization: Bearer _token" https://api.assembla.com/v1/groups.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": "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