Reviews

Reviews support the GTD weekly and monthly review process. They capture accomplishments, distractions, reflections, and habit adherence to help you stay aligned with your goals.

GET /api/v1/reviews

List all reviews for the authenticated user.

Response

[
  {
    "id": "clxr1s2t3...",
    "review_type": "weekly",
    "review_date": "2026-03-22",
    "accomplishments": "Shipped the API documentation. Completed all Q1 planning tasks.",
    "distractions": "Got sidetracked by social media on Tuesday.",
    "reflections": "Need to batch email checking to morning and evening only.",
    "habit_adherence": {
      "meditation": { "completed": 5, "total": 7 },
      "exercise": { "completed": 3, "total": 5 }
    },
    "createdAt": "2026-03-22T18:00:00.000Z",
    "updatedAt": "2026-03-22T18:00:00.000Z"
  }
]

POST /api/v1/reviews

Create a new review.

Request Body

{
  "review_type": "weekly",
  "review_date": "2026-03-22",
  "accomplishments": "Shipped the API documentation. Completed all Q1 planning tasks.",
  "distractions": "Got sidetracked by social media on Tuesday.",
  "reflections": "Need to batch email checking to morning and evening only.",
  "habit_adherence": {
    "meditation": { "completed": 5, "total": 7 },
    "exercise": { "completed": 3, "total": 5 }
  }
}

Fields

Field	Type	Required	Description
`review_type`	`string`	Yes	One of: `weekly`, `monthly`
`review_date`	`string`	Yes	The date of the review (ISO 8601 date)
`accomplishments`	`string`	No	Summary of what was accomplished
`distractions`	`string`	No	What caused distractions or derailed focus
`reflections`	`string`	No	Insights and takeaways for the next period
`habit_adherence`	`object`	No	JSON object tracking habit completion rates

Response

Returns the created review object.