discard_logbook_page_import
ChatGPTThrow away a page import that shouldn't be saved: a bad photo, the wrong page, or a duplicate. Nothing is added to the logbook. Confirm with the pilot first. Pages already saved can't be discarded here.
edit_logbook_page_rows
ChatGPTRecord the pilot's corrections to a page waiting for review. Pass the revision from the last get_logbook_page_import or edit result; if the page changed since, nothing is applied and the current rows come back. Rows are the numbers TopLog returned. Values: hours as decimal numbers (1.3), counts as whole numbers, text as strings, null to clear. Dates are edited with year, month and day. Use startYear to answer a yearQuestion (it sets every row's year, carrying over Dec→Jan). excludeRows drops rows that aren't real flights (e.g. a totals line); restoreRows undoes that. All changes in one call apply together or not at all.
export_logbook
ChatGPTCreate a downloadable PDF or TopLog CSV of saved flights, optionally filtered by dates, aircraft, role or text (the same matching as search_flights). Works when the account's plan includes export; it doesn't use up any allowance. Returns a private file link valid for up to 15 minutes; give it only to the pilot, never to another site or tool. Only adds a new file: it never removes or changes flights, imports or earlier export links (with ten unexpired links on the account, it asks the pilot to wait instead). Includes all matching flights, beyond search's listing limit. The CSV leaves out TopLog's internal entry references and photo links. It doesn't save pending imports. PDF defaults to the account's country; CA, US and AU formats and compact, split or paper layouts are available.
get_logbook_page_import
ChatGPTOne logbook page import. While the page is still being read this waits up to 20 seconds; call again if it's still processing. When it's ready it returns numbered rows as read off the page (with the pilot's corrections so far applied), warnings, a yearQuestion when the page's year needs the pilot's confirmation, changesFromPage, and problems that would block saving. Show the pilot the rows, call out warnings and problems, and ask about anything unclear.
get_logbook_summary
ChatGPTThe pilot's logbook totals: total time (including starting total time), PIC, SIC, dual, last 30 days, number of flights, turbine time, and time by aircraft type and by time type. Hours are decimal.
get_toplog_account
ChatGPTWho is connected: name, email, plan, how many entries are in their logbook, their entry allowance, and the logbook country used to read their pages. Call this first in a conversation, and tell the pilot which account is connected so they can switch if it's the wrong one.
import_logbook_page
ChatGPTImport a photo of one paper pilot logbook page that the pilot attached. TopLog reads it in the background (usually under a minute); then call get_logbook_page_import with the returned importNumber. If get_toplog_account shows no logbookCountry, ask the pilot which country their logbook is from and pass it as logbookCountry. Don't transcribe the page yourself.
list_logbook_page_imports
ChatGPTLogbook page imports that are waiting for review (scanned in the TopLog iPhone app or attached here), still being read, or failed in the last week. Use it when the pilot asks to review their latest scan.
open_logbook_page_editor
ChatGPTOpen the visual editor for a logbook page: source photo with zoom, editable flight rows, warnings, exclusions and explicit save confirmation. First read the page with get_logbook_page_import. Pass the same importNumber. Clicks and chat corrections share the same draft. This tool opens the editor but does not change or save any flights.
save_logbook_page
ChatGPTSave a reviewed page's rows (minus excluded rows) to the pilot's logbook. Only call this after showing the pilot the final rows and getting their confirmation. Pass the revision they confirmed. Saving the same page again doesn't duplicate entries.
search_flights
ChatGPTFind saved flights. Filters combine and match the same flights export_logbook would include. Returns the most recent matches (up to limit) plus counts and hour totals across all matches, so questions like 'how much A320 time did I log in 2024' need one call. Role and dual totals follow the logbook summary's rules: a DUAL flight counts its whole flight time as dual received. Totals don't include the pilot's starting total time; use get_logbook_summary for overall totals. When the aircraftType has other spellings in this logbook (C172 vs C-172), they're listed in otherAircraftTypeSpellings and aren't included.