49868155b9
Add a new document that precisely describes the string representation of datetime and date types. The previous description of them as "ISO 8601 Datetime" was very imprecise, as ISO 8601 describes many different ways of representing a datetime and date. Specify the datetime format precisely as the ISO 8601 profile described in RFC 3339, and the date format precisely as the "Complete date" format from the W3C note on date and time formats. Adjust all the references to ISO 8601 datetimes or dates to link back to the definition. Fixes #1420
4.4 KiB
| title | description | menu | aliases | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Admin::Report | Admin-level information about a filed report. |
|
|
Example
{
"id": "1",
"action_taken": false,
"action_taken_at": null,
"category": "spam",
"comment": "",
"forwarded": false,
"created_at": "2022-09-09T21:19:23.085Z",
"updated_at": "2022-09-09T21:19:23.085Z",
"account": {
"id": "108965218747268792",
"username": "admin",
"domain": null,
"created_at": "2022-09-08T22:48:07.985Z",
"email": "admin@mastodon.local",
// ...
"account": {
"id": "108965218747268792",
"username": "admin",
"acct": "admin",
// ...
}
},
"target_account": {
"id": "108965430868193066",
"username": "goody",
"domain": null,
"created_at": "2022-09-08T23:42:04.731Z",
"email": "goody@mastodon.local",
// ...
"account": {
"id": "108965430868193066",
"username": "goody",
"acct": "goody",
// ...
}
},
"assigned_account": null,
"action_taken_by_account": null,
"statuses": [],
"rules": []
}
Attributes
id
Description: The ID of the report in the database.
Type: String (cast from an integer, but not guaranteed to be a number)
Version history:
2.9.1 - added
action_taken
Description: Whether an action was taken to resolve this report.
Type: Boolean
Version history:
2.9.1 - added
action_taken_at
Description: When an action was taken, if this report is currently resolved.
Type: {{}} String (Datetime) or null
Version history:
2.9.1 - added
category
Description: The category under which the report is classified.
Type: String (Enumerable oneOf)
spam = Malicious, fake, or repetitive content
violation = Violates one or more specific rules
other = The default (catch-all) category
Version history:
3.5.0 - added
comment
Description: An optional reason for reporting.
Type: String
Version history:
2.9.1 - added
forwarded
Description: Whether a report was forwarded to a remote instance.
Type: Boolean
Version history:
4.0.0 - added
created_at
Description: The time the report was filed.
Type: String (Datetime)
Version history:
2.9.1 - added
updated_at
Description: The time of last action on this report.
Type: String (Datetime)
Version history:
2.9.1 - added
account
Description: The account which filed the report.
Type: [Admin::Account]({{< relref "entities/Admin_Account" >}})
Version history:
2.9.1 - added
target_account
Description: The account being reported.
Type: [Admin::Account]({{< relref "entities/Admin_Account" >}})
Version history:
2.9.1 - added
assigned_account
Description: The account of the moderator assigned to this report.
Type: {{}} [Admin::Account]({{< relref "entities/Admin_Account" >}}) or null
Version history:
2.9.1 - added
action_taken_by_account
Description: The account of the moderator who handled the report.
Type: {{}} [Admin::Account]({{< relref "entities/Admin_Account" >}}) or null
Version history:
2.9.1 - added
statuses
Description: Statuses attached to the report, for context.
Type: Array of [Status]({{< relref "entities/Status" >}})
Version history:
2.9.1 - added
rules
Description: Rules attached to the report, for context.
Type: Array of [Rule]({{< relref "entities/Rule" >}})
Version history:
3.5.0 - added
See also
{{< page-relref page="methods/admin/reports" caption="admin/reports API methods">}}
{{< caption-link url="https://github.com/mastodon/mastodon/blob/main/app/serializers/rest/admin/report_serializer.rb" caption="app/serializers/rest/admin/report_serializer.rb" >}}