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

# Correct a learned fact

> Corrects a learned fact's claim text and/or category. Any member of the owning teammate's team may edit. A new claim must stay anonymized — no person or customer names, no contract-level details — or the call answers 422 `LEARNED_FACT_NOT_ANONYMIZED`. The correction reaches the hubs' pages on the next daily learning run. The response carries only the fields this call changes; read the fact back from `GET /business/knowledge-hubs/learned-facts` for its confidence, channels and dates. Retired facts cannot be edited (404).

Errors:
- `404` `LEARNED_FACT_NOT_FOUND` — No active fact with that id, it was already retired, or it belongs to another team (existence is never confirmed).
- `422` `LEARNED_FACT_NOT_ANONYMIZED` — The new claim names a person or customer, or carries a contract-level detail.
- `422` `VALIDATION_FAILED` — Neither claim nor category given, or a value outside its limits or enum.
- `429` `RATE_LIMITED` — More than 30 knowledge-hub/campaign requests in a minute (or 1000 in a day). Knowledge hubs share the campaigns bucket.

Requires one of the following token scopes: campaigns.



## OpenAPI

````yaml /openapi.json patch /business/knowledge-hubs/learned-facts/{factId}
openapi: 3.1.0
info:
  title: Fuse Business API
  version: 1.0.0
  description: >-
    External API for lists, campaigns, prospect search and contacts.
    Authenticate with your API token as HTTP Basic. All paths are under /api/v1.
servers:
  - url: https://api.tryfuse.ai/api/v1
    description: Production
security:
  - basicAuth: []
tags:
  - name: Lists
  - name: Custom columns
  - name: Smart columns
  - name: Exports
  - name: Campaigns
  - name: Knowledge hubs
  - name: Analytics
  - name: Website intent
  - name: Account
  - name: Prospect search
  - name: Campaign steps
  - name: Scheduled sends
  - name: Campaign templates
  - name: Agents
  - name: Research
  - name: Company search
  - name: Saved searches
  - name: Folders
  - name: Contacts
paths:
  /business/knowledge-hubs/learned-facts/{factId}:
    patch:
      tags:
        - Knowledge hubs
      summary: Correct a learned fact
      description: >-
        Corrects a learned fact's claim text and/or category. Any member of the
        owning teammate's team may edit. A new claim must stay anonymized — no
        person or customer names, no contract-level details — or the call
        answers 422 `LEARNED_FACT_NOT_ANONYMIZED`. The correction reaches the
        hubs' pages on the next daily learning run. The response carries only
        the fields this call changes; read the fact back from `GET
        /business/knowledge-hubs/learned-facts` for its confidence, channels and
        dates. Retired facts cannot be edited (404).


        Errors:

        - `404` `LEARNED_FACT_NOT_FOUND` — No active fact with that id, it was
        already retired, or it belongs to another team (existence is never
        confirmed).

        - `422` `LEARNED_FACT_NOT_ANONYMIZED` — The new claim names a person or
        customer, or carries a contract-level detail.

        - `422` `VALIDATION_FAILED` — Neither claim nor category given, or a
        value outside its limits or enum.

        - `429` `RATE_LIMITED` — More than 30 knowledge-hub/campaign requests in
        a minute (or 1000 in a day). Knowledge hubs share the campaigns bucket.


        Requires one of the following token scopes: campaigns.
      operationId: updateLearnedFact
      parameters:
        - name: factId
          in: path
          required: true
          description: >-
            24-character hex id of the learned fact (from GET
            /business/knowledge-hubs/learned-facts).
          schema:
            type: string
            description: >-
              24-character hex id of the learned fact (from GET
              /business/knowledge-hubs/learned-facts).
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                claim:
                  type: string
                  minLength: 1
                  maxLength: 1000
                  description: >-
                    Corrected claim text (1-1000 characters). Free text — there
                    is no vocabulary — but it must stay anonymized: a
                    deterministic gate answers 422 LEARNED_FACT_NOT_ANONYMIZED
                    when the claim contains an email address, a run of 9 or more
                    phone-like digits, a currency amount in the same claim as
                    deal language (discount, quote, contract, renewal, proposal,
                    negotiated, agreed), or contract vocabulary (renewal date,
                    contract term, termination clause, auto-renew, payment
                    terms, net 30/60/90, master service agreement, MSA, SOW,
                    non-disclosure, NDA). Person and customer names are NOT
                    checked, so keep them out yourself. The edit reaches the
                    hub's pages on the next daily learning run, not immediately.
                category:
                  type: string
                  enum:
                    - overview
                    - products
                    - pricing
                    - icp-use-cases
                    - differentiators
                    - competitors
                    - faq
                    - source-digest
                    - custom
                    - objection
                    - faq-insight
                  description: >-
                    Fact category, one of overview (company summary), products,
                    pricing, icp-use-cases (ideal customers and use cases),
                    differentiators, competitors, faq, source-digest (digest of
                    one source), custom (user-authored), objection (a buyer
                    objection) or faq-insight (a recurring question).
              description: At least one of claim or category is required.
      responses:
        '200':
          description: Success
          headers:
            RateLimit-Limit:
              schema:
                type: integer
              description: Requests permitted in the current window.
            RateLimit-Remaining:
              schema:
                type: integer
              description: Requests remaining in the current window.
            RateLimit-Reset:
              schema:
                type: integer
              description: Seconds until the current window resets.
          content:
            application/json:
              schema:
                type: object
                required:
                  - fact
                properties:
                  fact:
                    type: object
                    required:
                      - id
                      - claim
                      - category
                    description: >-
                      The fields the update reports. Read the fact back from the
                      list endpoint for the rest.
                    properties:
                      id:
                        type: string
                      claim:
                        type:
                          - string
                          - 'null'
                        description: The claim as stored after this call.
                      category:
                        type:
                          - string
                          - 'null'
                        enum:
                          - overview
                          - products
                          - pricing
                          - icp-use-cases
                          - differentiators
                          - competitors
                          - faq
                          - source-digest
                          - custom
                          - objection
                          - faq-insight
                          - null
              example:
                fact:
                  id: 68a1fb0a9c41d20014b3f201
                  claim: >-
                    A SOC 2 Type II report is available on request before a
                    trial.
                  category: faq-insight
        '400':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '402':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '409':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - basicAuth: []
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
            param:
              type:
                - string
                - 'null'
            doc_url:
              type:
                - string
                - 'null'
            request_id:
              type:
                - string
                - 'null'
          required:
            - code
            - message
      required:
        - error
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: >-
        Your API token (`af_…`) as the Basic-auth username, with an empty
        password.

````