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

# Update the facts sheet

> Update the facts sheet. A key that is present replaces its section; a key that is absent is kept.

<Info>A key that is present in the body replaces that section of the sheet in full. A key that is absent is left as it was. So `{ "codes": [...] }` rewrites the codes and touches nothing else, and to clear a section you send it empty (`"codes": []` or `"delivery_promise": null`). Keys outside the sheet's field list are ignored.</Info>

Values outside the shape are dropped, not rejected; read the sheet back after writing. See [The facts sheet](/api/facts-sheet).


## OpenAPI

````yaml openapi.json PATCH /sdk/{id}/facts
openapi: 3.1.0
info:
  title: NextIntent API
  version: 1.0.0
  description: >-
    Websites, switches, the facts sheet and API keys, per account. Authenticate
    with an API key (ni_live_...) or a console session as a Bearer token. A key
    is account-wide or bound to one website; a bound key sees only that website
    and cannot create or delete websites.
servers:
  - url: https://api.nextintent.ai/v1
security:
  - bearer: []
paths:
  /sdk/{id}/facts:
    patch:
      summary: >-
        Update the facts sheet: a key that is present replaces its section, a
        key that is absent is kept
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
          description: The website id
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Facts'
      responses:
        '200':
          description: Facts
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Facts'
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Facts:
      type: object
      properties:
        currency:
          type: string
        free_shipping_threshold:
          type: number
          nullable: true
        shipping_flat:
          type: number
          nullable: true
        shipping_zones:
          type: array
          items:
            type: object
            properties:
              countries:
                type: array
                items:
                  type: string
              rest_of_world:
                type: boolean
              free_shipping_threshold:
                type: number
                nullable: true
              shipping_flat:
                type: number
                nullable: true
        return_days:
          type: number
          nullable: true
        delivery_promise:
          type: string
          nullable: true
        size_notes:
          type: array
          items:
            type: object
            properties:
              handle:
                type: string
              text:
                type: string
              url:
                type: string
        links:
          type: object
        codes:
          type: array
          items:
            type: object
            properties:
              label:
                type: string
              percent:
                type: number
              starts_at:
                type: string
                format: date-time
              expires_at:
                type: string
                format: date-time
              first_order_only:
                type: boolean
        discounts_allowed:
          type: boolean
        output:
          type: string
          enum:
            - card
            - popup
            - event
            - none
        popup:
          type: object
          nullable: true
    Error:
      type: object
      properties:
        error:
          type: string
  securitySchemes:
    bearer:
      type: http
      scheme: bearer

````