Blocklet Server icon

Blocklet Server

Consume Blocklet Server API
Join our community

Actions10

Overview

This node interacts with the Blocklet Server API to manage tags within a Blocklet app (team). Specifically, the "Update Tag" operation allows users to modify an existing tag's details such as its title, color, and description. This is useful for organizing and categorizing resources or users by updating tag metadata dynamically.

Practical examples include:

  • Renaming a tag to better reflect its purpose.
  • Changing the color of a tag to improve visual identification.
  • Updating the description to provide more context about the tag's use.

Properties

Name Meaning
App DID DID (Decentralized Identifier) of the Blocklet app (team) where the tag belongs.
ID ID of the tag to update. Optional but usually required to identify which tag to modify.
Title New title/name of the tag.
Color New color of the tag, represented as a hex color code (e.g., #4B5563).
Description New description text providing additional information about the tag.

Output

The output is a JSON object representing the updated tag returned from the Blocklet Server API. It typically includes fields such as the tag's ID, title, color, description, and possibly other metadata related to the tag.

No binary data output is involved in this operation.

Dependencies

  • Requires an API key credential for authenticating requests to the Blocklet Server API.
  • The node depends on the blockletServerApiRequest function to communicate with the external Blocklet Server service.
  • Proper configuration of the API credentials in n8n is necessary for successful execution.

Troubleshooting

  • Common issues:

    • Missing or invalid App DID or Tag ID will cause the update to fail.
    • Providing incomplete or invalid color codes may result in errors or unexpected tag appearance.
    • Network or authentication failures when connecting to the Blocklet Server API.

  • Error messages:

    • "Not implemented tag action: updateTag": Indicates the operation name might be misspelled or unsupported.
    • API error messages related to authorization or resource not found should be checked against the provided App DID and Tag ID.

  • Resolutions:

    • Verify that the App DID and Tag ID are correct and exist in the Blocklet server.
    • Ensure the API key credential is valid and has sufficient permissions.
    • Validate color codes and required fields before executing the node.

Links and References

Discussion