> ## Documentation Index > Fetch the complete documentation index at: https://docs.kordless.ai/llms.txt > Use this file to discover all available pages before exploring further. # Create a quote as a Business member > Creates a Quote against the Live Environment of the Business's connection. Authenticates the caller's session; any active Business member (owner, editor, or viewer) may quote. ## OpenAPI ````yaml /api-reference/openapi.yaml post /v1/businesses/{businessId}/quotes openapi: 3.1.0 info: title: Kordless API version: 1.0.0 description: | The Kordless API creates deterministic quotes against published Book Versions and returns immutable Quote Receipts. The same pipeline serves headless API-key traffic, Business-member sessions, and anonymous end-customer surfaces. ## Authentication Headless routes require a secret API key as a bearer token: ``` Authorization: Bearer sk_test_... ``` Test keys use the `sk_test_` prefix; Live keys use `sk_live_`. The key binds a Workspace, Project, and one Environment — a Test key can never address Live data. Member routes under `/v1/businesses/{businessId}` authenticate the caller's session and Business membership. The `/v1/public_quotes` routes are anonymous by design. ## Idempotency Quote creation accepts an optional `idempotencyKey` in the request body. Retrying with the same key and the same payload replays the original Quote; the same key with a different payload returns `409 idempotency_conflict`. When omitted, the server generates an `auto_` key. ## Envelopes and request IDs Success responses are `{ "data": …, "requestId": … }`; failures are `{ "error": { "code", "message", "requestId", "details?" } }`. Every response also carries an `x-request-id` header, echoed on created Quotes as `requestCorrelationId`. servers: - url: https://your-kordless-instance.com description: Replace with your Kordless instance base URL security: - BearerAuth: [] tags: - name: Quotes description: Headless quote creation and retrieval with an API key. - name: Public quotes description: Anonymous end-customer quotes against the Live-published Book. - name: Business portal description: Member-session routes used by the hosted Business Portal. - name: API keys description: >- Workspace-session routes for the API-key lifecycle (create, rotate, revoke). - name: Webhooks description: >- Workspace-session routes for webhook endpoints, deliveries, test events, and replay. - name: Request logs description: Workspace-session log search and Quote Intent traces. - name: Status description: Anonymous liveness signal. paths: /v1/businesses/{businessId}/quotes: post: tags: - Business portal summary: Create a quote as a Business member description: | Creates a Quote against the Live Environment of the Business's connection. Authenticates the caller's session; any active Business member (owner, editor, or viewer) may quote. operationId: createBusinessQuote parameters: - name: businessId in: path required: true schema: type: string format: uuid description: The Business ID. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateHostedQuoteRequest' responses: '201': description: The created Quote Intent and its Receipt. content: application/json: schema: $ref: '#/components/schemas/CreateQuoteResponse' '401': description: No authenticated session. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: error: code: unauthorized message: Authentication is required. requestId: req_9f8e7d6c '404': $ref: '#/components/responses/QuoteScopeNotFound' '409': $ref: '#/components/responses/IdempotencyConflict' '422': $ref: '#/components/responses/InvalidQuoteRequest' security: [] components: schemas: CreateHostedQuoteRequest: type: object required: - bookId - offeringId additionalProperties: false properties: bookId: type: string format: uuid offeringId: type: string maxLength: 80 factors: type: object default: {} additionalProperties: type: - string - 'null' maxLength: 200 idempotencyKey: type: string minLength: 8 maxLength: 120 CreateQuoteResponse: type: object required: - data - requestId properties: data: type: object required: - quoteIntent - quoteReceipt properties: quoteIntent: $ref: '#/components/schemas/QuoteIntent' quoteReceipt: $ref: '#/components/schemas/QuoteReceipt' requestId: type: string ErrorEnvelope: type: object required: - error properties: error: type: object required: - code - message - requestId properties: code: type: string message: type: string requestId: type: string details: type: object description: >- Optional structured context, for example `fields` on validation failures. QuoteIntent: type: object description: The persisted quote request. properties: id: type: string format: uuid workspaceId: type: string format: uuid projectId: type: string format: uuid environmentId: type: string format: uuid bookId: type: string format: uuid bookVersionId: type: string format: uuid nullable: true description: Pinned at creation from the Environment's publication pointer. status: type: string enum: - created - requires_input - processing - succeeded - failed - expired source: type: string enum: - hosted - api idempotencyKey: type: string requestCorrelationId: type: string description: Matches the `x-request-id` of the creating request. inputs: type: object properties: offeringId: type: string factors: type: object additionalProperties: type: - string - 'null' expiresAt: type: string format: date-time nullable: true createdAt: type: string format: date-time QuoteReceipt: type: object description: | Immutable outcome evidence. Exactly one evidence channel is populated: `computation` on success, `missingInputs` when input is required, or `failure` on an unpriced outcome. properties: id: type: string format: uuid quoteIntentId: type: string format: uuid outcome: type: string enum: - succeeded - requires_input - failed source: type: string enum: - hosted - api bookVersionId: type: string format: uuid nullable: true description: Always set on succeeded receipts. computation: $ref: '#/components/schemas/QuoteComputation' missingInputs: type: array items: type: string description: >- Dotted paths such as `factors.vehicle_size` or `offeringId`. Empty unless the outcome is `requires_input`. failure: type: object nullable: true properties: code: type: string description: >- For example `no_published_version`, `unknown_offering`, `unknown_factor`, `unknown_factor_option`. message: type: string idempotencyKey: type: string requestCorrelationId: type: string latencyMs: type: integer minimum: 0 createdAt: type: string format: date-time QuoteComputation: type: object nullable: true description: >- Present only on `succeeded` receipts. All amounts are integer minor units. properties: currency: type: string description: ISO 4217 currency code. lineItems: type: array minItems: 1 items: $ref: '#/components/schemas/ReceiptLineItem' totalMinor: type: integer minimum: 0 description: Always reconciles to the sum of line items. paymentTerms: type: object properties: depositBasisPoints: type: integer minimum: 0 maximum: 10000 depositMinor: type: integer minimum: 0 balanceDueMinor: type: integer minimum: 0 description: Deposit plus balance always reconciles to `totalMinor`. conditions: type: array items: type: string derivation: type: array minItems: 1 items: $ref: '#/components/schemas/DerivationEntry' ReceiptLineItem: type: object properties: kind: type: string enum: - base - surcharge - discount - guardrail label: type: string amountMinor: type: integer ruleId: type: string nullable: true DerivationEntry: type: object description: One step of the deterministic evaluation, in order. properties: sequence: type: integer minimum: 0 phase: type: string enum: - base - baseOverride - scopedModifier - conditionalModifier - discount - guardrail - paymentTerms ruleId: type: string nullable: true ruleType: type: string nullable: true status: type: string enum: - applied - skipped reason: type: string deltaMinor: type: integer runningTotalMinor: type: integer minimum: 0 responses: QuoteScopeNotFound: description: >- The Business, Book, or Environment scope does not exist for this credential. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: error: code: quote_scope_not_found message: The Quote scope does not exist. requestId: req_9f8e7d6c IdempotencyConflict: description: The idempotency key was already used with a different payload. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: error: code: idempotency_conflict message: The idempotency key was already used with a different payload. requestId: req_9f8e7d6c InvalidQuoteRequest: description: >- The request body failed schema validation; `details.fields` lists the offending fields. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: error: code: invalid_quote_request message: A Business, offering, and factor selections are required. requestId: req_9f8e7d6c details: fields: offeringId: - Required securitySchemes: BearerAuth: type: http scheme: bearer description: >- Secret API key (`sk_test_…` or `sk_live_…`). The key binds a Workspace, Project, and Environment. ````