Presets

Get a specific preset version

Returns the full content of a specific version of the preset row for the requested scope. Pulls from the live table if the version is current, otherwise from the temporal history table.

get/v1/presets/versions/{version}

Request

Base URL: https://api.handoff.ai
URL: https://api.handoff.ai/v1/presets/versions/{version}
Auth: HTTP bearer

Path parameters

versioninteger required

Version number to fetch.

Example:3

Query parameters

forType'MATCHING' | 'ESTIMATE' | 'TAKEOFF' | 'TRADE_REPORT'

Preset workflow type. Defaults to MATCHING.

Example:MATCHING

storeReferencestring

Store/region identifier scoping the preset row.

Example:STORE-NYC-001

customerReferencestring

Customer identifier scoping the preset row.

Example:CUST-12345

targetClientIdstring uuid

Response

Version returned.

presetIdstring uuid nullable required

Unique identifier for this preset configuration. Null if no presets exist yet.

storeReferencestring nullable required

Store reference if store-specific, null otherwise

customerReferencestring nullable required

Customer reference if customer-specific, null otherwise

forType'MATCHING' | 'ESTIMATE' | 'TAKEOFF' | 'TRADE_REPORT' required

Preset workflow type

presetsstring[] required

List of preset instructions

versioninteger required

Monotonic version number for this preset row. Starts at 1 and increments on every write.

changeDescriptionstring nullable required

Description of the change that produced the current version, or null for pre-versioning rows.

createdAtstring date-time required

ISO 8601 timestamp of preset creation

updatedAtstring date-time required

ISO 8601 timestamp of last update

warningsstring[]

Non-fatal validation warnings for the saved presets (e.g. a TAKEOFF_PRODUCT: tag naming an unknown product — such presets never apply to any job until fixed)

Example response

{
  "presetId": "e3f4a5b6-c7d8-4e9f-0a1b-2c3d4e5f6a7b",
  "storeReference": "STORE-NYC-001",
  "forType": "MATCHING",
  "presets": [
    "Include 10% waste factor for all lumber",
    "Prefer in-stock items over special orders",
    "Use premium grade materials for structural components"
  ],
  "version": 3,
  "changeDescription": "Added premium-materials preset for high-end residential customers",
  "createdAt": "2025-12-05T16:30:00Z",
  "updatedAt": "2025-12-05T16:30:00Z",
  "warnings": [
    "Preset 2 has an unrecognized TAKEOFF_PRODUCT tag (\"WINDOW_DOORS\") and will never apply to any job"
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.