> ## Documentation Index
> Fetch the complete documentation index at: https://docs.marro.si/llms.txt
> Use this file to discover all available pages before exploring further.

# Accept or decline a published customer quote

> Bearer-authenticated digital acceptance, not certified e-signing. Explicit confirmation, current revision/fingerprint and one persistent UUID idempotency key are required. Exact retries return saved evidence; another key or decision cannot overwrite it. Expired, archived, cancelled or stale new decisions fail. JSON stream is limited to 4096 bytes. No payment or provider request is made.



## OpenAPI

````yaml /openapi.json post /api/public/customer-quotes
openapi: 3.1.0
info:
  title: Marro API
  version: 1.0.0
  description: >-
    Server-to-server access to one organization’s data in Marro. Each key
    belongs to an organization and can use only the scopes it was given for
    modules the organization subscribes to. Keys go only in the Authorization
    header, over HTTPS, from a server: never in browser code or a URL. A key
    that was ever sent over plain HTTP or in a URL must be treated as leaked:
    revoke it and create a new one. The API sends no CORS headers.


    Every response carries `X-Request-Id`, to quote to support. Once the key is
    checked, responses also carry `RateLimit-Limit`, `RateLimit-Remaining` and
    `RateLimit-Reset` (seconds until the window resets) for whichever limit is
    closer to running out. An address that is not an endpoint answers 404
    `NOT_FOUND` in the same error shape.
servers:
  - url: https://app.marro.si
security: []
tags:
  - name: Leads
    description: >-
      Record-link custom fields accept numeric target ID arrays (one or up to 20
      according to recordLink.multiple). Reads resolve accessible targets to
      id/kind/name/href objects. Deleted, archived, disabled and inaccessible
      targets are omitted. Destinations require the corresponding leads.read or
      crm.records.read scope; user destinations have no public API scope. Object
      destinations use object:<id>, require objects.records.read and the key
      creator current object grants.
  - name: Customers
    description: >-
      Contacts, companies and enabled opportunities with record-type custom
      fields. Dedicated crm.records scopes are required.
  - name: Reference
    description: 'How this organization is set up: fields, stages, sources and people.'
  - name: Money
    description: >-
      Products, quotes, invoices and payments. Amounts are integers in the
      smallest currency unit (paise, cents); a new document is in the
      organization's own currency. Tax follows the organization's regional
      settings: under India GST an invoice carries CGST and SGST inside the
      organization's state, IGST outside it, and no GST without a supplier
      GSTIN; under a single-rate tax (Australia GST 10%, UK VAT) each taxed line
      carries that tax (singleTaxMinor), and none without the supplier's
      registration number. Each document keeps the tax it was issued under
      (tax.model).
  - name: Reports
    description: >-
      Custom reports shared with everyone in the organization, and their
      figures. Built in the app under Reports → Custom reports; a key reads them
      over every lead.
paths:
  /api/public/customer-quotes:
    post:
      tags:
        - Customer quote access
      summary: Accept or decline a published customer quote
      description: >-
        Bearer-authenticated digital acceptance, not certified e-signing.
        Explicit confirmation, current revision/fingerprint and one persistent
        UUID idempotency key are required. Exact retries return saved evidence;
        another key or decision cannot overwrite it. Expired, archived,
        cancelled or stale new decisions fail. JSON stream is limited to 4096
        bytes. No payment or provider request is made.
      operationId: decide-published-customer-quote
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                organizationId:
                  type: integer
                  exclusiveMinimum: 0
                  maximum: 9007199254740991
                quoteId:
                  type: string
                  format: uuid
                  pattern: >-
                    ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                revision:
                  type: integer
                  exclusiveMinimum: 0
                  maximum: 9007199254740991
                fingerprint:
                  type: string
                  pattern: ^[a-f0-9]{64}$
                idempotencyKey:
                  type: string
                  format: uuid
                  pattern: >-
                    ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                decision:
                  type: string
                  enum:
                    - accepted
                    - declined
                confirmed:
                  type: boolean
                  const: true
              required:
                - organizationId
                - quoteId
                - revision
                - fingerprint
                - idempotencyKey
                - decision
                - confirmed
              additionalProperties: false
      responses:
        '200':
          description: Decision saved or exact retry replayed
          content:
            application/json:
              schema:
                type: object
                properties:
                  decision:
                    type: string
                    enum:
                      - accepted
                      - declined
                  revision:
                    type: integer
                    minimum: -9007199254740991
                    maximum: 9007199254740991
                  fingerprint:
                    type: string
                  decidedAt:
                    type: string
                  replayed:
                    type: boolean
                required:
                  - decision
                  - revision
                  - fingerprint
                  - decidedAt
                  - replayed
                additionalProperties: false
        '409':
          description: Decision unavailable or changed
        '413':
          description: JSON body exceeds 4096 bytes
        '415':
          description: JSON content type required
      security:
        - CustomerQuoteBearer: []
components:
  securitySchemes:
    CustomerQuoteBearer:
      type: http
      scheme: bearer
      description: >-
        One private customer quote bearer token. Not a staff JWT or organization
        API key. Never log it or put it in a URL query/path.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.