Tasks API
Aurinko's Tasks API integrates task management into your apps, abstracting Google Tasks, Microsoft To Do, and Outlook Tasks. Perform CRUD tasks while managing lists.
Last updated
Aurinko API
Aurinko's Tasks API integrates task management into your apps, abstracting Google Tasks, Microsoft To Do, and Outlook Tasks. Perform CRUD tasks while managing lists.
Last updated
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.
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.
First, create your account in the , then follow the guide to .
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 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.
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.
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.
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:
Each account connected to Aurinko can have zero or more , and each task list contains a collection of individual 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.
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.