Discuss Kit icon

Discuss Kit

Consume Discuss Kit API
Join our community

Actions66

Overview

This node integrates with the Discuss Kit API to manage discussion boards and related content. Specifically, for the Board - Create operation, it allows users to create a new board within the Discuss Kit platform by specifying details such as title, description, cover image, type, and associated passports.

Common scenarios where this node is beneficial include:

  • Automating the creation of new discussion or content boards in a community or knowledge base platform.
  • Setting up categorized spaces (e.g., blog, documentation, bookmarks) programmatically for organizing content.
  • Integrating board creation into workflows that require dynamic generation of discussion spaces based on external triggers.

Practical example:

  • A company wants to automatically create a new discussion board whenever a new project starts, setting the board’s title to the project name, adding a description, and selecting the board type as "discussion" to facilitate team communication.

Properties

Name Meaning
Title The title of the board to be created.
Description A textual description providing more details about the board.
Passports A list of passport identifiers associated with the board (multiple values allowed).
Cover URL of the cover image representing the board visually.
Type The category/type of the board. Options: Discussion, Blog, Bookmark, Documentation.

Output

The output JSON contains the response from the Discuss Kit API after creating the board. This typically includes the newly created board's details such as its unique identifier, title, description, type, cover image URL, and any other metadata returned by the API.

No binary data output is involved in this operation.

Dependencies

  • Requires access to the Discuss Kit API endpoint /api/boards.
  • Uses an API authentication mechanism configured via n8n credentials (an API key or token).
  • Relies on the blockletComponentApiRequest helper function to make HTTP requests to the Discuss Kit backend.

Troubleshooting

  • Common issues:

    • Missing required fields like the board title will cause the API request to fail.
    • Invalid or expired API credentials will result in authentication errors.
    • Providing unsupported board types or malformed URLs for the cover image may lead to validation errors.

  • Error messages and resolutions:

    • "Missing required parameter: title": Ensure the Title property is set and not empty.
    • "Unauthorized" or "Authentication failed": Verify that the API key/token credential is correctly configured and valid.
    • "Invalid board type": Confirm that the Type property is one of the supported options (discussion, blog, bookmark, doc).
    • Network timeouts or connection errors: Check network connectivity and API availability.

Links and References

Discussion