custody_patterns_list
ChatGPTThe custody schedule patterns Kidtime can build, such as 2-2-3 or alternating weeks: id, name, split and a one-line description. Call this when someone wants a custody schedule and has neither named a pattern nor described their days: it shows a picker, so do not pick for them, do not assume a pattern from earlier chats, and wait for their choice before groups_save or custody_schedules_save. When they described their days (such as every other weekend, Friday to Monday), do not show the picker: match a pattern from the list in custody_schedules_save, confirm it in words, and save. Use one of these ids as templateType. Reads a fixed list and nothing about any person.
custody_schedules_list
ChatGPTThe custody schedules on a calendar: pattern (templateType), first and last day, time zone, exchange times, who has the children first (toMember), and the children. For which parent has the children on which day, and each parent's share of nights, call events_list. Changes nothing.
custody_schedules_save
ChatGPTSet the custody schedule (the parenting time or visitation schedule) on a calendar, as the app's custody schedule maker does. This REPLACES the hand-offs from startDate to endDate (a year by default) with the pattern's. On a calendar made in chat nobody else is told: it is the person's own until they share or claim it. Only on a family already kept in the Kidtime app does the other parent see the change, as from the app. Needs a templateType from custody_patterns_list, the person's real first day as startDate with patternShift for where it falls in the pattern, the parent who has the pattern's day 0 (toMemberId), and the person's time zone (ask if you do not know it). Then call events_list and read the first hand-offs back to the person; if any is wrong, call this again with corrected values, which replaces the schedule, rather than editing single hand-offs. Nothing is saved until this returns. Patterns (templateType id, name): 2-2-3 (2-2-3), alternating-weeks (Alternating Weeks), 2-2-5-5 (2-2-5-5), 3-4-4-3 (3-4-4-3), 4-3-3-4 (4-3-3-4), 3-3-4-4 (3-3-4-4), 2-5-5-2 (2-5-5-2), 4-on-4-off (4 On / 4 Off), 3-on-3-off (3 On / 3 Off), 4-3 (4-3), extended-weekend (Extended Weekend), every-weekend (Every Weekend), every-third-week (Every Third Week), every-third-day (Every Third Day), alternating-weekends (Alternating Weekends), first-third-weekends (1st & 3rd Weekends), first-third-fifth-weekends (1st, 3rd & 5th Weekends).
events_delete
ChatGPTDELETES an event from a calendar, as the app does. On a calendar made in chat nobody else is told: it is the person's own until they share or claim it. Only on a family already kept in the Kidtime app does the other parent see it go and get told. For a repeating event, scope "single" (default) deletes this one, "future" this one and every later one, "all" the whole series except days both parents have confirmed. Ask the person before deleting more than one event. Needs the eventId from events_list.
events_list
ChatGPTWhat is on a calendar between two instants, and how parenting time is split. Use it for who has the kids on a date, and for custody percentage or overnight questions over any range, such as a full year of every other weekend. It returns, as the app's calendar reads them: events (hand-offs carry custodyTransitions, from which parent to which, for which child), and blocksByChild, each child's analytics: each parent's overnights and custody percentage per month; add the months up for a longer range. Who has a child at a moment is the parent the last hand-off before it went to. traditionsByDate gives the holidays and birthdays on each day; a break is an event with its tradition. For who had the kids on a holiday in past years, use traditions_get. Give timezone (IANA), and startDate and endDate as ISO instants for an exact range, such as this Sunday's midnight to two weeks later. Times come back in UTC: show them in the event's startTimeZone. Where the client can, it draws the days as a calendar, so sum them up in a sentence or two instead of listing every day. Changes nothing.
events_save
ChatGPTAdd an event to a calendar, or change one, as the app's event form does. On a calendar made in chat nobody else is told: it is the person's own until they share or claim it. Only on a family already kept in the Kidtime app is the other parent told and the event synced to their connected calendars, as from the app. With no eventId it adds the event (an all-day one with startDate and endDate, a timed one with startDateTime, endDateTime and startTimeZone; rrule makes it repeat; custodyTransitions makes it a hand-off). With an eventId from events_list it changes that event: send only what changes, and scope "future" to change a repeating event from this one on. Member ids come from members_list. Nothing changes until this returns.
groups_list
ChatGPTSigned in: the person's families on Kidtime, each with its groupId. Not signed in: the calendars this person made in chat, including in earlier ChatGPT chats, so call it first to find one before making another. With none, call groups_save, which needs no sign-in. Call members_list for its people. Changes nothing.
groups_save
ChatGPTStart a shared calendar for two parents, or rename its people. With no groupId it creates a calendar from both parents' first names and returns its groupId, its members and a link: signed in, it is a new family on the person's account; not signed in, it is kept for them until they claim it at the link. With a groupId it renames people, and names past the children there add children. It stores first names, so ask before calling. Nothing exists until this returns. Then call custody_schedules_save.
members_list
ChatGPTThe parents and children in a calendar, with the member ids the other tools take (toMemberId, attendeeIds). Changes nothing.
members_save
ChatGPTChanges a person's first name or birthday on a calendar, by membershipId from members_list, and replaces the one saved before. The new name shows on the calendar, its hand-offs and its page; a birthday then shows every year. On a calendar made in chat nobody else is told. Ask before changing a name.
plan_jurisdictions_list
ChatGPTWhat a parenting plan made with Kidtime contains for a US state or a country: every section it covers, the state's own terms (Florida says time-sharing, not parenting time), how it is signed (notary, sworn statement, signer roles), the court heading, and which states have wording of their own. Call it when someone asks what goes in a parenting plan where they live, or how to sign or title one. It describes Kidtime's template, not legal advice, so pass on the disclaimer it returns. Reads fixed data and nothing about any person.
traditions_get
ChatGPTFor one of the family's traditions (an id from traditions_list's traditions, not a preset id): its date each year (timeline) and which parent had each child that night (holders: holderMemberId, a member id from members_list; null when no schedule covers it). inherited is true when the night falls after the schedule's last hand-off, so it is a projection, not a set hand-off. Use it to compare years, such as whether Christmas alternates. Changes nothing.
traditions_list
ChatGPTThe holidays Kidtime offers for the family's country (presets), enabledPresetIds for the ones the calendar shows, and the family's traditions: holidays that are on, birthdays (with memberId; isMissingBirthDate when none is set) and breaks with their dates per year. Call it before traditions_save, for the holiday ids. For who had the kids on a holiday each year, use traditions_get; for what is on a date, events_list. Changes nothing.
traditions_save
ChatGPTTurn holidays on or off by id from traditions_list (the others stay as they are), and add, edit or remove breaks with their dates per year, such as spring break. On a calendar made in chat nobody else is told: it is the person's own until they share or claim it. Only on a family already kept in the Kidtime app do both parents see the change. Who has the kids on a holiday is set with events_save, not here. Removing a break deletes its dates: confirm with the person first.