Added

Quoter API - Quote contracts and legacy line-item sunset


Summary

The Quoter v1 reference now matches existing quote responses and line-item creation behavior. Integrations generated from the previous reference should regenerate their clients to handle structured quote tags. The API major version remains v1.

The legacy line-item creation endpoint is deprecated and has a sunset date of October 31, 2027. Move calls to the quote-section endpoint before that date.


Changes

Changed

  • GET /v1/quotes

    • String tag items → structured tag objects
    • Type: change
    • Notes: Each tag contains id, name, created_at and modified_at. This corrects the reference to match existing production responses. Regenerate clients that previously expected strings, and use name for the display label or id for identity.
  • GET /v1/quotes, GET /v1/quotes/{quote_id}

    • Contact identifiers documented with a prefix → bare identifiers
    • Type: improvement
    • Notes: Contact identifiers are returned without a cont_ prefix. Treat them as opaque values and pass the returned identifier unchanged. Quotes created before June 17, 2025 can appear in the list while the individual fetch returns 404.
  • POST /v1/quotes/{quote_id}/sections/{section_id}/line-items

    • taxable required with a documented false default → optional with a true default
    • Type: improvement
    • Notes: Omitting taxable uses true; set it to false explicitly for a non-taxable line. New lines appear at the end of the section. Item-field validation errors use line_items[i].field paths, while other validation errors may have no item path. These corrections document existing behavior.

Deprecated

  • POST /v1/line-items
    • Available → deprecated, sunset October 31, 2027
    • Type: deprecation
    • Notes: Use POST /v1/quotes/{quote_id}/sections/{section_id}/line-items instead. The legacy endpoint continues to work until its sunset date.

Dates

  • Effective: [2026-10-05]