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 "Create Tag" operation allows users to create a new tag associated with a given app DID. Tags can be used to categorize or label resources, users, or other entities within the Blocklet ecosystem.

Common scenarios where this node is beneficial include:

  • Organizing content or users by custom labels.
  • Adding metadata to resources for filtering or searching.
  • Managing team-specific tags dynamically in workflows.

For example, you might use this node to create a tag named "Urgent" with a red color to mark high-priority items in your app.

Properties

Name Meaning
App DID DID of the blocklet app (team) to which the tag will belong.
Title Title of the tag; the name that identifies the tag.
Color Color of the tag, specified as a hex color code (e.g., #4B5563).
Description Optional description providing more details about the tag's purpose or usage.

Output

The node outputs JSON data representing the created tag object returned from the Blocklet Server API. This typically includes fields such as the tag's unique ID, title, description, color, and any other metadata provided by the API.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Blocklet Server API.
  • The node depends on the Blocklet Server API being accessible and properly configured.
  • No additional environment variables are explicitly required beyond the API authentication.

Troubleshooting

  • Common issues:

    • Invalid or missing App DID: Ensure the DID string is correct and corresponds to an existing Blocklet app.
    • Missing required parameters like Title: The node requires at least the App DID and Title to create a tag.
    • API authentication errors: Verify that the API key credential is valid and has sufficient permissions.

  • Error messages:

    • "Not implemented tag action: createTag": Indicates a misconfiguration or unsupported operation; ensure the operation parameter is correctly set to "createTag".
    • API errors returned from the server (e.g., validation errors) will be passed through; check the error message for details.

  • To resolve errors, verify all required inputs, confirm API credentials, and check network connectivity to the Blocklet Server.

Links and References

Discussion