Aurinko
Aurinko websiteAurinko blogAPI ReferenceContact Support
Aurinko API
Aurinko API
  • Getting started
    • What is Unified Mailbox API?
    • Getting started with Aurinko
    • Get your developer API keys
    • Adding Aurinko to Google Workspace allowlist
    • Bubble.io plugin
    • Team members and roles in applications
  • Unified APIs
    • Email API
    • Calendar API
    • Contacts API
    • Tasks API
    • Webhooks API
      • Configuring Pub/Sub for Gmail API Webhooks
    • Direct API
  • Authentication
    • OAuth Flow
      • Account OAuth Flow
      • User ОАuth Flow
      • Service Account OAuth Flow
    • Authentication scopes
    • Authorized return URLs
    • Google OAuth setup
    • Office 365 OAuth setup
    • ZOHO OAuth setup
    • Service accounts
      • Setting up G Suite service account
      • Setting up Office 365 daemon app registration
  • Scheduling
    • Create your first appointment booking page
    • Calendar Booking Page
    • Booking API
    • Group Booking API
  • Workspace Addons
    • Outlook addins
      • Create your first Outlook addin
      • Office 365: Installing Outlook addin
    • Microsoft Teams apps
      • Microsoft Teams bot setup
      • Create your first MS Teams app
      • Installing MS Teams app
    • Chrome Extensions with Google authentication
    • Google Workspace Add-Ons
  • Dynamic API
    • What is Dynamic (Virtual) API?
    • Getting Started with Dynamic API
Powered by GitBook
On this page
  • Aurinko Tasks API
  • Functionality
  • Aurinko account setup
  • Tasks API Endpoints
  • Tasks sync quickstart
  • Other examples
  1. Unified APIs

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.

PreviousContacts APINextWebhooks API

Last updated 3 months ago

Aurinko Tasks API


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 , then follow the guide to .

Tasks API Endpoints


Task lists

Tasks

Synchronization

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.

curl -X POST -H 'Authorization: Bearer <access token>' \
    -G https://api.aurinko.io/v1/tasklists/default/sync[?awaitReady=false] \
    -d skipCompletedBeforeDate='2023-05-29T10:58:27Z'

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:

{
    "syncUpdatedToken": "asdfghjklpoiuytrew",
    "syncDeletedToken": "zxcvbnmlkjhgfdsaq",
    "ready": true
}

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.

curl -X GET -H 'Authorization: Bearer <access_token>' \
    -G https:/api.aurinko.io/v1/tasklists/default/sync/updated \
    -d deltaToken='{syncUpdatedToken}'

Response:

{
    "nextPageToken": "string",
    "nextDeltaToken": "string",
    "records": [{...}]
}

Continue loading pages using provided nextPageToken until you find another nextDeltaToken.

curl -X GET -H 'Authorization: Bearer <access_token>' \
    -G https:/api.aurinko.io/v1/tasklists/default/sync/updated \
    -d pageToken='{nextPageToken}'

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.

curl -H 'Authorization: Bearer <access_token>' \
    -X GET https:/api.aurinko.io/v1/tasklists

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.

curl -H 'Authorization: Bearer <access_token>' \
    -X GET https:/api.aurinko.io/v1/tasklists/default

Tasks

To get a list of tasks from a list, make a request to the /tasklists/{id}/tasks endpoint.

curl -X POST -H 'Authorization: Bearer <access_token>' \
    -G https:/api.aurinko.io/v1/tasklists/default/tasks

To create a new task POST json payload to /tasklists/{id}/tasks endpoint:

curl -H 'Authorization: Bearer <access_token>' \
    -X POST https:/api.aurinko.io/v1/tasklists/default/tasks \
    -d '{
    "title": "My Task",
    "parentId": "string",
    "notes": "Task description...",
    "status": "notStarted",
    "importance": "low",
    "due": "2024-10-24T14:00:00Z",
    "startDateTime": "2024-10-23T14:00:00Z",
}'

Use PATCH request to update existing tasks:

curl -X POST -H 'Authorization: Bearer <access_token>' \
    https:/api.aurinko.io/v1/tasklists/default/tasks/{taskId} \
    -d '{
    -d '{
    "title": "My Task (updated)",
    "parentId": "string",
    "notes": "Task description...",
    "status": "notStarted",
    "importance": "high",
    "due": "2024-10-24T14:00:00Z",
    "startDateTime": "2024-10-23T14:00:00Z",
}'

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.

Aurinko portal
get your developer API keys
task lists
Tasks
Tasks sync