> ## Documentation Index
> Fetch the complete documentation index at: https://adminroletesting-justin-client-exports.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Récupérer les conversations de l'Assistant

> Renvoie l’historique de conversation paginé de l’Assistant IA

<div id="usage">
  ## Utilisation
</div>

Utilisez cet endpoint pour exporter l’historique des conversations de l’Assistant IA à partir de votre documentation. Chaque conversation inclut la requête de l’utilisateur, la réponse de l’Assistant IA, les sources citées, le statut de résolution et la catégorie de la requête.

Parcourez les résultats à l’aide du paramètre `cursor` renvoyé dans la réponse. Continuez à récupérer les données tant que `hasMore` vaut `true`.

<div id="filtering">
  ## Filtrage
</div>

Filtrez les conversations par plage de dates à l'aide des paramètres `dateFrom` et `dateTo`.

<div id="conversation-data">
  ## Données de conversation
</div>

Chaque conversation comprend :

* **query** : la question de l’utilisateur
* **response** : la réponse de l’Assistant
* **sources** : les pages référencées dans la réponse, avec leur title et leur URL
* **resolutionStatus** : indique si l’Assistant a répondu correctement à la question. La valeur est `answered` ou `unanswered`. Utilisez ce champ pour suivre et analyser les lacunes de la documentation mises en évidence par les questions des utilisateurs auxquelles l’Assistant n’a pas pu répondre.
* **queryCategory** : la classification du type de requête (si disponible)
* **pageUrl** : URL complète de la page de documentation où la conversation a démarré, ou `null` si aucun chemin de page n'est disponible. Utilisez ce champ pour attribuer les conversations à une page spécifique.


## OpenAPI

````yaml fr/analytics.openapi.json GET /v1/analytics/{projectId}/assistant
openapi: 3.1.0
info:
  title: Mintlify Analytics Export API
  version: 1.0.0
  description: API d’exportation des données Analytics de la documentation
servers:
  - url: https://api.mintlify.com
    description: Production
security: []
paths:
  /v1/analytics/{projectId}/assistant:
    get:
      tags:
        - Analytics
      summary: Récupérer les conversations de l’Assistant
      description: Renvoie l’historique de conversation paginé de l’Assistant IA
      parameters:
        - $ref: '#/components/parameters/projectId'
        - schema:
            type: string
            description: Date au format ISO 8601 ou AAAA-MM-JJ
            example: '2024-01-01'
          required: false
          name: dateFrom
          in: query
        - schema:
            type: string
            description: >-
              Date au format ISO 8601 ou AAAA-MM-JJ. `dateTo` est une borne
              supérieure exclusive. Les résultats incluent les dates
              antérieures, mais pas la date spécifiée.
            example: '2024-01-01'
          required: false
          name: dateTo
          in: query
        - schema:
            type: number
            minimum: 1
            maximum: 1000
            default: 100
            description: Nombre maximal de résultats par page
          required: false
          name: limit
          in: query
        - schema:
            type: string
            format: ulid
            description: Curseur de pagination (format ULID)
          required: false
          name: cursor
          in: query
      responses:
        '200':
          description: Données de conversation paginées
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AssistantConversationsResponse'
        '400':
          description: Paramètres de requête invalides
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AnalyticsErrorResponse'
        '500':
          description: Erreur serveur
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AnalyticsErrorResponse'
      security:
        - bearerAuth: []
components:
  parameters:
    projectId:
      schema:
        $ref: '#/components/schemas/projectId'
      required: true
      name: projectId
      in: path
  schemas:
    AssistantConversationsResponse:
      type: object
      properties:
        conversations:
          type: array
          description: Liste des conversations de l’Assistant.
          items:
            type: object
            properties:
              id:
                type: string
                description: Identifiant unique de la conversation.
              timestamp:
                type: string
                description: Horodatage de la conversation.
              query:
                type: string
                description: La question de l’utilisateur adressée à l’Assistant.
              response:
                type: string
                description: La réponse générée par l’Assistant.
              sources:
                type: array
                description: Pages de documentation référencées dans la réponse.
                items:
                  type: object
                  properties:
                    title:
                      type: string
                      description: Titre de la page de documentation référencée.
                    url:
                      type: string
                      description: URL de la page de documentation référencée.
                  required:
                    - title
                    - url
              queryCategory:
                type:
                  - string
                  - 'null'
                description: >-
                  Catégorie de regroupement automatiquement attribuée à la
                  conversation, le cas échéant.
              pageUrl:
                type:
                  - string
                  - 'null'
                description: >-
                  URL complète de la page de documentation où la conversation a
                  démarré. Null si aucun chemin de page n'a été capturé.
            required:
              - id
              - timestamp
              - query
              - response
              - sources
              - queryCategory
              - pageUrl
        nextCursor:
          type:
            - string
            - 'null'
          description: >-
            Curseur de pagination permettant de récupérer la page de résultats
            suivante. Null s’il n’y a plus de résultats.
        hasMore:
          type: boolean
          description: >-
            Indique si des résultats supplémentaires sont disponibles au‑delà de
            cette page.
      required:
        - conversations
        - nextCursor
        - hasMore
    AnalyticsErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Message d’erreur décrivant ce qui s’est mal passé.
        details:
          type: array
          description: Détails supplémentaires sur l’erreur.
          items:
            type: object
            properties:
              message:
                type: string
                description: >-
                  Description d’une erreur spécifique de validation ou de
                  traitement.
            required:
              - message
      required:
        - error
    projectId:
      type: string
      description: >-
        ID de votre projet. Vous pouvez le copier depuis la page [API
        keys](https://dashboard.mintlify.com/settings/organization/api-keys) de
        votre Dashboard.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        L’en-tête Authorization requiert un jeton Bearer. Utilisez une clé d’API
        administrateur (préfixée par `mint_`). Il s’agit d’une clé secrète côté
        serveur. Générez-en une depuis la [page API
        keys](https://dashboard.mintlify.com/settings/organization/api-keys)
        dans votre Dashboard.

````