Motion Logo Motion
API Keys

Move Task

Move a task to a different workspace.

PATCH v1 / tasks / {id} / move

Authorization

X-API-Key string required

Header with the name X-API-Key where the value is your API key.

Path Parameters

id string

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 (representing minutes), "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

completedTime datetime

The timestamp when the task was completed

updatedTime datetime

The timestamp when the task was last updated

startOn string

Date indicating when a task should start, in YYYY-MM-DD format

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

lastInteractedTime datetime

The timestamp when the task was last interacted with

customFieldValues record<object>

Record of custom field values for the entity, where each key is the name of the custom field (not the ID). Each object contains a "type" discriminator and a "value" property that varies based on the field type.

chunks array<object>

Array of scheduling chunks for the task

Was this page helpful?