Whenna

Create a Whenna plan (a shareable link that finds the time everyone is free). Returns the link to share with humans or other agents, and a creator_key that authorizes locking the final time. Times are wall-clock in the given IANA timezone. For a RECURRING plan ("every Tuesday"), pass weekday names i

Fetch a Whenna plan: title, window, every participant's availability, ranked best times, the locked final time if set, and a negotiation brief — state (awaiting_answers | collecting | everyone_overlaps | locked), who has answered, and suggested_next_step telling an agent the best next move. Poll thi

Set a participant's free times on a plan (replaces that participant's previous answer). Express availability as free ranges per day; the server converts them to slots. Use the participant's human name so the group recognizes them. An EMPTY free array records an explicit "can't make any of these time

Set where the group meets: a place name, or video_call:true to attach Whenna's built-in encrypted video room (the room link then goes on everyone's calendar automatically). Place and video room are mutually exclusive. Requires creator_key.

Group memory: start the group's next plan from a finished one. Clones the setup (title, hours, place/video, discussion), proposes the next occurrences of the locked weekday as candidate days, links old→new (the old link shows everyone "the next one is live"), and emails the people who opted in to he

Ranked best meeting times for a plan: contiguous blocks where the most participants are free, with who is free in each block.

Lock the final time on a plan (requires the creator_key returned by whenna_create_plan). Pass use_best:true to lock the top-ranked best time automatically, or give an explicit day/start. Everyone viewing the link sees it as confirmed, with add-to-calendar buttons. Returns calendar links (Google, Out