> ## Documentation Index
> Fetch the complete documentation index at: https://developers.getfernand.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List links

Returns all navigation links configured for the specified position (HEADER or FOOTER) in the knowledge base. Links are returned in sort order. These links appear in the knowledge base navigation to provide quick access to external resources or important pages. Links are language-specific based on the default language setting.


## OpenAPI

````yaml https://api.getfernand.com/openapi.json get /knowledge/links
openapi: 3.0.3
info:
  title: Fernand API Documentation
  version: '3.0'
  description: This is the documentation for the [Fernand](https://getfernand.com) API.
  termsOfService: https://getfernand.com/terms
  contact:
    name: Fernand Support
    url: https://getfernand.com
    email: support@getfernand.com
  x-logo:
    url: https://app.getfernand.com/images/favicon/icon_128.png
servers:
  - url: https://api.getfernand.com
    description: ''
    x-last-modified: 1764750693905
security:
  - apiKeyHeader: []
externalDocs:
  description: You can access our documentation online by visiting https://api.fernand.help
  url: https://api.fernand.help
paths:
  /knowledge/links:
    get:
      tags:
        - Knowledge Links
      summary: List links
      description: >-
        Returns all navigation links configured for the specified position
        (HEADER or FOOTER) in the knowledge base. Links are returned in sort
        order. These links appear in the knowledge base navigation to provide
        quick access to external resources or important pages. Links are
        language-specific based on the default language setting.
      operationId: listLinks
      parameters:
        - name: position
          in: query
          required: true
          schema:
            type: string
            enum:
              - HEADER
              - FOOTER
          description: Position where links should be displayed (case-insensitive).
          example: HEADER
      responses:
        '200':
          description: Links retrieved successfully.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/KnowledgeLinkLang'
components:
  schemas:
    KnowledgeLinkLang:
      type: object
      description: >-
        Navigation link combined with language-specific content. Inherits all
        properties from KnowledgeLink model and adds language-specific fields.
      allOf:
        - $ref: '#/components/schemas/KnowledgeLink'
        - type: object
          properties:
            title:
              type: string
              maxLength: 250
              description: Display text for the link shown in navigation.
              example: Contact Us
      x-computed-hash: 2b6d21ff36ba971be271b295a5b9e82f064073e6cee1af4f2b803b6ea8fefba5
      x-last-modified: 1769075325
    KnowledgeLink:
      type: object
      properties:
        id:
          type: integer
          format: int64
          description: Unique identifier for the link.
        sort:
          type: integer
          description: Sort order within the position (HEADER or FOOTER).
          example: 1
        url:
          type: string
          maxLength: 250
          description: Destination URL for the link.
          example: https://piedpiper.com/contact
        target:
          type: string
          maxLength: 6
          enum:
            - _blank
            - _self
          description: Link target behavior - _blank for new tab, _self for same window.
          example: _blank
        position:
          type: string
          maxLength: 6
          enum:
            - HEADER
            - FOOTER
          description: Where the link is displayed in the knowledge base.
          example: HEADER
      x-computed-hash: e887866a88caa67ffffb49193c7a9ed3c1a580f597ac733824d62223eff3abb9
      x-last-modified: 1769075325
  securitySchemes:
    apiKeyHeader:
      type: apiKey
      description: >-
        Authenticate your account by including your secret key in API requests.

        You can manage your API keys in the
        [Dashboard](https://app.getfernand.com/).


        Authentication to the API is performed by using the HTTP Header
        X-API-Key.
      name: X-API-Key
      in: header
      x-last-modified: 1764750344730

````