GravitySocial icon

GravitySocial

Interact with GravitySocial API

Actions21

Overview

This node interacts with the GravitySocial API to manage tags within a specified workspace. Specifically, the Update Tag operation allows users to modify existing tag properties such as the tag's name and color. This is useful in scenarios where you want to rename tags or change their visual representation (color) to better organize or categorize social media content.

Practical examples:

  • Renaming a tag from "Holiday" to "Vacation" after a campaign rebranding.
  • Changing the color of a tag to match new brand guidelines or to visually differentiate tags more clearly in the UI.

Properties

Name Meaning
Workspace UUID The unique identifier (UUID) of the workspace where the tag exists.
Tag UUID The unique identifier (UUID) of the tag to update.
Update Fields Collection of fields to update on the tag:
- Name New name for the tag.
- Color New color for the tag in hexadecimal format (e.g., #FF5733).

Output

The node outputs the JSON response returned by the GravitySocial API after updating the tag. This typically includes the updated tag object with its current properties such as UUID, name, color, and any other metadata provided by the API.

If multiple items are processed, the output is an array of updated tag objects.

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to the GravitySocial API via an API key credential.
  • The node expects the API base URL and access token to be configured in the credentials.
  • The workspace UUID must be known and valid.
  • The tag UUID must correspond to an existing tag in the specified workspace.

Troubleshooting

  • Common issues:

    • Invalid or missing Workspace UUID or Tag UUID will cause the request to fail.
    • Providing invalid color codes (not in hex format) may result in validation errors.
    • Network or authentication failures if the API key is incorrect or expired.

  • Error messages:

    • Validation Error: Indicates that one or more fields did not pass API validation, e.g., invalid color format or empty name.
      • Resolution: Check the input values for correctness and completeness.
    • HTTP status errors (e.g., 401 Unauthorized, 404 Not Found):
      • Resolution: Verify API credentials, workspace UUID, and tag UUID.
    • Unsupported file error will not occur here since no file upload is involved in this operation.

Links and References

Discussion