Motion Logo Motion API Documentation
Support
API Keys

Create Task

Create a task

POST v1 / tasks

Authorization

Authorization string required

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

Body

application/json

dueDate datetime

ISO 8601 Due date on the task. REQUIRED for scheduled tasks

duration string | number

A duration can be one of the following... "NONE", "REMINDER", or an integer greater than 0

status string

Defaults to workspace default status

autoScheduled object | null

Set values to turn auto scheduling on, set value to null if you want to turn auto scheduling off. The status for the task must have auto scheduling enabled.

name string required

Title of the task

projectId string

workspaceId string required

description string

Github Flavored Markdown for the input

priority string

ASAP, HIGH, MEDIUM, and LOW are valid values

labels array<string>

The names of the labels to be added to the task

assigneeId string

The user id the task should be assigned to

Response

200 - application/json - object

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

Was this page helpful?