Navigation

Load Full Navigation of a Space

PropertyDescription
MethodGET
Path/open/v1/spaces/$me/nav-nodes/$all
Accept-
Content-Typeapplication/json
DescriptionLoads all navigation nodes in the space's navigation tree.
  • Request
    • Query
      (empty)
    • Body
      // (empty)
      
  • Response
    type NavNodesAllView = {
      navNodes: NavNode[]
    }
    

Load the path to a Navigation Node from Root

PropertyDescription
MethodGET
Path/open/v1/spaces/$me/nav-nodes/{navNodeId}/$path
Accept-
Content-Typeapplication/json
DescriptionView the path from the root to the requested node (specified by node ID) in the navigation tree.
  • Request

    • Query

      ParamRequired?DefaultTypeDescriptionExample
      languageO-stringRequested languageko
    • Body

      // (empty)
      
  • Response

    type NavNodesPathView = {
      navNodes: NavNode[]
      categories: Category[]
      articles: Article[]
    }
    

Load the path to a Navigation Node from Root by Entity

PropertyDescription
MethodGET
Path/open/v1/spaces/$me/nav-nodes/${entityType}s/{entityId}/$path
Accept-
Content-Typeapplication/json
DescriptionView the path from the root to the requested node (specified by the attached entity type and ID) in the navigation tree.
Allowed values for entity types:articles or categories.
  • Request

    • Query

      ParamRequired?DefaultTypeDescriptionExample
      languageO-stringRequested languageko
    • Body

      // (empty)
      
  • Response

    type NavNodesPathView = {
      navNodes: NavNode[]
      categories: Category[]
      articles: Article[]
    }
    

Load a single level of a Navigation

PropertyDescription
MethodGET
Path/open/v1/spaces/$me/nav-nodes/{navNodeId}/$children
Accept-
Content-Typeapplication/json
DescriptionView the requested navigation node (specified by node ID) and its direct children nodes.
  • Request

    • Query

      ParamRequired?DefaultTypeDescriptionExample
      languageO-stringRequested languageko
    • Body

      // (empty)
      
  • Response

    type NavNodesLevelView = {
      navNode: NavNode
      children: NavNode[]
      categories: Category[]
      articles: Article[]
    }
    

Load a single level of a Navigation by Entity

PropertyDescription
MethodGET
Path/open/v1/spaces/$me/nav-nodes/${entityType}s/{entityId}/$children
Accept-
Content-Typeapplication/json
DescriptionView the requested navigation node (specified by the attached entity type and ID) and its direct children nodes.
Allowed values for entity types:articles or categories.
  • Request

    • Query

      ParamRequired?DefaultTypeDescriptionExample
      languageO-stringRequested languageko
    • Body

      // (empty)
      
  • Response

    type NavNodesLevelView = {
      navNode: NavNode
      children: NavNode[]
      categories: Category[]
      articles: Article[]
    }