Tags Active
HTTP Verb: GET
Available statuses: 200 OK, 204 No Content, 404 Not Found
Object: Tag
Location: n/a
Formats: XML, JSON
Returns a list of active tags. See states in tag object fields reference.
Params
Param | Description |
---|---|
page | Parameter to specify which page to request, see per_page to determine how many items per page. |
per_page | Specify the number of tags fetched per one page, default is 25. |
Examples
Request JSON, using cURL utility:
curl -i -H "Authorization: Bearer _token" https://api.assembla.com/v1/spaces/_space_id/tags/active.json
Response
HTTP/1.1 200 OK
Server: nginx/0.8.55
Date: Thu, 19 Jul 2012 11:46:28 GMT
Content-Type: application/json; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Status: 200
...
[
{
"id":124,
"name":"abcd",
"space_id":"bcsn1KfUGr4Pf7XcWdifgZ",
"state":2,
"created_at":"2013-06-04T08:18:11-10:00",
"updated_at":"2013-06-04T08:18:11-10:00"
},
...
]
JSON is formatted here for readability, in a real response JSON body is inline with no indentation.
Request XML, using cURL utility:
curl -i -H "Authorization: Bearer _token" https://api.assembla.com/v1/spaces/_space_id/tags/active.xml
Response
HTTP/1.1 200 OK
Server: nginx/0.8.55
Date: Thu, 19 Jul 2012 11:44:49 GMT
Content-Type: application/xml; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Status: 200
...
<?xml version="1.0" encoding="UTF-8"?>
<tags type="array">
<tag>
<id type="integer">124</id>
<name>abcd</name>
<space-id>bcsn1KfUGr4Pf7XcWdifgZ</space-id>
<state type="integer">2</state>
<created-at type="datetime">2013-06-04T08:18:11-10:00</created-at>
<updated-at type="datetime">2013-06-04T08:18:11-10:00</updated-at>
</tag>
...
</tags>
Description for each field: tag object fields reference