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

# List Site Health issues

> List a website's Site Health issues: one group per kind of problem (check) with its title, why it matters, severity (critical, warning, opportunity), priority (high, medium, low), owner (writer, developer or either; null when unknown), effort (minutes, hours, days), whether it is site-wide, counts of affected pages by status (open, in_progress, fixed, verified, dismissed), up to three sections it concentrates in, and sample affected pages with each page's detail, recommendation, evidence, assignee and task_revision. Filter by status, check, a search term, the stored URLs of specific pages (page_urls), or assignee "me" (signed-in connections only). Groups are paged: page is 0-based, page_size defaults to 25 (max 200) and total counts the groups that match; counts totals pages by status across the whole site, ignoring the status filter. A group carries at most 50 sample pages (10 when a tool calls it, which also caps page_size at 25); has_more_pages says to read the rest with the issue pages read (get_site_health_issue_pages or POST /v1/seo/issues/pages), whose page 0 repeats the sample pages. has_evidence false means the site has never been crawled or audited. Requires Site Health on the website's plan; otherwise the call fails with 403.



## OpenAPI

````yaml /api-reference/openapi.json post /api/v1/seo/issues
openapi: 3.1.0
info:
  title: AthenaHQ API
  description: >-
    AthenaHQ API provides programmatic access to manage your websites and
    prompts for AI-powered content optimization.
  version: 1.0.0
  contact:
    email: support@athenahq.ai
servers:
  - url: https://api.athenahq.ai
    description: Production server
security:
  - apiKey: []
tags:
  - name: Basics
    description: Core API operations for managing websites and prompts
  - name: Metrics
    description: Metrics and analytics endpoints for tracking AI visibility
  - name: Billing
    description: Billing and credits endpoints for managing usage
  - name: Team Management
    description: Endpoints for managing team members and invitations
  - name: Groups
    description: Endpoints for managing groups of websites
  - name: Content
    description: >-
      Endpoints for accessing Content Hub data — tabs, tracked URLs, and per-URL
      prompt breakdowns.
  - name: Pitch Workspace
    description: >-
      Endpoints for accessing pitch workspace reports — org-scoped pitch runs
      with competitors, prompts, attributes, and aggregate metrics.
  - name: Knowledge Base
    description: >-
      Endpoints for reading the brand Knowledge Base — approved brand facts and
      the pillars that organize them.
paths:
  /api/v1/seo/issues:
    post:
      tags:
        - Site Health
      summary: List Site Health issues
      description: >-
        List a website's Site Health issues: one group per kind of problem
        (check) with its title, why it matters, severity (critical, warning,
        opportunity), priority (high, medium, low), owner (writer, developer or
        either; null when unknown), effort (minutes, hours, days), whether it is
        site-wide, counts of affected pages by status (open, in_progress, fixed,
        verified, dismissed), up to three sections it concentrates in, and
        sample affected pages with each page's detail, recommendation, evidence,
        assignee and task_revision. Filter by status, check, a search term, the
        stored URLs of specific pages (page_urls), or assignee "me" (signed-in
        connections only). Groups are paged: page is 0-based, page_size defaults
        to 25 (max 200) and total counts the groups that match; counts totals
        pages by status across the whole site, ignoring the status filter. A
        group carries at most 50 sample pages (10 when a tool calls it, which
        also caps page_size at 25); has_more_pages says to read the rest with
        the issue pages read (get_site_health_issue_pages or POST
        /v1/seo/issues/pages), whose page 0 repeats the sample pages.
        has_evidence false means the site has never been crawled or audited.
        Requires Site Health on the website's plan; otherwise the call fails
        with 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: Success
          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: 'Bad Request: validation failed'
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '401':
          description: Unauthenticated
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '429':
          description: 'Rate limited: honor Retry-After before retrying'
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
          headers:
            Retry-After:
              description: Seconds to wait before retrying
              schema:
                type: integer
                minimum: 1
        '500':
          description: Internal Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        API key for authentication. You can create one
        [here](https://app.athenahq.ai/organization?tab=api).

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.