Presets

List preset versions

Lists every version of the preset row for the requested scope, newest first. Includes the current version (from the live table) plus every prior version archived in the temporal history table.

Use this to render a version timeline. Each entry omits the full presets array — fetch /v1/presets/versions/{version} for full content.

get/v1/presets/history

Request

  • Base URL: https://api.handoff.ai
  • URL: https://api.handoff.ai/v1/presets/history
  • Auth: HTTP bearer

Query parameters

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

Preset workflow type. Defaults to MATCHING.

Example:MATCHING
storeReferencestring

Store/region identifier. If provided, returns history for this store's presets.

Example:STORE-NYC-001
customerReferencestring

Customer identifier. If provided, returns history for this customer's presets.

Example:CUST-12345
targetClientIdstring uuid

Response

Version list returned successfully (may be empty if no presets exist for the scope).

Example response

{
  "versions": [
    {
      "presetId": "e3f4a5b6-c7d8-4e9f-0a1b-2c3d4e5f6a7b",
      "forType": "MATCHING",
      "version": 3,
      "changeDescription": "Added premium-materials preset for high-end residential customers",
      "createdAt": "2026-04-12T16:30:00Z"
    }
  ]
}

Changes

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