API: Tags

Currently the only available tags API method is listing tags.

List tags

GET /api/tags

The tags resource returns all tags for the account.

JSON
XML

$ curl -H "X-FreckleToken:lx3gi6pxdjtjn57afp8c2bv1me7g89j" https://apitest.letsfreckle.com/api/tags.json
Response:
[
  {
    "tag": {
      "name": "a",
      "billable": true,
      "created_at": "2010-06-09T20:44:57Z",
      "import_id": null,
      "updated_at": "2010-06-09T20:44:57Z",
      "account_id": 5039,
      "id": 55629
    }
  }
  /* ...more tags... */
]
Try with hurl.

$ curl -H "X-FreckleToken:lx3gi6pxdjtjn57afp8c2bv1me7g89j" https://apitest.letsfreckle.com/api/tags.xml
Response:
<?xml version="1.0" encoding="UTF-8"?>
<tags type="array">
  <tag>
    <account-id type="integer">5039</account-id>
    <billable type="boolean">true</billable>
    <created-at type="date time">2010-06-09T20:44:57Z</created-at>
    <id type="integer">55629</id>
    <import-id type="integer" nil="true"></import-id>
    <name>a</name>
    <updated-at type="date time">2010-06-09T20:44:57Z</updated-at>
  </tag>
  <!-- ...more tags... -->
</tags>
Try with hurl.

Response codes

Returns 200 OK and an array of tags in the response body.

Roles

Freelancers have access to this resource, but will only see tags that are used in assigned projects.