New: The Tara API is Here


As teams continue to take advantage of our powerful integration stack, we’re hearing lots of requests for other beloved tools to be added to the sync list. Enter: the Tara API. Our brand new API encourages you to build custom integrations to fit your custom workflows.

Keep reading to learn more about how it works, along with other improvements from the week.

Accessing the API

Tara provides a public REST API that lets users retrieve and update Tara’s domain objects. Some common workflows we’re seeing teams create include sending customer feedback from Productboard into requirements, and auto logging issues from sentry. The possibilities are endless!

Tara’s data can be collected via an access key, which can be generated by a workspace admin. Your team will be able to work with the key for up to 60 minutes before needing to generate another one.

There are a few actions you can perform with the API. Currently, these operations include:

Retrieve a requirement

curl \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <ACCESS_KEY> " \
-X GET \
https://<API_URL>/api/requirement\?id=ymLxhcDpqkPrpjktIJGM

Update a requirement

curl \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <ACCESS_KEY> " \
-X PUT \
-d '{"id":"ymLxhcDpqkPrpjktIJGM","title":"Task Activity History for Requirement 2","description":"Requirement Description 2"}' \
https://<API_URL>/api/requirement

Retrieve a task

curl \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <ACCESS_KEY> " \
-X GET \
https://<API_URL>/api/task\?id=1010

Update a task

curl \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <ACCESS_KEY> " \
-X PUT \
-d '{"id":"1010","title":"Add Task 3","description":"Task Description 2","assignee":"Tim","collaborators":["Jack","Jill","Mary"],"effortLevel":10,"status":1,"url":"https://foo.bar"}' \
https://<API_URL>/api/task

Create a task

curl \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <ACCESS_KEY> " \
-X POST \
-d '{"title":"Add Task 4","description":"Task Description 4","assignee":"Tim","collaborators":["Jack","Jill","Mary"],"effortLevel":10,"status":1,"url":"https://foo.bar"}' \
https://<API_URL>/api/task

This documentation can also be found on the API page of our help center.

By accessing these operations, you can easily create your own custom integrations using low-code tools like Zapier, or create custom scripts to share data between Tara and your favorite tools. New tasks created through the API will import into the task backlog at the top of the Work drawer.

Planning Imported Tasks

The new Work drawer lets you see as many or as few of your projects as you want at one time. This view simplifies planning; tasks can be directly dragged and dropped into sprints. Imported tasks from Trello or Asana are located under the imports bin in the Work drawer and can also now be easily dragged + dropped into your sprints.

Importing GitHub Labels

Tara helps you organize your tasks by type, status, and priority with labels. If your engineering team uses labels in GitHub, these tags can also be imported into Tara via your issues. Now your imported tasks can stay organized, and you can avoid the tedious task of adding labels back manually.

Bug Fixes and Under the Hood Improvements

  • Added the ability to view labels in task descriptions from the task details panel
  • Added an email and Slack notification when a task is assigned to you
  • Added valid invite link extension from 3 days to 7 days
  • Added label import to tasks coming in from GitHub
  • Added the ability to create a new workspace to the workspace settings page
  • Fixed display issue with longer requirement names in the work drawer
  • Fixed requirement filtering based on team selection in define mode
  • Fixed ability to edit and remove labels
  • Fixed issue with double-clicking tasks to open the task modal
  • Fixed modal editor height to match screen height

These are features that have been requested by our community for quite some time. We would love to hear your feedback below, on Twitter @taradotai, or on our official Discord server, Git Ship Done!