List Tasks

Get all tasks for a given query

GET v1 / tasks

Authorization

Authorization string required

Bearer authentication header of the form Bearer <token> where <token> is your auth token.

Query Parameters

assigneeId string

Limit tasks returned to a specific assignee

cursor string

Use if a previous request returned a cursor. Will page through results

includeAllStatuses boolean

Limit tasks returned by statuses that exist on tasks, cannot specify this ('includeAllStatuses') AND status in the same request

label string

Limit tasks returned by label on the task

name string

Limit tasks returned to those that contain this string. Case in-sensitive

projectId string

Limit tasks returned to a given project

status array<string>

Limit tasks returned by statuses that exist on tasks, cannot specify this ('status') AND includeAllStatuses in the same request

workspaceId string

The id of the workspace you want tasks from. If not provided, will return tasks from all workspaces the user is a member of.

Response

200 - application/json - object

meta object required

Contains the nextCursor, if one exists, along with the pageSize

tasks array<object> required

The tasks returned

id string required

name string required

description string required

The HTML contents of the description

duration string | number

An integer greater than 0, "NONE", or "REMINDER"

dueDate datetime

When is the task due

deadlineType string required

Values are HARD, SOFT (default) or NONE

parentRecurringTaskId string required

If this is an instance of a recurring task, this field will be the parent recurring task id

completed boolean required

Whether the task is completed or not

creator object required

project object

workspace object required

status object required

The status of the task

priority string required

Valid options are ASAP, HIGH, MEDIUM, or LOW

labels array<object> required

An array of labels

assignees array<object> required

An array of assignees

scheduledStart datetime

The time that motion has scheduled this task to start

createdTime datetime required

The time that the task was created

scheduledEnd datetime

The time that motion has scheduled this task to end

schedulingIssue boolean required

Returns true if Motion was unable to schedule this task. Check Motion directly to address