Gravity

Save a new note at the top of the user's Gravity list. Use it for "save this to Gravity", "note that…" or "add a todo". Keep it the user's words; Markdown works (- [ ] for checklists).

Transcribe a recording (through AssemblyAI) and save it as a new note at the top of the user's Gravity list, the way the app's mic does. Use it for "save this voice memo to Gravity". A tag spoken first with a pause becomes the note's tag; tag sets one instead.

Add a paragraph to the end of an existing note. The rest of the note stays as it is, and so does its place in the list. If the note should also go back to the top, call rescue_note after.

Take a note off the list into Archive. Nothing is deleted; rescue_note brings it back.

Replace one exact piece of a note's text. old_text must appear exactly once in the current note; include enough surrounding text to make it unique. To rewrite the whole note, pass its full current text (from fetch) as old_text. Example: old_text "- [ ] milk", new_text "- [x] milk" ticks off milk. The note keeps its place in the list; if it should also go back to the top, call rescue_note after.

Read one note's full text and details by ID. A very long note comes in parts: while metadata.next_offset is a number, call fetch again with offset set to it. null means you have read to the end.

Browse the list the way the Gravity app shows it: newest or most recently rescued first. Filter by tag, by when notes were created, by state (the list, Archive or Deleted Notes), and optionally by words. Use it for questions like "what did I note last week" or "my idea: notes from September". Each note shows its first 500 characters; call fetch for the rest. Pages with cursor.

The tags on notes in the list (todo, idea, read…) with how many notes use each, most used first.

Move a note back to the top of the list, the way swiping right does in the app. Also brings an archived note back to the list.

Take a note out of Deleted Notes and put it back where it was.

Find notes by their words, parts of words and meaning, the way search in the Gravity app does: the best matches first. Put a tag with its colon in the query (todo: dentist) to search only that tag. Covers the list and Archive, not Deleted Notes. Returns titles and IDs; call fetch for a note's full text. For dates, tags or more text per result, use list_notes.

Turn speech in a recording into text, in 99 languages. The audio is transcribed by AssemblyAI. A tag spoken first with a pause ("To do, call the bank") comes back written ("todo: call the bank"). To save it as a note in one step, use add_voice_note.

Move a note to Deleted Notes, where the user can restore it. Pass the revision you read so that if the note changed since, Gravity keeps the newer text as a separate note.

Get a link to upload a recording that's over 2 MB and isn't already online, up to 100 MB. PUT the file's bytes to upload_url (e.g. curl -T memo.m4a '<upload_url>'), then pass upload_id to transcribe_audio or add_voice_note. The link works for 15 minutes; the upload_id for a day. The recording is deleted once it's transcribed.