Tasks
The trial's task board is a simple kanban for the study team: tasks with assignees and due dates, moved between lanes. Reading tasks needs trial.readTasks; creating and editing them needs trial.writeTasks (an assignee can always read and update their own). Lanes are managed by trial admins.
Endpoints
| Method | Path | Description |
|---|---|---|
GET |
/trials/<trialId>/tasks |
The trial's tasks, as {"tasks": [...]}. |
POST |
/trials/<trialId>/tasks |
Create a task. |
PUT |
/tasks/<taskId> |
Update a task. |
DELETE |
/tasks/<taskId> |
Delete a task. |
GET |
/trials/<trialId>/task-lanes |
The board's lanes, as {"lanes": [...]}. |
POST |
/trials/<trialId>/task-lanes |
Add a lane. |
PUT DELETE |
/task-lanes/<laneId> |
Rename, reorder or remove a lane. |
Task fields
| Field | Type | Notes |
|---|---|---|
title |
string | |
description |
string | |
taskLane |
lane _id |
The lane the task is in. |
index |
integer | Position within the lane. |
status |
pending, completed |
Moving a task into the lane marked isCompleteLane completes it. |
assignees |
list of user _ids |
Who is responsible. They are notified. |
dueDate |
datetime | null for none. |
Lane fields
| Field | Type | Notes |
|---|---|---|
name |
string | |
description |
string | |
index |
integer | Position on the board. |
isCompleteLane |
boolean | Tasks moved here count as done. |