Tasks API
Integrate task management seamlessly into your apps! Aurinko Tasks API abstracts Google Tasks, Microsoft To Do & Outlook Tasks for a unified experience. Create/Read/Update/Delete tasks & manage lists
The Aurinko Tasks API is part of the Aurinko Unified API platform, enabling developers to integrate task management functionalities effortlessly into their applications. This API abstracts the differences between task management services such as Google Tasks, Microsoft To Do, and Outlook Tasks, offering a consistent interface for task-related operations.
Functionality
The Aurinko Tasks API offers robust functionalities for managing tasks:
Create Tasks: Create new tasks with various attributes like titles, descriptions, due dates, priorities, and custom fields, depending on the capabilities of the underlying service.
Read Tasks: Retrieve details of existing tasks, including titles, statuses, due dates, and completion status.
Update Tasks: Modify existing tasks by updating attributes like titles, descriptions, due dates, and priorities, or by marking tasks as completed or uncompleted.
Delete Tasks: Permanently remove tasks from the user’s account.
Lists: Manage task lists, including creating, reading, updating, and deleting lists, subject to the capabilities of the underlying service.
Aurinko account setup
First, create your account in the Aurinko portal, then follow the guide to get your developer API keys.
Tasks API Endpoints
Task lists
Each account connected to Aurinko can have zero or more task lists, and each task list contains a collection of individual tasks.
Tasks
Tasks are objects within a task list that generally support all features and attributes of modern task management apps like task subject, description, priority, due date, status, etc. Aurinko supports key task functionality: creating and modifying tasks.
Synchronization
Tasks sync methods allow developers to implement incremental synchronization of task list data in a uniform manner across different providers. Aurinko supports requesting updated as well as deleted tasks.
Tasks sync quickstart
Start a new sync
A new sync needs to be provisioned by calling the sync-start method /calendars/{calendarId}/sync
The sync is available per task list, hence {taskListId} or default. skipCompletedBeforeDate
applies for the initial full load.
The Aurinko platform will initialize all necessary internal resources and let you know when it's ready to serve data. The response should look like this:
If the response shows ready: false
call the sync-start method again. Once the sync is ready you will get delta tokens syncUpdatedToken
, syncDeletedToken
and can start loading updated and deleted events.
Initial full sync
Initial requests /tasklists/{taskListId}/sync/updated
and /tasklists/{taskListId}/sync/deleted
are equivalent to a full sync with the skipCompletedBeforeDate
filter, plus loading all updated tasks (deleted tasks) since the sync start.
Response:
Continue loading pages using provided nextPageToken
until you find another nextDeltaToken
.
Incremental sync
A new deltaToken (nextDeltaToken in response) is provided for loading tasks that have been modified/deleted since the last sync-updated/sync-deleted request. In cases where a large number of tasks have changed since the last incremental sync request, you may find a nextPageToken
instead of the nextDeltaToken
in the response. Continue loading pages using the provided nextPageToken
until you find another nextDeltaToken
.
Other examples
Task lists
To view a list of all task lists a user has access to, make a request to the /tasklists
endpoint.
You can get information for a single task list by providing the appropriate list id, /tasklists/{id}
. You can use default as an ID to get your default list.
Tasks
To get a list of tasks from a list, make a request to the /tasklists/{id}/tasks
endpoint.
To create a new task POST json payload to /tasklists/{id}/tasks
endpoint:
Use PATCH request to update existing tasks:
Last updated