Change Log

New Features

• Custom API Endpoints can now be managed over the API: create, list, get, update and delete them under /insites/api/v2/endpoints, gated by the instance API key. Every endpoint must carry at least one authorization policy (no public-by-omission), the slug and file path are namespace-validated, inputs are allow-listed, and each change is recorded in the event stream. Documented under the new API section in the API docs.
• The Instance API Key policy can now be selected on the Authorization Policies dropdown when configuring a Custom API Endpoint.
• Documented the error response standard on the API Overview page — the error envelope fields, plus per-item results and success/fail/total counts for bulk ("Add Multiple") endpoints.
• Documented the GeoJSON serialization standard — GeoJSON values are sent as JSON-encoded strings and returned as parsed JSON objects.
• New "Controllers" section on the API Overview — what a controller is, how to call one with {% function %}, and when to use a controller instead of the HTTP API. Includes explicit guidance for AI assistants so generated on-instance Liquid uses controllers rather than HTTP calls.
• Endpoint documentation now renders a Controller Contract section (stability, returns, errors, and silent failures) for any controller that declares a contract in its front matter, in both the HTML docs and the Markdown export.

Improvements

• Example HTTP and Controller requests are now rendered in read-only code editors, and the Copy Request button copies the exact raw text.
• Authorization header examples now use the {API_KEY} placeholder consistently across every endpoint and module.
• Renamed "GraphQL Name" to "Display Name" on the Add and Edit GraphQL pages.
• Updated the cancel button icon on the Custom API Endpoint pages.
• Removed unused total counts from internal GraphQL queries.

Bug Fixes

• Bulk ("Add Multiple") endpoints now display their real array-of-objects request example instead of a placeholder or a single object.
• Appending .md to a documentation URL now redirects to the real Markdown version instead of returning HTML with a markdown content type. Fixed the CMS, Forms, Permissions, and Stripe reference sections rendering another module's content.
• Controller request examples now pass the payload with the correct params: params named argument, so the example is copy-paste-valid.
• cURL examples now escape apostrophes correctly, so a copied command runs as-is instead of breaking at the shell.
• The Markdown documentation now shows a literal & in cURL example URLs and example data, instead of an HTML-escaped &.
• The API Overview now documents the search, sort, and pagination defaults accurately: defaults are noted as resource-specific rather than universal, and a dotted search field (e.g. company.name) is documented as returning an error.

New Features

• Add event financial reporting: Revenue/Expenses/Net P&L/Margin % columns on All Events, a Financials tab with a Highcharts waterfall, a Net P&L header chip, and a per-user Ex-Tax/Gross toggle.
• Redesign the event detail page on an operations-first layout: header with operational counters and countdowns, left-column summary cards (Reference, Venue), and a horizontally-scrolling tab rail.

Improvements

• Group Event Details tab fields into logical sections.
• Add Archive path to Reassign drawer empty-states.
• Document nested file keys on Event upload/gallery, Speaker image, Sponsor logo, and Expense attachment/invoice fields.
• Add explicit error-message prop to Canonical URL field.
• Add id to nested object refs in Events API v2 example responses.
• Default list columns now include Revenue, Expenses, Net P&L, and Margin % between Event Start Date and Status.

Bug Fixes

• Fix silent image upload failures, missing Android Camera option, and reactive-Proxy/gallery-uuid upload bugs.
• Fix orphaned commas/spaces in PDF ticket venue address.
• Normalize Events datetime fields to ISO 8601 UTC, reject naive input, and fix a Liquid syntax error in validate_datetime_fields.
• Remove unused total_entries selections from Events GraphQL queries.
• Fix URL validation.
• Hide Link/Password fields for venue events and add URL validation parity with CRM Company Website.
• Restore pricing tier archive/restore/reassign feature.
• Fix pricing division migration data loss and non-idempotency.
• Remove dead pricing field references from event_pricing_division GraphQL that always resolved to null.
• Guard pagination totalCount against undefined to fix a recurring console error across Speakers, Sponsors, Venue Contacts, System Fields, and other list pages.
• Fix event import silently discarding ticket prices, and silently discarding whole pricing divisions when venue/area info is missing; prevent duplicate divisions on re-import.
• Fix event detail page timezone, pagination, and stale-validation bugs; correct day/hour countdown boundary math; show Net P&L/Margin % as neutral/0% instead of red or a dash at zero.
• Wrap the event title instead of truncating it, hide the date line when no date is set, and remove the Ticket Layout summary card pending a real rendered-ticket thumbnail.

New Features

• Add per-database webhooks for item and configuration events.
• Add Address UI element with Google Places autocomplete.
• Add Create Database endpoint to the Platform API v2.
• Add Soft Deleted item count column to the Databases list.
• Link email field to CRM contact from database record, with tooltip and no-match text.

Improvements

• De-duplicate Display Fields options and already-saved column settings.
• Return database_id from custom-database lookup queries.
• Store array-type field values as arrays via the v2 item API.
• Flatten databases list response to a standard shape.
• Pluralize the database segment in v2 item API paths.
• Include image/file URLs in external item API results.
• Relabel Reports API Calls chart to External API Calls.
• Stack checkbox field options vertically to match the radio field.
• Make System Info tab items full width on the database item view.
• Set Data list search placeholders.
• Update delete-database confirmation modal to match Figma.
• Switch database item restore history icon and fix History drawer timeline bullet colours.

Bug Fixes

• Show data source display value instead of the raw UUID/ID in the Database Items list and v2 API.
• Show the Reports date filter in the instance's localisation date format, fixing invalid-date submission and a cold-load race condition.
• Fix multi-select/data-source lookup fields not rehydrating saved values, guard against malformed responses, and correct CRM search matching.
• Fix Address field repopulation, invalid-key flash, and Google Maps state issues.
• Fix optional-chaining bug causing console errors on every item edit; bump axios to 1.19.0.
• Fix emoji import corruption and guarantee import jobs finalise on unexpected errors.
• Fix import jobs never finalising due to malformed log_file JSON; validate import field values.
• Fix Add Item form hanging indefinitely on the loading spinner.
• Fix database item link on belongs-to fields resolving to the wrong item.
• Fix advanced filter chip showing null instead of the actual value.
• Fix filtered database items list showing wrong pager total.
• Fix localisationData timezone key mismatch and drop is_daylight_savings_time.
• Fix broken line breaks in History drawer descriptions.
• Fix quotes and backslashes corrupting item property values.
• Fix Items view crash on deprecated field types and reject them at create time.
• Fix duplicate webhook records, webhook drawer error message, and a deploy-blocking Liquid expression.

API Changes

• External v2 API now served at /data/api/v2; the /databases prefix is deprecated.
• External v2 item update changed from PUT to PATCH.
• Document dot-notation payload format for item add/update APIs.

New Features

• Dedicated stack support. env add now connects to instances on the Insites dedicated stack as well as the shared stack, and works out which one an instance belongs to from its URL.
• Browser-based authorization for the dedicated stack. Pass only the instance URL and the CLI opens the Partner Portal for you to approve, with no email, instance UUID, or portal URL to type.
• New -s, --stack <stack> option on env add to set the stack explicitly when an instance uses a custom domain the CLI cannot classify.
• env list now shows which stack each environment belongs to.
• New check command: lint your Liquid. check run reports offenses grouped by file with the offending lines shown, exits 1 when anything is found, and supports -a autofix, -c to filter to named checks, -f text|json, and -s for errors only. check init writes a configuration file for disabling checks or changing their severity, and check update-docs refreshes the Liquid documentation the linter validates against.
• Language server for Liquid, giving editors and Claude Code hover documentation, completions, go-to-definition, rename, and inline diagnostics.

Bug Fixes

• Restored the logs command. insites-cli logs <environment> returned "unknown command".
• Fixed logsv2 reports failing with a file-not-found error for every report.
• Fixed logsv2 alerts add failing to send Slack alerts.
• Fixed every logsv2 command reporting errors as an empty {}. A missing environment or bad token now prints the real message.
• Fixed insites-cli <command> --help showing the general command list instead of that command's own help.
• Fixed deploy, sync, and modules targeting the wrong Partner Portal for environments on the dedicated stack.

Improvements

• Every env add run reports which stack it selected.
• Existing environments need no migration. Those saved before this release resolve to the correct stack from their instance URL.
• logs and logsv2 now have distinct descriptions in the help output.

Notes

• On the dedicated stack, only the Partner Portal is supported so far. Logs and deployment events still route through the shared hosts.
• Larger install than 5.9.2, from the linter and language server.

Features

• Add show_in_quick_view toggle to ManageCustomField and filter in ViewOpportunity; add custom field columns to All Opportunities table
• Add Sort Activities button, rich text notes editor, wider activity drawer
• Add Mark as Won/Lost/Withdrawn to board card menu
• Add clear option to Lost Reason; fix Task Related Record hiding after category clear
• Add Name (email) label format to CRM-contact select options; add contact email as mailto link
• Pin Contact/Company/Lead Referred By/Form Submission on board card; add CRM links with hover icon
• Add id to nested object refs in opportunities API example responses
• Add LocalisationServices and wire setLocalisation on app mount

Bug Fix

• Fix task completion on Lost — use lowercase 'completed'/'open' status values; complete linked tasks; warn about linked tasks on Lost/Delete
• Fix response headers (response_headers: JSON syntax) and add Deprecation: true header to v1 opportunities route
• Comment out deleted_at from graphql mutation return fields; remove redundant deleted_at filters
• Fix Vue warnings in Reports
• Malformed UUID returns 400; add OPTIONS pages for collection and single-resource
• Fix F4 anti-patterns — replace direct axios.post with postWebhook service helper
• Fix date filter — change Target Conversion Date ui_element to date picker; fix date filter format error
• Fix Notes editor pre-populate — wrap setValue in nextTick to avoid Stencil race condition
• Fix board card relative date — use day-level wording (Today/Yesterday/Tomorrow/In X days)
• Update Opportunity Screen UI — status tag colour, contact email_2, company filter, copy icon hover, layout/card updates, Playwright E2E tests
• Fix data source foreign_property, Form Submissions tab blank issue, and Form Submission Details display
• Fix status validation, DELETE 204, filter opportunity_uuid from custom fields schema; fix sub-resource routing
• Fix missing-partial errors in v2 API — add blank line after frontmatter in 23 controller files
• Board view: remove breadcrumbs, fix column height/hover states/dark mode background; separate Board/Table View routes
• Fix exists condition on custom field filters — emit boolean true not quoted empty string; add custom field filtering
• Fix filter chip showing UUID — resolve display names for data source filters
• Fix activity drawer footer z-index overlap and remove list shadow
• Fix Notes editor not pre-populating on edit; fix dropped characters in Notes/Message fields
• Activities toolbar: remove Filter label, move sort after filter, add small-breakpoint layout
• Fix board card task row — icon visibility, text colour, DD MMM date format, layout, hover tooltip
• Fix board card custom fields and rendering; fix custom field values not showing/saving
• Remove ins-table shadow in task drawer
• Fix confetti firing on edit of already-Won opportunity; fire only on transition to won; replace with canvas-confetti fireworks
• Include scoped InputColor CSS in build output; fix stage colour picker
• Fix TypeError on Reports page — optional chaining in 7 report components; fix custom date range label
• Fix filter not applying and no-results empty state card in Opportunities view
• Add blank line after frontmatter in get_pipeline.liquid; fix colour picker # prefix; fix TypeError on .results
• Fix blank lines, trailing newlines, remove insites-tools.log from tracking; add path frontmatter to pipeline partials
• Fix TypeError on .remove(); fix Add Pipeline button loading state and save crash
• Fix tab routing errors and Vue warnings in Opportunities board/activity views
• Fix System Fields pagination, search bar visibility, and page size mismatch
• Add get_pipeline_details controller partial; fix edit pipeline page not loading
• Fix custom field values not showing in InfoCard/edit form; fix uuid display_field; fix data source lookup stuck loading
• Fix System Fields delete modal — add DELETE type-to-confirm input; update copy
• Fix pipeline stage API — block phantom sub-resource routes, add id to nested pipeline in stage responses
• Reduce board card sub-detail gap from 8px to 4px
• Fix task detail link opening with error in new tab
• Fix stage order not saving — sync drag state to reactive data
• Remove is_daylight_savings_time from localisationData localStorage
• Auto-select current date and time when opening Add Activity form
• Add task name link to details page and --iia-main hover colour in Opportunity Tasks
• Fix date fields to follow instance localisation format across forms
• Fix opportunity owner field using wrong lookup endpoint
• Fix board view NaN date display and target conversion date saving as null
• Fix table view loading — keep table mounted and use ListPage loadingScreen overlay
• Fix board view No Stage Added state — visibility, content height and small paragraph
• Show ADD PIPELINE button in header when search returns no results
• Restore total_entries in get_sales_target.graphql
• Split list/detail routes into separate endpoints for exact slug matching
• Replace hardcoded date/time display formats with localisation helpers

Improvements

• Update delete confirmation modal copy, button labels and DELETE input to match Figma
• Various build/lint/CSS cleanup (chunk-vendors build artifact, ESLint globals, insites-tools.log removal from tracking)

Hot Fix

• Fix activity Notes editor not loading its saved value on edit
• Fix activity Date/Time defaulting to today on edit — only default for new activities
• Make email activity Message a rich-text HTML editor; render as HTML in the timeline (SMS stays plain text)
• Fix opportunity Media File/Image custom fields not loading on edit — resolve __field property_upload in get_details and use InsInputFileWrap setFiles

Release Date: June 11, 2026

New Features

• Percentage Processing Fee — Orders and quotes now support a percentage-based processing fee via the is_percentage_processing_fee flag (default: false / fixed amount). The processing_fee_amount is automatically computed server-side on every save using the order/quote base (subtotal + tax + shipping − discounts, clamped to $0). Applies across the v2 API, CSV import, and quote-to-order conversion.
• Auto-generated Quote Number — quote_number is now automatically generated from the record ID on creation. The field is no longer required on POST or CSV import.

Bug Fixes

Quotes

• GET list and GET single: items[] flattened to canonical shape; id added to all nested objects
• POST: quote_status defaults to Draft when not supplied; enum and reference integrity validation added; quote_contact_id correctly derived; geo_json cascade fixed
• PATCH: enum validation and reference integrity checks added; quote_number now enforced
• DELETE: items[] flattened; id added to nested objects

Orders

• GET list and GET single: items[] flattened to canonical shape; doc examples corrected
• POST: items[] flattened in response; *_contact_id fields removed (not in schema); geo_json cascade fixed
• PATCH: items[] flattened in response; order_company correctly marked as not required

Order Items

• POST/PATCH: response shape corrected; null validation and UUID guards added
• PATCH: empty-string order.uuid now rejected
• GET list: page/size required flags corrected; 400 example fixed; nested id fields added

Order Discounts

• id added to nested order and discount objects across GET list, GET single, DELETE
• POST: UUID guards and enum validation added

Order Shipping Packages

• Status enum validation added to POST
• GET list: required flags corrected; sort validation added
• DELETE 200 example aligned with live response

Payments

• POST/PATCH: reference integrity and enum validation; null protection added
• DELETE: nested order id added; stale enum values removed; 404 shape corrected
• GET list: stale enum examples removed; unreachable 400 removed
• GET single: path param display and nested order id fixed

Quote Discounts

• GET single 404 and DELETE 404 doc examples aligned with live response shape
• POST: reference integrity and enum validation added
• PATCH: validation and doc fixes
• GET list: unreachable 400 example removed
• id added to nested quote and discount objects

Quote Items

• POST: reference integrity validation and doc fixes
• id added to nested objects in DELETE 200 doc example

Quote Shipping Packages

• POST: reference integrity and enum validation added
• GET list: page/size correctly marked Optional
• Doc: invalid enum values corrected; id added to nested objects

System Fields

• POST: success status corrected to 200; enum validation added
• PATCH: 404 guard and enum validation added
• DELETE: 404 guard prevents GraphQL internals leaking in error responses

Custom Fields

• DELETE now returns the deleted record; non-numeric id validation added
• Category and product custom field doc schema and example accuracy fixes

Configuration

• Stripe config: partial PATCH now preserves unset fields; non-boolean livemode rejected
• PATCH: empty-string rejected for measurement_unit and weight_unit

Freight Suppliers

• Fixed size field drift in DELETE
• page/size correctly marked Optional in GET list doc
• DELETE 200 example aligned with cURL path record

Products

• CSV SKU import is now atomic per row; duplicate SKU errors include the conflicting UUID
• effective_price is now always computed server-side on create/update and cannot be overridden via the API or CSV import
• Backfill migration recalculates effective_price on all existing products and variants using paginated queries (500 per page) to avoid table locks

Improvements

• id sub-field added to all nested relation objects (order, quote, contact, company, discount, product, product variant) across orders and quotes v2 API responses and doc examples
• All v2 API doc examples updated to reflect live response shapes
• Unreachable 400 examples removed from GET list endpoints across orders and quotes
• Stale enum values removed from payments and order shipping package docs
• CSV import templates for orders and quotes now include the Is Percentage Processing Fee column

Breaking Changes

• v2 API — Response shape: items[] on orders and quotes has been flattened from { id, properties: { uuid, ... } } to a flat object { id, uuid, ... } across all endpoints (GET list, GET single, POST, PATCH, DELETE). Any client reading item.properties.* will break.
• v2 API — Stricter validation: Enum fields on orders and quotes POST/PATCH now reject invalid values with 400. Previously invalid values were silently accepted.
• v2 API — Reference integrity: Quotes PATCH now rejects non-existent relation UUIDs. Order items POST and order discounts POST now reject empty or invalid UUIDs.
• v2 API — Required field: quote_number is now required on quotes PATCH.
• v2 API — Removed field: *_contact_id fields removed from Orders POST — these were not in the order schema and are no longer accepted.
• v2 API — Computed field: processing_fee_amount is now server-computed on every save. Any client-supplied value is ignored and overwritten. Clients should stop sending this field and read it back from the response.
• Products — effective_price — effective_price on products and product variants now always stores the ex-tax active list price. Previously it stored the raw sale_price or regular_price regardless of tax-inclusive flags.
  • Values change for tax-inclusive catalogs. Catalogs with is_tax_included, is_sale_price_tax_included, or is_variant_sale_price_tax_included set to true will see effective_price change after the backfill migration runs.
  • Listings sorted or filtered by effective_price will reorder. Re-test any storefront listing, sort, or price-range filter that reads this field.
  • effective_price is read-only. It is computed server-side on every create/update; values sent in POST/PATCH bodies or CSV imports are ignored and overwritten — read it back from the response.
  • total_price is unchanged. It stays tax-inclusive.

New feature

• Event Stream now records every create / update / delete made through the v2 API, matching the coverage already in place for admin-UI actions.
• Add POST /crm/api/v2/custom-fields/contacts endpoint.
• Add POST /crm/api/v2/custom-fields/companies endpoint.
• v2 Activity responses now expose created_by (set once at creation, immutable on edit) alongside last_updated_by, so the original creator stays visible after the activity has been edited.

Security

• Upgrade axios to ^1.16.0 to pick up upstream security patches; admin UI now handles 401 responses cleanly without throwing.
• Admin sessions opened via 2FA or SSO now respect the configured platform session timeout.
• Breaking — v2 API authentication failures now return an inline 401 JSON response ({"error":"unauthorized"}) on the original URL across all HTTP methods. Previously the response was a 302 redirect to the login page; clients that followed the redirect must update to handle the 401 directly.

Breaking changes

• v2 action endpoints (archive / restore / complete / open on contacts, companies, tasks) switched from PATCH to POST. PATCH on these URLs now returns 405. API clients must update to POST.
• v2 DELETE endpoints now return 204 No Content (was 200 with body). DELETE against a missing resource returns 404 with a documented JSON body, and against a structurally invalid uuid returns 400 with a clean JSON body.
• Custom-fields create error response key changed from errors (array) to singular error (string). Clients that parse the errors array on this endpoint must switch to error.

Improvements

• CRM address autocomplete migrated to the new Google Places API (PlaceAutocompleteElement), keeping the feature working as Google retires the legacy widget.
• Settings → Instance Configuration: the page no longer flashes a "Failed to fetch Instance Configuration Details" error during the backend's reconnect heartbeat, and now connects through the production WebSocket endpoint.
• v2 API documentation refreshed across the board to match the v5.14.1 contract — HTTP methods, URL bases, request/response examples, body-field tables, and field-mapping notes have all been corrected and aligned with what the API actually returns.

Bug fixes

• Fix broken redirects when the configured old_url contained a leading slash (was producing double-slash URLs).
• Fix table pagination crash on CRM Tasks, CRM Activities, Tasks List, and Dashboard when loading a page.
• Task detail panel and edit drawer now reflect changes immediately after saving an edit, without needing a page reload.
• Partial PATCH on /v2/contacts/{uuid} now preserves every untouched property — previously, sending only the field you wanted to change could either return a 400 error or null out the rest of the contact.
• Fix task edit drawer showing the wrong due date for tasks that already had one stored.
• Partial PATCH on /v2/tasks/{uuid} and /v2/tasks/comments/{uuid} no longer returns 400 when the request body omits a field; untouched properties are preserved, matching the contacts behaviour.

New Features

• Move Import Tickets from All Events page to Tickets page.
• Add additional fields to Advanced Filter for Tickets.
• Add link to CRM records on Ticket Details drawer.
• Add Event Name to Tickets export and fix import header mismatch.
• Render Events list date columns in device-local time.
• Show selected timezone on date field labels; update API doc descriptions.
• Sort display field options alphabetically by default.

Improvements

• Update v2 API update endpoints from PUT to PATCH.
• Remove event_uuid from Add Event Tickets example payload; move to controller_payload.
• Regenerate ticket PDF on contact assignment; add loading toast on View PDF.
• Update Sponsors list card layout to group company and sponsorship details.
• Load venue contacts from live venue record when editing event.
• Style circular avatar image on Sponsors and Speakers info cards; add initials fallback.
• Refine sponsor link layout, hit area, and ellipsis truncation.
• Update sponsor card company name and top-alignment styles.
• Update sponsor card link, separator, computation wrapper, and button alignment styles.
• Apply sponsor card styling to Speaker list cards.
• Centre-align Speakers card content and set inner gap.
• Venue contact card: hover/remove action, compact treatment, and button alignment.
• Fix venue contacts card on Event Venue tab.
• Fix duplicate contact re-selection in Assign Contact drawer.
• Enforce required fields on Events, Speakers, and Sponsors PATCH mutations.
• Enforce required fields on Tickets PATCH.
• Enforce question and answer as required on FAQs PATCH.
• Update delete confirmation modal content for tickets.
• Rename area card buttons; update delete confirmation modal for venues.
• Update delete confirmation modal content for system fields.
• Simplify delete pricing tier confirmation dialog text.
• Update division and pricing tier card action button labels.

Bug Fixes

• Fix sponsor link click opening edit drawer.
• Fix group ticket PDF empty content when created via API.
• Fix custom field time/datetime inputs to follow localization time format.
• Fix expense API docs showing incorrect required state for fields.
• Revert System Fields update endpoints from PATCH to PUT.
• Fix filter chips showing UUIDs for Purchased By Contact and Company fields.
• Fix failed to fetch data when filtering by Purchased By Contact/Company.
• Fix Category advanced filter showing invalid text conditions.
• Roll back Tax fields to conditional required and fix Tax* (%) label.
• Fix advanced filter chips not displaying dates using localization settings.
• Fix drawer delete not working on add event ticket list.
• Fix group ticket capacity error handling and drawer delete.
• Fix image upload failing on mobile.
• Fix date format in ticket PDF templates using day instead of month.
• Fix Company label in ticket contact details info table.
• Fix CRM Contact not prefilled when editing a speaker.
• Fix gross/net/tax calculation for expense and revenue fields in Events table.
• Fix page heading gross/net/tax totals and tax column display.
• Fix delete confirmation modals and wrong item deletion bugs.
• Fix ticket delete/PDF bulk action modal titles and button labels.
• Fix event date input/display timezone interpretation.

Improvement

• Faster related_records: Reduced object allocations in related_records, improving performance up to 4x.

• Asset cache invalidation now per-instance: Changed the internal implementation of cache invalidation for assets. The updated=... query parameter appended by the asset_url (and asset_path) filter is now derived from a per-instance assets_updated_at timestamp that is bumped whenever assets change, instead of being derived per asset. This means all asset URLs are invalidated together when any asset is updated, ensuring CDN caches stay consistent.

• Batched page loading on deploy: Pages are now loaded in batches during deploy, providing better support for very large deploys - particularly those containing pages generated by Static Site Generators (SSG).

• Faster Instance Clone asset dump: The asset manifest step of pos-cli clone is significantly faster, reducing the time spent in the export phase of cloning instances with large numbers of assets.

• InstanceClone clone-record status on export failure: Previously, InstanceClone could leave the target instance's clone record in pending indefinitely when export failed (for example due to an oversized file). Failures are now surfaced cleanly as a terminal failed status with a sanitized error message, so pos-cli polling resolves instead of hanging.

New Feature

• cache_control argument for admin_assets_create and admin_asset_update mutations: When provided, the value (for example max-age=31536000, public) is stored in the asset's metadata and applied as the Cache-Control header on the underlying object in the file storage provider (S3, R2, etc.), allowing CDNs and browsers to cache assets according to your policy.

• authorization_policies argument for admin_page_create and admin_page_update mutations: Authorization policies can now be associated with a page by name (the same identifier used in Liquid frontmatter, e.g. page_policy or modules/my_module/page_policy), in addition to the existing authorization_policy_ids. Names and ids can be combined; all provided names must resolve to existing AuthorizationPolicy records.

Deprecation

• Deprecated url argument in admin_assets_create: Asset URLs are now derived from the asset name and the per-instance CDN, so the argument is ignored. Upload bytes via admin_assets_presign_urls first, then call admin_assets_create without the url argument. The argument will be removed in a future release.

New Features

• Per-endpoint Markdown documentation, designed for use with AI assistants. Each endpoint can now be exported as a clean Markdown snippet containing the cURL and Controller request examples, parameter list, response shape, and object reference.
• "Copy for LLM" and "View as Markdown" buttons added to every endpoint — copy the endpoint's full Markdown to your clipboard, or open the raw Markdown in a new tab to share or paste into your AI tool of choice.
• Resource pages now have a sticky table of contents listing all endpoints, so you can jump between endpoints without scrolling back to the top. Responsive layout on narrower screens.
• Redesigned API documentation layout. Endpoint details on the left, live example request and response on the right — easier to scan, easier to compare an endpoint's parameters against its example output.
• Per-endpoint Markdown now includes the Controller (Liquid) example alongside the cURL example, matching what the HTML docs show.
• Search behaviour for list endpoints is now documented on the API Overview page — which fields are searchable, how search_by / keyword / exact interact, and how search combines with pagination and sort.

Improvements

• Endpoint parameters are now split into clearly-labelled Path Parameters, Body Fields, and Query Parameters sections — no more confusion about which values go in the URL versus the JSON body.
• Every endpoint now has a single canonical URL — /admin/api/<module>/<resource>#<endpoint>. Older URLs redirect there automatically so existing bookmarks and shared links keep working.
• Markdown export's Object section now matches the HTML resource reference — nested fields show with dot notation, object-type parents are typed correctly, and list-only query parameters no longer leak into the response shape.
• Sidebar navigation and dark mode now hold up cleanly across every module.
• Parent-resource path parameters (e.g. event_uuid on event sponsors, cart_uuid on cart items) now show a description instead of rendering blank.
• Body Fields in the Markdown export are cleaner on POST and PATCH endpoints — fixed duplicate rows and broken dot-notation paths on resources with object references.
• Body Fields no longer lists response-only file metadata (.file_name, .extension, .url) under upload fields. The information is still available in the resource's response Object reference where it belongs.
• Test Request panel cleaned up — the API URL preview now uses the same code-block styling as the Example Request, and the payload editor stays in sync with the URL preview.
• Overview and Module Versions pages now share consistent page spacing with the rest of the docs.
• Dark mode polish across the sticky example panel and sidebar.

Security

• Upgraded the axios HTTP client from 0.27.x (end-of-life) to 1.16.0, picking up two years of security patches and bug fixes.
• Removed the bundled jQuery 1.12.4 dependency (end-of-life since 2016, multiple unpatched vulnerabilities).

Bug Fixes

• Controller examples are now valid Liquid out of the box — placeholder values are properly quoted so copy-pasting the example works without manual edits.
• DELETE endpoint cURL examples no longer include an empty request body flag.
• Locale data cached in the browser is no longer wiped when a localisation request fails — previous translations stay loaded until a successful refresh.