Hudu icon

Hudu

Interact with Hudu REST API

Article → Get Many

AI-generated

Overview

This node operation retrieves multiple articles from the Hudu system. It supports filtering, limiting the number of results, and optionally including additional details such as markdown content, company details, and folder details. It can return all results or a limited subset, and can wrap the results in a single item to optimize downstream processing.

Use Case Examples

  1. Retrieve up to 25 articles with their markdown content included for AI text processing.
  2. Fetch all articles from a specific company and include folder details with custom folder path separators.
  3. Get articles updated in the last 7 days, returning all results wrapped in a single item to avoid rate limiting downstream.

Properties

Name Meaning
Return All Whether to return all results or only up to a given limit.
Limit Maximum number of results to return when not returning all.
Wrap Results in Single Item Whether to return all results as a single item with an 'items' array and 'count' field to prevent downstream nodes from executing once per result item.
Include Markdown Content Whether to include article content converted to markdown format for each article.
Include Company Details Whether to include company name for each article by resolving company_id to company_id_label, which performs additional company lookups.
Include Folder Details Whether to include folder name, description, and full path for each article, performing additional folder lookups.
Prepend Company to Folder Path Whether to prepend the company name (or Central KB for global articles) to each folder_path value, applicable only if folder details are included.
Separator Choose how to separate folder names in the folder_path string, applicable only if folder details are included.
Custom Separator Custom string to use between folder names when building the folder_path value, applicable only if separator is set to custom and folder details are included.
Filters Filter the results by various criteria such as company, draft status, sharing enabled, folder ID, name, search query, slug, and updated date range.

Output

JSON

  • items - Array of article objects when results are wrapped in a single item.
  • count - Number of articles returned when results are wrapped in a single item.
  • any article property - Properties of each article object returned individually or within the items array.

Dependencies

  • Hudu REST API
  • API authentication token or API key credential

Troubleshooting

  • Common issues include API authentication errors, rate limiting when processing many articles without wrapping results, and performance impacts when using client-side filtering such as folder ID filtering.
  • Error messages may indicate unknown resource or operation if incorrect parameters are provided.
  • To resolve rate limiting, enable 'Wrap Results in Single Item' to reduce downstream node executions.

Discussion