Mastodon icon

Mastodon

Interact with Mastodon API

Overview

This node allows users to interact with the Mastodon social network API, specifically enabling operations on various Mastodon resources. For the Status resource with the Delete Status operation, it deletes a specific status (post) from a Mastodon instance.

Typical use cases include:

  • Automating the removal of outdated or unwanted posts.
  • Managing content programmatically across Mastodon instances.
  • Integrating Mastodon status deletion into larger workflows for social media management.

For example, a user might set up a workflow that deletes a status by its ID after a certain event occurs, such as detecting inappropriate content or automating cleanup tasks.

Properties

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

Output

The output is a JSON object representing the response from the Mastodon API after attempting to delete the specified status. This typically includes confirmation of deletion or error details if the operation failed.

No binary data output is produced by 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 instance is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing Status ID will cause the deletion to fail.
    • Incorrect Mastodon URL or unreachable instance will result in connection errors.
    • Insufficient permissions or invalid API credentials can cause authorization errors.
  • Error messages:

    • "The operation "delete" for resource "status" is not implemented!" — indicates a misconfiguration or unsupported operation; ensure the correct resource and operation are selected.
    • API errors returned from Mastodon (e.g., 404 Not Found if the status does not exist, 401 Unauthorized if credentials are invalid).
  • Resolutions:

    • Verify the Status ID is correct and corresponds to an existing post.
    • Confirm the Mastodon URL is accurate and the instance is reachable.
    • Ensure the API authentication token has the required scopes/permissions to delete statuses.
    • Enable "Continue On Fail" in the node settings to handle errors gracefully within workflows.

Links and References

Discussion