v1

latestOpenAPI 3.0.12026-07-22120163333.7 KB
Tasks & Appointments V2

My Tasks

Returns tasks assigned to the caller, sorted by startTime descending. Supports cursor-based pagination via currentId (offset) + limit.

Notes:

  • currentId must be >= 0 (INVALID_PARAMETER otherwise).
  • limit must be in [1, 100] (LIMIT_NOT_VALID otherwise).
  • timeZoneCode selects how start/end times are formatted; when omitted, the caller's configured timezone is used.
get/v2.0/tasks/my-tasks

Query parameters

userIdinteger nullable

User ID to query tasks for. Defaults to the current authenticated user if not provided.

User ID to query tasks for. Defaults to the current authenticated user if not provided.

currentIdinteger

Cursor-based pagination anchor. Pass the last returned item's id to fetch the next page. Default 0 (start from beginning).

Cursor-based pagination anchor. Pass the last returned item's id to fetch the next page. Default 0 (start from beginning).

limitinteger

Page size, 1–100. Default 10.

Page size, 1–100. Default 10.

timeZoneCodestring nullable

IANA timezone code (e.g. 'America/New_York'). If not provided, falls back to the user's configured timezone.

IANA timezone code (e.g. 'America/New_York'). If not provided, falls back to the user's configured timezone.

Headers

Authorizationstring required

Bearer [access_token]

Response

Tasks assigned to the caller.

Example response

{
  "tasks": [
    {
      "timeZoneCode": "America/Los_Angeles",
      "address": "123 Main St, Los Angeles, CA"
    }
  ]
}