spectaql.yml

spectaql:
  #  logoFile: ./test/fixtures/logo.png
  #  faviconFile: ./test/fixtures/favicon.png
  displayAllServers: true
  targetDir: ./storage/app/api-docs
  oneFile: true
  themeDir: spectaql

introspection:
  removeTrailingPeriodFromDescriptions: false
  schemaFile: ./storage/app/public/lighthouse-schema.graphql
  #  metadataFile: ./examples/data/metadata.json
  #  dynamicExamplesProcessingModule: ./examples/customizations/examples
  queryNameStrategy: capitalizeFirst
  fieldExpansionDepth: 2

  spectaqlDirective:
    enable: true

extensions:
  graphqlScalarExamples: true

info:
  title: Aiding App API Reference
  description: Documentation for the Aiding App API
  termsOfService: https://www.example.com/terms
  contact:
    name: API Support
    url: http://www.example.com/support
    email: support@example.com
  license:
    name: Elastic License 2.0
    url: https://www.elastic.co/licensing/elastic-license
  x-introItems:
    - title: Authorization
      description: Add additional details for authentication. Supports `markdown`, more sections can be added.
    - title: Querying the same field for different union types
      description: |
        When querying a field that returns a union type, you may get back an error "conflict because they return conflicting types". For example, if you query for interactable on a union type of `Student | Contact` and request `full_name` you may get back this error.

        This is due to the fields having different type definitions. In order to get around this you will need to define an alias for the field you are querying.

        For example, you can query for `student_full_name: full_name` and `contact_full_name: full_name` to get back the data you are looking for.

servers:
  - url: ${APP_URL}/graphql
    description: This server
    production: true
    headers:
      - name: Authorization
        example: Bearer <YOUR_TOKEN_HERE>
        comment: The API token generated for a System User within the dashboard.