Tasks Public API – How to Integrate and Manage Your Tasks

Modified on Wed, 4 Nov at 6:18 PM

The Tasks Public API lets you connect your Board Portal (BP) tasks to other tools, such as Microsoft Planner or Power Automate. An API (application programming interface) is a secure way for two software tools to exchange data. With it, you can automate repetitive work and keep your tasks in sync across your tools.


✋ Who can do what

  • Users with permission to generate a personal API token can create a token, connect an external tool and create, read, update or delete tasks through the API.
  • Administrators can help with permissions and setup. If you are not sure you have the right permissions, contact your administrator.

❓ What can you do with the Tasks Public API?

  • Create tasks automatically.
  • Retrieve and track all your tasks.
  • Update the status of tasks.
  • Delete tasks you no longer need.

Some examples:

  • Create a task automatically from a meeting outcome.
  • Sync your tasks with Microsoft Planner.
  • Start a workflow when a task is completed.

✅ Before you start

  • You have access to the Board Portal.
  • You have permission to generate a personal API token.
  • You have a tool that can call APIs, for example Power Automate, Postman or an internal system.

✍ Users with token permission: set up the connection

Step 1: generate your API token

An API token is a secret key that proves the external tool is allowed to act on your behalf.

  1. Go to your user settings.
  2. Generate a personal API token.
  3. Copy the token and store it in a safe place.

The token works like a password. Never share it publicly.

Step 2: connect your external tool

  1. In your external tool (for example Power Automate or Planner), use your API token to authenticate.
  2. Set up the API calls to the DiliTrust endpoints. An endpoint is the web address the tool calls to perform an action.
  3. If needed, test the connection with a tool such as Postman.

Step 3: manage your tasks through the API

  • Retrieve tasks: get the list of your tasks and their status (To do, Done, Overdue).
  • Create tasks: add tasks from your external tool, with details such as title, due date and assignee.
  • Update tasks: change the status or details of a task to keep your tools in sync.
  • Delete tasks: remove tasks that are no longer relevant.

⭐ Tips

  • Test your API calls in a test (sandbox or staging) environment first.
  • Keep your API token secure and replace it regularly.
  • Use automation tools such as Power Automate to save time.
  • Check your integrations regularly to make sure data stays consistent.
  • Start simple, test your setup, then automate step by step.

⛔ Limitations

  • Some fields, such as status values, may not be strictly checked by the API. Always check your data before you send it.
  • Access currently relies on a token.
  • What you can do through the API may depend on your permissions and configuration.

❓ FAQ

Can I share my API token with a colleague?

No. The token works like a password. Each user should use their own personal token.

Which tools can I connect?

Any tool that can call APIs, for example Power Automate, Microsoft Planner, Postman or an internal system.

I can't generate a token. What should I do?

Contact your administrator to check your permissions.

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article