> ## 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.

# Déplacer des faits de marque

> Classe de 1 à 50 faits de marque dans un pilier publié de la base de connaissances. Fonctionne pour les faits non classés et reclasse ceux d’autres piliers. Le statut de vérification ne change jamais et seuls les faits approuvés d’un pilier publié alimentent la génération ; le déplacement met donc les faits approuvés au travail. Les ID sans fait sur le site web sont signalés dans not_found_ids sans faire échouer l’appel ; les nouvelles tentatives sont ainsi idempotentes. Nécessite une clé API d’administrateur de site web. Également disponible comme outil MCP `move_brand_facts`.



## OpenAPI

````yaml fr/api-reference/openapi.json post /api/v1/knowledge-base/facts/move
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/move:
    post:
      tags:
        - Knowledge Base
      summary: Déplacer des faits de marque
      description: >-
        Classe de 1 à 50 faits de marque dans un pilier publié de la base de
        connaissances. Fonctionne pour les faits non classés et reclasse ceux
        d’autres piliers. Le statut de vérification ne change jamais et seuls
        les faits approuvés d’un pilier publié alimentent la génération ; le
        déplacement met donc les faits approuvés au travail. Les ID sans fait
        sur le site web sont signalés dans not_found_ids sans faire échouer
        l’appel ; les nouvelles tentatives sont ainsi idempotentes. Nécessite
        une clé API d’administrateur de site web. Également disponible comme
        outil MCP `move_brand_facts`.
      operationId: moveBrandFacts
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                website_id:
                  type: string
                  format: uuid
                  description: Site web dont déplacer les faits.
                pillar_id:
                  type: string
                  format: uuid
                  description: Pilier publié où classer les faits.
                fact_ids:
                  type: array
                  minItems: 1
                  maxItems: 50
                  items:
                    type: string
                    format: uuid
                  description: >-
                    Faits à déplacer. Un déplacement unique est un tableau d’un
                    élément.
              required:
                - website_id
                - pillar_id
                - fact_ids
      responses:
        '200':
          description: Rapport de déplacement
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - true
                  moved_count:
                    type: integer
                    description: Faits effectivement reclassés dans le pilier.
                  unchanged_ids:
                    type: array
                    items:
                      type: string
                    description: >-
                      Faits demandés non déplacés : déjà sur la cible ou absents
                      au moment de l’exécution du déplacement.
                  not_found_ids:
                    type: array
                    items:
                      type: string
                    description: >-
                      ID demandés sans fait sur ce site web : déjà supprimés ou
                      n’ayant jamais existé.
                  pillar:
                    type: object
                    description: Pilier cible dans lequel les faits ont été classés.
                    properties:
                      id:
                        type: string
                      name:
                        type: string
                    required:
                      - id
                      - name
                required:
                  - success
                  - moved_count
                  - unchanged_ids
                  - not_found_ids
                  - pillar
        '400':
          description: Requête incorrecte — paramètres invalides ou pilier cible non publié
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                empty_fact_ids:
                  value:
                    error: 'factIds: fact_ids must contain at least one id'
                too_many_fact_ids:
                  value:
                    error: 'factIds: fact_ids must contain at most 50 ids'
                unpublished_pillar:
                  value:
                    error: facts can only be moved to a published pillar
        '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 pilier de cet ID sur le site
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                pillar_not_found:
                  value:
                    error: Pillar not found
      security:
        - apiKey: []
components:
  schemas:
    Error:
      type: object
      description: Objet de réponse d’erreur
      required:
        - error
      properties:
        error:
          type: string
          description: Message expliquant l’erreur
          example: Unauthorized
  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.