Mastodon icon

Mastodon

Interact with Mastodon API

Overview

This node interacts with the Mastodon API to manage featured tags on a Mastodon instance. Specifically, the "Unfeature Tag" operation under the "Featured Tags" resource allows users to remove a tag from the list of featured tags on their Mastodon server.

Common scenarios for this node include:

  • Moderators or administrators managing the visibility of tags by removing outdated or irrelevant featured tags.
  • Automating cleanup of featured tags based on certain criteria or schedules.
  • Integrating Mastodon tag management into broader social media workflows.

For example, an admin could use this node to programmatically unfeature a trending tag that is no longer relevant or appropriate.

Properties

Name Meaning
Mastodon URL The URL of the Mastodon instance to connect to (e.g., https://mastodon.social).
Tag ID The unique identifier of the featured tag to remove from the Mastodon instance.

Output

The output JSON contains the response from the Mastodon API after attempting to unfeature the specified tag. This typically includes confirmation of the removal or details about the tag's updated status.

No binary data output is involved in this operation.

Dependencies

  • Requires an API authentication token credential configured in n8n to authenticate requests to the Mastodon instance.
  • The Mastodon instance URL must be provided and accessible.
  • Network connectivity to the specified Mastodon server is necessary.

Troubleshooting

  • Common Issues:

    • Incorrect or missing Mastodon instance URL can cause connection failures.
    • Invalid or expired API authentication tokens will result in authorization errors.
    • Providing a non-existent or incorrect Tag ID will cause the operation to fail as the tag cannot be found.
  • Error Messages:

    • "The operation "unfeature" for resource "featuredTags" is not implemented!" — indicates a misconfiguration or unsupported operation; ensure correct resource and operation names.
    • API errors related to authentication or permissions usually indicate issues with the provided credentials.
    • Errors indicating the tag ID was not found suggest verifying the Tag ID input.
  • Resolutions:

    • Double-check the Mastodon URL and ensure it is reachable.
    • Verify that the API authentication token has sufficient permissions.
    • Confirm the Tag ID exists on the Mastodon instance before attempting to unfeature.

Links and References

Discussion