GET /v1/users
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:
|
| filter[usergroup] |
Specify user group ID. Assembla provides the following predefined user group IDs:
|
Examples
Request XML, using cURL utility:
curl -i -H "Authorization: Bearer _token" https://api.assembla.com/v1/users.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"?>
<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://api.assembla.com/v1/users.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": "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