HTTP Verb: GET

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

Object: User

Location: n/a

Formats: XML, JSON

Returns a list of users.

Params

Param Description
filter[spacegroup] Specify space group ID. Assembla provides the following predefined space group IDs:
  • rule-2: All spaces
  • rule-10: Active spaces
  • rule-11: Archived spaces
  • rule-12: Proposed spaces
  • rule-13: Template spaces
  • rule-14: Shared spaces
Check Portfolio Group API for getting a list of custom groups.
filter[usergroup] Specify user group ID. Assembla provides the following predefined user group IDs:
  • rule-1: All users
  • rule-3: Managers
Check Portfolio Group API for getting a list of custom groups.

Examples

Request XML, using cURL utility:

curl -i -H "Authorization: Bearer _token" https://_portfolio_subdomain.api.assembla.com/v1/users.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"?>
<users type="array">
  <user>
    <id>dd_iFeDNur4PMj5bfBjDYC</id>
    <login>username</login>
    <name>Full Name</name>
    <picture></picture>
    <email>name@domain.com</email>
  </user>
  ...
</users>

Request JSON, using cURL utility:

curl -i -H "Authorization: Bearer _token" https://_portfolio_subdomain.api.assembla.com/v1/users.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": "dd_iFeDNur4PMj5bfBjDYC",
    "login": "username",
    "name": "Full Name",
    "picture": "",
    "email": "name@domain.com"
  },
  ...
]

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

Description for each field: User object fields reference