add_code_source
ChatGPTSets or replaces a draft project's source for a building code its drawings reference (codeName from get_project codeSources): a public URL, or one of the project's files that is the code book. The public URL may be fetched to read the code. Codes the drawings do not reference cannot be added.
add_saved_files_to_project
ChatGPTAdds PDFs or DWGs to a draft project's check: saved files, or PDFs or DWGs uploaded in Microsoft 365 Copilot or Teams chat (both from list_saved_files). Groundbook sets each file's type and role; change them only if the user asks.
ask
ChatGPTAsks Groundbook's project assistant about a project's drawings and issues and saves the conversation. It reads sheets, issues, and schedules and answers with references. Uses the project's chat allowance and existing credits. Repeating a question starts another turn and can use more credits. If status is running, call again with the conversationId and no question to collect the answer.
assign_issue
ChatGPTAssigns an issue to someone by email and sends an assignment email. A person outside the project is only invited when grantProjectAccess is true. Repeating an existing assignment does not add another assignee; a failed notification may be retried.
create_project
ChatGPTCreates a draft for a requested Groundbook drawing check and returns its upload link. Check list_projects and list_saved_files for existing drawings first. The person uploads PDF or DWG drawings on the project page; files attached in this chat cannot be sent to Groundbook. Give the project a name and optionally review instructions. Repeating this call creates another draft.
create_smart_overlay
ChatGPTStarts a Smart Overlay: drawings laid over each other in two colors to see what differs. Give PDFs already in Groundbook (documentId from get_project files or list_saved_files); one file compares sheets within it, such as two floors. Returns a link: when the person opens it, the sheets are read, the pairs you name (or matching floors) are set up, and each pair is aligned. Nothing is charged here; each new sheet pair the person opens is one overlay, free at first and then paid with credits (the result says how many free ones are left).
delete_project
ChatGPTPermanently deletes a project with all its files and issues. This cannot be undone. Only the owner can delete.
export_issues
ChatGPTBuilds a PDF report, marked-up drawings, a Bluebeam FDF, or a CSV of a project's issues. Returns an export id; call get_export until it is ready.
get_export
ChatGPTProgress of an export. When ready, the file can be downloaded from the project page's notifications, or with the CLI.
get_fieldwire_send
ChatGPTProgress of a send to Fieldwire: how many tasks were created, updated, pinned on a plan, or failed.
get_issue
ChatGPTOne issue in full: description, impact, recommended fix, every sheet reference with the cited text and any drawing overlay that shows it, assignees, its Fieldwire task, and comments.
get_me
ChatGPTThe signed-in account: email, organization, credit balance, a first-project discount or legacy trial credit when it has one, and what Groundbook can do (features, each with where to start it). Also explains purchase availability for this connection. Credit purchases, reloads, and top-ups are not available in this ChatGPT connection. If the person asks to buy credits, explain that purchases are unavailable in this chat. Do not provide purchase instructions or links, including a website home page used to direct them to billing, checkout, or an upgrade. An informational check-access link may explain existing access; it must not lead them into a purchase flow.
get_project
ChatGPTOne project with its check status and progress, files, review instructions, the language its findings are written in, code sources, and price. Set includeSharing only when the person asks about project access or wants to change sharing.
get_smart_overlay
ChatGPTOne saved Smart Overlay: its files and each pair of sheets laid over each other, with whether the pair is aligned and whether an AI-drafted alignment still waits for the person's review.
give_issue_feedback
ChatGPTRecords whether an issue is correct, with optional reasons: important, low_importance, strong_evidence, wrong_or_missing_evidence, duplicate, unclear, related_issue, incorrect, not_relevant, not_yet_important, other. Optional details explain other. Usefulness is one shared value per issue: setting it replaces it for everyone, null clears it, and leaving it out keeps it.
import_from_egnyte
ChatGPTCopies PDFs or DWGs from the person's connected Egnyte into a draft project. Paths come from list_egnyte_folder. Each file is then analyzed; start_check once every file has finished.
import_from_onedrive
ChatGPTMicrosoft 365 Copilot and Teams only: adds PDFs or DWGs the person uploaded there (they are saved to OneDrive), or any PDF or DWG in their OneDrive, to a draft project. Pass the file names as the person sees them. Files attached in Claude, ChatGPT, or other chats are not in OneDrive: the person uploads them on the project page. Each file is then analyzed; start_check once every file has finished.
list_egnyte_folder
ChatGPTSubfolders and PDFs in one folder of the person's connected Egnyte. Start at the root and walk down to find the drawings, then add them with import_from_egnyte.
list_issues
ChatGPTIssues found on a project, most severe first. Filter by severity, status, discipline, label, file, assignee, overlay, comments, usefulness, or text; leave out every filter the person did not ask for. total is how many match; projectTotal and projectCounts cover the whole project. Each issue has a number, the drawing sheets it cites, its outside sources and code sections, whether a drawing overlay shows it, its Fieldwire task, and a link.
list_project_overlays
ChatGPTThe drawing comparisons on a project's Overlays tab: two sheets laid over each other, what the review concluded (issue_found, no_issue_found, inconclusive, or pending when no result is recorded yet), and the issues each one supports. Filter by outcome or text. Each has a link that opens the two drawings together.
list_projects
ChatGPTProjects this account can open, newest first. Filter by text (address or file name) and status: draft (not started), processing (check running), ready (issues available, or a takeoff delivered while the review still runs: see review), archived (review stopped).
list_saved_files
ChatGPTPDFs and DWGs saved for reuse by this account or its organization, with the projects that already use them, and (in chatUploads) PDFs or DWGs the person uploaded in Microsoft 365 Copilot or Teams chat. Add either kind to a project with add_saved_files_to_project.
list_smart_overlays
ChatGPTSmart Overlays this account saved: drawings the person laid over each other in two colors, newest first, each with its files and link. Also how many free overlays are left and what one costs after that.
remove_code_source
ChatGPTRemoves a building code from a draft project's check.
remove_file
ChatGPTRemoves a file from a draft project. The upload is deleted unless it is a saved file.
remove_project_share
ChatGPTRemoves a person's access to a project, or cancels a pending invitation.
send_issues_to_fieldwire
ChatGPTSends a project's issues to the person's connected Fieldwire as tasks, pinned on the plan when Fieldwire has that sheet. Sending an issue again updates its task. The Fieldwire project is the one the drawings came from when known; otherwise the result lists the projects to choose from. Returns a send id; call get_fieldwire_send until it is done.
set_file_role
ChatGPTMarks a file in a draft project as checked (reviewed for issues) or reference (context only), and optionally sets its file type: Drawing, Specifications, Report, Calculations, Code, Supporting document. Every drawing sheet, whatever its discipline, is a Drawing. Groundbook sets both when files are added; change them only if the user asks.
set_review_instructions
ChatGPTWhat the check should focus on (at least 20 characters), an optional short title, and whether to check against building codes. Set the person's role and project phase here too; both are required before starting a check. Use values the person supplied.
share_project
ChatGPTInvite someone by email to a project, sending an invitation email, or turn organization-wide access on or off. Repeating an invitation can send another email.
start_check
ChatGPTStarts Groundbook's review of a draft project's drawings using existing credits after any first-project discount. If credits do not cover the remaining price, explains the missing access and returns an informational link. Every file must have finished analyzing and at least one must be marked checked. Credit purchases, reloads, and top-ups are not available in this ChatGPT connection. If the person asks to buy credits, explain that purchases are unavailable in this chat. Do not provide purchase instructions or links, including a website home page used to direct them to billing, checkout, or an upgrade. An informational check-access link may explain existing access; it must not lead them into a purchase flow.
unassign_issue
ChatGPTRemoves an assignee from an issue, by assignee id (from get_issue assignees) or by email.
update_issue
ChatGPTChanges an issue's severity, status (open, reviewed, resolved, dismissed, or a project status), or labels.
update_project
ChatGPTRename a project, set the language its findings are written in, or add a custom issue status or discipline to it.
add_code_source
Claudeadd_saved_files_to_project
Claudeask
Claudeassign_issue
Claudebuy_credits
Claudecreate_project
Claudecreate_smart_overlay
Claudedelete_project
Claudeexport_issues
Claudeget_export
Claudeget_fieldwire_send
Claudeget_issue
Claudeget_me
Claudeget_project
Claudeget_smart_overlay
Claudegive_issue_feedback
Claudeimport_from_egnyte
Claudeimport_from_onedrive
Claudelist_egnyte_folder
Claudelist_issues
Claudelist_project_overlays
Claudelist_projects
Claudelist_saved_files
Claudelist_smart_overlays
Clauderemove_code_source
Clauderemove_file
Clauderemove_project_share
Claudesend_issues_to_fieldwire
Claudeset_file_role
Claudeset_review_instructions
Claudeshare_project
Claudestart_check
Claudeunassign_issue
Claudeupdate_issue
Claudeupdate_project
Claudeupload_files
Claude