Mastodon icon

Mastodon

Interact with Mastodon API

Actions115

Filters → Update Filter

AI-generated

Overview

This node operation updates an existing filter on a Mastodon instance. It allows users to modify filter properties such as the phrase to filter, the contexts where the filter applies (e.g., home, notifications, public, thread), whether the filter is irreversible, and whether to match whole words only. This operation is useful for managing content filtering preferences on Mastodon, enabling automation of filter updates based on dynamic criteria or workflows.

Use Case Examples

  1. Updating a filter to change the phrase it blocks on a Mastodon instance.
  2. Modifying the contexts where a filter applies, such as adding the public timeline to the filter scope.
  3. Setting a filter to be irreversible to prevent it from being removed accidentally.

Properties

Name Meaning
Mastodon URL The URL of the Mastodon instance to connect to.
Authentication Type The method used to authenticate with the Mastodon instance, either OAuth2 or Access Token.
Filter ID The unique identifier of the filter to update.
Update Fields The fields to update on the filter, including phrase, context, irreversible flag, and whole word matching.

Output

JSON

  • id - The unique identifier of the updated filter.
  • phrase - The phrase that the filter is set to block.
  • context - The contexts where the filter is applied.
  • irreversible - Indicates if the filter is irreversible.
  • whole_word - Indicates if the filter matches whole words only.

Dependencies

  • Mastodon API credentials (OAuth2 or Access Token)

Troubleshooting

  • Ensure the correct authentication type is selected and valid credentials are provided; OAuth2 is required for authentication operations.
  • Verify the filter ID is correct and exists on the Mastodon instance before attempting to update.
  • Check that the Mastodon instance URL is correctly formatted and accessible.
  • Handle errors returned by the Mastodon API, such as invalid parameters or permission issues, by reviewing error messages and adjusting inputs accordingly.

Discussion