BOLDR MAX

Create a section (a table definition) in a job. tableConfig defines the columns; form groups created from the section become its rows. Column types: text | number | measurement | angle | boolean | singleSelect | multiSelect | formula | conversionTable | instructions.

create_section

Create a blank annotation canvas (sketch) in a group. Draw on it with apply_canvas_ops. Auto-named "Canvas N" when name is omitted.

create_canvas

Create a reusable job template (column + tolerance configuration) in the organization library. API-created templates are always org-private.

create_template

Create up to 50 form-group rows in one section atomically. Cells are keyed by column id; measurement/angle cells take a VALUE (number, measurement string like "3' 4-1/2\"", or {value, label, note}) and the measurement docs are created for you — never pass measurement ids here. Other column types take the same values as set_cell_value. Prefer this over repeated create_group/create_measurement calls.

create_groups

Permanently delete a file and its stored content (binary, thumbnail, annotations). Confirm with the user first.

delete_file

Permanently delete a formula from the org library, or from a template (pass templateId). Confirm with the user first.

delete_formula

Permanently delete a group and (via the backend cascade) its measurements and files. The Default group cannot be deleted. Confirm with the user first.

delete_group

Permanently delete a job AND everything under it (groups, measurements, files) via the backend cascade. This cannot be undone — confirm with the user first.

delete_job

Delete a job folder. Jobs inside it are NOT deleted — they are moved out (folderId reset to '').

delete_folder

Permanently delete an org label (including its preview and cell images). Confirm with the user first.

delete_label

Permanently delete a measurement. Any form cell referencing it is cleared to empty. Confirm with the user first.

delete_measurement

Permanently delete a project AND everything under it (folders, jobs, groups, measurements, files) via the backend cascade. This cannot be undone — confirm with the user first.

delete_project

Permanently delete a section AND all of its groups (their measurements and files cascade). This cannot be undone — confirm with the user first.

delete_section

Permanently delete an org template with its files and formulas. Confirm with the user first.

delete_template

Apply a batch of annotation operations to a file's canvas atomically, using the same reducer the apps run. The operation set is closed and fully schematized in the ops union — these twelve and nothing else: addStroke / updateStroke / removeStroke (freehand strokes), addShape / updateShape / removeShape (rectangles, ellipses, text, and lines — an arrow is kind 'line' with style.cap 'arrow'; style.cap decorates the end and style.startCap the start, each 'arrow' | 'butt' | 'round' | 'square', and strokes take the same cap/startCap at their top level), addMeasurement / updateMeasurement / removeMeasurement (measurement tiles placed on the canvas), setLayers (replace the layer list), setTileScaleFactor and setTileDocSize (tile sizing). When asked to label a measurement, tile, or measurement annotation, ALWAYS set the measurement's own label with update_measurement (tiles render measurement.label first) — never labelOverride, which is a canvas-only caption that leaves the measurement unlabeled everywhere else; reserve it for an explicitly canvas-specific caption. For paged PDF documents (pdfCanvas files) pass page — each page has its own canvas in PDF-point coordinates (origin top-left; see get_canvas for the page size). On template canvases a tile needs only columnId (a column of the template's tableConfig): the server stamps the groupId link that binds it to the form field when the template is imported. The remove* ops and setLayers discard elements permanently.

apply_canvas_ops

Run a calculator's equations against supplied input values and return the computed outputs. Keys of `inputs` are field ids (see get_calculator). Measurement fields accept a number in the field's unit or a measurement string like "3' 4-1/2\""; angle fields take degrees; select fields take an option string.

evaluate_calculator

Produce the full CSV export of a job — the same file the BOLDR apps generate — with all cell values, computed formula columns, and measurements formatted in the requested unit.

export_job_csv

Step 2 of a direct upload: after the bytes were PUT to the URL from get_upload_url, validates them and attaches the file to the group or template chosen in step 1 — photos become annotation canvases, PDFs become paged PDF documents, exactly like upload_file.

finalize_upload

Scan every toleranced value in a job and return the ones outside their tolerance bounds, ranked by deviation severity. Deviation is a percentage of the allowed tolerance range (100% = at the bound).

find_out_of_tolerance

Step 1 of uploading a file whose original bytes are on disk (an attachment in a sandbox, a local file) or too big to inline (up to 25 MB; PNG/JPEG/PDF, SVG also for template files): returns a one-time URL. PUT the raw bytes to it from a shell — curl -X PUT --upload-file <path> "<putUrl>" — then call finalize_upload with the uploadId. The bytes go directly to BOLDR storage without passing through this conversation. The URL expires in 15 minutes and accepts exactly one PUT.

get_upload_url

Fetch one template in full (tableConfig with options, tolerances) plus its files and formula count. Resolves org templates first, then the public/shared pool.

get_template

Read a file's Skia annotation canvas (strokes, shapes, placed measurements, layers) — group files or template files (templateId). Paged PDF documents (pdfCanvas files) keep one canvas per page: pass page (default 0); coordinates are PDF points, origin top-left. Edit with apply_canvas_ops.

get_canvas

Fetch a calculator: its input and output fields (with units and options) and the equations linking them. Use it to learn what inputs evaluate_calculator needs. Set includeDiagram to also see the labeled diagram image.

get_calculator

How a job's toleranced measurements have tracked over time: per-day (or per-week) counts, out-of-tolerance counts, and average/worst deviation as a percentage of the allowed range. Useful for 'is accuracy improving?' questions.

get_deviation_trend

Fetch one file (group file, or template file via templateId): notes return their full text; photos and image files return the image inline (thumbnail by default) plus a 15-minute signed URL for the full-resolution original; other binaries (PDF, 3D) return the signed URL only.

get_file

One-call snapshot of a job: metadata, sections (the column schemas), and groups with their filled-in cell values and measurement counts. Cell values are formatted in the requested unit. Formula-column values are computed by the apps and omitted here — use export_job_csv for fully computed rows.

get_job_details

Completion statistics for a job: overall progress, per-section cell fill counts, measurement counts, and how many toleranced values are in or out of tolerance.

get_job_progress

Roll up completion across every job in a project: per-job progress (0–1, maintained by the backend) and project-level summary. Cheap — use get_job_progress for a per-section breakdown of one job.

get_project_progress

Save a construction calculator from the library into a group as a calculator instance file — the same file the apps' run screen saves. The definition is frozen into the file (it keeps working if the source calculator changes) and the diagram with its thumbnail comes along. Pass inputs to pre-fill input fields (field id → value, parsed exactly like evaluate_calculator); computed outputs are never stored — the apps derive them live, and evaluate_calculator shows them here.

import_calculator

Import a whole table (e.g. a CSV) in one call: creates a section from column definitions (column ids are generated server-side) and all rows with their measurements. Row cells are keyed by column NAME; measurement/angle cells take values exactly like create_groups. Max 50 rows per call — for more, follow up with create_groups using the returned column ids.

import_table

Browse the construction-calculator library (stair, rafter, volume, conversion calculators and more). source: 'public' = the REEKON-curated library, 'shared' = calculators shared specifically with this organization.

list_calculators

List files attached to a job's groups — photos and documents (type 'annotation'), notes, sketches ('canvas'), labels — or a template's files (pass templateId instead). Use get_file to read a note or view an image. With projectId+jobId only, sweeps the whole job (capped).

list_files

List the organization's formula library, or a template's (pass templateId). Pass formulaId to fetch one formula in full (including variableToColumnMap). Formulas compute derived values from measurement columns.

list_formulas

List a project's job folders. Jobs reference folders by folderId ('' = not in a folder).

list_folders

List the jobs in a project. progress is a 0–1 completion fraction maintained by the backend. Note: nameContains filters within each page — keep paginating while nextPageToken is present.

list_jobs

List the org's printable-label library (or the public pool with source 'public'). Pass labelId to fetch one label in full with a 15-minute preview-image URL.

list_labels

List measurements for one group (paginated) or for the whole job (capped). Values are formatted in the requested unit; length values are stored internally in micrometers (valueRaw), angles in signed degrees. Rows include tolerance status where the group defines tolerances.

list_measurements

List the projects in the organization. Note: nameContains filters within each page, so a filtered page may be short — keep paginating while nextPageToken is present.

list_projects

List reusable job templates (column and tolerance configurations). source: 'org' = this organization's private templates, 'public' = the public library, 'shared' = templates other orgs shared with this one.

list_templates

Lock a measurement column to a fixed display/entry unit (the apps' "Lock units"): every value in the column shows in that unit for all users, and bare-number inputs to create_measurement/create_groups for the column are read in it (measurement strings with an explicit unit still win). Pass unit: null to remove the lock.

set_column_unit_lock