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

# Create a new link

Creates a new navigation link in the knowledge base header or footer. Links are automatically assigned a sort order based on their position among existing links. URLs are automatically prefixed with https\:// if no protocol is provided. The combination of URL and position must be unique within the knowledge base.


## OpenAPI

````yaml https://api.getfernand.com/openapi.json post /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:
    post:
      tags:
        - Knowledge Links
      summary: Create a new link
      description: >-
        Creates a new navigation link in the knowledge base header or footer.
        Links are automatically assigned a sort order based on their position
        among existing links. URLs are automatically prefixed with https:// if
        no protocol is provided. The combination of URL and position must be
        unique within the knowledge base.
      operationId: createLink
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                title:
                  type: string
                  maxLength: 60
                  description: Display text for the link (required).
                  example: Contact Us
                url:
                  type: string
                  maxLength: 250
                  description: >-
                    Destination URL (required, automatically prefixed with
                    https:// if missing).
                  example: https://piedpiper.com/contact
                target:
                  type: string
                  maxLength: 6
                  enum:
                    - _blank
                    - _self
                  description: >-
                    Link target behavior - _blank opens in new tab, _self opens
                    in same window (required).
                  example: _blank
                position:
                  type: string
                  maxLength: 6
                  enum:
                    - HEADER
                    - FOOTER
                  description: >-
                    Where the link should be displayed (required,
                    case-insensitive).
                  example: HEADER
              required:
                - title
                - url
                - target
                - position
      responses:
        '200':
          description: Link created successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KnowledgeLinkLang'
        '400':
          description: Invalid input or duplicate link.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
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

````