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

# Lister les problèmes d'État du site

> Liste les problèmes d'État du site d'un site web : un groupe par type de problème (check) avec son titre, pourquoi il compte, sa gravité (critical, warning, opportunity), sa priorité (high, medium, low), son responsable (writer, developer ou either ; null s'il est inconnu), l'effort (minutes, hours, days), s'il concerne tout le site, le nombre de pages touchées par statut (open, in_progress, fixed, verified, dismissed), jusqu'à trois sections où il se concentre, et des pages touchées en exemple avec, pour chacune, le détail, la recommandation, les preuves, la personne assignée et task_revision. Filtrez par statut, check, terme de recherche, URL stockées de pages précises (page_urls) ou assignee "me" (connexions avec session uniquement). Les groupes sont paginés : page commence à 0, page_size vaut 25 par défaut (200 au maximum) et total compte les groupes correspondants ; counts additionne les pages par statut sur tout le site, sans tenir compte du filtre de statut. Un groupe contient au plus 50 pages en exemple (10 lorsqu'un outil l'appelle, ce qui limite aussi page_size à 25) ; has_more_pages indique de lire le reste avec la lecture des pages du problème (get_site_health_issue_pages ou POST /v1/seo/issues/pages), dont la page 0 reprend les pages en exemple. has_evidence à false signifie que le site n'a jamais été exploré ni audité. Nécessite État du site dans l'offre du site web ; sinon l'appel échoue avec un code 403.



## OpenAPI

````yaml fr/api-reference/openapi.json post /api/v1/seo/issues
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/seo/issues:
    post:
      tags:
        - Site Health
      summary: Lister les problèmes d'État du site
      description: >-
        Liste les problèmes d'État du site d'un site web : un groupe par type de
        problème (check) avec son titre, pourquoi il compte, sa gravité
        (critical, warning, opportunity), sa priorité (high, medium, low), son
        responsable (writer, developer ou either ; null s'il est inconnu),
        l'effort (minutes, hours, days), s'il concerne tout le site, le nombre
        de pages touchées par statut (open, in_progress, fixed, verified,
        dismissed), jusqu'à trois sections où il se concentre, et des pages
        touchées en exemple avec, pour chacune, le détail, la recommandation,
        les preuves, la personne assignée et task_revision. Filtrez par statut,
        check, terme de recherche, URL stockées de pages précises (page_urls) ou
        assignee "me" (connexions avec session uniquement). Les groupes sont
        paginés : page commence à 0, page_size vaut 25 par défaut (200 au
        maximum) et total compte les groupes correspondants ; counts additionne
        les pages par statut sur tout le site, sans tenir compte du filtre de
        statut. Un groupe contient au plus 50 pages en exemple (10 lorsqu'un
        outil l'appelle, ce qui limite aussi page_size à 25) ; has_more_pages
        indique de lire le reste avec la lecture des pages du problème
        (get_site_health_issue_pages ou POST /v1/seo/issues/pages), dont la page
        0 reprend les pages en exemple. has_evidence à false signifie que le
        site n'a jamais été exploré ni audité. Nécessite État du site dans
        l'offre du site web ; sinon l'appel échoue avec un code 403.
      operationId: seoIssues.list
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                website_id:
                  type: string
                status:
                  type: string
                  enum:
                    - open
                    - in_progress
                    - fixed
                    - verified
                    - dismissed
                check:
                  type: string
                search:
                  type: string
                assignee:
                  enum:
                    - me
                  type: string
                page:
                  type: integer
                page_urls:
                  type: array
                  items:
                    type: string
                page_size:
                  type: integer
              required:
                - website_id
      responses:
        '200':
          description: Réussite
          content:
            application/json:
              schema:
                type: object
                properties:
                  groups:
                    type: array
                    items:
                      type: object
                      properties:
                        check:
                          type: string
                        title:
                          type: string
                        why_it_matters:
                          anyOf:
                            - type: string
                            - type: 'null'
                        owner:
                          anyOf:
                            - type: string
                              enum:
                                - writer
                                - developer
                                - either
                            - type: 'null'
                        effort:
                          anyOf:
                            - type: string
                              enum:
                                - minutes
                                - hours
                                - days
                            - type: 'null'
                        bucket:
                          type: string
                          enum:
                            - technical_cleanup
                            - content_restructuring
                            - content_enrichment
                        severity:
                          type: string
                          enum:
                            - critical
                            - warning
                            - opportunity
                        priority:
                          type: string
                          enum:
                            - high
                            - medium
                            - low
                        site_wide:
                          type: boolean
                        counts:
                          type: object
                          properties:
                            open:
                              type: integer
                            in_progress:
                              type: integer
                            fixed:
                              type: integer
                            verified:
                              type: integer
                            dismissed:
                              type: integer
                          required:
                            - open
                            - in_progress
                            - fixed
                            - verified
                        sections:
                          type: array
                          items:
                            type: object
                            properties:
                              section:
                                type: string
                              open:
                                type: integer
                              audited:
                                type: integer
                            required:
                              - section
                              - open
                              - audited
                        pages:
                          type: array
                          items:
                            type: object
                            properties:
                              finding_id:
                                type: string
                              page_id:
                                type: string
                              property_id:
                                type: string
                              url:
                                type: string
                              status:
                                type: string
                                enum:
                                  - open
                                  - in_progress
                                  - fixed
                                  - verified
                                  - dismissed
                              page_title:
                                anyOf:
                                  - type: string
                                  - type: 'null'
                              detail:
                                type: string
                              recommendation:
                                anyOf:
                                  - type: string
                                  - type: 'null'
                              shared_value:
                                anyOf:
                                  - type: string
                                  - type: 'null'
                              evidence:
                                type: array
                                items:
                                  type: string
                              evidence_links:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    label:
                                      type: string
                                    url:
                                      type: string
                                  required:
                                    - label
                                    - url
                              robots_txt_rule:
                                anyOf:
                                  - type: object
                                    properties:
                                      url:
                                        type: string
                                      line:
                                        type: integer
                                      excerpt:
                                        type: array
                                        items:
                                          type: object
                                          properties:
                                            line:
                                              type: integer
                                            text:
                                              type: string
                                          required:
                                            - line
                                            - text
                                    required:
                                      - url
                                      - line
                                      - excerpt
                                  - type: 'null'
                              first_seen_at:
                                type: string
                              last_seen_at:
                                type: string
                              resolved_at:
                                anyOf:
                                  - type: string
                                  - type: 'null'
                              last_checked_at:
                                anyOf:
                                  - type: string
                                  - type: 'null'
                              assignee:
                                anyOf:
                                  - type: object
                                    properties:
                                      id:
                                        type: string
                                      name:
                                        type: string
                                    required:
                                      - id
                                      - name
                                  - type: 'null'
                              task_revision:
                                type: integer
                              draft:
                                anyOf:
                                  - type: object
                                    properties:
                                      run_id:
                                        type: string
                                      status:
                                        type: string
                                    required:
                                      - run_id
                                      - status
                                  - type: 'null'
                            required:
                              - finding_id
                              - page_id
                              - property_id
                              - url
                              - status
                              - page_title
                              - detail
                              - recommendation
                              - shared_value
                              - evidence
                              - evidence_links
                              - robots_txt_rule
                              - first_seen_at
                              - last_seen_at
                              - resolved_at
                              - last_checked_at
                              - assignee
                              - task_revision
                              - draft
                        has_more_pages:
                          type: boolean
                      required:
                        - check
                        - title
                        - why_it_matters
                        - owner
                        - effort
                        - bucket
                        - severity
                        - priority
                        - site_wide
                        - counts
                        - sections
                        - pages
                        - has_more_pages
                  total:
                    type: integer
                  counts:
                    type: object
                    properties:
                      open:
                        type: integer
                      in_progress:
                        type: integer
                      fixed:
                        type: integer
                      verified:
                        type: integer
                      dismissed:
                        type: integer
                    required:
                      - open
                      - in_progress
                      - fixed
                      - verified
                  page_size:
                    type: integer
                  has_evidence:
                    type: boolean
                required:
                  - groups
                  - total
                  - counts
                  - page_size
                  - has_evidence
        '400':
          description: 'Requête incorrecte : échec de la validation'
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '401':
          description: Non authentifié
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '403':
          description: Interdit
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '404':
          description: Introuvable
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '409':
          description: Conflit
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '429':
          description: 'Limite atteinte : respectez Retry-After avant de réessayer'
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
          headers:
            Retry-After:
              description: Secondes à attendre avant de réessayer
              schema:
                type: integer
                minimum: 1
        '500':
          description: Erreur interne
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
components:
  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.