GET /v1/spaces

Returns a list of spaces user is participating in.

Params

Param	Description
with_tools	Filter spaces by the presence of specific tools. Allowed values: tickets: Spaces having Tickets tools git: Spaces having Git repos svn: Spaces having SVN repos p4: Spaces having P4 repos The parameter represents a comma-separated list of tools to filter by, i.e. with_tools=tickets,git.
with_last_comment	Parameter to specify whether the last ticket comment should be included in the response for every space.
tool_perms	Filter spaces by specific permission for the current user in tools. Allowed values: view: Spaces having tools where user has view permission edit: Spaces having tools where user has edit permission view permission is assumed if the parameter is omitted.

Examples

Request XML, using cURL utility:

curl -i -H "Authorization: Bearer _token" https://api.assembla.com/v1/spaces.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"?>
<spaces type="array">
  <space>
    <status type="integer">1</status>
    <banner-height nil="true"></banner-height>
    <banner nil="true"></banner>
    <updated-at type="datetime">2011-06-20T13:58:06Z</updated-at>
    <last-payer-changed-at nil="true"></last-payer-changed-at>
    <team-tab-role type="integer">0</team-tab-role>
    <created-at type="datetime">2011-06-20T13:58:06Z</created-at>
    <approved type="boolean">false</approved>
    <tabs-order nil="true"></tabs-order>
    <is-commercial type="boolean">false</is-commercial>
    <is-manager type="boolean">false</is-manager>
    <team-permissions type="integer">2</team-permissions>
    <can-join type="boolean">false</can-join>
    <banner-text nil="true"></banner-text>
    <restricted type="boolean">false</restricted>
    <share-permissions type="boolean">true</share-permissions>
    <can-apply type="boolean">true</can-apply>
    <is-volunteer type="boolean">false</is-volunteer>
    <public-permissions type="integer">0</public-permissions>
    <wiki-name>ADMIN</wiki-name>
    <name>ADMIN</name>
    <style nil="true"></style>
    <parent-id nil="true"></parent-id>
    <default-showpage>Wiki</default-showpage>
    <description nil="true"></description>
    <id>dS5eHkVWar2RUfabdgZEU2</id>
    <banner-link nil="true"></banner-link>
    <commercial-from nil="true"></commercial-from>
    <restricted-date nil="true"></restricted-date>
    <watcher-permissions type="integer">1</watcher-permissions>
  </space>
  ...
</spaces>

Request JSON, using cURL utility:

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

[
  {
    "status":1,
    "banner_height":null,
    "banner":null,
    "updated_at":"2011-06-20T13:58:06Z",
    "last_payer_changed_at":null,
    "team_tab_role":0,
    "created_at":"2011-06-20T13:58:06Z",
    "approved":false,
    "tabs_order":null,
    "is_commercial":false,
    "is_manager":false,
    "team_permissions":2,
    "can_join":false,
    "banner_text":null,
    "restricted":false,
    "share_permissions":true,
    "can_apply":true,
    "is_volunteer":false,
    "public_permissions":0,
    "wiki_name":"ADMIN",
    "name":"ADMIN",
    "style":null,
    "parent_id":null,
    "default_showpage":"Wiki",
    "description":null,
    "id":"dS5eHkVWar2RUfabdgZEU2",
    "banner_link":null,
    "commercial_from":null,
    "restricted_date":null,
    "watcher_permissions":1
  },
  ...
]

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

Description for each field: space object fields reference