account
ChatGPTWhat's the user's own and has to be unique or checked: their handle and name, their time zone, how and when they're reached (which channels, how much a day, quiet hours), their number, the accounts they've connected, an invite to accept, a personal token. set takes any of these by name, each described in the schema; with nothing, it gives the account as it stands. A name that can't be set comes back saying so, with the ones that can. Setting a number texts it a code, and connecting an account gives a link to open.
catch_up
ChatGPTWhat's new, what's waiting and whose turn it is, for the user. With nothing: what arrived since they last asked (what's for them in full: sent to them by name, or answering their thoughts; the rest counted by person and thread), how much is still waiting, and the games where it's their turn. waiting: true is the whole list of what's waiting for them, other people's first, then their own to-dos and reminders, each with what it's under; it waits until they answer it or say it's done (change, done: true). from narrows either to one person or den. Everything it gives in full now counts as shown to them (count says how many), and asking again gives only what's newer: it's the one read that does, so find never changes what's new.
change
ChatGPTChange what's already there, by any link: a thought (its id or link), a den ("#Family"), a person ("@linus") or "me" (the user's own den: their page and picture). One (thought_id and the changes at the top level), many (thought_ids with the same changes, or changes: a list each with its own), or every thought of the user's a filter matches (matching; validate previews what it would touch). Edit its words in place (replace, append) or rewrite them (text), when it was said or when it happens, make it private, mark something waiting as done, set who it's for (set_for), address it to more or take it back, move it under or out from under other thoughts, add, reorder or take off its files, follow someone or stop (subscribe), delete, restore. A change that would let more people read a thought answers with who, and does nothing until confirmed; every result that touches who can read says how it was and how it is. Every old version is kept. Nobody is texted: that's send.
find
ChatGPTEvery read of thoughts (the user's, and those of people they share with). It only reads: nothing is recorded, nobody is told they were looked up, and nothing stops being new. Filters that all combine, and a view of what they find: query: words. Alone, one search for everything they can find: people by name, @handle or a near spelling (each with their page), then thoughts by words and by meaning; match says how good the best is (strong, weak, none). person: whose (a name, @handle, or "me"). With query, "what does Linus think about X": their thoughts best matching, then their latest. What they have said, never what they would say. under: what it's under: a thought (id or link: a list, a post, a thread) or a den ("#Family"). Alone, what's directly under it; with any other filter, everything below it that matches. said_after / said_before / added_after: when it was said or saved. happening_after / happening_before: what's happening in that window ("what's on tomorrow"), anyone's the user can read, soonest first. visible_to: the user's own thoughts by who can read them: "me" (nobody else), "everyone" (public), a #den, or a person (sent to them by name). ids: thoughts in full by id or pasted link, each with what it's under and what's under it. view: how much of each: brief (the default), full, tree, seen, history, files. A view that isn't one comes back with the list and what each gives. private, meta, source, as_of filter too. A cut text has words and words_shown. A list says shown and total; next_cursor has the rest.
get_started
ChatGPTWhere anything on Den starts: who the user is (their @handle first, and anything odd about the account), their time zone and named times, the people and dens they share with, what's waiting for them, whose turn it is in their games, people they've written to who haven't joined, what can be set on their account, and a next question to offer them.
play
ChatGPTA turn in something with rules, one call a turn: a game, the user's words, and their move. A game's result says what happened, what happened while they were away, what's waiting on them, what a move can be and what they could do next, one question for them, and the game as it stands, drawn in the chat where the app can show it. A move the game can't read or can't allow changes nothing and comes back saying what would work. One (fields at the top level) or many (plays). With only a game, joins or resumes it and returns where it stands; the same move sent twice is made once. With nothing, the games there are.
report_bug
ChatGPTTell Den's team something is broken: one (fields at the top level) or many (bugs). For when a tool fails more than once, returns something wrong or confusing, or the user says something's broken. It's sent with this connection's recent calls, so what_happened needn't repeat them. Reporting the same thing again doesn't report it twice.
save
ChatGPTSave thoughts: one (fields at the top level) or many (thoughts, up to 500; top-level fields apply to each). Each says who it's for, what it goes under, and the files it holds; a thought may be only its files. A reminder is remind_at, a to-do of the user's own is waiting: true. With name it makes a den: a place people are in. Returns each thought's link, at once: files are kept, then read (a voice memo is transcribed first, since its words are the thought's). Saving the same thing again (a retry, a re-run import) doesn't save twice. Nothing saved is texted, emailed or posted anywhere: that's send. validate previews without saving.
send
ChatGPTEverything that leaves Den or buzzes someone's pocket: a text, an email, a post or DM on X, an invite onto Den, a nudge to someone already here. Takes a thought that's already saved (thought_id) and one person (name, via, address at the top level) or many (to). via is the channel, one word; the result of one Den doesn't have says which it has and what each takes. Someone not on Den gets its first line and a link, and joins to read the rest. Whoever it's sent to can read it from then on: visible_to in the result says who. An invite needs no thought: what's given waits for them when they arrive. Sending the same thing to the same place again sends once. It goes only to the person and channel given.
upload
ChatGPTA link, good for an hour, for files too big for a call and for bulk imports. With thought_id, what's sent becomes that thought's files (a post made with save, then its video); without, each file is a thought of its own. On a phone it opens a file picker. From a terminal: curl -T each file (per-file options in the query: name, said_at, text), or a whole list of thoughts in one request (?as=thoughts, JSON lines or array). Options here apply to everything sent to it.