mirror of
https://github.com/mastodon/documentation
synced 2025-04-11 22:56:17 +02:00
bcf77cb795
* add identifier for troubleshooting pages * mention mutes can be temporary now * bell for notifications * convert images to jpg and rename them * suspensions now reversible * unread notifications * suspended: true * mutes expiry * replies_policy, type of notification * notify * featuredTags AP representation * new env vars * accounts merge * maintenance cli * list replies * suspended flag * follower sync * minor formatting * add note about idempotency of follow action * account featured tags, min_id and max_id, plus normalization * follow marcin and nightpool's suggestion * bearcaps * replies_policy update * featuredtags now have a url
61 lines
1.8 KiB
Markdown
61 lines
1.8 KiB
Markdown
---
|
|
title: reports
|
|
description: Report problematic users to your moderators.
|
|
menu:
|
|
docs:
|
|
weight: 70
|
|
parent: methods-accounts
|
|
---
|
|
|
|
{{< hint style="warning" >}}
|
|
|
|
Responses are not currently documented.
|
|
{{< /hint >}}
|
|
{{< api-method method="post" host="https://mastodon.example" path="/api/v1/reports" title="File a report" >}}
|
|
{{< api-method-description >}}
|
|
|
|
**Returns:** Report\
|
|
**OAuth:** User token + `write:reports`\
|
|
**Version history:**\
|
|
1.1 - added\
|
|
2.3.0 - add `forward` parameter
|
|
|
|
{{< endapi-method-description >}}
|
|
{{< api-method-spec >}}
|
|
{{< api-method-request >}}
|
|
{{< api-method-headers >}}
|
|
{{< api-method-parameter name="Authorization" type="string" required=true >}}
|
|
Bearer <user token>
|
|
{{< endapi-method-parameter >}}
|
|
{{< endapi-method-headers >}}
|
|
{{< api-method-form-data-parameters >}}
|
|
{{< api-method-parameter name="account_id" type="string" required=true >}}
|
|
ID of the account to report
|
|
{{< endapi-method-parameter >}}
|
|
{{< api-method-parameter name="status_ids" type="array" required=false >}}
|
|
Array of Statuses to attach to the report, for context
|
|
{{< endapi-method-parameter >}}
|
|
{{< api-method-parameter name="comment" type="string" required=false >}}
|
|
Reason for the report \(default max 1000 characters\)
|
|
{{< endapi-method-parameter >}}
|
|
{{< api-method-parameter name="forward" type="boolean" required=false >}}
|
|
If the account is remote, should the report be forwarded to the remote admin?
|
|
{{< endapi-method-parameter >}}
|
|
{{< endapi-method-form-data-parameters >}}
|
|
{{< endapi-method-request >}}
|
|
{{< api-method-response >}}
|
|
{{< api-method-response-example httpCode=200 >}}
|
|
{{< api-method-response-example-description >}}
|
|
{{< endapi-method-response-example-description >}}
|
|
|
|
|
|
```
|
|
|
|
```
|
|
{{< endapi-method-response-example >}}
|
|
{{< endapi-method-response >}}
|
|
{{< endapi-method-spec >}}
|
|
{{< endapi-method >}}
|
|
|
|
|