Skip to main content

Add Notes to a Task

Track progress, decisions, or context by adding notes to a task.

CLI​

Add a note via apply​

A markdown document with task_id in its frontmatter is applied as a note:

cat <<'EOF' | ud apply -f -
---
task_id: a1b2c3d4
---
Discussed with team, moving deadline to next Friday
EOF

Add a longer note with markdown​

cat <<'EOF' | ud apply -f -
---
task_id: a1b2c3d4
---

## Meeting Notes - Feb 15

- Agreed on the new API design
- @alice will handle the frontend
- Deadline extended to Feb 28
EOF

To update an existing note, include its note_id in the frontmatter.

List all notes on a task​

ud get notes --task <task-id>

Delete a note​

ud delete note <note-id>

curl​

Add a note​

curl -X POST https://your-server.com/todolist/{taskId}/notes \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Discussed with team, moving deadline to next Friday"
  }'

List notes​

curl -X GET https://your-server.com/todolist/{taskId}/notes \
  -H "Authorization: Bearer $TOKEN"

Response:

[
  {
    "id": "n1e2f3...",
    "content": "Discussed with team, moving deadline to next Friday",
    "created_at": "2026-02-15T14:30:00Z",
    "updated_at": "2026-02-15T14:30:00Z"
  }
]

Delete a note​

curl -X DELETE https://your-server.com/todolist/{taskId}/notes/{noteId} \
  -H "Authorization: Bearer $TOKEN"