Mastodon icon

Mastodon

Interact with Mastodon API

Overview

This node interacts with the Mastodon social network API, specifically allowing users to manage their favourites (likes) on statuses (posts). The "Unfavourite" operation under the "Favourites" resource removes a previously favourited status by its ID. This is useful for automating the management of liked content, such as unliking posts based on certain criteria or cleaning up favourites in bulk.

Practical examples:

  • Automatically unfavouriting a post after a certain time period.
  • Removing favourites from posts that no longer meet your interest criteria.
  • Integrating Mastodon favourite management into broader social media workflows.

Properties

Name Meaning
Mastodon URL The URL of the Mastodon instance to connect to (e.g., https://mastodon.social).
Status ID The unique identifier of the status (post) to unfavourite.

Output

The output JSON contains the response from the Mastodon API after attempting to unfavourite the specified status. Typically, this will include details about the status and its updated favourite state. If the operation succeeds, the status will no longer be marked as favourited by the authenticated user.

No binary data output is involved in this operation.

Dependencies

  • Requires an API authentication token credential for Mastodon OAuth2 to authorize requests.
  • Needs the URL of the target Mastodon instance.
  • The node depends on the Mastodon API being accessible and the provided credentials having permission to modify favourites.

Troubleshooting

  • Common issues:

    • Invalid or expired API authentication token can cause authorization failures.
    • Incorrect Mastodon instance URL may lead to connection errors.
    • Providing an invalid or non-existent Status ID will result in errors from the Mastodon API.
  • Error messages:

    • "The operation "unfavourite" for resource "favourites" is not implemented!" — indicates a misconfiguration or unsupported operation; verify the operation name.
    • Network or authentication errors typically indicate problems with credentials or instance URL.
  • Resolutions:

    • Ensure the Mastodon URL is correct and reachable.
    • Verify that the API key or OAuth token is valid and has necessary scopes.
    • Confirm the Status ID exists and belongs to a status that was previously favourited.

Links and References

Discussion