NewTwos

Get one list, its things (in the app’s display order, per the list’s `sort`), and any reminders on those things. Get the `id` from list_lists or search.

get_list

Get a single thing by id, plus its reminder (or null).

get_thing

Create a NEW list from a markdown document in one call. The title comes from `title`, or the document’s first heading (`# …`) when omitted; the rest becomes the list’s things (checkboxes → todos, `1.` → numbered, `-`/`*` → bullets, indentation → nesting). Returns the new list and how many things were created.

import_markdown

List your Twos lists, most recently updated first (50 per page; pass `page` for more). Use a list’s `id` with get_list, create_thing, update_list, etc.

list_lists

List reminders (soonest first). ALWAYS pass `from` and `to` when the user names a day or period ("August 24", "this week", "Tuesday") — compute the range yourself from today's date and cover the WHOLE local day (from 00:00 to 23:59:59 of the last day), or you will miss anything scheduled later in the day. Without a range it returns the next year of reminders, capped. Set `todos_only: true` for "to-dos with reminders" (calendar events are never to-dos), and `include_calendar: false` to leave out events synced in from a connected calendar.

list_reminders

List the user’s saved places (named addresses like Home and Work). set_reminder already accepts a saved place’s name as `place`, so you only need this to answer "what places do I have saved".

list_places

List the tags you use across your things, with usage counts.

list_tags

List your things newest-first across all lists (or one list). Filter by `list_id`, `completed`, `type`, `tag`, `favorited` (starred), or `text` (substring match). To find a SPECIFIC item in a named list — e.g. to check, complete, or un-complete it — pass `list_id` + `text` and do NOT set `completed`, so it matches whether or not the item is already done. `since` + `sort` give an incremental cursor (e.g. poll for things created after a timestamp). Each thing has a stable `id`.

list_things

Remove the reminder from a thing.

remove_reminder

Save a named place from an address, or update the address of one with the same name, e.g. label "Work" and address "500 Market St, San Francisco". After this, set_reminder can use the name as `place`.

save_place

Search across your list titles and thing text, links, and tags (case-insensitive, matches whole words and partial words, up to 50 lists + 50 things). Returns matching lists and things, plus a flat `results` array of {id, title, url} you can pass to `fetch`. Useful for finding ids before updating. Set `favorited: true` to return only starred things that match — e.g. "starred things that mention X". `has_more` true means results were capped — narrow the query, or to enumerate a SPECIFIC list use list_things with list_id (+ optional text), paging until has_more is false (search is not a complete enumeration).

search

Set or replace the reminder on a thing. A thing has at most one reminder. Pass exactly one of `at` (an ISO 8601 datetime) or `place` (fires on arriving at or leaving a place). Pass `thing_id` for an existing thing, OR omit it and pass `text` to create a new to-do and set the reminder on it in one call — so "remind me to X at <time>" or "remind me to X when I get home" works without a pre-existing thing. For a recurrence like "every 3 months", pass `repeat` "monthly" with `every` 3. For two notifications (e.g. on the day and a day before), pass `alert_minutes` and `second_alert_minutes`. Place reminders go off on the Twos phone app and ignore the time, repeat, and alert options.

set_reminder

Update a list (rename, change emoji, star, archive). Only the fields you send change.

update_list

Update ONE thing. Set `completed: true` to check off a todo, `canceled: true` to cancel it. Checking off a thing with a REPEATING reminder works like the app: a completed copy stays where it was done, the reminder advances, and this thing comes back open on its next occurrence (the result has `repeating_reminder`; do not check it off again). Checking off a thing with a one-off reminder removes that reminder, as in the app. Set `list_id` (or `list` by name / "today") to move it to another list, `list_ref` to point it at another list (empty string clears it), or change text/type/url/tags. Only the fields you send change. Content edits keep the thing’s position in its list (they don’t reorder it); only moving it to a new list changes its order. To change MANY things at once, use `update_things`.

update_thing

Apply one change to MANY things at once — "check all these off", "move these to Kitchen", "star these". Pass `ids` (the thing ids, from search/list_things) and `set` (the fields to change, same shape as update_thing: completed, canceled, favorited, type, tags, tabs, url, list_ref, and a move via list_id or `list` name). The same `set` is applied to every id. Things you no longer own are skipped, not errors. Max 500 ids per call.

update_things