Close menu
Explore Plans
Mobile menu Close menu
Motion

Find a task

Pro plus icon Search your Motion tasks by name and return the best match.

Developer info

API endpoint slug
motion.find_a_task
Runtime method
performQuery("motion.find_a_task"}

Query fields

Search text Text input > Title

Label
Search text
Helper text
Find a task whose name contains this text (case-insensitive).
Slug
search_text
Required
true
Can have default value
true

Project Dropdown list

Label
Which project?
Helper text
Limit the search to a project, or choose Any.
Slug
project
Required
true
Can have default value
false

Ingredients

Task The unique ID of the task.

Slug
task_id
Filter code
Motion.findATask.TaskId
Type
String
Example
aBcD1234

Task name The name of the task.

Slug
task_name
Filter code
Motion.findATask.TaskName
Type
String
Example
Draft Q3 roadmap

Description The task description.

Slug
description
Filter code
Motion.findATask.Description
Type
String
Example
Outline the key initiatives for Q3.

Status The current status of the task.

Slug
status
Filter code
Motion.findATask.Status
Type
String
Example
Todo

Priority The task priority (ASAP, HIGH, MEDIUM, LOW).

Slug
priority
Filter code
Motion.findATask.Priority
Type
String
Example
HIGH

Due date When the task is due.

Slug
due_date
Filter code
Motion.findATask.DueDate
Type
Date with time (ISO8601)
Example
2020-07-08T04:17:06+05:00

Assignees Comma-separated names of the task assignees.

Slug
assignees
Filter code
Motion.findATask.Assignees
Type
String
Example
Jane Doe, John Smith

Labels Comma-separated labels on the task.

Slug
labels
Filter code
Motion.findATask.Labels
Type
String
Example
urgent, roadmap

Project name The name of the task's project.

Slug
project_name
Filter code
Motion.findATask.ProjectName
Type
String
Example
Product Planning

Workspace name The name of the task's workspace.

Slug
workspace_name
Filter code
Motion.findATask.WorkspaceName
Type
String
Example
Product Team