admin

Perform moderation actions with accounts and reports.

レスポンスのドキュメントは準備中です Exact nature of parameters has not been validated.

Account methods

get
View accounts by criteria

https://mastodon.example/api/v1/admin/accounts

View accounts matching certain criteria for filtering, up to 100 at a time. Pagination may be done with the HTTP Link header in the response.

戻り値: Admin::Account
OAuth: User token + admin:read:accounts
実装履歴:

  • 2.9.1 - 追加

リクエスト

ヘッダ
Authorization
必須
string
Bearer <user token>
クエリ
local
任意
boolean
Filter for local accounts?
remote
任意
boolean
Filter for remote accounts?
by_domain
任意
string
Filter by the given domain
active
任意
boolean
Filter for currently active accounts?
pending
任意
boolean
Filter for currently pending accounts?
disabled
任意
boolean
Filter for currently disabled accounts?
silenced
任意
boolean
Filter for currently silenced accounts?
suspended
任意
boolean
Filter for currently suspended accounts?
username
任意
string
Username to search for
display_name
任意
string
Display name to search for
email
任意
string
Lookup a user with this email
ip
任意
string
Lookup users by this IP address
staff
任意
boolean
Filter for staff accounts?

レスポンス

200: Success

get
View a specific account

https://mastodon.example/api/v1/admin/accounts/:id

View admin-level information about the given account.

戻り値: Admin::Account
OAuth: User token + admin:read:accounts
実装履歴:

  • 2.9.1 - 追加

リクエスト

パス
:id
必須
string
ID of the account
ヘッダ
Authorization
必須
string
Bearer <user token>

レスポンス

200: Success

post
Perform an action against an account

https://mastodon.example/api/v1/admin/accounts/:account_id/action

Perform an action against an account and log this action in the moderation history.

戻り値: empty object
OAuth: User token + admin:write:accounts
実装履歴:

  • 2.9.1 - 追加

リクエスト

パス
:account_id
必須
string
ID of the account
ヘッダ
Authorization
必須
string
Bearer <user token>
フォームのパラメータ
type
任意
string
Type of action to be taken. Enumerable oneOf: none disable silence suspend
report_id
任意
string
ID of an associated report that caused this action to be taken
warning_preset_id
任意
string
ID of a preset warning
text
任意
string
Additional text for clarification of why this action was taken
send_email_notification
任意
boolean
Whether an email should be sent to the user with the above information.

レスポンス

200: Success

post
Approve pending account

https://mastodon.example/api/v1/admin/accounts/:id/approve

Approve the given local account if it is currently pending approval.

戻り値: Admin::Account
OAuth: User token + admin:write:accounts
実装履歴:

  • 2.9.1 - 追加

リクエスト

パス
:id
必須
string
ID of the account
ヘッダ
Authorization
必須
string
Bearer <user token>

レスポンス

200: Success

post
Reject pending account

https://mastodon.example/api/v1/admin/accounts/:id/reject

Reject the given local account if it is currently pending approval.

戻り値: Admin::Account
OAuth: User token + admin:write:accounts
実装履歴:

  • 2.9.1 - 追加

リクエスト

パス
:id
必須
string
ID of the account
ヘッダ
Authorization
必須
string
Bearer <user token>

レスポンス

200: Success

post
Re-enable account

https://mastodon.example/api/v1/admin/accounts/:id/enable

Re-enable a local account whose login is currently disabled.

戻り値: Admin::Account
OAuth: User token + admin:write:accounts
実装履歴:

  • 2.9.1 - 追加

リクエスト

パス
:id
必須
string
ID of the account
ヘッダ
Authorization
必須
string
Bearer <user token>

レスポンス

200: Success

post
Unsilence account

https://mastodon.example/api/v1/admin/accounts/:id/unsilence

Unsilence a currently silenced account.

戻り値: Admin::Account
OAuth: User token + admin:write:accounts
実装履歴:

  • 2.9.1 - 追加

リクエスト

パス
:id
必須
string
ID of the account
ヘッダ
Authorization
必須
string
Bearer <user token>

レスポンス

200: Success

post
Unsuspend account

https://mastodon.example/api/v1/admin/accounts/:id/unsuspend

Unsuspend a currently suspended account.

戻り値: Admin::Account
OAuth: User token + admin:write:accounts
実装履歴:

  • 2.9.1 - 追加

リクエスト

パス
:id
必須
string
ID of the account
ヘッダ
Authorization
必須
string
Bearer <user token>

レスポンス

200: Success

Report methods

get
View all reports

https://mastodon.example/api/v1/admin/reports

View all reports. Pagination may be done with HTTP Link header in the response.

戻り値: Array of Admin::Report
OAuth: User token + admin:read:reports
実装履歴:

  • 2.9.1 - 追加

リクエスト

ヘッダ
Authorization
必須
string
Bearer <user token>
クエリ
resolved
任意
boolean
account_id
任意
string
target_account_id
任意
string

レスポンス

200: Success

get
View a single report

https://mastodon.example/api/v1/admin/reports/:id/

View information about the report with the given ID.

戻り値: Admin::Report
OAuth: User token + admin:read:reports
実装履歴:

  • 2.9.1 - 追加

リクエスト

パス
:id
必須
string
ID of the report
ヘッダ
Authorization
必須
string
Bearer <user token>

レスポンス

200: Success

post
Assign report to self

https://mastodon.example/api/v1/admin/reports/:id/assign_to_self

Claim the handling of this report to yourself.

戻り値: Admin::Report
OAuth: User token + admin:write:reports
実装履歴:

  • 2.9.1 - 追加

リクエスト

パス
:id
必須
string
ID of the report
ヘッダ
Authorization
必須
string
Bearer <user token>

レスポンス

200: Success

post
Unassign report

https://mastodon.example/api/v1/admin/reports/:id/unassign

Unassign a report so that someone else can claim it.

戻り値: Admin::Report
OAuth: User token + admin:write:reports
実装履歴:

  • 2.9.1 - 追加

リクエスト

パス
:id
必須
string
ID of the report
ヘッダ
Authorization
必須
string
Bearer <user token>

レスポンス

200: Success

post
Mark as resolved

https://mastodon.example/api/v1/admin/reports/:id/resolve

Mark a report as resolved with no further action taken.

戻り値: Admin::Report
OAuth: User token + admin:write:reports
実装履歴:

  • 2.9.1 - 追加

リクエスト

パス
:id
必須
string
ID of the report
ヘッダ
Authorization
必須
string
Bearer <user token>

レスポンス

200: Success

post
Re-open report

https://mastodon.example/api/v1/admin/reports/:id/reopen

Reopen a currently closed report.

戻り値: Admin::Report
OAuth: User token + admin:write:reports
実装履歴:

  • 2.9.1 - 追加

リクエスト

パス
:id
必須
string
ID of the report
ヘッダ
Authorization
必須
string
Bearer <user token>

レスポンス

200: Success

最終更新 May 17, 2020 · このページを改善する
他の言語: English