Files

2.7 KiB

Motion Routing Reference

App name: motion Base URL proxied: api.usemotion.com

API Path Pattern

/motion/v1/{resource}

Common Endpoints

Get Current User

GET /motion/v1/users/me

List Workspaces

GET /motion/v1/workspaces

List Tasks

GET /motion/v1/tasks
GET /motion/v1/tasks?workspaceId={workspaceId}
GET /motion/v1/tasks?projectId={projectId}

Get Task

GET /motion/v1/tasks/{taskId}

Create Task

POST /motion/v1/tasks
Content-Type: application/json

{
  "name": "Task name",
  "workspaceId": "ws_xxx",
  "priority": "HIGH",
  "duration": 30
}

Update Task

PATCH /motion/v1/tasks/{taskId}
Content-Type: application/json

{
  "name": "Updated name",
  "priority": "LOW"
}

Delete Task

DELETE /motion/v1/tasks/{taskId}

Move Task

POST /motion/v1/tasks/{taskId}/move
Content-Type: application/json

{
  "workspaceId": "ws_new"
}

Unassign Task

POST /motion/v1/tasks/{taskId}/unassign

List Projects

GET /motion/v1/projects?workspaceId={workspaceId}

Get Project

GET /motion/v1/projects/{projectId}

Create Project

POST /motion/v1/projects
Content-Type: application/json

{
  "name": "Project name",
  "workspaceId": "ws_xxx",
  "priority": "HIGH"
}

List Users

GET /motion/v1/users?workspaceId={workspaceId}

List Comments

GET /motion/v1/comments?taskId={taskId}

Create Comment

POST /motion/v1/comments
Content-Type: application/json

{
  "taskId": "tk_xxx",
  "content": "Comment text"
}

List Recurring Tasks

GET /motion/v1/recurring-tasks?workspaceId={workspaceId}

Create Recurring Task

POST /motion/v1/recurring-tasks
Content-Type: application/json

{
  "name": "Weekly review",
  "workspaceId": "ws_xxx",
  "frequency": "weekly"
}

Delete Recurring Task

DELETE /motion/v1/recurring-tasks/{recurringTaskId}

List Schedules

GET /motion/v1/schedules

List Statuses

GET /motion/v1/statuses?workspaceId={workspaceId}

Notes

  • Workspace IDs start with ws_
  • Task IDs start with tk_
  • Project IDs start with pr_
  • Timestamps are in ISO 8601 format
  • Priority values: ASAP, HIGH, MEDIUM, LOW
  • Deadline types: HARD, SOFT, NONE
  • Cursor-based pagination with cursor query parameter
  • workspaceId is required for listing projects, users, recurring tasks, and statuses

Resources