@graph8/sdk 0.251.0 → 0.262.0

package/docs/api/quotes.md

@@ -0,0 +1,2553 @@
+<!-- Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. -->
+
+# `g8.api.quotes`: Quotes
+
+56 operations (26 read, 6 write, 7 destructive, 17 external).
+
+12 of these also have a hand-written method (`g8.quotes`), marked **★** below. Prefer the hand-written method when one exists: it unwraps the `data` envelope and takes friendlier arguments. See [../sdk-clients.md](../sdk-clients.md).
+
+Every example below assumes this setup (server-side, API key):
+
+```ts
+import { g8 } from "@graph8/sdk";
+
+g8.init({ apiKey: process.env.G8_API_KEY! });
+```
+
+Example values are placeholders that match each field's type. Only required fields are shown. Every example is type-checked against the SDK in CI.
+
+Exact TypeScript types for every operation on this page, and every schema they use: [quotes.d.ts](quotes.d.ts).
+
+## Operations
+
+| Call | HTTP | Tier | Scope | Summary |
+|---|---|---|---|---|
+| [`archiveQuote`](#op-archivequote) | `POST /api/v1/quotes/{quote_id}/archive` | destructive | `quotes:delete` | Archive Quote |
+| [`batchQuoteAction`](#op-batchquoteaction) | `POST /api/v1/quotes/batch` | external | `quotes:run` | Batch Quote Action |
+| [`bulkUpdateStripeProductSettings`](#op-bulkupdatestripeproductsettings) | `PATCH /api/v1/stripe/product-settings/bulk` | write | `quotes:write` | Bulk Update Stripe Product Settings |
+| [`calculateMailboxCapacity`](#op-calculatemailboxcapacity) | `POST /api/v1/quotes/mailbox-capacity` | read | `quotes:read` | Calculate Mailbox Capacity |
+| [`connectStripeApiKey`](#op-connectstripeapikey) | `POST /api/v1/stripe/api-key` | external | `quotes:run` | Connect Stripe Api Key |
+| [`createManualProduct`](#op-createmanualproduct) | `POST /api/v1/manual-products` | write | `quotes:write` | Create Manual Product |
+| [`createQuote`](#op-createquote) ★ | `POST /api/v1/quotes` | external | `quotes:run` | Create Quote |
+| [`createQuoteBillingContact`](#op-createquotebillingcontact) | `POST /api/v1/quote-billing-contact` | external | `quotes:run` | Create Quote Billing Contact |
+| [`createQuoteContact`](#op-createquotecontact) | `POST /api/v1/quote-contacts` | external | `quotes:run` | Create Quote Contact |
+| [`createQuoteTemplate`](#op-createquotetemplate) | `POST /api/v1/quote-templates` | external | `quotes:run` | Create Quote Template |
+| [`deleteManualProduct`](#op-deletemanualproduct) | `DELETE /api/v1/manual-products/{product_id}` | destructive | `quotes:delete` | Delete Manual Product |
+| [`deleteQuote`](#op-deletequote) ★ | `DELETE /api/v1/quotes/{quote_id}` | destructive | `quotes:delete` | Delete Quote |
+| [`deleteQuoteDocument`](#op-deletequotedocument) | `DELETE /api/v1/quote-settings/documents/{doc_id}` | destructive | `quotes:delete` | Delete Quote Document |
+| [`deleteQuoteTemplate`](#op-deletequotetemplate) | `DELETE /api/v1/quote-templates/{template_id}` | destructive | `quotes:delete` | Delete Quote Template |
+| [`downloadQuoteEvidence`](#op-downloadquoteevidence) | `GET /api/v1/quotes/{quote_id}/evidence/{evidence_id}` | read | `quotes:read` | Download Quote Evidence |
+| [`duplicateQuote`](#op-duplicatequote) ★ | `POST /api/v1/quotes/{quote_id}/duplicate` | external | `quotes:run` | Duplicate Quote |
+| [`editQuoteAsDraft`](#op-editquoteasdraft) ★ | `POST /api/v1/quotes/{quote_id}/edit-as-draft` | external | `quotes:run` | Edit Quote As Draft |
+| [`expireQuote`](#op-expirequote) | `POST /api/v1/quotes/{quote_id}/expire` | destructive | `quotes:delete` | Expire Quote |
+| [`getCompanyQuotes`](#op-getcompanyquotes) ★ | `GET /api/v1/companies/{company_id}/quotes` | read | `quotes:read` | Get Company Quotes |
+| [`getCompanyRevenueSummary`](#op-getcompanyrevenuesummary) | `GET /api/v1/stripe/companies/{company_id}/revenue-summary` | read | `quotes:read` | Get Company Revenue Summary |
+| [`getCompanyStripeInvoices`](#op-getcompanystripeinvoices) | `GET /api/v1/stripe/companies/{company_id}/invoices` | read | `quotes:read` | Get Company Stripe Invoices |
+| [`getCompanyStripeSubscriptions`](#op-getcompanystripesubscriptions) | `GET /api/v1/stripe/companies/{company_id}/subscriptions` | read | `quotes:read` | Get Company Stripe Subscriptions |
+| [`getContactQuotes`](#op-getcontactquotes) ★ | `GET /api/v1/contacts/{contact_id}/quotes` | read | `quotes:read` | Get Contact Quotes |
+| [`getQuote`](#op-getquote) ★ | `GET /api/v1/quotes/{quote_id}` | read | `quotes:read` | Get Quote |
+| [`getQuotePdf`](#op-getquotepdf) | `GET /api/v1/quotes/{quote_id}/pdf` | read | `quotes:read` | Get Quote Pdf |
+| [`getQuoteSettings`](#op-getquotesettings) ★ | `GET /api/v1/quote-settings` | read | `quotes:read` | Get Quote Settings |
+| [`getStripeData`](#op-getstripedata) | `GET /api/v1/stripe/connections/{connection_id}/data` | read | `quotes:read` | Get Stripe Data |
+| [`getStripeDataPage`](#op-getstripedatapage) | `GET /api/v1/stripe/connections/{connection_id}/data/{resource}` | read | `quotes:read` | Get Stripe Data Page |
+| [`getStripeIntegrationStatus`](#op-getstripeintegrationstatus) | `GET /api/v1/stripe/integration-status` | read | `quotes:read` | Get Stripe Integration Status |
+| [`listManualProducts`](#op-listmanualproducts) | `GET /api/v1/manual-products` | read | `quotes:read` | List Manual Products |
+| [`listQuotableProducts`](#op-listquotableproducts) ★ | `GET /api/v1/quotable-products` | read | `quotes:read` | List Quotable Products |
+| [`listQuoteDocuments`](#op-listquotedocuments) | `GET /api/v1/quote-settings/documents` | read | `quotes:read` | List Quote Documents |
+| [`listQuoteEvidence`](#op-listquoteevidence) | `GET /api/v1/quotes/{quote_id}/evidence` | read | `quotes:read` | List Quote Evidence |
+| [`listQuoteTemplates`](#op-listquotetemplates) | `GET /api/v1/quote-templates` | read | `quotes:read` | List Quote Templates |
+| [`listQuotes`](#op-listquotes) ★ | `GET /api/v1/quotes` | read | `quotes:read` | List Quotes |
+| [`listStripeProductSettings`](#op-liststripeproductsettings) | `GET /api/v1/stripe/product-settings` | read | `quotes:read` | List Stripe Product Settings |
+| [`listStripeProductSubscribers`](#op-liststripeproductsubscribers) | `GET /api/v1/stripe/products/{product_id}/subscribers` | read | `quotes:read` | List Stripe Product Subscribers |
+| [`listStripeProducts`](#op-liststripeproducts) | `GET /api/v1/stripe/products` | read | `quotes:read` | List Stripe Products |
+| [`markQuoteAccepted`](#op-markquoteaccepted) | `POST /api/v1/quotes/{quote_id}/mark-accepted` | external | `quotes:run` | Mark Quote Accepted |
+| [`previewPaymentSchedule`](#op-previewpaymentschedule) | `POST /api/v1/quotes/payment-schedule` | read | `quotes:read` | Preview Payment Schedule |
+| [`previewQuoteDraft`](#op-previewquotedraft) | `POST /api/v1/quotes/preview-draft` | read | `quotes:read` | Preview Quote Draft |
+| [`previewQuoteSend`](#op-previewquotesend) | `POST /api/v1/quotes/{quote_id}/send-preview` | read | `quotes:read` | Preview Quote Send |
+| [`revokeQuote`](#op-revokequote) | `POST /api/v1/quotes/{quote_id}/revoke` | destructive | `quotes:delete` | Revoke Quote |
+| [`searchQuoteContacts`](#op-searchquotecontacts) | `GET /api/v1/quote-contacts` | read | `quotes:read` | Search Quote Contacts |
+| [`sendQuote`](#op-sendquote) ★ | `POST /api/v1/quotes/{quote_id}/send` | external | `quotes:run` | Send Quote |
+| [`triggerStripeSync`](#op-triggerstripesync) | `POST /api/v1/stripe/sync` | external | `quotes:run` | Trigger Stripe Sync |
+| [`unarchiveQuote`](#op-unarchivequote) | `POST /api/v1/quotes/{quote_id}/unarchive` | external | `quotes:run` | Unarchive Quote |
+| [`updateManualProduct`](#op-updatemanualproduct) | `PATCH /api/v1/manual-products/{product_id}` | write | `quotes:write` | Update Manual Product |
+| [`updateQuotePatch`](#op-updatequotepatch) | `PATCH /api/v1/quotes/{quote_id}` | external | `quotes:run` | Update Quote |
+| [`updateQuotePut`](#op-updatequoteput) ★ | `PUT /api/v1/quotes/{quote_id}` | external | `quotes:run` | Update Quote |
+| [`updateQuoteSettings`](#op-updatequotesettings) | `PUT /api/v1/quote-settings` | external | `quotes:run` | Update Quote Settings |
+| [`updateQuoteTemplate`](#op-updatequotetemplate) | `PUT /api/v1/quote-templates/{template_id}` | external | `quotes:run` | Update Quote Template |
+| [`updateStripeCustomerMapping`](#op-updatestripecustomermapping) | `PATCH /api/v1/stripe/customers/{customer_id}/mapping` | write | `quotes:write` | Update Stripe Customer Mapping |
+| [`uploadQuoteDocument`](#op-uploadquotedocument) | `POST /api/v1/quote-settings/documents` | external | `quotes:run` | Upload Quote Document |
+| [`uploadQuoteEvidence`](#op-uploadquoteevidence) | `POST /api/v1/quotes/{quote_id}/evidence` | write | `quotes:write` | Upload Quote Evidence |
+| [`upsertStripeProductSettings`](#op-upsertstripeproductsettings) | `PUT /api/v1/stripe/product-settings/{stripe_product_id}` | write | `quotes:write` | Upsert Stripe Product Settings |
+
+---
+
+<a id="op-archivequote"></a>
+
+### `g8.api.quotes.archiveQuote(input)`
+
+**Archive Quote**
+
+- HTTP: `POST /api/v1/quotes/{quote_id}/archive`
+- operationId: `archive_quote_quotes__quote_id__archive_post` (also callable as `g8.api.call("archive_quote_quotes__quote_id__archive_post", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `quotes:delete`
+
+Take a quote off the active list. REVERSIBLE - see `/unarchive`.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.quote_id` | `string` | yes | Quote id (UUID). |
+
+**Returns** `ApiResponse_QuotePayload_`: the envelope `{ data: QuotePayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.quotes.archiveQuote({ path: { quote_id: "id" } });
+```
+
+---
+
+<a id="op-batchquoteaction"></a>
+
+### `g8.api.quotes.batchQuoteAction(input)`
+
+**Batch Quote Action**
+
+- HTTP: `POST /api/v1/quotes/batch`
+- operationId: `batch_quote_action_quotes_batch_post` (also callable as `g8.api.call("batch_quote_action_quotes_batch_post", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `quotes:run`
+
+Archive, expire or revoke up to 200 quotes.
+
+READ THE PER-ROW RESULT, not the HTTP status. Each quote runs in its own
+transaction, so a 200 here means "the batch ran", not "every quote moved":
+an out-of-scope id comes back `forbidden`, an unknown one `error`, and a
+quote whose status makes the action meaningless comes back `skipped`.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `BatchQuoteActionRequest` | yes | Request body; fields below. |
+
+Body fields (`BatchQuoteActionRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.action` | `"archive" \| "expire" \| "revoke"` | yes | What to do to every quote in the list. |
+| `body.quote_ids` | `Array<string>` | yes | Quote ids. An out-of-scope or unknown id is reported per-row, not fatal. min items 1, max items 200 |
+
+**Returns** `ApiResponse_QuoteListPayload_`: the envelope `{ data: QuoteListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`QuoteListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.quotes.batchQuoteAction({ body: { action: "archive", quote_ids: ["id"] } });
+```
+
+---
+
+<a id="op-bulkupdatestripeproductsettings"></a>
+
+### `g8.api.quotes.bulkUpdateStripeProductSettings(input)`
+
+**Bulk Update Stripe Product Settings**
+
+- HTTP: `PATCH /api/v1/stripe/product-settings/bulk`
+- operationId: `bulk_update_stripe_product_settings_stripe_product_settings_bulk_patch` (also callable as `g8.api.call("bulk_update_stripe_product_settings_stripe_product_settings_bulk_patch", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `quotes:write`
+
+Apply the same settings to many products. Org Admin or Owner key only.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `BulkProductSettingsRequest` | yes | Request body; fields below. |
+
+Body fields (`BulkProductSettingsRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.stripe_product_ids` | `Array<string>` | yes | Stripe product ids to update. |
+| `body.updates` | `ProductSettingsUpdateRequest` | yes |  |
+
+**Returns** `ApiResponse_BillingPayload_`: the envelope `{ data: BillingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.quotes.bulkUpdateStripeProductSettings({ body: { stripe_product_ids: ["id"], updates: {} } });
+```
+
+---
+
+<a id="op-calculatemailboxcapacity"></a>
+
+### `g8.api.quotes.calculateMailboxCapacity(input)`
+
+**Calculate Mailbox Capacity**
+
+- HTTP: `POST /api/v1/quotes/mailbox-capacity`
+- operationId: `calculate_mailbox_capacity_quotes_mailbox_capacity_post` (also callable as `g8.api.call("calculate_mailbox_capacity_quotes_mailbox_capacity_post", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `quotes:read`
+
+Mailboxes and domains needed to reach `contacts_per_month`, for a 30-,
+7- and 1-day delivery window, with their cost. ARITHMETIC ONLY: nothing is
+bought or written. POST only because the inputs are a body.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `MailboxCapacityRequest` | yes | Request body; fields below. |
+
+Body fields (`MailboxCapacityRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.contacts_per_month` | `integer` | yes | Target contacts to reach per month. min 0 |
+| `body.domain_tld` | `string` | no | TLD for the per-domain cost estimate. default `".com"` |
+| `body.warmed` | `boolean` | no | Mailbox warmup state. Advisory under the current platform-wide daily cap. default `false` |
+
+**Returns** `ApiResponse_BillingPayload_`: the envelope `{ data: BillingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.quotes.calculateMailboxCapacity({ body: { contacts_per_month: 0 } });
+```
+
+---
+
+<a id="op-connectstripeapikey"></a>
+
+### `g8.api.quotes.connectStripeApiKey(input)`
+
+**Connect Stripe Api Key**
+
+- HTTP: `POST /api/v1/stripe/api-key`
+- operationId: `connect_stripe_api_key_stripe_api_key_post` (also callable as `g8.api.call("connect_stripe_api_key_stripe_api_key_post", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `quotes:run`
+
+Connect Stripe with a restricted API key. REACHES STRIPE to validate it.
+
+Replaces any key already stored for the org. The key is write-only: the
+response carries the connection id and whether it is a live-mode key,
+never the key. Products sync within fifteen minutes, or immediately with
+`POST /stripe/sync`.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `StripeApiKeyRequest` | yes | Request body; fields below. |
+
+Body fields (`StripeApiKeyRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.api_key` | `string` | yes | Stripe restricted or secret key: rk_live_, rk_test_, sk_live_ or sk_test_. min length 10 |
+
+**Returns** `ApiResponse_BillingPayload_`: the envelope `{ data: BillingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.quotes.connectStripeApiKey({ body: { api_key: "xxxxxxxxxx" } });
+```
+
+---
+
+<a id="op-createmanualproduct"></a>
+
+### `g8.api.quotes.createManualProduct(input)`
+
+**Create Manual Product**
+
+- HTTP: `POST /api/v1/manual-products`
+- operationId: `create_manual_product_manual_products_post` (also callable as `g8.api.call("create_manual_product_manual_products_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `quotes:write`
+
+Add a product to the manual catalogue. Org Admin or Owner key only.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `ManualProductCreateRequest` | yes | Request body; fields below. |
+
+Body fields (`ManualProductCreateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.default_unit_amount` | `integer` | yes | In cents. min 0, max 1000000000 |
+| `body.name` | `string` | yes | min length 1, max length 500 |
+| `body.active` | `boolean` | no | default `true` |
+| `body.billing_frequency` | `"one_time" \| "month" \| "year" \| "quarter"` | no | default `"one_time"` |
+| `body.category` | `string \| null` | no | max length 100 |
+| `body.currency` | `string` | no | default `"USD"`, min length 3, max length 3 |
+| `body.description` | `string \| null` | no | max length 5000 |
+| `body.quotable` | `boolean` | no | default `true` |
+| `body.sort_order` | `integer` | no | default `0`, min 0, max 10000 |
+
+**Returns** `ApiResponse_BillingPayload_`: the envelope `{ data: BillingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.quotes.createManualProduct({ body: { default_unit_amount: 0, name: "Example" } });
+```
+
+---
+
+<a id="op-createquote"></a>
+
+### `g8.api.quotes.createQuote(input)`
+
+**Create Quote**
+
+- HTTP: `POST /api/v1/quotes`
+- operationId: `create_quote_quotes_post` (also callable as `g8.api.call("create_quote_quotes_post", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `quotes:run`
+- ★ Hand-written: [`g8.quotes.create()`](../sdk-clients.md#g8-quotes-create)
+
+Create a new quote in `draft` status. Always creates — never sends.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `QuoteCreateRequest` | yes | Request body; fields below. |
+
+Body fields (`QuoteCreateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.line_items` | `Array<QuoteLineItemRequest>` | yes | min items 1 |
+| `body.title` | `string` | yes | min length 1, max length 500 |
+| `body.accepted_payment_methods` | `Array<"ach" \| "credit_card" \| "wire"> \| null` | no |  |
+| `body.billing_address` | `string \| null` | no | max length 2000 |
+| `body.billing_contact_id` | `integer \| null` | no |  |
+| `body.billing_email` | `string \| null` | no | max length 255 |
+| `body.billing_legal_name` | `string \| null` | no | max length 255 |
+| `body.billing_primary_email` | `string \| null` | no | max length 255 |
+| `body.contract_duration_unit` | `"months" \| "weeks" \| "days" \| null` | no |  |
+| `body.contract_duration_value` | `number \| null` | no | min 0.1, max 3650 |
+| `body.contract_end_date` | `string \| null` | no |  |
+| `body.contract_months` | `number \| null` | no | min 0.1, max 120 |
+| `body.contract_start_date` | `string \| null` | no |  |
+| `body.currency` | `string` | no | default `"USD"`, min length 3, max length 3 |
+| `body.deal_id` | `string \| null` | no |  |
+| `body.marketing_rights` | `Array<"logo" \| "quote" \| "case_study"> \| null` | no |  |
+| `body.mashup_company_id` | `integer \| null` | no |  |
+| `body.notes` | `string \| null` | no | max length 10000 |
+| `body.owner_id` | `string \| null` | no | max length 255 |
+| `body.payment_terms` | `"due_on_receipt" \| "net_15" \| "net_30" \| "net_45" \| "net_60" \| "net_90"` | no | default `"net_30"` |
+| `body.privacy_content` | `string \| null` | no | max length 50000 |
+| `body.public_notes` | `string \| null` | no | max length 50000 |
+| `body.signer_contact_id` | `integer \| null` | no |  |
+| `body.signer_email` | `string \| null` | no | max length 255 |
+| `body.signer_name` | `string \| null` | no | max length 255 |
+| `body.tax_amount` | `integer` | no | default `0`, min 0, max 1000000000 |
+| `body.template_id` | `string \| null` | no |  |
+| `body.terms_content` | `string \| null` | no | max length 50000 |
+| `body.valid_until` | `string \| null` | no |  |
+
+**Returns** `ApiResponse_QuoteDetail_`: the envelope `{ data: QuoteDetail, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`QuoteDetail` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `activity` | `Array<Record<string, unknown>> \| null` | no |  |
+| `envelope` | `Record<string, unknown> \| null` | no |  |
+| `id` | `string \| null` | no |  |
+| `line_items` | `Array<Record<string, unknown>> \| null` | no |  |
+| `quote_number` | `string \| null` | no |  |
+| `status` | `string \| null` | no |  |
+| `title` | `string \| null` | no |  |
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.quotes.createQuote({
+  body: {
+    line_items: [{ product_name: "Example", unit_amount: 0 }],
+    title: "Example",
+  },
+});
+```
+
+---
+
+<a id="op-createquotebillingcontact"></a>
+
+### `g8.api.quotes.createQuoteBillingContact(input)`
+
+**Create Quote Billing Contact**
+
+- HTTP: `POST /api/v1/quote-billing-contact`
+- operationId: `create_quote_billing_contact_quote_billing_contact_post` (also callable as `g8.api.call("create_quote_billing_contact_quote_billing_contact_post", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `quotes:run`
+
+Create the FINANCE contact a quote bills to. Name and email only.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `QuoteBillingContactCreateRequest` | yes | Request body; fields below. |
+
+Body fields (`QuoteBillingContactCreateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.email` | `string` | yes | max length 255 |
+| `body.mashup_company_id` | `integer` | yes | Company the contact belongs to. min 1 |
+| `body.deal_id` | `string \| null` | no |  |
+| `body.name` | `string \| null` | no | max length 255 |
+
+**Returns** `ApiResponse_QuotePayload_`: the envelope `{ data: QuotePayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.quotes.createQuoteBillingContact({ body: { email: "jane@acme.com", mashup_company_id: 1 } });
+```
+
+---
+
+<a id="op-createquotecontact"></a>
+
+### `g8.api.quotes.createQuoteContact(input)`
+
+**Create Quote Contact**
+
+- HTTP: `POST /api/v1/quote-contacts`
+- operationId: `create_quote_contact_quote_contacts_post` (also callable as `g8.api.call("create_quote_contact_quote_contacts_post", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `quotes:run`
+
+Create a SIGNER contact and link it to the deal and company.
+
+The full CRM contact, so the new row is immediately usable as the signer
+rather than being a name on an email. For the finance contact a quote bills
+to, use `/quote-billing-contact`.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `QuoteContactCreateRequest` | yes | Request body; fields below. |
+
+Body fields (`QuoteContactCreateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.email` | `string` | yes | min length 3, max length 320 |
+| `body.buying_role` | `string \| null` | no |  |
+| `body.deal_id` | `string \| null` | no | Deal to link it to. |
+| `body.department` | `string \| null` | no |  |
+| `body.first_name` | `string \| null` | no |  |
+| `body.last_name` | `string \| null` | no |  |
+| `body.linkedin_url` | `string \| null` | no |  |
+| `body.mashup_company_id` | `integer \| null` | no | Company to link the new contact to. |
+| `body.mobile_phone` | `string \| null` | no |  |
+| `body.phone` | `string \| null` | no |  |
+| `body.title` | `string \| null` | no |  |
+
+**Returns** `ApiResponse_QuotePayload_`: the envelope `{ data: QuotePayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.quotes.createQuoteContact({ body: { email: "jane@acme.com" } });
+```
+
+---
+
+<a id="op-createquotetemplate"></a>
+
+### `g8.api.quotes.createQuoteTemplate(input)`
+
+**Create Quote Template**
+
+- HTTP: `POST /api/v1/quote-templates`
+- operationId: `create_quote_template_quote_templates_post` (also callable as `g8.api.call("create_quote_template_quote_templates_post", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `quotes:run`
+
+Create a template. ORG ADMIN - it changes what every future quote starts as.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `QuoteTemplateRequest` | yes | Request body; fields below. |
+
+Body fields (`QuoteTemplateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.name` | `string` | yes | min length 1, max length 255 |
+| `body.contract_duration_unit` | `"months" \| "weeks" \| "days" \| null` | no |  |
+| `body.contract_duration_value` | `number \| null` | no | min 0.1, max 3650 |
+| `body.contract_months` | `number \| null` | no | min 0.1, max 120 |
+| `body.default_line_items` | `Array<Record<string, unknown>> \| null` | no |  |
+| `body.default_payment_terms` | `string \| null` | no |  |
+| `body.default_valid_days` | `integer \| null` | no | min 1, max 365 |
+| `body.description` | `string \| null` | no |  |
+| `body.document_ids` | `Array<string> \| null` | no | Legal documents to attach to every quote built from this template. Ids come from `GET /quote-settings/documents`. |
+| `body.is_default` | `boolean` | no | default `false` |
+| `body.terms_override` | `string \| null` | no |  |
+
+**Returns** `ApiResponse_QuotePayload_`: the envelope `{ data: QuotePayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.quotes.createQuoteTemplate({ body: { name: "Example" } });
+```
+
+---
+
+<a id="op-deletemanualproduct"></a>
+
+### `g8.api.quotes.deleteManualProduct(input)`
+
+**Delete Manual Product**
+
+- HTTP: `DELETE /api/v1/manual-products/{product_id}`
+- operationId: `delete_manual_product_manual_products__product_id__delete` (also callable as `g8.api.call("delete_manual_product_manual_products__product_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `quotes:delete`
+
+Retire a manual product. A soft delete: line items on existing quotes keep it.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.product_id` | `string (uuid)` | yes | Manual product id. |
+
+**Returns** `ApiResponse_BillingPayload_`: the envelope `{ data: BillingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.quotes.deleteManualProduct({ path: { product_id: "00000000-0000-0000-0000-000000000000" } });
+```
+
+---
+
+<a id="op-deletequote"></a>
+
+### `g8.api.quotes.deleteQuote(input)`
+
+**Delete Quote**
+
+- HTTP: `DELETE /api/v1/quotes/{quote_id}`
+- operationId: `delete_quote_quotes__quote_id__delete` (also callable as `g8.api.call("delete_quote_quotes__quote_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `quotes:delete`
+- ★ Hand-written: [`g8.quotes.delete()`](../sdk-clients.md#g8-quotes-delete)
+
+Delete a draft quote. 400s on any non-draft status (legal-record preservation).
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.quote_id` | `string` | yes | Quote UUID |
+
+**Returns** `ApiResponse_dict_`: the envelope `{ data: Record<string, unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.quotes.deleteQuote({ path: { quote_id: "id" } });
+```
+
+---
+
+<a id="op-deletequotedocument"></a>
+
+### `g8.api.quotes.deleteQuoteDocument(input)`
+
+**Delete Quote Document**
+
+- HTTP: `DELETE /api/v1/quote-settings/documents/{doc_id}`
+- operationId: `delete_quote_document_quote_settings_documents__doc_id__delete` (also callable as `g8.api.call("delete_quote_document_quote_settings_documents__doc_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `quotes:delete`
+
+Remove a document from the library. ORG ADMIN.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.doc_id` | `string` | yes | Document id. |
+
+**Returns** `ApiResponse_QuotePayload_`: the envelope `{ data: QuotePayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.quotes.deleteQuoteDocument({ path: { doc_id: "id" } });
+```
+
+---
+
+<a id="op-deletequotetemplate"></a>
+
+### `g8.api.quotes.deleteQuoteTemplate(input)`
+
+**Delete Quote Template**
+
+- HTTP: `DELETE /api/v1/quote-templates/{template_id}`
+- operationId: `delete_quote_template_quote_templates__template_id__delete` (also callable as `g8.api.call("delete_quote_template_quote_templates__template_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `quotes:delete`
+
+Delete a template. ORG ADMIN. Quotes already built from it are untouched.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.template_id` | `string` | yes | Template id. |
+
+**Returns** `ApiResponse_QuotePayload_`: the envelope `{ data: QuotePayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.quotes.deleteQuoteTemplate({ path: { template_id: "id" } });
+```
+
+---
+
+<a id="op-downloadquoteevidence"></a>
+
+### `g8.api.quotes.downloadQuoteEvidence(input)`
+
+**Download Quote Evidence**
+
+- HTTP: `GET /api/v1/quotes/{quote_id}/evidence/{evidence_id}`
+- operationId: `download_quote_evidence_quotes__quote_id__evidence__evidence_id__get` (also callable as `g8.api.call("download_quote_evidence_quotes__quote_id__evidence__evidence_id__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `quotes:read`
+
+A download URL for one attached PDF. The URL expires after 60 seconds.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.quote_id` | `string (uuid)` | yes | Quote id. |
+| `path.evidence_id` | `string (uuid)` | yes | Evidence id. |
+
+**Returns** `ApiResponse_BillingPayload_`: the envelope `{ data: BillingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.quotes.downloadQuoteEvidence({
+  path: {
+    quote_id: "00000000-0000-0000-0000-000000000000",
+    evidence_id: "00000000-0000-0000-0000-000000000000",
+  },
+});
+```
+
+---
+
+<a id="op-duplicatequote"></a>
+
+### `g8.api.quotes.duplicateQuote(input)`
+
+**Duplicate Quote**
+
+- HTTP: `POST /api/v1/quotes/{quote_id}/duplicate`
+- operationId: `duplicate_quote_quotes__quote_id__duplicate_post` (also callable as `g8.api.call("duplicate_quote_quotes__quote_id__duplicate_post", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `quotes:run`
+- ★ Hand-written: [`g8.quotes.duplicate()`](../sdk-clients.md#g8-quotes-duplicate)
+
+Clone any quote into a new draft. Title gets ``(Copy)`` suffix.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.quote_id` | `string` | yes | Source quote UUID (any status) |
+
+**Returns** `ApiResponse_QuoteDetail_`: the envelope `{ data: QuoteDetail, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`QuoteDetail` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `activity` | `Array<Record<string, unknown>> \| null` | no |  |
+| `envelope` | `Record<string, unknown> \| null` | no |  |
+| `id` | `string \| null` | no |  |
+| `line_items` | `Array<Record<string, unknown>> \| null` | no |  |
+| `quote_number` | `string \| null` | no |  |
+| `status` | `string \| null` | no |  |
+| `title` | `string \| null` | no |  |
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.quotes.duplicateQuote({ path: { quote_id: "id" } });
+```
+
+---
+
+<a id="op-editquoteasdraft"></a>
+
+### `g8.api.quotes.editQuoteAsDraft(input)`
+
+**Edit Quote As Draft**
+
+- HTTP: `POST /api/v1/quotes/{quote_id}/edit-as-draft`
+- operationId: `edit_quote_as_draft_quotes__quote_id__edit_as_draft_post` (also callable as `g8.api.call("edit_quote_as_draft_quotes__quote_id__edit_as_draft_post", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `quotes:run`
+- ★ Hand-written: [`g8.quotes.editAsDraft()`](../sdk-clients.md#g8-quotes-editasdraft)
+
+Convert a sent quote back into an editable draft via void+clone.
+
+Voids the existing signing envelope (so the recipient's link stops
+resolving), marks the source ``voided``, and creates a fresh ``draft``
+with all the line items copied across. Returns
+``{new_quote_id, new_quote_number, voided_envelope_id, source_quote_id}``.
+The caller should navigate to / update the new draft.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.quote_id` | `string` | yes | Source quote UUID (must be in 'sent' status) |
+
+**Returns** `ApiResponse_dict_`: the envelope `{ data: Record<string, unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.quotes.editQuoteAsDraft({ path: { quote_id: "id" } });
+```
+
+---
+
+<a id="op-expirequote"></a>
+
+### `g8.api.quotes.expireQuote(input)`
+
+**Expire Quote**
+
+- HTTP: `POST /api/v1/quotes/{quote_id}/expire`
+- operationId: `expire_quote_quotes__quote_id__expire_post` (also callable as `g8.api.call("expire_quote_quotes__quote_id__expire_post", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `quotes:delete`
+
+Mark a quote expired. TERMINAL - the customer's link stops working.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.quote_id` | `string` | yes | Quote id (UUID). |
+
+**Returns** `ApiResponse_QuotePayload_`: the envelope `{ data: QuotePayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.quotes.expireQuote({ path: { quote_id: "id" } });
+```
+
+---
+
+<a id="op-getcompanyquotes"></a>
+
+### `g8.api.quotes.getCompanyQuotes(input)`
+
+**Get Company Quotes**
+
+- HTTP: `GET /api/v1/companies/{company_id}/quotes`
+- operationId: `get_company_quotes_companies__company_id__quotes_get` (also callable as `g8.api.call("get_company_quotes_companies__company_id__quotes_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `quotes:read`
+- ★ Hand-written: [`g8.quotes.forCompany()`](../sdk-clients.md#g8-quotes-forcompany)
+
+List every quote attached to a given company (account view).
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.company_id` | `integer` | yes | MashupCompany ID |
+
+**Returns** `ApiResponse_list_QuoteDetail__`: the envelope `{ data: Array<QuoteDetail>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`QuoteDetail` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `activity` | `Array<Record<string, unknown>> \| null` | no |  |
+| `envelope` | `Record<string, unknown> \| null` | no |  |
+| `id` | `string \| null` | no |  |
+| `line_items` | `Array<Record<string, unknown>> \| null` | no |  |
+| `quote_number` | `string \| null` | no |  |
+| `status` | `string \| null` | no |  |
+| `title` | `string \| null` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.quotes.getCompanyQuotes({ path: { company_id: 123 } });
+```
+
+---
+
+<a id="op-getcompanyrevenuesummary"></a>
+
+### `g8.api.quotes.getCompanyRevenueSummary(input)`
+
+**Get Company Revenue Summary**
+
+- HTTP: `GET /api/v1/stripe/companies/{company_id}/revenue-summary`
+- operationId: `get_company_revenue_summary_stripe_companies__company_id__revenue_summary_get` (also callable as `g8.api.call("get_company_revenue_summary_stripe_companies__company_id__revenue_summary_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `quotes:read`
+
+Total paid, MRR, invoice count and customer-since date for one company.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.company_id` | `integer` | yes | graph8 company id. |
+
+**Returns** `ApiResponse_BillingPayload_`: the envelope `{ data: BillingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.quotes.getCompanyRevenueSummary({ path: { company_id: 123 } });
+```
+
+---
+
+<a id="op-getcompanystripeinvoices"></a>
+
+### `g8.api.quotes.getCompanyStripeInvoices(input)`
+
+**Get Company Stripe Invoices**
+
+- HTTP: `GET /api/v1/stripe/companies/{company_id}/invoices`
+- operationId: `get_company_stripe_invoices_stripe_companies__company_id__invoices_get` (also callable as `g8.api.call("get_company_stripe_invoices_stripe_companies__company_id__invoices_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `quotes:read`
+
+A company's Stripe invoice history, newest first.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.company_id` | `integer` | yes | graph8 company id. |
+| `query.page` | `integer` | no | 1-based page. default `1` |
+| `query.limit` | `integer` | no | default `50` |
+
+**Returns** `ApiResponse_BillingListPayload_`: the envelope `{ data: BillingListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`BillingListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.quotes.getCompanyStripeInvoices({ path: { company_id: 123 } });
+```
+
+---
+
+<a id="op-getcompanystripesubscriptions"></a>
+
+### `g8.api.quotes.getCompanyStripeSubscriptions(input)`
+
+**Get Company Stripe Subscriptions**
+
+- HTTP: `GET /api/v1/stripe/companies/{company_id}/subscriptions`
+- operationId: `get_company_stripe_subscriptions_stripe_companies__company_id__subscriptions_get` (also callable as `g8.api.call("get_company_stripe_subscriptions_stripe_companies__company_id__subscriptions_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `quotes:read`
+
+A company's current Stripe subscriptions, through its customer mapping.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.company_id` | `integer` | yes | graph8 company id. |
+
+**Returns** `ApiResponse_BillingListPayload_`: the envelope `{ data: BillingListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`BillingListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.quotes.getCompanyStripeSubscriptions({ path: { company_id: 123 } });
+```
+
+---
+
+<a id="op-getcontactquotes"></a>
+
+### `g8.api.quotes.getContactQuotes(input)`
+
+**Get Contact Quotes**
+
+- HTTP: `GET /api/v1/contacts/{contact_id}/quotes`
+- operationId: `get_contact_quotes_contacts__contact_id__quotes_get` (also callable as `g8.api.call("get_contact_quotes_contacts__contact_id__quotes_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `quotes:read`
+- ★ Hand-written: [`g8.quotes.forContact()`](../sdk-clients.md#g8-quotes-forcontact)
+
+List quotes where this contact is the signer.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.contact_id` | `integer` | yes | MashupContact ID (the quote signer) |
+
+**Returns** `ApiResponse_list_QuoteDetail__`: the envelope `{ data: Array<QuoteDetail>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`QuoteDetail` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `activity` | `Array<Record<string, unknown>> \| null` | no |  |
+| `envelope` | `Record<string, unknown> \| null` | no |  |
+| `id` | `string \| null` | no |  |
+| `line_items` | `Array<Record<string, unknown>> \| null` | no |  |
+| `quote_number` | `string \| null` | no |  |
+| `status` | `string \| null` | no |  |
+| `title` | `string \| null` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.quotes.getContactQuotes({ path: { contact_id: 123 } });
+```
+
+---
+
+<a id="op-getquote"></a>
+
+### `g8.api.quotes.getQuote(input)`
+
+**Get Quote**
+
+- HTTP: `GET /api/v1/quotes/{quote_id}`
+- operationId: `get_quote_quotes__quote_id__get` (also callable as `g8.api.call("get_quote_quotes__quote_id__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `quotes:read`
+- ★ Hand-written: [`g8.quotes.get()`](../sdk-clients.md#g8-quotes-get)
+
+Get full quote detail: line items, activity log, envelope tracking, resolved contact/company names.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.quote_id` | `string` | yes | Quote UUID |
+
+**Returns** `ApiResponse_QuoteDetail_`: the envelope `{ data: QuoteDetail, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`QuoteDetail` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `activity` | `Array<Record<string, unknown>> \| null` | no |  |
+| `envelope` | `Record<string, unknown> \| null` | no |  |
+| `id` | `string \| null` | no |  |
+| `line_items` | `Array<Record<string, unknown>> \| null` | no |  |
+| `quote_number` | `string \| null` | no |  |
+| `status` | `string \| null` | no |  |
+| `title` | `string \| null` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.quotes.getQuote({ path: { quote_id: "id" } });
+```
+
+---
+
+<a id="op-getquotepdf"></a>
+
+### `g8.api.quotes.getQuotePdf(input)`
+
+**Get Quote Pdf**
+
+- HTTP: `GET /api/v1/quotes/{quote_id}/pdf`
+- operationId: `get_quote_pdf_quotes__quote_id__pdf_get` (also callable as `g8.api.call("get_quote_pdf_quotes__quote_id__pdf_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `quotes:read`
+
+The quote document, as the customer sees it.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.quote_id` | `string` | yes | Quote id (UUID). |
+
+**Returns** `ApiResponse_QuotePayload_`: the envelope `{ data: QuotePayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.quotes.getQuotePdf({ path: { quote_id: "id" } });
+```
+
+---
+
+<a id="op-getquotesettings"></a>
+
+### `g8.api.quotes.getQuoteSettings(input?)`
+
+**Get Quote Settings**
+
+- HTTP: `GET /api/v1/quote-settings`
+- operationId: `get_quote_settings_quote_settings_get` (also callable as `g8.api.call("get_quote_settings_quote_settings_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `quotes:read`
+- ★ Hand-written: [`g8.quotes.settings()`](../sdk-clients.md#g8-quotes-settings)
+
+Get org quote settings (branding, default terms, sender identity).
+
+Auto-creates default settings if none exist for the org.
+
+**Input**: none.
+
+**Returns** `ApiResponse_QuoteSettingsResponse_`: the envelope `{ data: QuoteSettingsResponse, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.quotes.getQuoteSettings();
+```
+
+---
+
+<a id="op-getstripedata"></a>
+
+### `g8.api.quotes.getStripeData(input)`
+
+**Get Stripe Data**
+
+- HTTP: `GET /api/v1/stripe/connections/{connection_id}/data`
+- operationId: `get_stripe_data_stripe_connections__connection_id__data_get` (also callable as `g8.api.call("get_stripe_data_stripe_connections__connection_id__data_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `quotes:read`
+
+Recent customers, subscriptions, invoices and charges, read LIVE from Stripe.
+
+`connection_id` must be the org's own stored connection - any other id is
+a 404, because connection ids are guessable.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.connection_id` | `string` | yes | The org's Stripe connection id. |
+
+**Returns** `ApiResponse_BillingPayload_`: the envelope `{ data: BillingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.quotes.getStripeData({ path: { connection_id: "id" } });
+```
+
+---
+
+<a id="op-getstripedatapage"></a>
+
+### `g8.api.quotes.getStripeDataPage(input)`
+
+**Get Stripe Data Page**
+
+- HTTP: `GET /api/v1/stripe/connections/{connection_id}/data/{resource}`
+- operationId: `get_stripe_data_page_stripe_connections__connection_id__data__resource__get` (also callable as `g8.api.call("get_stripe_data_page_stripe_connections__connection_id__data__resource__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `quotes:read`
+
+One page of a Stripe list, read live. Cursor-paged: pass `next_cursor`
+back as `starting_after`; `has_more` false means the last page.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.connection_id` | `string` | yes | The org's Stripe connection id. |
+| `path.resource` | `"customers" \| "subscriptions" \| "invoices" \| "charges"` | yes | Which Stripe list to page through. |
+| `query.limit` | `integer` | no | default `20` |
+| `query.starting_after` | `string \| null` | no | `next_cursor` from the previous page. |
+
+**Returns** `ApiResponse_BillingPayload_`: the envelope `{ data: BillingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.quotes.getStripeDataPage({ path: { connection_id: "id", resource: "customers" } });
+```
+
+---
+
+<a id="op-getstripeintegrationstatus"></a>
+
+### `g8.api.quotes.getStripeIntegrationStatus(input?)`
+
+**Get Stripe Integration Status**
+
+- HTTP: `GET /api/v1/stripe/integration-status`
+- operationId: `get_stripe_integration_status_stripe_integration_status_get` (also callable as `g8.api.call("get_stripe_integration_status_stripe_integration_status_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `quotes:read`
+
+Whether the quote catalogue is ready: `state` is one of `needs_catalog`,
+`syncing`, `no_quotable_products` or `ready`, counted across Stripe AND the
+manual catalogue.
+
+**Input**: none.
+
+**Returns** `ApiResponse_BillingPayload_`: the envelope `{ data: BillingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.quotes.getStripeIntegrationStatus();
+```
+
+---
+
+<a id="op-listmanualproducts"></a>
+
+### `g8.api.quotes.listManualProducts(input?)`
+
+**List Manual Products**
+
+- HTTP: `GET /api/v1/manual-products`
+- operationId: `list_manual_products_manual_products_get` (also callable as `g8.api.call("list_manual_products_manual_products_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `quotes:read`
+
+The org's own product catalogue - quotable with or without Stripe.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.include_inactive` | `boolean` | no | Include inactive products. default `false` |
+| `query.include_non_quotable` | `boolean` | no | Include products not offered on quotes. default `true` |
+| `query.category` | `string \| null` | no |  |
+| `query.page` | `integer` | no | 1-based page. default `1` |
+| `query.limit` | `integer` | no | default `100` |
+
+**Returns** `ApiResponse_BillingListPayload_`: the envelope `{ data: BillingListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`BillingListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.quotes.listManualProducts();
+```
+
+---
+
+<a id="op-listquotableproducts"></a>
+
+### `g8.api.quotes.listQuotableProducts(input?)`
+
+**List Quotable Products**
+
+- HTTP: `GET /api/v1/quotable-products`
+- operationId: `list_quotable_products_quotable_products_get` (also callable as `g8.api.call("list_quotable_products_quotable_products_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `quotes:read`
+- ★ Hand-written: [`g8.quotes.products()`](../sdk-clients.md#g8-quotes-products)
+
+List products available for quote line items (Stripe catalog + org manual catalog).
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.currency` | `string \| null` | no | Filter prices to this currency code (e.g. USD) |
+| `query.page` | `integer` | no | default `1` |
+| `query.limit` | `integer` | no | default `100` |
+
+**Returns** `ApiResponse_QuotableProductsResponse_`: the envelope `{ data: QuotableProductsResponse, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`QuotableProductsResponse` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<Record<string, unknown>>` | yes |  |
+| `limit` | `integer` | yes |  |
+| `page` | `integer` | yes |  |
+| `total` | `integer` | yes |  |
+
+**Example**
+
+```ts
+const result = await g8.api.quotes.listQuotableProducts();
+```
+
+---
+
+<a id="op-listquotedocuments"></a>
+
+### `g8.api.quotes.listQuoteDocuments(input?)`
+
+**List Quote Documents**
+
+- HTTP: `GET /api/v1/quote-settings/documents`
+- operationId: `list_quote_documents_quote_settings_documents_get` (also callable as `g8.api.call("list_quote_documents_quote_settings_documents_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `quotes:read`
+
+The reusable legal documents a template can attach. A READ.
+
+**Input**: none.
+
+**Returns** `ApiResponse_QuoteListPayload_`: the envelope `{ data: QuoteListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`QuoteListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.quotes.listQuoteDocuments();
+```
+
+---
+
+<a id="op-listquoteevidence"></a>
+
+### `g8.api.quotes.listQuoteEvidence(input)`
+
+**List Quote Evidence**
+
+- HTTP: `GET /api/v1/quotes/{quote_id}/evidence`
+- operationId: `list_quote_evidence_quotes__quote_id__evidence_get` (also callable as `g8.api.call("list_quote_evidence_quotes__quote_id__evidence_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `quotes:read`
+
+The PDFs attached to a quote, newest first.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.quote_id` | `string (uuid)` | yes | Quote id. |
+
+**Returns** `ApiResponse_BillingListPayload_`: the envelope `{ data: BillingListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`BillingListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.quotes.listQuoteEvidence({ path: { quote_id: "00000000-0000-0000-0000-000000000000" } });
+```
+
+---
+
+<a id="op-listquotetemplates"></a>
+
+### `g8.api.quotes.listQuoteTemplates(input?)`
+
+**List Quote Templates**
+
+- HTTP: `GET /api/v1/quote-templates`
+- operationId: `list_quote_templates_quote_templates_get` (also callable as `g8.api.call("list_quote_templates_quote_templates_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `quotes:read`
+
+Reusable quote templates. A READ - any key, not just an admin's.
+
+Matching the app, where listing is `get_current_user` and only the writes
+below are admin-gated.
+
+**Input**: none.
+
+**Returns** `ApiResponse_QuoteListPayload_`: the envelope `{ data: QuoteListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`QuoteListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.quotes.listQuoteTemplates();
+```
+
+---
+
+<a id="op-listquotes"></a>
+
+### `g8.api.quotes.listQuotes(input?)`
+
+**List Quotes**
+
+- HTTP: `GET /api/v1/quotes`
+- operationId: `list_quotes_quotes_get` (also callable as `g8.api.call("list_quotes_quotes_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `quotes:read`
+- ★ Hand-written: [`g8.quotes.list()`](../sdk-clients.md#g8-quotes-list)
+
+List quotes for the org with optional status / company / deal / owner filters.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.status` | `string \| null` | no | Filter by quote status: draft, sent, viewed, accepted, declined, voided, expired |
+| `query.mashup_company_id` | `integer \| null` | no | Filter quotes for a specific company |
+| `query.deal_id` | `string \| null` | no | Filter quotes linked to a specific deal (UUID) |
+| `query.owner_id` | `string \| null` | no | Filter quotes owned by a specific user (email) |
+| `query.page` | `integer` | no | default `1` |
+| `query.limit` | `integer` | no | default `50` |
+
+**Returns** `ApiResponse_QuoteListResponse_`: the envelope `{ data: QuoteListResponse, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`QuoteListResponse` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<QuoteSummary>` | yes |  |
+| `limit` | `integer` | yes |  |
+| `page` | `integer` | yes |  |
+| `total` | `integer` | yes |  |
+
+**Example**
+
+```ts
+const result = await g8.api.quotes.listQuotes();
+```
+
+---
+
+<a id="op-liststripeproductsettings"></a>
+
+### `g8.api.quotes.listStripeProductSettings(input?)`
+
+**List Stripe Product Settings**
+
+- HTTP: `GET /api/v1/stripe/product-settings`
+- operationId: `list_stripe_product_settings_stripe_product_settings_get` (also callable as `g8.api.call("list_stripe_product_settings_stripe_product_settings_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `quotes:read`
+
+Every synced product with its quote-builder name, category and `quotable` flag.
+
+**Input**: none.
+
+**Returns** `ApiResponse_BillingListPayload_`: the envelope `{ data: BillingListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`BillingListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.quotes.listStripeProductSettings();
+```
+
+---
+
+<a id="op-liststripeproductsubscribers"></a>
+
+### `g8.api.quotes.listStripeProductSubscribers(input)`
+
+**List Stripe Product Subscribers**
+
+- HTTP: `GET /api/v1/stripe/products/{product_id}/subscribers`
+- operationId: `list_stripe_product_subscribers_stripe_products__product_id__subscribers_get` (also callable as `g8.api.call("list_stripe_product_subscribers_stripe_products__product_id__subscribers_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `quotes:read`
+
+Customers subscribed to one product, with the graph8 company each maps to.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.product_id` | `string` | yes | Stripe product id. |
+| `query.page` | `integer` | no | 1-based page. default `1` |
+| `query.limit` | `integer` | no | default `100` |
+| `query.filter_model` | `string \| null` | no | Grid filter model as JSON, as the app's grid sends it. |
+| `query.sort_model` | `string \| null` | no | Grid sort model as JSON. |
+
+**Returns** `ApiResponse_BillingListPayload_`: the envelope `{ data: BillingListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`BillingListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.quotes.listStripeProductSubscribers({ path: { product_id: "id" } });
+```
+
+---
+
+<a id="op-liststripeproducts"></a>
+
+### `g8.api.quotes.listStripeProducts(input?)`
+
+**List Stripe Products**
+
+- HTTP: `GET /api/v1/stripe/products`
+- operationId: `list_stripe_products_stripe_products_get` (also callable as `g8.api.call("list_stripe_products_stripe_products_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `quotes:read`
+
+Synced Stripe products with price range, subscriber counts and MRR.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.page` | `integer` | no | 1-based page. default `1` |
+| `query.limit` | `integer` | no | default `100` |
+| `query.filter_model` | `string \| null` | no | Grid filter model as JSON, as the app's grid sends it. |
+| `query.sort_model` | `string \| null` | no | Grid sort model as JSON. |
+
+**Returns** `ApiResponse_BillingListPayload_`: the envelope `{ data: BillingListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`BillingListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.quotes.listStripeProducts();
+```
+
+---
+
+<a id="op-markquoteaccepted"></a>
+
+### `g8.api.quotes.markQuoteAccepted(input)`
+
+**Mark Quote Accepted**
+
+- HTTP: `POST /api/v1/quotes/{quote_id}/mark-accepted`
+- operationId: `mark_quote_accepted_quotes__quote_id__mark_accepted_post` (also callable as `g8.api.call("mark_quote_accepted_quotes__quote_id__mark_accepted_post", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `quotes:run`
+
+Accept a quote on the customer's behalf. THIS RAISES AN INVOICE.
+
+It runs the same provisioning path a signed envelope runs: the quote flips
+to accepted, the total rolls up to the linked deal, and
+`provision_from_accepted_quote` materialises the invoice or subscription
+with the org's configured billing provider. Use it when the customer paid
+or signed outside graph8, not to tidy up a stale quote.
+
+`evidence_type` and `evidence_note` are REQUIRED and land on the audit row
+stamped `method="manual"`, so a manual accept stays distinguishable from a
+signed-envelope accept forever.
+
+The app additionally requires the caller to be an Owner/Admin or the
+resolved quote/deal owner, and refuses a quote that is not in the
+sent/viewed transition set with a 409.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.quote_id` | `string` | yes | Quote id (UUID). |
+| `body` | `ManualAcceptRequest` | yes | Request body; fields below. |
+
+Body fields (`ManualAcceptRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.evidence_note` | `string` | yes | What happened, in the accepter's own words. Stored on the audit row. min length 3, max length 2000 |
+| `body.evidence_type` | `"offline_signature" \| "customer_email" \| "verbal_authorization" \| "payment_received"` | yes | How the customer accepted, outside the e-sign flow. |
+
+**Returns** `ApiResponse_QuotePayload_`: the envelope `{ data: QuotePayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.quotes.markQuoteAccepted({
+  path: { quote_id: "id" },
+  body: { evidence_note: "example", evidence_type: "offline_signature" },
+});
+```
+
+---
+
+<a id="op-previewpaymentschedule"></a>
+
+### `g8.api.quotes.previewPaymentSchedule(input)`
+
+**Preview Payment Schedule**
+
+- HTTP: `POST /api/v1/quotes/payment-schedule`
+- operationId: `preview_payment_schedule_quotes_payment_schedule_post` (also callable as `g8.api.call("preview_payment_schedule_quotes_payment_schedule_post", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `quotes:read`
+
+What a set of line items would bill, and when. Arithmetic over the body.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `PaymentSchedulePreviewRequest` | yes | Request body; fields below. |
+
+Body fields (`PaymentSchedulePreviewRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.contract_start_date` | `string` | yes | ISO date the contract starts. |
+| `body.line_items` | `Array<QuoteLineItem>` | yes | min items 1, max items 500 |
+| `body.contract_duration_unit` | `"months" \| "weeks" \| "days" \| null` | no |  |
+| `body.contract_duration_value` | `number \| null` | no | min 0.1, max 3650 |
+| `body.contract_end_date` | `string \| null` | no |  |
+| `body.contract_months` | `number \| null` | no | min 0.1, max 120 |
+| `body.tax_amount` | `integer` | no | default `0`, min 0, max 1000000000 |
+
+**Returns** `ApiResponse_QuotePayload_`: the envelope `{ data: QuotePayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.quotes.previewPaymentSchedule({
+  body: {
+    contract_start_date: "example",
+    line_items: [{ product_name: "Example", unit_amount: 0 }],
+  },
+});
+```
+
+---
+
+<a id="op-previewquotedraft"></a>
+
+### `g8.api.quotes.previewQuoteDraft(input)`
+
+**Preview Quote Draft**
+
+- HTTP: `POST /api/v1/quotes/preview-draft`
+- operationId: `preview_quote_draft_quotes_preview_draft_post` (also callable as `g8.api.call("preview_quote_draft_quotes_preview_draft_post", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `quotes:read`
+
+Render a quote that does not exist yet. Creates nothing.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `Record<string, unknown>` | yes | Request body; fields below. |
+
+**Returns** `ApiResponse_QuotePayload_`: the envelope `{ data: QuotePayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.quotes.previewQuoteDraft({ body: {} });
+```
+
+---
+
+<a id="op-previewquotesend"></a>
+
+### `g8.api.quotes.previewQuoteSend(input)`
+
+**Preview Quote Send**
+
+- HTTP: `POST /api/v1/quotes/{quote_id}/send-preview`
+- operationId: `preview_quote_send_quotes__quote_id__send_preview_post` (also callable as `g8.api.call("preview_quote_send_quotes__quote_id__send_preview_post", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `quotes:read`
+
+Render the exact email and document `/send` would produce. SENDS NOTHING.
+
+Takes the identical body to `/send` on purpose - a preview rendered from a
+different body predicts nothing. `deliver` is accepted and inert.
+
+Tiered as a READ: it renders and returns, and nothing in the handler
+reaches a mail transport.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.quote_id` | `string` | yes | Quote id (UUID). |
+| `body` | `QuoteSendPreviewRequest` | yes | Request body; fields below. |
+
+Body fields (`QuoteSendPreviewRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.cc_emails` | `Array<string> \| null` | no |  |
+| `body.deliver` | `boolean` | no | default `true` |
+| `body.email_body` | `string \| null` | no |  |
+| `body.message` | `string \| null` | no |  |
+| `body.notification_mode` | `"after_each" \| "after_all"` | no | default `"after_each"` |
+| `body.preview_recipient_email` | `string \| null` | no |  |
+| `body.recipient_email` | `string \| null` | no |  |
+| `body.recipient_name` | `string \| null` | no |  |
+| `body.recipients` | `Array<QuoteSendRecipient> \| null` | no |  |
+| `body.subject` | `string \| null` | no |  |
+
+**Returns** `ApiResponse_QuotePayload_`: the envelope `{ data: QuotePayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.quotes.previewQuoteSend({ path: { quote_id: "id" }, body: {} });
+```
+
+---
+
+<a id="op-revokequote"></a>
+
+### `g8.api.quotes.revokeQuote(input)`
+
+**Revoke Quote**
+
+- HTTP: `POST /api/v1/quotes/{quote_id}/revoke`
+- operationId: `revoke_quote_quotes__quote_id__revoke_post` (also callable as `g8.api.call("revoke_quote_quotes__quote_id__revoke_post", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `quotes:delete`
+
+Withdraw a quote the customer has already been sent. TERMINAL.
+
+Revoke rather than expire when the offer itself was wrong: it pulls the
+document back rather than letting it lapse.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.quote_id` | `string` | yes | Quote id (UUID). |
+
+**Returns** `ApiResponse_QuotePayload_`: the envelope `{ data: QuotePayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.quotes.revokeQuote({ path: { quote_id: "id" } });
+```
+
+---
+
+<a id="op-searchquotecontacts"></a>
+
+### `g8.api.quotes.searchQuoteContacts(input?)`
+
+**Search Quote Contacts**
+
+- HTTP: `GET /api/v1/quote-contacts`
+- operationId: `search_quote_contacts_quote_contacts_get` (also callable as `g8.api.call("search_quote_contacts_quote_contacts_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `quotes:read`
+
+Find a contact to put on a quote as signer or billing contact.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.q` | `string` | no | Name or email fragment. Empty returns the default page. default `""` |
+| `query.limit` | `integer` | no | The app's default is 100 and deliberately not smaller: the signer picker has to show every plausible match, and a short page reads as 'this contact does not exist'. default `100` |
+| `query.company_id` | `integer \| null` | no | Scope to contacts at this company. |
+| `query.deal_id` | `string \| null` | no | Scope to contacts linked to this deal. Combined with `company_id` the two scopes are a UNION - on the deal OR at the company - and each row comes back with an `on_deal` flag. Given `deal_id` alone, the company is derived from the deal. |
+
+**Returns** `ApiResponse_QuoteListPayload_`: the envelope `{ data: QuoteListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`QuoteListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.quotes.searchQuoteContacts();
+```
+
+---
+
+<a id="op-sendquote"></a>
+
+### `g8.api.quotes.sendQuote(input)`
+
+**Send Quote**
+
+- HTTP: `POST /api/v1/quotes/{quote_id}/send`
+- operationId: `send_quote_quotes__quote_id__send_post` (also callable as `g8.api.call("send_quote_quotes__quote_id__send_post", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `quotes:run`
+- ★ Hand-written: [`g8.quotes.send()`](../sdk-clients.md#g8-quotes-send)
+
+Send the quote for e-signature (or resend if it's already in flight).
+
+Side effects: creates / reuses a signing envelope, sends the
+customer-facing email via SES, logs to the universal inbox, rolls
+quote status forward to ``sent``. Recipient is resolved from
+``signer_contact_id`` or ``signer_email`` (one must be set).
+
+Idempotent for resend: when the quote already has an envelope in
+``sent`` or ``viewed`` state, the existing envelope is re-emailed
+and the recipient keeps the original signing link.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.quote_id` | `string` | yes | Quote UUID (must be in draft or sent status) |
+| `body` | `QuoteSendRequest` | no | Request body; fields below. |
+
+Body fields (`QuoteSendRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.message` | `string \| null` | no |  |
+| `body.subject` | `string \| null` | no |  |
+
+**Returns** `ApiResponse_QuoteDetail_`: the envelope `{ data: QuoteDetail, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`QuoteDetail` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `activity` | `Array<Record<string, unknown>> \| null` | no |  |
+| `envelope` | `Record<string, unknown> \| null` | no |  |
+| `id` | `string \| null` | no |  |
+| `line_items` | `Array<Record<string, unknown>> \| null` | no |  |
+| `quote_number` | `string \| null` | no |  |
+| `status` | `string \| null` | no |  |
+| `title` | `string \| null` | no |  |
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.quotes.sendQuote({ path: { quote_id: "id" } });
+```
+
+---
+
+<a id="op-triggerstripesync"></a>
+
+### `g8.api.quotes.triggerStripeSync(input?)`
+
+**Trigger Stripe Sync**
+
+- HTTP: `POST /api/v1/stripe/sync`
+- operationId: `trigger_stripe_sync_stripe_sync_post` (also callable as `g8.api.call("trigger_stripe_sync_stripe_sync_post", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `quotes:run`
+
+Sync the org's Stripe catalogue now instead of waiting for the schedule.
+
+404 when Stripe is not connected. For a large catalogue, poll
+`GET /stripe/integration-status` and watch `total_products` grow.
+
+**Input**: none.
+
+**Returns** `ApiResponse_BillingPayload_`: the envelope `{ data: BillingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.quotes.triggerStripeSync();
+```
+
+---
+
+<a id="op-unarchivequote"></a>
+
+### `g8.api.quotes.unarchiveQuote(input)`
+
+**Unarchive Quote**
+
+- HTTP: `POST /api/v1/quotes/{quote_id}/unarchive`
+- operationId: `unarchive_quote_quotes__quote_id__unarchive_post` (also callable as `g8.api.call("unarchive_quote_quotes__quote_id__unarchive_post", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `quotes:run`
+
+Restore an archived quote to the active list.
+
+A quote that is not archived comes back unchanged - unarchiving an already
+active quote is a no-op and announces nothing. Stated because the sibling
+sequence unarchive raises 403 unconditionally and had to be withdrawn from
+the contract; this one is genuinely callable.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.quote_id` | `string` | yes | Quote id (UUID). |
+
+**Returns** `ApiResponse_QuotePayload_`: the envelope `{ data: QuotePayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.quotes.unarchiveQuote({ path: { quote_id: "id" } });
+```
+
+---
+
+<a id="op-updatemanualproduct"></a>
+
+### `g8.api.quotes.updateManualProduct(input)`
+
+**Update Manual Product**
+
+- HTTP: `PATCH /api/v1/manual-products/{product_id}`
+- operationId: `update_manual_product_manual_products__product_id__patch` (also callable as `g8.api.call("update_manual_product_manual_products__product_id__patch", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `quotes:write`
+
+Change some fields of a manual product. Only the fields you send change.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.product_id` | `string (uuid)` | yes | Manual product id. |
+| `body` | `ManualProductUpdateRequest` | yes | Request body; fields below. |
+
+Body fields (`ManualProductUpdateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.active` | `boolean \| null` | no |  |
+| `body.billing_frequency` | `"one_time" \| "month" \| "year" \| "quarter" \| null` | no |  |
+| `body.category` | `string \| null` | no | max length 100 |
+| `body.currency` | `string \| null` | no | min length 3, max length 3 |
+| `body.default_unit_amount` | `integer \| null` | no | min 0, max 1000000000 |
+| `body.description` | `string \| null` | no | max length 5000 |
+| `body.name` | `string \| null` | no | min length 1, max length 500 |
+| `body.quotable` | `boolean \| null` | no |  |
+| `body.sort_order` | `integer \| null` | no | min 0, max 10000 |
+
+**Returns** `ApiResponse_BillingPayload_`: the envelope `{ data: BillingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.quotes.updateManualProduct({
+  path: { product_id: "00000000-0000-0000-0000-000000000000" },
+  body: {},
+});
+```
+
+---
+
+<a id="op-updatequotepatch"></a>
+
+### `g8.api.quotes.updateQuotePatch(input)`
+
+**Update Quote**
+
+- HTTP: `PATCH /api/v1/quotes/{quote_id}`
+- operationId: `update_quote_quotes__quote_id__patch` (also callable as `g8.api.call("update_quote_quotes__quote_id__patch", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `quotes:run`
+
+Update a quote in place (``PUT`` or ``PATCH`` — both accepted).
+
+All fields are optional; only the ones you send change. Draft quotes edit
+directly. A ``sent`` / ``viewed`` quote is recalled to draft first (voiding
+its live signing link) while keeping the same row + quote number; terminal
+quotes (accepted/declined/voided/expired) reject the update.
+
+``owner_id`` reassigns the quote's AE (a blank value is ignored — it never
+nulls an existing owner). ``billing_legal_name`` / ``billing_email`` /
+``billing_primary_email`` / ``billing_address`` set the customer's billing
+identity. Passing ``line_items`` replaces the entire line-item set (and
+re-runs quotable-product authorization). Totals recalculate automatically.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.quote_id` | `string` | yes | Quote UUID |
+| `body` | `QuoteUpdateRequest` | yes | Request body; fields below. |
+
+Body fields (`QuoteUpdateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.accepted_payment_methods` | `Array<"ach" \| "credit_card" \| "wire"> \| null` | no |  |
+| `body.billing_address` | `string \| null` | no | max length 2000 |
+| `body.billing_contact_id` | `integer \| null` | no |  |
+| `body.billing_email` | `string \| null` | no | max length 255 |
+| `body.billing_legal_name` | `string \| null` | no | max length 255 |
+| `body.billing_primary_email` | `string \| null` | no | max length 255 |
+| `body.contract_duration_unit` | `"months" \| "weeks" \| "days" \| null` | no |  |
+| `body.contract_duration_value` | `number \| null` | no | min 0.1, max 3650 |
+| `body.contract_end_date` | `string \| null` | no |  |
+| `body.contract_months` | `number \| null` | no | min 0.1, max 120 |
+| `body.contract_start_date` | `string \| null` | no |  |
+| `body.currency` | `string \| null` | no | min length 3, max length 3 |
+| `body.deal_id` | `string \| null` | no |  |
+| `body.line_items` | `Array<QuoteLineItemRequest> \| null` | no | min items 1 |
+| `body.marketing_rights` | `Array<"logo" \| "quote" \| "case_study"> \| null` | no |  |
+| `body.mashup_company_id` | `integer \| null` | no |  |
+| `body.notes` | `string \| null` | no | max length 10000 |
+| `body.owner_id` | `string \| null` | no | max length 255 |
+| `body.payment_terms` | `"due_on_receipt" \| "net_15" \| "net_30" \| "net_45" \| "net_60" \| "net_90" \| null` | no |  |
+| `body.privacy_content` | `string \| null` | no | max length 50000 |
+| `body.public_notes` | `string \| null` | no | max length 50000 |
+| `body.signer_contact_id` | `integer \| null` | no |  |
+| `body.signer_email` | `string \| null` | no | max length 255 |
+| `body.signer_name` | `string \| null` | no | max length 255 |
+| `body.tax_amount` | `integer \| null` | no | min 0, max 1000000000 |
+| `body.terms_content` | `string \| null` | no | max length 50000 |
+| `body.title` | `string \| null` | no | min length 1, max length 500 |
+| `body.valid_until` | `string \| null` | no |  |
+
+**Returns** `ApiResponse_QuoteDetail_`: the envelope `{ data: QuoteDetail, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`QuoteDetail` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `activity` | `Array<Record<string, unknown>> \| null` | no |  |
+| `envelope` | `Record<string, unknown> \| null` | no |  |
+| `id` | `string \| null` | no |  |
+| `line_items` | `Array<Record<string, unknown>> \| null` | no |  |
+| `quote_number` | `string \| null` | no |  |
+| `status` | `string \| null` | no |  |
+| `title` | `string \| null` | no |  |
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.quotes.updateQuotePatch({ path: { quote_id: "id" }, body: {} });
+```
+
+---
+
+<a id="op-updatequoteput"></a>
+
+### `g8.api.quotes.updateQuotePut(input)`
+
+**Update Quote**
+
+- HTTP: `PUT /api/v1/quotes/{quote_id}`
+- operationId: `update_quote_quotes__quote_id__put` (also callable as `g8.api.call("update_quote_quotes__quote_id__put", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `quotes:run`
+- ★ Hand-written: [`g8.quotes.update()`](../sdk-clients.md#g8-quotes-update)
+
+Update a quote in place (``PUT`` or ``PATCH`` — both accepted).
+
+All fields are optional; only the ones you send change. Draft quotes edit
+directly. A ``sent`` / ``viewed`` quote is recalled to draft first (voiding
+its live signing link) while keeping the same row + quote number; terminal
+quotes (accepted/declined/voided/expired) reject the update.
+
+``owner_id`` reassigns the quote's AE (a blank value is ignored — it never
+nulls an existing owner). ``billing_legal_name`` / ``billing_email`` /
+``billing_primary_email`` / ``billing_address`` set the customer's billing
+identity. Passing ``line_items`` replaces the entire line-item set (and
+re-runs quotable-product authorization). Totals recalculate automatically.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.quote_id` | `string` | yes | Quote UUID |
+| `body` | `QuoteUpdateRequest` | yes | Request body; fields below. |
+
+Body fields (`QuoteUpdateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.accepted_payment_methods` | `Array<"ach" \| "credit_card" \| "wire"> \| null` | no |  |
+| `body.billing_address` | `string \| null` | no | max length 2000 |
+| `body.billing_contact_id` | `integer \| null` | no |  |
+| `body.billing_email` | `string \| null` | no | max length 255 |
+| `body.billing_legal_name` | `string \| null` | no | max length 255 |
+| `body.billing_primary_email` | `string \| null` | no | max length 255 |
+| `body.contract_duration_unit` | `"months" \| "weeks" \| "days" \| null` | no |  |
+| `body.contract_duration_value` | `number \| null` | no | min 0.1, max 3650 |
+| `body.contract_end_date` | `string \| null` | no |  |
+| `body.contract_months` | `number \| null` | no | min 0.1, max 120 |
+| `body.contract_start_date` | `string \| null` | no |  |
+| `body.currency` | `string \| null` | no | min length 3, max length 3 |
+| `body.deal_id` | `string \| null` | no |  |
+| `body.line_items` | `Array<QuoteLineItemRequest> \| null` | no | min items 1 |
+| `body.marketing_rights` | `Array<"logo" \| "quote" \| "case_study"> \| null` | no |  |
+| `body.mashup_company_id` | `integer \| null` | no |  |
+| `body.notes` | `string \| null` | no | max length 10000 |
+| `body.owner_id` | `string \| null` | no | max length 255 |
+| `body.payment_terms` | `"due_on_receipt" \| "net_15" \| "net_30" \| "net_45" \| "net_60" \| "net_90" \| null` | no |  |
+| `body.privacy_content` | `string \| null` | no | max length 50000 |
+| `body.public_notes` | `string \| null` | no | max length 50000 |
+| `body.signer_contact_id` | `integer \| null` | no |  |
+| `body.signer_email` | `string \| null` | no | max length 255 |
+| `body.signer_name` | `string \| null` | no | max length 255 |
+| `body.tax_amount` | `integer \| null` | no | min 0, max 1000000000 |
+| `body.terms_content` | `string \| null` | no | max length 50000 |
+| `body.title` | `string \| null` | no | min length 1, max length 500 |
+| `body.valid_until` | `string \| null` | no |  |
+
+**Returns** `ApiResponse_QuoteDetail_`: the envelope `{ data: QuoteDetail, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`QuoteDetail` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `activity` | `Array<Record<string, unknown>> \| null` | no |  |
+| `envelope` | `Record<string, unknown> \| null` | no |  |
+| `id` | `string \| null` | no |  |
+| `line_items` | `Array<Record<string, unknown>> \| null` | no |  |
+| `quote_number` | `string \| null` | no |  |
+| `status` | `string \| null` | no |  |
+| `title` | `string \| null` | no |  |
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.quotes.updateQuotePut({ path: { quote_id: "id" }, body: {} });
+```
+
+---
+
+<a id="op-updatequotesettings"></a>
+
+### `g8.api.quotes.updateQuoteSettings(input)`
+
+**Update Quote Settings**
+
+- HTTP: `PUT /api/v1/quote-settings`
+- operationId: `update_quote_settings_quote_settings_put` (also callable as `g8.api.call("update_quote_settings_quote_settings_put", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `quotes:run`
+
+Org-wide quote branding, terms and sender identity. ORG ADMIN.
+
+`GET /quote-settings` was already published; this is its write half. Admin
+because `sender_email` decides whose name every quote goes out under.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `QuoteSettingsUpdateRequest` | yes | Request body; fields below. |
+
+Body fields (`QuoteSettingsUpdateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.accent_color` | `string \| null` | no |  |
+| `body.auto_advance_deal_on_quote_send` | `boolean \| null` | no |  |
+| `body.auto_close_deal_on_acceptance` | `boolean \| null` | no | Close the linked DEAL when a quote is accepted. Org-wide, and it changes what every future acceptance does to the pipeline. |
+| `body.company_address` | `string \| null` | no |  |
+| `body.company_email` | `string \| null` | no |  |
+| `body.company_logo_url` | `string \| null` | no |  |
+| `body.company_name` | `string \| null` | no |  |
+| `body.company_phone` | `string \| null` | no |  |
+| `body.default_billing_provider` | `string \| null` | no |  |
+| `body.default_payment_terms` | `string \| null` | no |  |
+| `body.default_privacy` | `string \| null` | no |  |
+| `body.default_terms` | `string \| null` | no |  |
+| `body.default_valid_days` | `integer \| null` | no |  |
+| `body.footer_text` | `string \| null` | no |  |
+| `body.privacy_url` | `string \| null` | no |  |
+| `body.quote_acceptance_roam_channel_id` | `string \| null` | no |  |
+| `body.quote_acceptance_roam_channel_name` | `string \| null` | no |  |
+| `body.quote_acceptance_roam_notifications_enabled` | `boolean \| null` | no |  |
+| `body.quote_number_prefix` | `string \| null` | no |  |
+| `body.required_billing_fields` | `Array<string> \| null` | no |  |
+| `body.sender_email` | `string \| null` | no | Whose name every quote goes out under. Admin-only for that reason. |
+| `body.sender_mode` | `string \| null` | no | `fixed` to always use `sender_email`, or `creator`. |
+| `body.sender_name` | `string \| null` | no |  |
+| `body.terms_library` | `Array<Record<string, unknown>> \| null` | no |  |
+| `body.terms_url` | `string \| null` | no |  |
+
+**Returns** `ApiResponse_QuotePayload_`: the envelope `{ data: QuotePayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.quotes.updateQuoteSettings({ body: {} });
+```
+
+---
+
+<a id="op-updatequotetemplate"></a>
+
+### `g8.api.quotes.updateQuoteTemplate(input)`
+
+**Update Quote Template**
+
+- HTTP: `PUT /api/v1/quote-templates/{template_id}`
+- operationId: `update_quote_template_quote_templates__template_id__put` (also callable as `g8.api.call("update_quote_template_quote_templates__template_id__put", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `quotes:run`
+
+Replace a template. ORG ADMIN.
+
+A PUT, matching the app: the body is the template's new state, not a patch,
+so an omitted field is CLEARED rather than left alone.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.template_id` | `string` | yes | Template id. |
+| `body` | `QuoteTemplateRequest` | yes | Request body; fields below. |
+
+Body fields (`QuoteTemplateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.name` | `string` | yes | min length 1, max length 255 |
+| `body.contract_duration_unit` | `"months" \| "weeks" \| "days" \| null` | no |  |
+| `body.contract_duration_value` | `number \| null` | no | min 0.1, max 3650 |
+| `body.contract_months` | `number \| null` | no | min 0.1, max 120 |
+| `body.default_line_items` | `Array<Record<string, unknown>> \| null` | no |  |
+| `body.default_payment_terms` | `string \| null` | no |  |
+| `body.default_valid_days` | `integer \| null` | no | min 1, max 365 |
+| `body.description` | `string \| null` | no |  |
+| `body.document_ids` | `Array<string> \| null` | no | Legal documents to attach to every quote built from this template. Ids come from `GET /quote-settings/documents`. |
+| `body.is_default` | `boolean` | no | default `false` |
+| `body.terms_override` | `string \| null` | no |  |
+
+**Returns** `ApiResponse_QuotePayload_`: the envelope `{ data: QuotePayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.quotes.updateQuoteTemplate({ path: { template_id: "id" }, body: { name: "Example" } });
+```
+
+---
+
+<a id="op-updatestripecustomermapping"></a>
+
+### `g8.api.quotes.updateStripeCustomerMapping(input)`
+
+**Update Stripe Customer Mapping**
+
+- HTTP: `PATCH /api/v1/stripe/customers/{customer_id}/mapping`
+- operationId: `update_stripe_customer_mapping_stripe_customers__customer_id__mapping_patch` (also callable as `g8.api.call("update_stripe_customer_mapping_stripe_customers__customer_id__mapping_patch", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `quotes:write`
+
+Map a Stripe customer to a graph8 company by hand, or unmap it with null.
+
+A manual mapping is recorded as such, so the automatic matcher leaves it alone.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.customer_id` | `integer` | yes | The synced customer row id (not the `cus_` id). |
+| `body` | `CustomerMappingRequest` | yes | Request body; fields below. |
+
+Body fields (`CustomerMappingRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.mashup_company_id` | `integer \| null` | yes | graph8 company id. Null removes the mapping. |
+
+**Returns** `ApiResponse_BillingPayload_`: the envelope `{ data: BillingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.quotes.updateStripeCustomerMapping({ path: { customer_id: 123 }, body: { mashup_company_id: 123 } });
+```
+
+---
+
+<a id="op-uploadquotedocument"></a>
+
+### `g8.api.quotes.uploadQuoteDocument(input?)`
+
+**Upload Quote Document**
+
+- HTTP: `POST /api/v1/quote-settings/documents`
+- operationId: `upload_quote_document_quote_settings_documents_post` (also callable as `g8.api.call("upload_quote_document_quote_settings_documents_post", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `quotes:run`
+
+Upload a legal document to the org's library. ORG ADMIN.
+
+Multipart, like the app. The PDF-only and 10 MB rules are the app's and are
+enforced there; they are documented here so a caller sees them before
+spending the upload.
+
+**Input**: none.
+
+**Returns** `ApiResponse_QuotePayload_`: the envelope `{ data: QuotePayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.quotes.uploadQuoteDocument();
+```
+
+---
+
+<a id="op-uploadquoteevidence"></a>
+
+### `g8.api.quotes.uploadQuoteEvidence(input)`
+
+**Upload Quote Evidence**
+
+- HTTP: `POST /api/v1/quotes/{quote_id}/evidence`
+- operationId: `upload_quote_evidence_quotes__quote_id__evidence_post` (also callable as `g8.api.call("upload_quote_evidence_quotes__quote_id__evidence_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `quotes:write`
+
+Attach an internal PDF to a quote - for example a copy signed outside
+graph8. Internal: it never enters the template or signing pipeline.
+
+Needs WRITE access to the quote. 400 for anything that is not a complete
+PDF, 413 above 10 MB.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.quote_id` | `string (uuid)` | yes | Quote id. |
+
+**Returns** `ApiResponse_BillingPayload_`: the envelope `{ data: BillingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.quotes.uploadQuoteEvidence({ path: { quote_id: "00000000-0000-0000-0000-000000000000" } });
+```
+
+---
+
+<a id="op-upsertstripeproductsettings"></a>
+
+### `g8.api.quotes.upsertStripeProductSettings(input)`
+
+**Upsert Stripe Product Settings**
+
+- HTTP: `PUT /api/v1/stripe/product-settings/{stripe_product_id}`
+- operationId: `upsert_stripe_product_settings_stripe_product_settings__stripe_product_id__put` (also callable as `g8.api.call("upsert_stripe_product_settings_stripe_product_settings__stripe_product_id__put", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `quotes:write`
+
+Set one product's quote-builder settings. Omitted fields are left
+unchanged. Org Admin or Owner key only.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.stripe_product_id` | `string` | yes | Stripe product id. |
+| `body` | `ProductSettingsUpdateRequest` | yes | Request body; fields below. |
+
+Body fields (`ProductSettingsUpdateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.category` | `string \| null` | no |  |
+| `body.friendly_description` | `string \| null` | no |  |
+| `body.friendly_name` | `string \| null` | no |  |
+| `body.quotable` | `boolean \| null` | no |  |
+| `body.sort_order` | `integer \| null` | no |  |
+
+**Returns** `ApiResponse_BillingPayload_`: the envelope `{ data: BillingPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.quotes.upsertStripeProductSettings({ path: { stripe_product_id: "id" }, body: {} });
+```
+
+---
+
+## Referenced types
+
+Named types that appear in the tables above. Full TypeScript definitions: `G8Contract.<Name>` (`import type { G8Contract } from "@graph8/sdk"`).
+
+<a id="type-quotelineitem"></a>
+
+### `QuoteLineItem`
+
+One priced line, mirroring the app's `LineItemDTO`. The two REQUIRED fields are required here too, and that is the point: the app model is built inside the handler, so a missing `product_name` or `unit_amount` would raise a bare `pydantic.ValidationError` there - not the `RequestValidationError` `error_handlers.py` registers - and escape as a 500 instead of a 422. `unit_amount` is in CENTS, like the app. An API that took dollars here while the app took cents would be wrong by a factor of a hundred on every quote, silently. CLOSED (`extra="forbid"`), which makes this stricter than the app on p…
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `product_name` | `string` | yes | min length 1, max length 255 |
+| `unit_amount` | `integer` | yes | CENTS, not dollars. min 0, max 1000000000 |
+| `billing_frequency` | `string \| null` | no |  |
+| `billing_start_date` | `string \| null` | no |  |
+| `description` | `string \| null` | no | max length 2000 |
+| `discount_pct` | `number` | no | default `0`, min 0, max 100 |
+| `manual_product_id` | `string \| null` | no |  |
+| `quantity` | `integer` | no | default `1`, min 1, max 10000 |
+| `sort_order` | `integer` | no | default `0` |
+| `start_month` | `integer` | no | default `1`, min 1, max 120 |
+| `stripe_price_id` | `string \| null` | no |  |
+| `stripe_product_id` | `string \| null` | no |  |
+
+<a id="type-quotelineitemrequest"></a>
+
+### `QuoteLineItemRequest`
+
+One line item on a quote request body. Shape mirrors ``integrations_v4.interfaces.fastapi.quote_router.LineItemDTO`` exactly. Pass either ``stripe_product_id`` + ``stripe_price_id`` (for a Stripe-catalogue product) or ``manual_product_id`` (for an org-owned manual catalogue entry), or neither (for a custom one-off line). Authorization is enforced server-side — non-quotable products are rejected with 400.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `product_name` | `string` | yes | min length 1, max length 255 |
+| `unit_amount` | `integer` | yes | In cents min 0, max 1000000000 |
+| `billing_frequency` | `"one_time" \| "month" \| "year" \| "quarter" \| null` | no |  |
+| `billing_start_date` | `string (date) \| null` | no | Exact recurring billing start date within the contract; start_month must remain 1 when supplied. |
+| `description` | `string \| null` | no | max length 2000 |
+| `discount_pct` | `number` | no | default `0`, min 0, max 100 |
+| `manual_product_id` | `string \| null` | no |  |
+| `quantity` | `integer` | no | default `1`, min 1, max 10000 |
+| `sort_order` | `integer` | no | default `0` |
+| `start_month` | `integer` | no | Contract month when recurring billing begins; 1 means at contract start. Use billing_start_date instead for an exact date. default `1`, min 1, max 120 |
+| `stripe_price_id` | `string \| null` | no |  |
+| `stripe_product_id` | `string \| null` | no |  |
+
+<a id="type-quotesendrecipient"></a>
+
+### `QuoteSendRecipient`
+
+One recipient of a quote preview.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `email` | `string` | yes | max length 255 |
+| `email_body` | `string \| null` | no | max length 10000 |
+| `name` | `string \| null` | no | max length 255 |
+| `role` | `"signer" \| "viewer"` | no | default `"signer"` |
+| `subject` | `string \| null` | no | max length 500 |
+
+<a id="type-quotesummary"></a>
+
+### `QuoteSummary`
+
+List-view row from ``GET /quotes``. ``extra="allow"`` keeps every backend column flowing through without us re-declaring CBQuote.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `accepted_at` | `string \| null` | no |  |
+| `created_at` | `string \| null` | no |  |
+| `currency` | `string \| null` | no |  |
+| `id` | `string \| null` | no |  |
+| `quote_number` | `string \| null` | no |  |
+| `sent_at` | `string \| null` | no |  |
+| `status` | `string \| null` | no |  |
+| `title` | `string \| null` | no |  |
+| `total` | `integer \| null` | no |  |