add_absence
ChatGPTMark a person as absent (sick, leave, weather or other) for a day or a range of days (YYYY-MM-DD, team timezone), like the app's 'I did not work' dialog on an empty timesheet day. One absence per day: an existing absence that day gets its reason changed. Refused for days that already have shifts and for days in a locked pay period. Workers can only mark themselves. For planned vacation, prefer request_time_off + approve_time_off. Undo with remove_absence. (Changes data.)
add_shift
ChatGPTAdd a completed shift manually (forgot to clock in). Times are YYYY-MM-DDTHH:MM in the team's local time (offset optional). A shift is one day: start and end on the same local day; work past midnight = two shifts. (Changes data.)
approve_joining_request
ChatGPTLet a requester join the team (id from list_joining_requests). They become an active member with the given role (default worker, like the app). Refuses if an active member already has their email or phone. (Changes data.)
approve_material_cost
ChatGPTApprove a pending material cost. (Changes data.)
approve_time_off
ChatGPTApprove a pending time-off request and record the days as leave. (Changes data.)
assign_equipment
ChatGPTSet who holds a piece of equipment, or unassign it (used_by_member_id null). Does not change its status. Membership id from list_members (id, not user_id); equipment id from list_equipment. (Changes data.)
award_pay_item
ChatGPTGive an employee a standalone pay item on a calendar day, without a shift. Uses the configured price. manual_roles must allow your role; [] is automatic only. Workers may award only themselves. Locked periods require an admin unlock. Use list_pay_items for the value it accepts. Reuse request_id when retrying the same award to prevent double pay. (Changes data.)
cancel_time_off
ChatGPTCancel (delete) your own time-off request while it is still pending, like the Delete button in the app. Approved or denied requests can't be cancelled this way. Ids from list_time_off. (Changes data.)
clock_in
ChatGPTStart an open shift on a job (no end time). Fails if the person already has an open shift. (Changes data.)
clock_out
ChatGPTEnd an open shift; computes hours and applies the team's automatic break rule. ALWAYS pass end_time when closing a forgotten shift from an earlier day (defaults to now, refused when that would book more than 16h). Pass shift_id when the person has several open shifts. (Changes data.)
convert_estimate_to_invoice
ChatGPTCreate a draft invoice from an estimate (same customer, job, line items and tax rate; next INV- number; due date from the team setting / 30 days), like the app's Create invoice action. The estimate itself is left unchanged; use update_estimate to mark it accepted/completed. (Changes data.)
create_crew
ChatGPTCreate a crew with a foreman (required, like the app), an optional name and colour, and optionally its members (same effect as set_crew_members). Put it on jobs afterwards with schedule_job. user ids from list_members. (Changes data.)
create_customer
ChatGPTCreate a customer record (name, plus optional email, phone, address and notes) that jobs, estimates and invoices can be attached to. Check list_customers first to avoid a duplicate. (Changes data.)
create_equipment
ChatGPTAdd a piece of equipment (tool, vehicle, machine) to the team's equipment list. Starts as available unless a status is given. Optionally assign it to a member (membership id from list_members). Use set_equipment_status / assign_equipment / update_equipment to change it later. (Changes data.)
create_estimate
ChatGPTCreate an estimate (draft unless status given). (Changes data.)
create_form
ChatGPTBuild a new custom form. fields are in display order; types: shortAnswer, paragraph, email, phone, website, dropdown/multipleChoice (need options), checkbox, number (min/max), rating (1-5 by default), date, time, datetime, jobSelector, userSelector, equipmentSelector. Unpublished by default: set is_published true to let the crew fill it. (Changes data.)
create_group
ChatGPTStart a named group conversation with teammates (user_ids from list_members; the user is added automatically), optionally with a first message from the user. Returns the channel id for send_chat_message. (Changes data.)
create_invoice
ChatGPTCreate an invoice (draft unless status given). (Changes data.)
create_job
ChatGPTCreate a job. The site address is required and is geocoded so the job can be geofenced: run geocode_address first and pass the confirmed latitude/longitude. (Changes data.)
create_job_task
ChatGPTAdd a task from the team's task list to a job (task ids from list_job_tasks → available_tasks), optionally with a quantity and job-specific name/number/unit/description. (Changes data.)
create_line_item_template
ChatGPTSave a reusable line item template. (Changes data.)
create_material_cost
ChatGPTRecord a material cost (manual entry, PO, bill or receipt) with line items. Submitted for approval (status pending) unless draft is true. (Changes data.)
create_note
ChatGPTCreate a note for the user (markdown body, optional todos). (Changes data.)
create_supplier
ChatGPTAdd a supplier / vendor. Refuses if one with the same name exists (returns its id). Check list_suppliers first. (Changes data.)
create_task
ChatGPTAdd a task to the team's catalogue. category groups tasks (reuse an existing one from list_tasks when it fits). (Changes data.)
create_work_order
ChatGPTCreate a work order; only title is required. Reuse request_id when retrying to get the same number. Optional forms, crew/member assignments and job/customer/machine links. (Changes data.)
delete_cost_object
ChatGPTDelete a cost object that nothing has been charged to. If anything was charged, archive it with save_cost_object instead. Confirm with the user first. (Changes data.)
delete_crew
ChatGPTDelete a crew. Its members stay on the team (unassigned) and their schedule entries from this crew are removed; the job's calendar blocks keep their dates but no longer have a crew. Crew ids from list_crews. (Changes data.)
delete_customer
ChatGPTPermanently delete a customer. Their jobs, estimates and invoices are kept but still point at the deleted customer id. Confirm with the user first. (Changes data.)
delete_equipment
ChatGPTPermanently delete a piece of equipment from the team's list (its past usage logs stay). Confirm with the user first. (Changes data.)
delete_estimate
ChatGPTPermanently delete an estimate. Confirm with the user first. (Changes data.)
delete_invoice
ChatGPTPermanently delete an invoice. Confirm with the user first. (Changes data.)
delete_job
ChatGPTPermanently delete a job, like the job form's Delete. Only possible while nobody has logged time on it (otherwise set it inactive with update_job). Can't be undone. (Changes data.)
delete_job_task
ChatGPTRemove a task from a job (the task stays in the team's task list). (Changes data.)
delete_line_item_template
ChatGPTDelete a line item template. Existing estimates/invoices keep their copied lines. (Changes data.)
delete_material_cost
ChatGPTPermanently delete a material cost / receipt. Owners, admins and managers can delete any; others only their own while draft or pending. Confirm with the user first. (Changes data.)
delete_note
ChatGPTDelete a note you wrote or one shared with the team, with its photos and recordings. Can't be undone. (Changes data.)
delete_pay_item
ChatGPTDelete a pay item and its automatic rules. It's no longer offered on shifts or as a job default; shifts that already have it keep it. Awards already given stay on reports and are never changed. (Changes data.)
delete_photo
ChatGPTPermanently delete a job photo (the file and its gallery entry). Photo id from list_job_photos. (Changes data.)
delete_shift
ChatGPTPermanently delete one shift entry (id from get_shifts). Refused in a locked pay period. Confirm with the user first. (Changes data.)
delete_work_order
ChatGPTDelete a cancelled work order only if no costs have been charged. Owner/admin/manager only. (Changes data.)
deny_joining_request
ChatGPTTurn down a joining request (id from list_joining_requests): the request is deleted, nobody is added. (Changes data.)
deny_time_off
ChatGPTDeny a pending time-off request (id from list_time_off). The employee sees it as denied; it cannot be approved afterwards. (Changes data.)
duplicate_estimate
ChatGPTCopy an estimate (customer, job, line items, tax, notes, validity) into a new draft with the next EST- number, like the app's Duplicate action. estimate_id from list_estimates. (Changes data.)
duplicate_invoice
ChatGPTCopy an invoice into a new draft with the next INV- number and a fresh due date (team setting / 30 days), like the app's Duplicate action. invoice_id from list_invoices. (Changes data.)
export_timesheet
ChatGPTTimesheet for a pay period as CSV text (hours are decimal, dates YYYY-MM-DD in the team's timezone). layout 'summary' (default) matches the app's payroll export: per employee one row per job (Employee, Start date, End date, Job, Total hours[, Rounded total]), then a Rounding row and a Total row. layout 'shifts' lists every shift and absence day (Employee, Date, Type, Job, Start, End, Break minutes, Hours, Notes). Omit dates for the current pay period. The app's Excel (.xlsx) file itself isn't produced here.
fetch
ChatGPTFull text of one search result by its id from search (e.g. job:abc, estimate:xyz, note:123). Returns { id, title, text, url, metadata }; text is markdown with line items and totals for estimates, invoices and material costs. Permissions are re-checked.
file_to_job
ChatGPTPut a copy of a file (a chat attachment's url or storage_path) into a job's Files tab, in a folder (created if new). The original stays where it is. (Changes data.)
geocode_address
ChatGPTLook up an address and return up to 3 matches with coordinates. Do this before creating a job and confirm the match with the user when there is more than one.
get_customer
ChatGPTOne customer in full: contact details, notes, their jobs, estimates and invoices (numbers, status, totals).
get_daily_report
ChatGPTOne person's daily report for a day in full: per job, each answer with its field label, and whether it was submitted. Pass report_id (from list_my_daily_reports / get_daily_reports) or a date (+ user_id; default yourself). Workers can open only their own.
get_daily_report_counts
ChatGPTWho filed daily reports between two dates (inclusive, max 62 days) and how often: per person, days filed (a day counts once any job entry is submitted), job entries submitted, drafts; plus active members who filed none. For one day's contents use get_daily_reports.
get_daily_report_form
ChatGPTThe team's daily report form: each field's id, label, type, whether it's required, and its options. Read it before submit_daily_report / update_daily_report to know the field ids.
get_daily_reports
ChatGPTDaily reports for a day: who filed, per-job entries and answers. For who filed over a date range (and how often) use get_daily_report_counts.
get_equipment
ChatGPTOne piece of equipment in full: type, model, number, status, who holds it, and its recent usage log per job.
get_estimate
ChatGPTOne estimate in full: line items with totals, subtotal, tax, total, customer, job, validity.
get_form
ChatGPTA form's settings and its fields in order (id, type, label, required, options/choices, limits). Field ids are the keys submit_form expects.
get_invite_link
ChatGPTThe team's shareable join link (same as the QR in the app's members list). Anyone who opens it files a joining request that an owner/admin still approves. Reuses the current link (valid 30 days); fresh=true revokes it and makes a new one. (Changes data.)
get_invoice
ChatGPTOne invoice in full: line items with totals, subtotal, tax, total, customer, job, due date.
get_job
ChatGPTFull job record including tasks and schedule blocks.
get_material_cost
ChatGPTOne material cost / receipt in full: line items, subtotal, tax, total, vendor, status. Foremen and workers can open only their own.
get_member
ChatGPTOne team member in full: contact details, role, employee number, crews, whether they're clocked in now. Workers can open only themselves.
get_note
ChatGPTOne note by id (from list_notes or search_notes): full markdown body and its todos.
get_pay_period_summary
ChatGPTPayroll summary for one pay period: per person, paid hours (after breaks), break and on-site minutes, days worked, hours per job, open shifts, absence days by reason, rounded total (team rounding setting), whether they've been checked off as reviewed and whether they have a personal unlock. Omit dates for the current period from the team's payroll settings (period_index 1 = previous). The app computes no overtime, so none is returned. Related: list_pay_periods, lock_pay_period, mark_payroll_reviewed, export_timesheet.
get_photo
ChatGPTOne job photo by id (from list_job_photos / search_team_photos) with its description and a download url valid about 1 hour.
get_quickbooks_status
ChatGPTWhether the team is connected to QuickBooks Online (company, who connected it, when), which JobSnap records are auto-created in QuickBooks, and the last sync. Pass entity_id (a customer, job, estimate or invoice id) to check whether that record is linked to QuickBooks. Linked records sync automatically whenever they change.
get_schedule
ChatGPTWho is scheduled on which job between two dates (crew schedules). Workers see their own.
get_shifts
ChatGPTList shifts (time entries) in a date range. Workers see only their own. Returns hours worked, breaks, job and notes.
get_team
ChatGPTThe company's settings: name, timezone, address, public email/phone, job statuses (names + '#RRGGBB' colours, is_active), GPS tracking level, time settings (start of work day HH:MM, require GPS, allow time edits, automatic break in minutes), daily report settings (due time HH:MM, summary recipients as user ids, field labels) and enabled features. Owners/admins also see estimate/invoice defaults (tax_rate is a PERCENT, periods in minutes).
get_work_order
ChatGPTWork order with forms/submission status, status history, costs (including who recorded each and unassigned markers), photos and invoices. Invoice data is limited to owner/admin.
grant_pay_period_unlock
ChatGPTLet one person's time be edited again inside a closed (locked) pay period, like the lock icon next to a name on the app's payroll screen; granted=false takes the unlock back. The period stays locked for everyone else. Dates are the pay period's first and last day (YYYY-MM-DD, inclusive); omit them for the current period (period_index 1 = previous). To reopen the whole period use lock_pay_period with locked=false. (Changes data.)
invite_member
ChatGPTAdd a new employee. Owners/admins create the member directly (role default worker; the app texts/emails them a sign-in link when they have a phone or email; with neither they're a stub who can't sign in yet). Managers/foremen can't create members: this files a joining request (full name, email AND phone required) that an owner/admin approves with approve_joining_request. Refuses if an active member already has that email or phone. (Changes data.)
list_channels
ChatGPTThe user's chat conversations, most recent first: the company channel, groups, job chats and direct messages they belong to, with the last message. Channel ids feed read_channel and send_chat_message.
list_cost_objects
ChatGPTThe team's costing setup: Equipment Repair on/off, the groups (max 3), whether work orders are enabled, and the cost objects (things like Safety, Travel, Training that time and costs can be charged to instead of a job).
list_crews
ChatGPTCrews with foreman, members and assigned jobs.
list_customers
ChatGPTSearch customers by name, email, phone or address.
list_equipment
ChatGPTEquipment with status (e.g. available / in use / maintenance / broken) and who has it.
list_estimates
ChatGPTEstimates with customer name and total, optionally by status (one or several) or customer, plus the total number matching.
list_form_submissions
ChatGPTSubmitted forms, newest first, with every answer. Filter by form and/or by the job picked in a job field. Owner/admin/manager/foreman see everyone's; workers see only their own.
list_forms
ChatGPTThe team's custom forms (inspections, checklists, sign-offs…), newest first. Workers only see published forms. Use get_form for a form's fields, submit_form to fill one.
list_invoices
ChatGPTInvoices with customer name and total, optionally by status (one or several) or customer, plus the total number matching. Due dates are ISO strings.
list_job_files
ChatGPTFiles and folders in a job's Files tab (optionally inside a folder, e.g. 'Plans/2026'). Use it to pick an existing folder name before filing something.
list_job_photos
ChatGPTJob photos, newest first, with the AI description and a download url valid about 1 hour. Filter by job, uploader and/or a date range (YYYY-MM-DD, team timezone, inclusive). For finding photos by what they show, use search_team_photos.
list_job_tasks
ChatGPTTasks (cost codes from the team's task list) assigned to a job, with quantity and unit, plus available_tasks: active catalog tasks not yet on the job (their ids go to create_job_task).
list_jobs
ChatGPTSearch jobs by name, number, client or address. Returns id, status, address, customer, and the total number of matches.
list_joining_requests
ChatGPTPeople waiting to join the team (from the invite link, company search, or a foreman/manager's invite), newest first. Approve with approve_joining_request or deny with deny_joining_request.
list_line_item_templates
ChatGPTThe team's reusable line items (title, description, default unit price, unit), A→Z, optionally filtered by text. Use them to fill line_items in create_estimate/create_invoice (quantity 1 by default).
list_material_costs
ChatGPTMaterial costs / receipts / POs, optionally by job or status, with each one's total and the total number matching. Foremen and workers see only the ones they filed.
list_members
ChatGPTTeam roster with roles and user ids.
list_my_daily_reports
ChatGPTYour own daily reports between two dates (default the last 14 days): date, jobs reported, submitted or draft. For the whole team on one day use get_daily_reports.
list_notes
ChatGPTThe user's notes (and, with include_team, notes shared with the team): title, kind, todos, linked job/customer.
list_pay_item_awards
ChatGPTAutomatic (rule) and standalone manual pay item awards, with ids, source, day, rule, period (a shift/day/week key), employee, amount and waived flag; waived awards are excluded from totals. Workers see their own only. Items picked on a shift are in get_shifts.
list_pay_items
ChatGPTThe team's pay items (travel, allowances, per diems paid on top of hours) and what each accepts, who can add each by hand (manual_roles, can_add) and whether it is also awarded automatically, plus a job's defaults when job_id is given. Owners/admins also get each item's automatic rules. Use before setting pay_items on a shift or editing rules.
list_pay_periods
ChatGPTPay periods with locked state, plus who has been checked off (reviewed) in each.
list_suppliers
ChatGPTThe team's suppliers / vendors (name, email, phone, address, notes), alphabetical, optionally filtered by name. Use the id as supplier_id on material costs.
list_tasks
ChatGPTThe team's task catalogue (cost codes / work items people log time and quantities against), grouped by category. Inactive tasks are hidden unless include_inactive.
list_teams
ChatGPTEvery company this user is an active member of, with their role in each. Use switch_team to change which one the tools act on.
list_time_off
ChatGPTTime-off requests, optionally filtered by status or person. Only owner/admin/manager see other people's.
list_todos
ChatGPTYour open todos across your own notes (like My TODO's), grouped by note, newest note first. include_done adds ticked ones. Tick with set_todo_done.
list_work_orders
ChatGPTList/search work orders by number or title, optionally mine, status, assignee, job, customer or machine. Defaults to open, in-progress and on-hold. Existing records remain readable when work orders are disabled.
lock_pay_period
ChatGPTLock (close) or unlock a pay period, given its first and last day. Creates the period record if the app hasn't yet. (Changes data.)
log_equipment_time
ChatGPTLog equipment usage on a job (minutes) for a day. (Changes data.)
mark_payroll_reviewed
ChatGPTCheck off (or uncheck) an employee as reviewed for a pay period. (Changes data.)
message_member
ChatGPTSend a direct message to a teammate on the user's behalf, in their DM thread; the teammate gets a push notification. Use it for "let X know…". It goes out under the user's name, so write the text in their voice, first person, ready to read as-is. (Changes data.)
move_job_file
ChatGPTMove or rename a file inside a job's Files tab (paths from list_job_files). to_path may be a folder (ending in '/') to keep the name. (Changes data.)
read_channel
ChatGPTRecent messages of a conversation the user belongs to (channel id from list_channels), oldest to newest, with sender names. since = only messages from that time on (YYYY-MM-DDTHH:MM, team timezone).
read_job_file
ChatGPTRead the text of a job file (PDF or text-like; path from list_job_files).
remove_absence
ChatGPTRemove the absence recorded on one day (YYYY-MM-DD) for a person, like clearing the reason in the app's absence dialog. Refused in a locked pay period. To cancel approved time off as a whole, ask an owner/admin to delete the request in the app. (Changes data.)
remove_member
ChatGPTRemove someone from the team (user_id from list_members), like the app's delete: a still-pending invitation is deleted outright; anyone who joined is marked deleted + inactive (their time and history stay). An owner can only be removed by an owner, and never the last active owner. (Changes data.)
remove_pay_item_award
ChatGPTRemove a standalone manual award (id from list_pay_item_awards). Checks current manual_roles and the pay-period lock. Automatic awards must be changed through their rule or source; they cannot be removed by hand. (Changes data.)
request_time_off
ChatGPTFile a time-off request for the user themself (always pending; nobody can file for someone else). (Changes data.)
restore_pay_item_award
ChatGPTPay a waived automatic award again (re-checks the rule). Owner/admin only. Id from list_pay_item_awards. (Changes data.)
save_cost_object
ChatGPTCreate a cost object (omit cost_object_id) or edit one: name, group (id from list_cost_objects, null for none), optional code such as a GL account, archived. Archive instead of deleting once anything has been charged. (Changes data.)
save_pay_item
ChatGPTCreate or edit a pay item (travel, allowance, per diem…) paid on top of hours, optionally with automatic rules (e.g. a bonus when a shift exceeds 9 hours or the daily report is on time). Rule awards use the item's price; manual_roles [] makes it automatic only. Omit id to create; with id, only the fields you pass change. Hours are decimal (0.75 = 45 min). choice/dropdown need options; checkbox needs amount; number needs amount (the rate per unit) and number_unit. Shifts already paid keep their price. (Changes data.)
schedule_job
ChatGPTPut a job on a crew's calendar for a date range (dates only, inclusive). Like the app: weekends and statutory holidays are skipped, overlapping blocks for the same crew are merged, and every crew member gets the days on their schedule. (Changes data.)
search
ChatGPTSearch everything this member can see in JobSnap: jobs, equipment, their material costs, their notes and notes shared with the team, plus team members (owner/admin/manager/foreman) and customers, estimates and invoices (owner/admin). Matches names, numbers, clients, addresses, vendors and note text, typo-tolerant. Returns { results: [{ id, title, url }] } (best first, up to 20); ids look like job:<id>, customer:<id>, note:<id>; pass one to fetch for the full text. For filtered lists use list_jobs, list_notes, etc.
search_documents
ChatGPTFind records by meaning when you don't know the exact name or number (e.g. "the deck job with the rotten joists", "invoice about gutter repairs"). Returns matching text chunks with their record type and id; open the record with the matching get_/list_ tool for details.
search_notes
ChatGPTSearch your notes and notes shared with the team by text (title, body, todos, linked job or customer). Returns previews; open one with get_note.
search_team_photos
ChatGPTFind job photos by what they show (e.g. "damaged gutter", "blue excavator"), using the photos' AI descriptions. Optionally limit to one job or uploader. Best matches first, each with a download url valid about 1 hour.
send_chat_message
ChatGPTPost a message as the user into a conversation they belong to (company channel, group, job chat or DM; channel id from list_channels). Members get a push notification. It goes out under the user's name: write it in their voice, ready to read as-is. For a DM to someone without an existing thread, use message_member. (Changes data.)
send_checklist
ChatGPTPost a checklist as the user into a team conversation they belong to (company channel, group, job chat or DM; channel id from list_channels), e.g. a punch list in a job chat. Items can be assigned to members of that conversation (user_ids from list_members): assigned items show up in that person's My TODOs. For a checklist just for the user, use create_checklist instead. (Changes data.)
set_checklist_items
ChatGPTTick or untick items of a checklist in a team conversation (ids from read_channel). Pass every item to change in one call. An assigned item is marked for its assignee, a shared one for the user. thread_root_id when the checklist is a thread reply. For checklists in your own conversation with the user, use tick_checklist. (Changes data.)
set_cost_groups
ChatGPTReplace the team's cost object groups (max 3, each with a label and an icon). Pass existing ids to rename or reorder; a group that cost objects still use can't be removed. Owner/admin only. (Changes data.)
set_costing_switches
ChatGPTTurn Equipment Repair charging on or off, and/or enable or disable work orders for the team. Disabling keeps all records and blocks new work orders and new charges. Owner/admin only. (Changes data.)
set_crew_members
ChatGPTSet exactly who is in a crew (the full list; omitted people are removed). Like dragging people on the app's scheduling whiteboard: a person is in one crew at a time, so anyone added is moved out of their other crew; people added get the crew's scheduled job days on their schedule and people removed lose them. The foreman is separate (update_crew). Ids from list_crews / list_members. (Changes data.)
set_equipment_status
ChatGPTSet a piece of equipment's status (available, in_use, maintenance, broken) and who holds it. Setting it available releases the holder. (Changes data.)
set_job_pay_item_defaults
ChatGPTOverride, for one job, how pay items start on its new shifts (otherwise each pay item's team show_on_shifts setting applies). defaults: keyed by pay item name or id — option label, true (checkbox), a quantity (number) to pre-fill, or null to go back to the team setting. show: items shown empty for the crew to fill in. hide: items only offered via Add pay item on this job. Other entries on the job stay. See list_pay_items for what each accepts. (Changes data.)
set_quickbooks_auto_create
ChatGPTTurn QuickBooks auto-create on or off per record type (customers, jobs, estimates, invoices): when on, new JobSnap records of that type are created in QuickBooks automatically. Requires a connected QuickBooks (see get_quickbooks_status). (Changes data.)
set_todo_done
ChatGPTTick or untick a todo inside one of the user's notes. (Changes data.)
set_work_order_settings
ChatGPTEnable/disable work orders or change the number prefix. Existing numbers and records are kept. Owner/admin only. (Changes data.)
submit_daily_report
ChatGPTFill in and submit your own daily report for one job on one day, like the Daily report screen. Answers are merged into what's already there (null clears a field). Required fields of the team's form (get_daily_report_form) must be filled to submit; pass submit=false to save a draft. Date defaults to today (team timezone). (Changes data.)
submit_form
ChatGPTFill in and submit a published form as the user. answers maps each field id (or exact label) from get_form to its value: text for text/email/phone/website/dropdown fields; a list of option strings for multipleChoice; true/false for checkbox; a number for number/rating; YYYY-MM-DD for date, HH:MM for time, YYYY-MM-DDTHH:MM (team timezone) for datetime; the id for job/user/equipment fields (from list_jobs / list_members / list_equipment, or a listed choice). Required fields must be answered. (Changes data.)
submit_material_cost
ChatGPTSubmit a draft material cost for approval (draft → pending). Foremen and workers can submit only their own. (Changes data.)
summarize_hours
ChatGPTTotal hours per person and per job over a date range. Workers get their own totals only.
switch_job
ChatGPTClose the current open shift and open a new one on another job at the same instant. (Changes data.)
switch_team
ChatGPTMake every following call act on another company the user belongs to (see list_teams). Only for external AI clients; the in-app assistant is already scoped.
transition_work_order
ChatGPTStart, hold, resume, complete, cancel or reopen. Cancellation needs a reason. Required forms must be submitted before completion. Assignees and office roles operate; only owner/admin/manager reopen. (Changes data.)
unschedule_job
ChatGPTTake a job off a crew's calendar: removes that crew's blocks (all of them, or only those overlapping a date range) and the members' schedule entries. (Changes data.)
update_crew
ChatGPTRename a crew, change its colour or its foreman. Members: set_crew_members. Crew ids from list_crews. (Changes data.)
update_customer
ChatGPTUpdate a customer's contact details or notes. (Changes data.)
update_daily_report
ChatGPTChange answers in an existing daily report (yours, or anyone's as owner/admin) for one job. Answers merge into the entry (null clears a field); submitted=true submits it (required fields checked), false puts it back to draft, omitted leaves it as is. An entry left with no answers is removed, and the report with it when empty. (Changes data.)
update_equipment
ChatGPTEdit a piece of equipment: name, type, model/serial, equipment number, status. Only the fields you pass change; pass null to clear type/model/equipment_number. Ids from list_equipment. To change who holds it use assign_equipment. (Changes data.)
update_estimate
ChatGPTUpdate an estimate's status, notes, line items, customer or job. (Changes data.)
update_form
ChatGPTChange a form's title, description, publishing, public link, notification emails, or replace its fields (pass the full list in order; keep each existing field's id from get_form so past answers stay linked; fields left out are removed). Set deleted true to delete the form. (Changes data.)
update_invoice
ChatGPTUpdate an invoice's status (sent/paid/overdue/cancelled), due date, notes, line items, customer or job. (Changes data.)
update_job
ChatGPTUpdate a job's name, address, customer, status, sales status or scheduled dates (status/sales status: owner/admin; scheduled dates: owner/admin/manager). (Changes data.)
update_job_task
ChatGPTChange a job task's quantity or its job-specific name/number/unit/description (null reverts to the task list's value). Ids from list_job_tasks. (Changes data.)
update_line_item_template
ChatGPTChange a line item template's title, description, default unit price or unit. template_id from list_line_item_templates. (Changes data.)
update_material_cost
ChatGPTEdit a material cost / receipt / PO (id from list_material_costs). Only the fields you pass change; pass null to clear. line_items REPLACES the whole list (send every line; keep each line's id to keep it). tax_rate is a PERCENT (15 = 15%); changing it drops the printed tax_amount so the rate drives the total, like the app. status may move between draft and pending (use approve_material_cost to approve; moving an approved cost back needs owner/admin/manager). supplier_id (from list_suppliers) also sets vendor_name. Foremen and workers can edit only their own costs, and not once approved. (Changes data.)
update_member
ChatGPTEdit a team member (user_id from list_members). Owners/admins: first/last name, employee number, role, status (inactive = can't sign in to this team), require GPS, and email/phone only for a member who has neither yet (adding one sends them an invitation). Everyone else may only change their own chat_enabled / daily_reports_enabled notification flags. The owner can't be demoted or deactivated by anyone else, admins can't make owners, and the team always keeps one active owner. (Changes data.)
update_my_email_preferences
ChatGPTTurn the signed-in user's own weekly emails on or off (Profile settings in the app). weekly_report_emails = their personal weekly timesheet email (their own hours, for every company they're in). weekly_team_report_emails = the weekly team hours report owners get, for every company they own. Per person, not per company; only for the signed-in user. If the user asks for an email or notification setting this doesn't cover, say it can only be changed in the app instead of changing something else. (Changes data.)
update_note
ChatGPTEdit a note you wrote or one shared with the team: title, markdown body, kind, todos (full list; keep a todo's id to keep it, omit id for a new one), linked job (null unlinks). Only the author can change who sees it (private / team). To just tick a todo use set_todo_done. (Changes data.)
update_shift
ChatGPTEdit a shift's times (YYYY-MM-DDTHH:MM local), break, job or notes. Hours are recalculated. (Changes data.)
update_supplier
ChatGPTEdit a supplier (id from list_suppliers). Only the fields you pass change; null clears. Renaming does not rewrite vendor_name on past costs. (Changes data.)
update_task
ChatGPTEdit a catalogue task (task_id from list_tasks). status inactive hides it from pickers without losing history. (Changes data.)
update_team_settings
ChatGPTChange company settings, like the app's Company, Time and Daily report settings screens. Only the fields you pass change. job_statuses REPLACES the whole ordered list (read get_team first; existing jobs keep their current status copy). automatic_break: pass null to turn it off. daily_report_due_time is HH:MM on the hour or half hour; summary recipients are user ids from list_members. Can't touch billing/trial. (Changes data.)
update_work_order
ChatGPTUpdate only the named fields. assignee_ids and forms replace their lists; crew_ids adds current crew members. Use [] to detach all forms or unassign everyone. (Changes data.)
waive_pay_item_award
ChatGPTSet aside an automatic (rule) award so it is not paid; it is kept so its rule can't recreate it. Owner/admin only; locked periods need an unlock. Undo with restore_pay_item_award. Id from list_pay_item_awards. (Changes data.)
who_is_clocked_in
ChatGPTWho is clocked in right now: open shifts started today (workers: only themselves). Open shifts from earlier days are not counted as clocked in; they are reported separately as missing_end_time (count plus the 10 most recent) so they can be fixed with clock_out and an end_time.
whoami
ChatGPTThe member these tools act as: user id, name, role, team and timezone.