Discuss Kit icon

Discuss Kit

Consume Discuss Kit API

Overview

This node integrates with the Discuss Kit API to manage labels within a discussion or content management system. Specifically, the Label - Create operation allows users to create new labels that can be used to categorize or tag content such as posts, blogs, documents, or discussions.

Common scenarios where this node is beneficial include:

  • Automatically generating labels for organizing content based on workflow triggers.
  • Creating custom tags for categorizing user-generated content in forums or knowledge bases.
  • Managing label metadata like color, description, and images programmatically.

For example, you might use this node to create a label named "Urgent" with a red color to flag high-priority discussions or documents.

Properties

Name Meaning
Name The name of the label to create (required).
ID Optional identifier for the label; usually auto-generated if not provided.
Slug A URL-friendly string representing the label.
Description Text describing the purpose or details of the label.
Image URL pointing to an image associated with the label.
Color The color assigned to the label (required).
Translation JSON object containing translations for the label in different languages.
Passports List of passports (strings) associated with the label, allowing multiple values.

Output

The output of this operation is a JSON object representing the created label. It typically includes the label's properties such as its name, ID, slug, description, color, image URL, translation data, and any associated passports.

No binary data output is involved in this operation.

Dependencies

  • Requires access to the Discuss Kit API endpoint for labels.
  • Needs an API authentication token or key configured in n8n credentials to authorize requests.
  • Utilizes a helper function to make HTTP POST requests to /api/labels with the label data.

Troubleshooting

  • Error: Unauthorized or Authentication Failed
    Ensure that the API key or authentication token is correctly set up in the node credentials and has sufficient permissions to create labels.

  • Error: Missing Required Parameters
    The "Name" and "Color" fields are required. Verify these inputs are provided and valid.

  • Error: Invalid JSON in Translation Field
    If providing translations, ensure the JSON object is well-formed.

  • Unexpected API Errors
    Check network connectivity and API availability. Review API rate limits or quota restrictions.

Links and References

Discussion