Discuss Kit icon

Discuss Kit

Consume Discuss Kit API

Overview

This node integrates with the Discuss Kit API to manage various content types such as discussions, blogs, bookmarks, documentation, comments, labels, boards, and search functionalities. Specifically, for the Documentation resource with the Add Assignee operation, it allows you to assign a user to a documentation item by specifying the content ID and the assignee.

Common scenarios where this node is beneficial include:

  • Automating task assignments in documentation workflows.
  • Managing collaborative editing by assigning responsible users to specific documents.
  • Integrating with other systems to dynamically update assignees based on external triggers or events.

For example, when a new document is created or updated, you can automatically add an assignee who is responsible for reviewing or maintaining that document.

Properties

Name Meaning
Content ID The unique identifier of the documentation content to which the assignee will be added.
Assignee The username or identifier of the user to assign to the specified documentation content.

Output

The node outputs JSON data representing the result of the API call to add an assignee. Typically, this will be the updated documentation content object or a confirmation response from the API indicating the assignee was successfully added.

No binary data output is produced by this operation.

Dependencies

  • Requires access to the Discuss Kit API.
  • Needs an API authentication token or key configured in n8n credentials (referred generically as "an API key credential").
  • The node uses internal helper functions to make HTTP requests to the Discuss Kit endpoints.

Troubleshooting

  • Common issues:

    • Invalid or missing Content ID: Ensure the content ID provided corresponds to an existing documentation item.
    • Invalid Assignee: The assignee must be a valid user recognized by the Discuss Kit system.
    • Authentication errors: Verify that the API key or authentication token is correctly configured and has sufficient permissions.
    • Network or API downtime: Check connectivity and Discuss Kit service status.
  • Error messages:

    • "error": "Content not found": The specified Content ID does not exist. Double-check the ID.
    • "error": "Unauthorized" or "Authentication failed": The API key or token is invalid or expired.
    • "error": "Assignee not found": The assignee value does not match any user in the system.

To resolve these errors, verify input parameters, ensure proper authentication setup, and confirm the existence of referenced users and content.

Links and References

Discussion