Marvin Help

API changelog

2026-10-04

  • Documentation moved from GitHub to this help center

  • Documented /api/doneItems, /api/notebook and /api/notebooks, and the currentItem alias

  • Documented getting time tracking data for a day with /api/tracks

  • Removed rewardId, itemSnoozeTime and permaSnoozeTime from the /api/addTask example, since the endpoint ignores them

2024-05-23

2024-05-23

  • Document change to /api/children

2024-01-03

  • Documented ?raw=1 for /api/habits endpoint

2023-03-21

  • Now only tasks and projects/categories are returned in /api/children (previously Time Blocks could sneak in)

2023-03-13

2023-03-09

  • Documented /api/updateHabit

2023-03-06

  • Improved Reminder documentation

2023-03-01

  • Documented /api/children

  • Documented /api/todayTimeBlocks

  • Improved Category/Project documentation

2023-02-06

  • Added X-Auto-Complete to /api/addTask

2023-01-19

  • Documented experimental /api/markDone

2022-12-05

  • Document /api/goals

  • Add ##Goal as shortcut when adding a task via API

2022-09-11

  • Document adding date to /api/dueItems

2022-08-08

  • ID of new item now sent when creating tasks, projects, and events

2022-04-05

  • Document /api/doc/create

  • Document /api/doc/delete

  • Improve documentation for /api/doc/update

2022-03-26

  • Documented bugfix/breaking change in /api/doc

2022-03-24

  • Documented /api/update

2022-02-24

  • Added Tracking and TrackingSince to /api/me

2022-02-23

2022-01-29

  • Documented timeZoneFix

2021-11-16

  • Documented RecurringTasks, SavedItems, and Recurrence in general

2021-11-15

  • Documented /api/todayItems date parameter

2021-08-22

  • Documented /api/addEvent

2021-07-11

  • Documented /api/tracks

2021-06-30

  • Documented new webhooks

  • Improved time block documentation

  • Documented user configuration (ProfileItems)

2021-06-07

  • Improved Webhooks CORS documentation (this is a frequent source of confusion)

2021-06-05

  • Documented Rewards

  • Documented BillingPeriod (in /api/me)

2021-04-04

  • Documented improved tomato timer webhooks. Now "timerDone" is dispatched after each work/break session finishes.

2021-03-08

  • Documented Trackers

2021-02-25

  • Documented Calendars and Events

2021-02-24

2021-02-23

  • Documented Goals

2021-02-08

  • Documented /api/me

  • Documented habit webhooks

2021-01-17

  • Documented /api/kudos

2020-10-15

  • Documented Webhooks

  • Documented Timer formats

  • Documented conflicts and fieldUpdates in direct database access page

2020-09-08

  • Added /api/addProject

  • Added support for more task fields in /api/addTask: bonusSection, customSection, timeBlockSection, rewardPoints, rewardId, backburner, reviewDate, timeEstimate, itemSnoozeTime, permaSnoozeTime

  • Added /api/claimRewardPoints

  • Added /api/unclaimRewardPoints

  • Added /api/spendRewardPoints

  • Added /api/resetRewardPoints

2020-07-26

2020-07-17

  • Published API documentation