> ## Documentation Index > Fetch the complete documentation index at: https://docs.athenahq.ai/llms.txt > Use this file to discover all available pages before exploring further. # Modifier un fait de marque > Modifie texte, source ou confiance d’un fait, uniquement les champs fournis. source_url: "" efface la source. Changer le texte crée un fait avec nouvel ID et archive l’actuel ; le nouveau conserve le statut et est renvoyé. Source/confiance modifient sur place et rapprochent à nouveau la source des liens internes. Le statut de révision ne change jamais ici. Clé administrateur requise. Disponible aussi comme MCP `update_brand_fact`. ## OpenAPI ````yaml fr/api-reference/openapi.json patch /api/v1/knowledge-base/facts/{fact_id} openapi: 3.1.0 info: title: API AthenaHQ description: >- L’API AthenaHQ permet de gérer vos sites et prompts par programme pour l’optimisation de contenu par IA. version: 1.0.0 contact: email: support@athenahq.ai servers: - url: https://api.athenahq.ai description: Serveur de production security: - apiKey: [] tags: - name: Basics description: Opérations API principales pour gérer sites et prompts - name: Metrics description: Points de terminaison de métriques et analyses de visibilité IA - name: Billing description: Points de facturation et crédits pour gérer la consommation - name: Team Management description: Points de terminaison de gestion des membres et invitations - name: Groups description: Points de terminaison de gestion des groupes de sites - name: Content description: >- Points de terminaison Content Hub : onglets, URL suivies et détail des prompts par URL. - name: Pitch Workspace description: >- Points de terminaison des rapports Pitch Workspace : exécutions à l’échelle de l’organisation avec concurrents, prompts, attributs et métriques agrégées. - name: Knowledge Base description: >- Endpoints de lecture de la base de connaissances de la marque — faits approuvés et piliers qui les organisent. paths: /api/v1/knowledge-base/facts/{fact_id}: patch: tags: - Knowledge Base summary: Modifier un fait de marque description: >- Modifie texte, source ou confiance d’un fait, uniquement les champs fournis. source_url: "" efface la source. Changer le texte crée un fait avec nouvel ID et archive l’actuel ; le nouveau conserve le statut et est renvoyé. Source/confiance modifient sur place et rapprochent à nouveau la source des liens internes. Le statut de révision ne change jamais ici. Clé administrateur requise. Disponible aussi comme MCP `update_brand_fact`. operationId: updateBrandFact parameters: - name: fact_id in: path required: true schema: type: string format: uuid description: Fait à mettre à jour. requestBody: required: true content: application/json: schema: type: object properties: website_id: type: string format: uuid description: Site web auquel appartient le fait. text: type: string minLength: 1 maxLength: 10000 description: >- Nouvel énoncé du fait. Limité à 10 000 caractères, comme la fenêtre de modification de l’application (add_brand_facts limite les nouveaux faits à 2 000 caractères). source_url: type: string maxLength: 2048 description: >- Nouvelle URL source. Une chaîne vide efface l’URL enregistrée. confidence: type: string enum: - high - medium - low description: Nouveau niveau de confiance. required: - website_id responses: '200': description: Fait mis à jour et instantané antérieur des champs modifiables content: application/json: schema: type: object properties: fact: $ref: '#/components/schemas/BrandFact' before: type: object description: Valeurs des champs modifiables avant cette mise à jour. properties: text: type: string source_url: type: - string - 'null' confidence: type: - string - 'null' enum: - high - medium - low - null required: - text - source_url - confidence required: - fact - before '400': description: Requête incorrecte — paramètres invalides content: application/json: schema: $ref: '#/components/schemas/Error' examples: missing_website_id: value: error: website_id is required blank_text: value: error: text must not be blank unsafe_source_url: value: error: source_url is not a valid URL '401': description: Non autorisé — clé API invalide ou absente content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: >- Interdit — aucun accès administrateur au site ou base non activée pour l’organisation content: application/json: schema: $ref: '#/components/schemas/Error' examples: unauthorized_website: value: error: Unauthorized access to this website kb_not_enabled: value: error: Knowledge Base is not enabled for this organization '404': description: Introuvable - Aucun fait avec cet ID sur le site web content: application/json: schema: $ref: '#/components/schemas/Error' examples: fact_not_found: value: error: Fact not found '409': description: >- Conflit — fait non remplaçable : issu d’une réponse IA, doublon masqué, rejeté ou déjà archivé par une autre modification ; récupérez-le à nouveau et réessayez sur le fait actif. Modifier le texte d’un fait déjà remplacé renvoie 404, car il est archivé. content: application/json: schema: $ref: '#/components/schemas/Error' examples: identical_fact: value: error: An identical fact already exists security: - apiKey: [] components: schemas: BrandFact: type: object properties: id: type: string format: uuid text: type: string description: Énoncé du fait. status: type: string enum: - approved - pending - rejected description: Statut de révision du fait. confidence: type: - string - 'null' enum: - high - medium - low - null description: Niveau de confiance attribué à l’ingestion, ou null si non évalué. source_url: type: - string - 'null' description: URL d’extraction du fait, enregistrée sans protocole. source_quote: type: - string - 'null' description: Citation textuelle de la source qui étaye le fait. source_type: type: string enum: - research - response - upload - content_hub description: Mode d’entrée du fait dans la base de connaissances. pillar: $ref: '#/components/schemas/BrandFactPillar' created_at: type: string description: Horodatage ISO 8601 d’ajout du fait. required: - id - text - status - confidence - source_url - source_quote - source_type - pillar - created_at Error: type: object description: Objet de réponse d’erreur required: - error properties: error: type: string description: Message expliquant l’erreur example: Unauthorized BrandFactPillar: type: - object - 'null' description: Pilier publié du fait, ou null s’il n’est pas classé. properties: id: type: string format: uuid name: type: string required: - id - name securitySchemes: apiKey: type: apiKey in: header name: x-api-key description: >- Clé API d’authentification. Créez-en une [ici](https://app.athenahq.ai/organization?tab=api). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.