Qlynk - Update Category icon

Qlynk - Update Category

Use this tool to update an existing category. You can change its name, color, or icon. Provide the category ID and the new values.

Overview

This node updates an existing category in the Qlynk system by changing its name, color, or icon. It requires the user to provide the category's numeric ID and the new values for the category's name, color, and icon. This node is useful for managing and organizing categories dynamically, such as updating category details in a content management or project organization system.

Use Case Examples

  1. Updating a category's name from 'Marketing' to 'Social Media' while changing its color to blue and icon to a folder.
  2. Changing the icon of a category to better represent its contents without altering its name or color.

Properties

Name Meaning
Category ID The numeric ID of the category to update, must be greater than 0.
Category Name The new name for the category, cannot be empty.
Color The new hex color code for the category, e.g., #3b82f6 for blue.
Icon The new Font Awesome icon name for the category, without the 'fa-' prefix.

Output

JSON

  • json
    • success - Indicates if the update operation was successful (true or false).
    • category_id - The ID of the category that was attempted to be updated.
    • statusCode - HTTP status code returned by the update request, e.g., 404 if category not found.
    • message - Error message if the category was not found or another error occurred.

Dependencies

  • An API key credential for Qlynk API authentication is required.

Troubleshooting

  • If 'category_id' is missing or less than or equal to 0, the node throws an error indicating the parameter is required and must be greater than 0.
  • If 'name' is empty or missing, the node throws an error indicating the name parameter is required.
  • If the category ID does not exist, the node returns a JSON object with success set to false and a 404 status code with a message 'Category not found - cannot update'.
  • To handle errors gracefully, enable 'Continue On Fail' to allow the workflow to proceed even if an update fails.

Discussion