# TruTec API

> REST API and hosted MCP server for TruTec: AI site measurements from aerial imagery, customers, sites, jobs, estimates and proposals, job costing, webhooks and bulk export.

- Base URL: https://trutec.ai/api/v1 (header `X-API-Key: sk_...`)
- MCP server: https://trutec.ai/api/v1/mcp
- OpenAPI 3.1 spec: https://trutec.ai/developers/openapi.yaml
- Every page in one file: https://trutec.ai/developers/llms-full.txt

## Get started

- [Build on TruTec](https://trutec.ai/developers/index.md): A REST API, webhooks, bulk export and a hosted MCP server for your TruTec workspace. Measure sites from aerial imagery and keep customers, sites, jobs and estimates in sync with your own systems.
- [Authentication & API keys](https://trutec.ai/developers/authentication.md): Every call carries a workspace API key. Choose what each key can do, keep separate keys for test and production, and rotate them without downtime.
- [Sandbox & testing](https://trutec.ai/developers/sandbox.md): Build and test against a separate sandbox workspace with sample data, then switch to your production key.
- [Errors & retries](https://trutec.ai/developers/errors.md): Status codes, the error body, and which requests are safe to retry.
- [Limits & billing](https://trutec.ai/developers/limits-and-billing.md): What the API costs, what uses measurement credits, and how fast you can call it.
- [Versioning & changes](https://trutec.ai/developers/versioning.md): How the API is versioned, what can change without notice, and how we announce breaking changes.
- [Data ownership & security](https://trutec.ai/developers/data-and-security.md): Your company's data is yours. Read it, change it and export all of it at any time, and keep what you pull in your own systems.

## Measure

- [Measure a site](https://trutec.ai/developers/measure-a-site.md): Send an address, a box, an outline, named areas or property parcels and get back paved area, stalls, striping and markings measured from aerial imagery.
- [Saved measurements & imagery](https://trutec.ai/developers/measurements.md): Read the takeoffs your team saved in TruTec, download their map exports and imagery, and find out which imagery they were measured on.
- [Saving & managing takeoffs](https://trutec.ai/developers/takeoffs.md): Save a detection onto a job as a takeoff, rename or delete takeoffs, and read every quantity a takeoff provides, by item and by service.
- [Editing takeoff shapes](https://trutec.ai/developers/takeoff-editing.md): List the shapes on a saved aerial takeoff and add, remove, reclassify, retype or rephase them, saved the same way the takeoff editor saves.
- [Blueprint takeoffs](https://trutec.ai/developers/blueprints.md): Measure a paving job from its PDF plan set — store the sheets, set their scale, run the takeoff models on the site plan, clean up the shapes and read the quantities.
- [Landscaping](https://trutec.ai/developers/landscaping.md): Landscape takeoffs end to end. Measure lawns, beds and trees on aerial imagery, count plants on a landscape plan, read irrigation, and change the results the way the editor does.
- [Measurement result reference](https://trutec.ai/developers/measurement-reference.md): Every field in a detection result, the category list, and the units each quantity uses.
- [Condition ratings (PASER & PCI)](https://trutec.ai/developers/condition-ratings.md): Rate pavement condition from one image or a location and get a PASER rating or a PCI score with the distresses found.

## Sales & CRM

- [Customers & sites](https://trutec.ai/developers/customers-and-sites.md): Create, find, update and archive the customer companies and job sites in a workspace, keyed by your own ids, and read their people, jobs and re-bids.
- [Customer portal](https://trutec.ai/developers/customer-portal.md): Turn a customer company's portal on or off, and get or reset its private link.
- [Contacts](https://trutec.ai/developers/contacts.md): Read and write the people you work with, their phones and emails, their roles at customers and sites, and who is on each job.
- [Leads](https://trutec.ai/developers/leads.md): Send new requests into the lead inbox from your website or other systems, and read, assign, mark contacted, move forward or dismiss them.
- [Notes & tasks](https://trutec.ai/developers/notes-and-tasks.md): Write notes and log calls, emails and meetings on jobs, contacts and customers; read activity logs and customer history; create and complete follow-ups.
- [Inbox & notifications](https://trutec.ai/developers/inbox-and-notifications.md): Read the email you sent customers and the replies that came back, see which replies still need an answer, and read your notifications, @mentions and the Daily Summary.
- [Email & text customers](https://trutec.ai/developers/messages.md): Email or text a customer about a job, a contact or a company, exactly like the Email and Text buttons in TruTec, and read texting conversations and message templates.
- [Custom fields](https://trutec.ai/developers/custom-fields.md): List and add your workspace's own fields on jobs, customers, contacts and sites, and read and write their values.
- [Re-bids, reminders & My day](https://trutec.ai/developers/rebids-and-reminders.md): Create re-bid jobs, snooze or decline re-bids, add past work, work the contract-renewal and maintenance reminders, update many follow-ups at once, and set "remind me" and birthday follow-ups.
- [Merge & search](https://trutec.ai/developers/merge-and-search.md): Search the whole workspace like the search box in TruTec, and merge duplicate customers, contacts and sites after previewing what moves.
- [Sales automation](https://trutec.ai/developers/sales-automation.md): Read and change the jobs pipeline's automation settings, build company pipeline automation rules, and launch, pause, resume or stop email campaigns.

## Estimating & proposals

- [Catalog](https://trutec.ai/developers/catalog.md): Read and set up the estimating catalog — services with their recipes and qualifiers, the crews, equipment, materials, trucking, subcontractors and overhead they cost out with, vendors and their prices, groups, and bulk import.
- [Estimates & proposals](https://trutec.ai/developers/estimates-and-proposals.md): Read estimates as structured data, and build them from your own systems — create, add and price lines, issue versions, mark them won or lost, and start change orders.
- [Proposals](https://trutec.ai/developers/proposals.md): Create the customer proposal for an estimate, edit its wording, email it to the customer, and track when it's viewed, accepted and signed.
- [Proposal workflow](https://trutec.ai/developers/proposal-workflow.md): Approve held sends, void or delete proposals, manage e-signature requests, make customer copies, switch terms and payment terms, add library content, arrange items, apply designs, and manage proposal templates and clauses.
- [Quote requests (RFQs)](https://trutec.ai/developers/rfqs-and-subcontractors.md): Ask suppliers and subcontractors for prices on an estimate's materials, equipment, trucking and sub work, record their quotes, compare them and lock the winner into the bid.
- [Subcontract agreements](https://trutec.ai/developers/agreements.md): Send subcontractors an agreement to e-sign, text them the link, track who has signed, sign for your company, and delete unsigned ones.
- [Production work orders](https://trutec.ai/developers/production-work-orders.md): Turn a won estimate into the crew's production sheet — header, one row per service with tons, gallons and square feet, crew plan — edit it, mark it issued or done, and put it in the crew packet.

## Jobs & field

- [Jobs](https://trutec.ai/developers/jobs.md): Create, find and update jobs, keep them in sync with your own system, and read their photos, proposal maps and change orders.
- [Delete, merge & follow-ups](https://trutec.ai/developers/job-cleanup-and-follow-ups.md): Delete a job, merge a duplicate job into the one to keep, and start, stop or check a job's automatic follow-up emails.
- [Photos & files](https://trutec.ai/developers/photos-and-files.md): Upload, read, edit and delete job photos, and the documents on jobs and customers, with signed download links.
- [Site assessments](https://trutec.ai/developers/site-assessments.md): Read and record field walkthroughs: assessments, the pins dropped on the site with their quantities, notes and photos, and totals per service.
- [Job details, tags & share links](https://trutec.ai/developers/job-details-and-links.md): The job page's detail fields, job number, tags, site, division and operations assignee; the customer portal conversation; and the links you hand out (review requests, photo reports, chosen photos, assessment reports, capital plans).
- [Warranty](https://trutec.ai/developers/warranty.md): Send customers their warranty packet when a job is done, send warranty work notices, and track every coverage item and when it ends.

## Operations

- [Schedule & crews](https://trutec.ai/developers/schedule-and-crews.md): Read and build the crew schedule, schedule won work from the queue, move and staff visits, publish to crews, and manage crews and the people on them.
- [Customer notices & dispatch](https://trutec.ai/developers/customer-notices-and-dispatch.md): Tell the customer when their work is scheduled, record their approval of a date, send the dispatch packet to crews, and manage the crew's packet link.
- [Holds & schedule requests](https://trutec.ai/developers/holds-and-schedule-requests.md): Pencil a date onto the schedule before the work is won, turn it into a real visit, and handle teammates' requests for a date, a move or a skipped day.
- [Crew messages](https://trutec.ai/developers/crew-messages.md): Read and post in a job's office-to-crew chat, and send one message to every crew with work coming up.
- [Job operations & materials](https://trutec.ai/developers/job-operations.md): Move a won job through your operational stages, record material orders and supplier availability, tick off supplier confirmations, and move cards on the Operations Pipeline.
- [Timesheets](https://trutec.ai/developers/timesheets.md): Read crew clock-ins and clock-outs, add missed shifts, correct punches with an audit trail, and approve or void time.
- [Change orders](https://trutec.ai/developers/change-orders.md): List, create and edit change orders on a job, send them to the customer for approval, and approve, decline or void them.
- [Job warranties](https://trutec.ai/developers/job-warranties.md): Draft no-charge warranty work on a job, email the customer a link to approve it, and void it.
- [Daily logs](https://trutec.ai/developers/daily-logs.md): Read each visit's daily log and the crew's daily reports, add office notes, and approve or send back a day.

## Money

- [Job costing](https://trutec.ai/developers/job-costing.md): Read and record a job's actual costs, and read its crew labor, invoices and crew and equipment allocation, plus a feed of every site with completed work.
- [Invoices & payments](https://trutec.ai/developers/invoices-and-payments.md): List and read invoices, draft invoices from line items, edit them, email them to the customer, mark them sent, paid or void, or put them back to draft. Read payments.
- [Owner reports](https://trutec.ai/developers/owner-reports.md): Run the reports from TruTec's Reports page (money owed, cash forecast, KPIs, win / loss, bid vs actual and more), read labor hours by person, day and job, and a month's revenue and direct cost per job.

## Workspace

- [Users & workspace](https://trutec.ai/developers/users-and-workspace.md): Read the workspace profile, plan and products, team members with their roles and teams, and invite new members by email.
- [Settings](https://trutec.ai/developers/settings.md): Read and change the workspace's settings — company profile, branding, units, estimating defaults, sales tax, proposal terms, job numbering and intake, takeoff, photo, scheduling and notification preferences — and its pipeline stages, job types and pick lists.

## Integrate

- [Webhooks & events](https://trutec.ai/developers/webhooks-and-events.md): Signed webhooks with retries and replay, plus an ordered event feed you can page with a cursor for incremental sync.
- [File exports](https://trutec.ai/developers/exports.md): Get any file the TruTec app can download (proposal PDFs, estimate and catalog workbooks, work orders, payroll, job costing, invoices, assessment reports, takeoff maps and KMZ, customer and job lists, management reports) as a 24-hour link.
- [Bulk data export](https://trutec.ai/developers/bulk-export.md): Stream whole datasets (customers, jobs, estimates, invoices, costs, labor, events) as JSON Lines, full or incremental, whenever you want.
- [AI assistants (MCP)](https://trutec.ai/developers/mcp.md): Connect ChatGPT, Claude, Cursor, VS Code or any MCP client to your TruTec data. Sign in with TruTec, or use an API key with the same permissions as the REST API.
- [Partner API](https://trutec.ai/developers/partner-api.md): For software platforms that resell or embed TruTec: create and manage customer workspaces, bill sessions, mint embed sessions, and test with sandbox dev keys.