Filter
Represents a user-defined filter for determining which statuses should not be shown to the user.
Example
{
"id": "19972",
"title": "Test filter",
"context": [
"home"
],
"expires_at": "2022-09-20T17:27:39.296Z",
"filter_action": "warn",
"keywords": [
{
"id": "1197",
"keyword": "bad word",
"whole_word": false
}
],
"statuses": [
{
"id": "1",
"status_id": "109031743575371913"
}
]
}
Attributes
id
Description: The ID of the Filter in the database.
Type: String (cast from an integer, but not guaranteed to be a number)
Version history:
4.0.0 - added
title
Description: A title given by the user to name the filter.
Type: String
Version history:
4.0.0 - added
context
Description: The contexts in which the filter should be applied.
Type: Array of String (Enumerable, anyOf)home
= home timeline and listsnotifications
= notifications timelinepublic
= public timelinesthread
= expanded thread of a detailed statusaccount
= when viewing a profile
Version history:
4.0.0 - added
expires_at
Description: When the filter should no longer be applied.
Type: nullable String (ISO 8601 Datetime), or null if the filter does not expire
Version history:
4.0.0 - added
filter_action
Description: The action to be taken when a status matches this filter.
Type: String (Enumerable, oneOf)warn
= show a warning that identifies the matching filter by title
, and allow the user to expand the filtered status. This is the default (and unknown values should be treated as equivalent to warn
).hide
= do not show this status if it is received
Version history:
4.0.0 - added
keywords
Description: The keywords grouped under this filter.
Type: Array of FilterKeyword
Version history:
4.0.0 - added
statuses
Description: The statuses grouped under this filter.
Type: Array of FilterStatus
Version history:
4.0.0 - added
See also
Implementation guidelines for filters V1::Filter (for Mastodon 3.5 and earlier) /api/v2/filters methods app/serializers/rest/filter_serializer.rbLast updated November 20, 2022 路 Improve this page