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

# Obtenir les vues enregistrées du groupe

> Renvoie toutes les vues enregistrées du groupe (préréglages de filtres) pour les sites web du groupe. Ces vues conservent un état de filtre partagé dans le groupe plutôt que limité à un seul site web.



## OpenAPI

````yaml fr/api-reference/openapi.json get /api/v1/group-saved-views
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/group-saved-views:
    get:
      tags:
        - Basics
      summary: Obtenir les vues enregistrées du groupe
      description: >-
        Renvoie toutes les vues enregistrées du groupe (préréglages de filtres)
        pour les sites web du groupe. Ces vues conservent un état de filtre
        partagé dans le groupe plutôt que limité à un seul site web.
      operationId: getGroupSavedViews
      parameters:
        - name: group_id
          in: query
          description: >-
            ID du groupe dont récupérer les vues. L’autorisation utilise son
            organisation.
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Réponse réussie avec les vues du groupe
          content:
            application/json:
              schema:
                type: object
                properties:
                  group_saved_views:
                    type: array
                    items:
                      $ref: '#/components/schemas/GroupSavedView'
                required:
                  - group_saved_views
        '400':
          description: Requête incorrecte — paramètres invalides
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Non autorisé — clé API invalide ou absente
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Interdit — vous n’avez pas accès à ce site
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Erreur interne du serveur
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - apiKey: []
components:
  schemas:
    GroupSavedView:
      type: object
      description: Vue enregistrée de groupe, partagée entre ses sites
      required:
        - id
        - name
        - icon
        - website_id
        - group_id
        - user_id
        - filters
        - created_at
        - created_by
      properties:
        id:
          type: string
          description: Identifiant unique de la vue de groupe
        name:
          type: string
          description: Nom d’affichage de la vue enregistrée
        icon:
          type: string
          description: Identifiant d’icône, RiBarChartLine par défaut
        website_id:
          type: string
          format: uuid
          description: Site depuis lequel cette vue enregistrée a été créée
        group_id:
          type: string
          format: uuid
          nullable: true
          description: Groupe de la vue enregistrée
        user_id:
          type: string
          nullable: true
          description: Utilisateur qui a créé la vue enregistrée
        filters:
          type: object
          description: >-
            Charge utile de préréglage de filtres du groupe (modèles, type et
            statut de prompt, variante, ID de sites web, ID de prompts de
            groupe, emplacements, personas, tags de prompts, identifiants
            cibles).
          additionalProperties: true
        created_at:
          type: string
          format: date-time
          description: Horodatage de création de la vue de groupe (UTC)
        updated_at:
          type: string
          format: date-time
          description: >-
            Horodatage de dernière mise à jour de la vue enregistrée du groupe
            (UTC). Facultatif.
        created_by:
          type: object
          nullable: true
          description: Utilisateur qui a créé la vue enregistrée
          required:
            - id
            - email
            - first_name
            - last_name
            - display_name
          properties:
            id:
              type: string
            email:
              type: string
              format: email
            first_name:
              type: string
              nullable: true
            last_name:
              type: string
              nullable: true
            display_name:
              type: string
    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.