git.squeep.com Git - akkoma/blob - docs/API/admin_api.md

   1 # Admin API
   2
   3 Authentication is required and the user must be an admin.
   4
   5 ## `GET /api/pleroma/admin/users`
   6
   7 ### List users
   8
   9 - Query Params:
  10   - *optional* `query`: **string** search term (e.g. nickname, domain, nickname@domain)
  11   - *optional* `filters`: **string** comma-separated string of filters:
  12     - `local`: only local users
  13     - `external`: only external users
  14     - `active`: only active users
  15     - `deactivated`: only deactivated users
  16     - `is_admin`: users with admin role
  17     - `is_moderator`: users with moderator role
  18   - *optional* `page`: **integer** page number
  19   - *optional* `page_size`: **integer** number of users per page (default is `50`)
  20   - *optional* `tags`: **[string]** tags list
  21   - *optional* `name`: **string** user display name
  22   - *optional* `email`: **string** user email
  23 - Example: `https://mypleroma.org/api/pleroma/admin/users?query=john&filters=local,active&page=1&page_size=10&tags[]=some_tag&tags[]=another_tag&name=display_name&email=email@example.com`
  24 - Response:
  25
  26 ```json
  27 {
  28   "page_size": integer,
  29   "count": integer,
  30   "users": [
  31     {
  32       "deactivated": bool,
  33       "id": integer,
  34       "nickname": string,
  35       "roles": {
  36         "admin": bool,
  37         "moderator": bool
  38       },
  39       "local": bool,
  40       "tags": array,
  41       "avatar": string,
  42       "display_name": string
  43     },
  44     ...
  45   ]
  46 }
  47 ```
  48
  49 ## DEPRECATED `DELETE /api/pleroma/admin/users`
  50
  51 ### Remove a user
  52
  53 - Params:
  54   - `nickname`
  55 - Response: User’s nickname
  56
  57 ## `DELETE /api/pleroma/admin/users`
  58
  59 ### Remove a user
  60
  61 - Method `DELETE`
  62 - Params:
  63   - `nicknames`
  64 - Response: Array of user nicknames
  65
  66 ### Create a user
  67
  68 - Method: `POST`
  69 - Params:
  70   `users`: [
  71     {
  72       `nickname`,
  73       `email`,
  74       `password`
  75     }
  76   ]
  77 - Response: User’s nickname
  78
  79 ## `POST /api/pleroma/admin/users/follow`
  80
  81 ### Make a user follow another user
  82
  83 - Params:
  84   - `follower`: The nickname of the follower
  85   - `followed`: The nickname of the followed
  86 - Response:
  87   - "ok"
  88
  89 ## `POST /api/pleroma/admin/users/unfollow`
  90
  91 ### Make a user unfollow another user
  92
  93 - Params:
  94   - `follower`: The nickname of the follower
  95   - `followed`: The nickname of the followed
  96 - Response:
  97   - "ok"
  98
  99 ## `PATCH /api/pleroma/admin/users/:nickname/toggle_activation`
 100
 101 ### Toggle user activation
 102
 103 - Params:
 104   - `nickname`
 105 - Response: User’s object
 106
 107 ```json
 108 {
 109   "deactivated": bool,
 110   "id": integer,
 111   "nickname": string
 112 }
 113 ```
 114
 115 ## `PUT /api/pleroma/admin/users/tag`
 116
 117 ### Tag a list of users
 118
 119 - Params:
 120   - `nicknames` (array)
 121   - `tags` (array)
 122
 123 ## `DELETE /api/pleroma/admin/users/tag`
 124
 125 ### Untag a list of users
 126
 127 - Params:
 128   - `nicknames` (array)
 129   - `tags` (array)
 130
 131 ## `GET /api/pleroma/admin/users/:nickname/permission_group`
 132
 133 ### Get user user permission groups membership
 134
 135 - Params: none
 136 - Response:
 137
 138 ```json
 139 {
 140   "is_moderator": bool,
 141   "is_admin": bool
 142 }
 143 ```
 144
 145 ## `GET /api/pleroma/admin/users/:nickname/permission_group/:permission_group`
 146
 147 Note: Available `:permission_group` is currently moderator and admin. 404 is returned when the permission group doesn’t exist.
 148
 149 ### Get user user permission groups membership per permission group
 150
 151 - Params: none
 152 - Response:
 153
 154 ```json
 155 {
 156   "is_moderator": bool,
 157   "is_admin": bool
 158 }
 159 ```
 160
 161 ## DEPRECATED `POST /api/pleroma/admin/users/:nickname/permission_group/:permission_group`
 162
 163 ### Add user to permission group
 164
 165 - Params: none
 166 - Response:
 167   - On failure: `{"error": "…"}`
 168   - On success: JSON of the user
 169
 170 ## `POST /api/pleroma/admin/users/permission_group/:permission_group`
 171
 172 ### Add users to permission group
 173
 174 - Params:
 175   - `nicknames`: nicknames array
 176 - Response:
 177   - On failure: `{"error": "…"}`
 178   - On success: JSON of the user
 179
 180 ## DEPRECATED `DELETE /api/pleroma/admin/users/:nickname/permission_group/:permission_group`
 181
 182 ## `DELETE /api/pleroma/admin/users/:nickname/permission_group/:permission_group`
 183
 184 ### Remove user from permission group
 185
 186 - Params: none
 187 - Response:
 188   - On failure: `{"error": "…"}`
 189   - On success: JSON of the user
 190 - Note: An admin cannot revoke their own admin status.
 191
 192 ## `DELETE /api/pleroma/admin/users/permission_group/:permission_group`
 193
 194 ### Remove users from permission group
 195
 196 - Params:
 197   - `nicknames`: nicknames array
 198 - Response:
 199   - On failure: `{"error": "…"}`
 200   - On success: JSON of the user
 201 - Note: An admin cannot revoke their own admin status.
 202
 203 ## `PATCH /api/pleroma/admin/users/activate`
 204
 205 ### Activate user
 206
 207 - Params:
 208   - `nicknames`: nicknames array
 209 - Response:
 210
 211 ```json
 212 {
 213   users: [
 214     {
 215       // user object
 216     }
 217   ]
 218 }
 219 ```
 220
 221 ## `PATCH /api/pleroma/admin/users/deactivate`
 222
 223 ### Deactivate user
 224
 225 - Params:
 226   - `nicknames`: nicknames array
 227 - Response:
 228
 229 ```json
 230 {
 231   users: [
 232     {
 233       // user object
 234     }
 235   ]
 236 }
 237 ```
 238
 239 ## DEPRECATED `PATCH /api/pleroma/admin/users/:nickname/activation_status`
 240
 241 ### Active or deactivate a user
 242
 243 - Params:
 244   - `nickname`
 245   - `status` BOOLEAN field, false value means deactivation.
 246
 247 ## `GET /api/pleroma/admin/users/:nickname_or_id`
 248
 249 ### Retrive the details of a user
 250
 251 - Params:
 252   - `nickname` or `id`
 253 - Response:
 254   - On failure: `Not found`
 255   - On success: JSON of the user
 256
 257 ## `GET /api/pleroma/admin/users/:nickname_or_id/statuses`
 258
 259 ### Retrive user's latest statuses
 260
 261 - Params:
 262   - `nickname` or `id`
 263   - *optional* `page_size`: number of statuses to return (default is `20`)
 264   - *optional* `godmode`: `true`/`false` – allows to see private statuses
 265 - Response:
 266   - On failure: `Not found`
 267   - On success: JSON array of user's latest statuses
 268
 269 ## `POST /api/pleroma/admin/relay`
 270
 271 ### Follow a Relay
 272
 273 - Params:
 274   - `relay_url`
 275 - Response:
 276   - On success: URL of the followed relay
 277
 278 ## `DELETE /api/pleroma/admin/relay`
 279
 280 ### Unfollow a Relay
 281
 282 - Params:
 283   - `relay_url`
 284 - Response:
 285   - On success: URL of the unfollowed relay
 286
 287 ## `GET /api/pleroma/admin/relay`
 288
 289 ### List Relays
 290
 291 - Params: none
 292 - Response:
 293   - On success: JSON array of relays
 294
 295 ## `POST /api/pleroma/admin/users/invite_token`
 296
 297 ### Create an account registration invite token
 298
 299 - Params:
 300   - *optional* `max_use` (integer)
 301   - *optional* `expires_at` (date string e.g. "2019-04-07")
 302 - Response:
 303
 304 ```json
 305 {
 306   "id": integer,
 307   "token": string,
 308   "used": boolean,
 309   "expires_at": date,
 310   "uses": integer,
 311   "max_use": integer,
 312   "invite_type": string (possible values: `one_time`, `reusable`, `date_limited`, `reusable_date_limited`)
 313 }
 314 ```
 315
 316 ## `GET /api/pleroma/admin/users/invites`
 317
 318 ### Get a list of generated invites
 319
 320 - Params: none
 321 - Response:
 322
 323 ```json
 324 {
 325
 326   "invites": [
 327     {
 328       "id": integer,
 329       "token": string,
 330       "used": boolean,
 331       "expires_at": date,
 332       "uses": integer,
 333       "max_use": integer,
 334       "invite_type": string (possible values: `one_time`, `reusable`, `date_limited`, `reusable_date_limited`)
 335     },
 336     ...
 337   ]
 338 }
 339 ```
 340
 341 ## `POST /api/pleroma/admin/users/revoke_invite`
 342
 343 ### Revoke invite by token
 344
 345 - Params:
 346   - `token`
 347 - Response:
 348
 349 ```json
 350 {
 351   "id": integer,
 352   "token": string,
 353   "used": boolean,
 354   "expires_at": date,
 355   "uses": integer,
 356   "max_use": integer,
 357   "invite_type": string (possible values: `one_time`, `reusable`, `date_limited`, `reusable_date_limited`)
 358
 359 }
 360 ```
 361
 362 ## `POST /api/pleroma/admin/users/email_invite`
 363
 364 ### Sends registration invite via email
 365
 366 - Params:
 367   - `email`
 368   - `name`, optional
 369
 370 ## `GET /api/pleroma/admin/users/:nickname/password_reset`
 371
 372 ### Get a password reset token for a given nickname
 373
 374 - Params: none
 375 - Response:
 376
 377 ```json
 378 {
 379   "token": "base64 reset token",
 380   "link": "https://pleroma.social/api/pleroma/password_reset/url-encoded-base64-token"
 381 }
 382 ```
 383
 384 ## `PATCH /api/pleroma/admin/users/force_password_reset`
 385
 386 ### Force passord reset for a user with a given nickname
 387
 388 - Params:
 389   - `nicknames`
 390 - Response: none (code `204`)
 391
 392 ## `GET /api/pleroma/admin/reports`
 393
 394 ### Get a list of reports
 395
 396 - Params:
 397   - *optional* `state`: **string** the state of reports. Valid values are `open`, `closed` and `resolved`
 398   - *optional* `limit`: **integer** the number of records to retrieve
 399   - *optional* `page`: **integer** page number
 400   - *optional* `page_size`: **integer** number of log entries per page (default is `50`)
 401 - Response:
 402   - On failure: 403 Forbidden error `{"error": "error_msg"}` when requested by anonymous or non-admin
 403   - On success: JSON, returns a list of reports, where:
 404     - `account`: the user who has been reported
 405     - `actor`: the user who has sent the report
 406     - `statuses`: list of statuses that have been included to the report
 407
 408 ```json
 409 {
 410   "totalReports" : 1,
 411   "reports": [
 412     {
 413       "account": {
 414         "acct": "user",
 415         "avatar": "https://pleroma.example.org/images/avi.png",
 416         "avatar_static": "https://pleroma.example.org/images/avi.png",
 417         "bot": false,
 418         "created_at": "2019-04-23T17:32:04.000Z",
 419         "display_name": "User",
 420         "emojis": [],
 421         "fields": [],
 422         "followers_count": 1,
 423         "following_count": 1,
 424         "header": "https://pleroma.example.org/images/banner.png",
 425         "header_static": "https://pleroma.example.org/images/banner.png",
 426         "id": "9i6dAJqSGSKMzLG2Lo",
 427         "locked": false,
 428         "note": "",
 429         "pleroma": {
 430           "confirmation_pending": false,
 431           "hide_favorites": true,
 432           "hide_followers": false,
 433           "hide_follows": false,
 434           "is_admin": false,
 435           "is_moderator": false,
 436           "relationship": {},
 437           "tags": []
 438         },
 439         "source": {
 440           "note": "",
 441           "pleroma": {},
 442           "sensitive": false
 443         },
 444         "tags": ["force_unlisted"],
 445         "statuses_count": 3,
 446         "url": "https://pleroma.example.org/users/user",
 447         "username": "user"
 448       },
 449       "actor": {
 450         "acct": "lain",
 451         "avatar": "https://pleroma.example.org/images/avi.png",
 452         "avatar_static": "https://pleroma.example.org/images/avi.png",
 453         "bot": false,
 454         "created_at": "2019-03-28T17:36:03.000Z",
 455         "display_name": "Roger Braun",
 456         "emojis": [],
 457         "fields": [],
 458         "followers_count": 1,
 459         "following_count": 1,
 460         "header": "https://pleroma.example.org/images/banner.png",
 461         "header_static": "https://pleroma.example.org/images/banner.png",
 462         "id": "9hEkA5JsvAdlSrocam",
 463         "locked": false,
 464         "note": "",
 465         "pleroma": {
 466           "confirmation_pending": false,
 467           "hide_favorites": false,
 468           "hide_followers": false,
 469           "hide_follows": false,
 470           "is_admin": false,
 471           "is_moderator": false,
 472           "relationship": {},
 473           "tags": []
 474         },
 475         "source": {
 476           "note": "",
 477           "pleroma": {},
 478           "sensitive": false
 479         },
 480         "tags": ["force_unlisted"],
 481         "statuses_count": 1,
 482         "url": "https://pleroma.example.org/users/lain",
 483         "username": "lain"
 484       },
 485       "content": "Please delete it",
 486       "created_at": "2019-04-29T19:48:15.000Z",
 487       "id": "9iJGOv1j8hxuw19bcm",
 488       "state": "open",
 489       "statuses": [
 490         {
 491           "account": { ... },
 492           "application": {
 493             "name": "Web",
 494             "website": null
 495           },
 496           "bookmarked": false,
 497           "card": null,
 498           "content": "<span class=\"h-card\"><a data-user=\"9hEkA5JsvAdlSrocam\" class=\"u-url mention\" href=\"https://pleroma.example.org/users/lain\">@<span>lain</span></a></span> click on my link <a href=\"https://www.google.com/\">https://www.google.com/</a>",
 499           "created_at": "2019-04-23T19:15:47.000Z",
 500           "emojis": [],
 501           "favourited": false,
 502           "favourites_count": 0,
 503           "id": "9i6mQ9uVrrOmOime8m",
 504           "in_reply_to_account_id": null,
 505           "in_reply_to_id": null,
 506           "language": null,
 507           "media_attachments": [],
 508           "mentions": [
 509             {
 510               "acct": "lain",
 511               "id": "9hEkA5JsvAdlSrocam",
 512               "url": "https://pleroma.example.org/users/lain",
 513               "username": "lain"
 514             },
 515             {
 516               "acct": "user",
 517               "id": "9i6dAJqSGSKMzLG2Lo",
 518               "url": "https://pleroma.example.org/users/user",
 519               "username": "user"
 520             }
 521           ],
 522           "muted": false,
 523           "pinned": false,
 524           "pleroma": {
 525             "content": {
 526               "text/plain": "@lain click on my link https://www.google.com/"
 527             },
 528             "conversation_id": 28,
 529             "in_reply_to_account_acct": null,
 530             "local": true,
 531             "spoiler_text": {
 532               "text/plain": ""
 533             }
 534           },
 535           "reblog": null,
 536           "reblogged": false,
 537           "reblogs_count": 0,
 538           "replies_count": 0,
 539           "sensitive": false,
 540           "spoiler_text": "",
 541           "tags": [],
 542           "uri": "https://pleroma.example.org/objects/8717b90f-8e09-4b58-97b0-e3305472b396",
 543           "url": "https://pleroma.example.org/notice/9i6mQ9uVrrOmOime8m",
 544           "visibility": "direct"
 545         }
 546       ]
 547     }
 548   ]
 549 }
 550 ```
 551
 552 ## `GET /api/pleroma/admin/grouped_reports`
 553
 554 ### Get a list of reports, grouped by status
 555
 556 - Params: none
 557 - On success: JSON, returns a list of reports, where:
 558   - `date`: date of the latest report
 559   - `account`: the user who has been reported (see `/api/pleroma/admin/reports` for reference)
 560   - `status`: reported status (see `/api/pleroma/admin/reports` for reference)
 561   - `actors`: users who had reported this status (see `/api/pleroma/admin/reports` for reference)
 562   - `reports`: reports (see `/api/pleroma/admin/reports` for reference)
 563
 564 ```json
 565   "reports": [
 566     {
 567       "date": "2019-10-07T12:31:39.615149Z",
 568       "account": { ... },
 569       "status": { ... },
 570       "actors": [{ ... }, { ... }],
 571       "reports": [{ ... }]
 572     }
 573   ]
 574 ```
 575
 576 ## `GET /api/pleroma/admin/reports/:id`
 577
 578 ### Get an individual report
 579
 580 - Params:
 581   - `id`
 582 - Response:
 583   - On failure:
 584     - 403 Forbidden `{"error": "error_msg"}`
 585     - 404 Not Found `"Not found"`
 586   - On success: JSON, Report object (see above)
 587
 588 ## `PATCH /api/pleroma/admin/reports`
 589
 590 ### Change the state of one or multiple reports
 591
 592 - Params:
 593
 594 ```json
 595   `reports`: [
 596     {
 597       `id`, // required, report id
 598       `state` // required, the new state. Valid values are `open`, `closed` and `resolved`
 599     },
 600     ...
 601   ]
 602 ```
 603
 604 - Response:
 605   - On failure:
 606     - 400 Bad Request, JSON:
 607
 608     ```json
 609       [
 610         {
 611           `id`, // report id
 612           `error` // error message
 613         }
 614       ]
 615     ```
 616
 617   - On success: `204`, empty response
 618
 619 ## `POST /api/pleroma/admin/reports/:id/respond`
 620
 621 ### Respond to a report
 622
 623 - Params:
 624   - `id`
 625   - `status`: required, the message
 626 - Response:
 627   - On failure:
 628     - 400 Bad Request `"Invalid parameters"` when `status` is missing
 629     - 403 Forbidden `{"error": "error_msg"}`
 630     - 404 Not Found `"Not found"`
 631   - On success: JSON, created Mastodon Status entity
 632
 633 ```json
 634 {
 635   "account": { ... },
 636   "application": {
 637     "name": "Web",
 638     "website": null
 639   },
 640   "bookmarked": false,
 641   "card": null,
 642   "content": "Your claim is going to be closed",
 643   "created_at": "2019-05-11T17:13:03.000Z",
 644   "emojis": [],
 645   "favourited": false,
 646   "favourites_count": 0,
 647   "id": "9ihuiSL1405I65TmEq",
 648   "in_reply_to_account_id": null,
 649   "in_reply_to_id": null,
 650   "language": null,
 651   "media_attachments": [],
 652   "mentions": [
 653     {
 654       "acct": "user",
 655       "id": "9i6dAJqSGSKMzLG2Lo",
 656       "url": "https://pleroma.example.org/users/user",
 657       "username": "user"
 658     },
 659     {
 660       "acct": "admin",
 661       "id": "9hEkA5JsvAdlSrocam",
 662       "url": "https://pleroma.example.org/users/admin",
 663       "username": "admin"
 664     }
 665   ],
 666   "muted": false,
 667   "pinned": false,
 668   "pleroma": {
 669     "content": {
 670       "text/plain": "Your claim is going to be closed"
 671     },
 672     "conversation_id": 35,
 673     "in_reply_to_account_acct": null,
 674     "local": true,
 675     "spoiler_text": {
 676       "text/plain": ""
 677     }
 678   },
 679   "reblog": null,
 680   "reblogged": false,
 681   "reblogs_count": 0,
 682   "replies_count": 0,
 683   "sensitive": false,
 684   "spoiler_text": "",
 685   "tags": [],
 686   "uri": "https://pleroma.example.org/objects/cab0836d-9814-46cd-a0ea-529da9db5fcb",
 687   "url": "https://pleroma.example.org/notice/9ihuiSL1405I65TmEq",
 688   "visibility": "direct"
 689 }
 690 ```
 691
 692 ## `PUT /api/pleroma/admin/statuses/:id`
 693
 694 ### Change the scope of an individual reported status
 695
 696 - Params:
 697   - `id`
 698   - `sensitive`: optional, valid values are `true` or `false`
 699   - `visibility`: optional, valid values are `public`, `private` and `unlisted`
 700 - Response:
 701   - On failure:
 702     - 400 Bad Request `"Unsupported visibility"`
 703     - 403 Forbidden `{"error": "error_msg"}`
 704     - 404 Not Found `"Not found"`
 705   - On success: JSON, Mastodon Status entity
 706
 707 ## `DELETE /api/pleroma/admin/statuses/:id`
 708
 709 ### Delete an individual reported status
 710
 711 - Params:
 712   - `id`
 713 - Response:
 714   - On failure:
 715     - 403 Forbidden `{"error": "error_msg"}`
 716     - 404 Not Found `"Not found"`
 717   - On success: 200 OK `{}`
 718
 719 ## `GET /api/pleroma/admin/config/migrate_to_db`
 720
 721 ### Run mix task pleroma.config migrate_to_db
 722
 723 Copy settings on key `:pleroma` to DB.
 724
 725 - Params: none
 726 - Response:
 727
 728 ```json
 729 {}
 730 ```
 731
 732 ## `GET /api/pleroma/admin/config/migrate_from_db`
 733
 734 ### Run mix task pleroma.config migrate_from_db
 735
 736 Copy all settings from DB to `config/prod.exported_from_db.secret.exs` with deletion from DB.
 737
 738 - Method `GET`
 739 - Params: none
 740 - Response:
 741
 742 ```json
 743 {}
 744 ```
 745
 746 ## `GET /api/pleroma/admin/config`
 747
 748 ### List config settings
 749
 750 List config settings only works with `:pleroma => :instance => :dynamic_configuration` setting to `true`.
 751
 752 - Params: none
 753 - Response:
 754
 755 ```json
 756 {
 757   configs: [
 758     {
 759       "group": string,
 760       "key": string or string with leading `:` for atoms,
 761       "value": string or {} or [] or {"tuple": []}
 762      }
 763   ]
 764 }
 765 ```
 766
 767 ## `POST /api/pleroma/admin/config`
 768
 769 ### Update config settings
 770
 771 Updating config settings only works with `:pleroma => :instance => :dynamic_configuration` setting to `true`.
 772 Module name can be passed as string, which starts with `Pleroma`, e.g. `"Pleroma.Upload"`.
 773 Atom keys and values can be passed with `:` in the beginning, e.g. `":upload"`.
 774 Tuples can be passed as `{"tuple": ["first_val", Pleroma.Module, []]}`.
 775 `{"tuple": ["some_string", "Pleroma.Some.Module", []]}` will be converted to `{"some_string", Pleroma.Some.Module, []}`.
 776 Keywords can be passed as lists with 2 child tuples, e.g.
 777 `[{"tuple": ["first_val", Pleroma.Module]}, {"tuple": ["second_val", true]}]`.
 778
 779 If value contains list of settings `[subkey: val1, subkey2: val2, subkey3: val3]`, it's possible to remove only subkeys instead of all settings passing `subkeys` parameter. E.g.:
 780 {"group": "pleroma", "key": "some_key", "delete": "true", "subkeys": [":subkey", ":subkey3"]}.
 781
 782 Compile time settings (need instance reboot):
 783 - all settings by this keys:
 784   - `:hackney_pools`
 785   - `:chat`
 786   - `Pleroma.Web.Endpoint`
 787   - `Pleroma.Repo`
 788 - part settings:
 789   - `Pleroma.Captcha` -> `:seconds_valid`
 790   - `Pleroma.Upload` -> `:proxy_remote`
 791   - `:instance` -> `:upload_limit`
 792
 793 - Params:
 794   - `configs` => [
 795     - `group` (string)
 796     - `key` (string or string with leading `:` for atoms)
 797     - `value` (string, [], {} or {"tuple": []})
 798     - `delete` = true (optional, if parameter must be deleted)
 799     - `subkeys` [(string with leading `:` for atoms)] (optional, works only if `delete=true` parameter is passed, otherwise will be ignored)
 800   ]
 801
 802 - Request (example):
 803
 804 ```json
 805 {
 806   configs: [
 807     {
 808       "group": "pleroma",
 809       "key": "Pleroma.Upload",
 810       "value": [
 811         {"tuple": [":uploader", "Pleroma.Uploaders.Local"]},
 812         {"tuple": [":filters", ["Pleroma.Upload.Filter.Dedupe"]]},
 813         {"tuple": [":link_name", true]},
 814         {"tuple": [":proxy_remote", false]},
 815         {"tuple": [":proxy_opts", [
 816           {"tuple": [":redirect_on_failure", false]},
 817           {"tuple": [":max_body_length", 1048576]},
 818           {"tuple": [":http": [
 819             {"tuple": [":follow_redirect", true]},
 820             {"tuple": [":pool", ":upload"]},
 821           ]]}
 822         ]
 823         ]},
 824         {"tuple": [":dispatch", {
 825           "tuple": ["/api/v1/streaming", "Pleroma.Web.MastodonAPI.WebsocketHandler", []]
 826         }]}
 827       ]
 828     }
 829   ]
 830 }
 831 ```
 832
 833 - Response:
 834
 835 ```json
 836 {
 837   configs: [
 838     {
 839       "group": string,
 840       "key": string or string with leading `:` for atoms,
 841       "value": string or {} or [] or {"tuple": []}
 842      }
 843   ]
 844 }
 845 ```
 846
 847 ## `GET /api/pleroma/admin/moderation_log`
 848
 849 ### Get moderation log
 850
 851 - Params:
 852   - *optional* `page`: **integer** page number
 853   - *optional* `page_size`: **integer** number of log entries per page (default is `50`)
 854   - *optional* `start_date`: **datetime (ISO 8601)** filter logs by creation date, start from `start_date`. Accepts datetime in ISO 8601 format (YYYY-MM-DDThh:mm:ss), e.g. `2005-08-09T18:31:42`
 855   - *optional* `end_date`: **datetime (ISO 8601)** filter logs by creation date, end by from `end_date`. Accepts datetime in ISO 8601 format (YYYY-MM-DDThh:mm:ss), e.g. 2005-08-09T18:31:42
 856   - *optional* `user_id`: **integer** filter logs by actor's id
 857   - *optional* `search`: **string** search logs by the log message
 858 - Response:
 859
 860 ```json
 861 [
 862   {
 863     "data": {
 864       "actor": {
 865         "id": 1,
 866         "nickname": "lain"
 867       },
 868       "action": "relay_follow"
 869     },
 870     "time": 1502812026, // timestamp
 871     "message": "[2017-08-15 15:47:06] @nick0 followed relay: https://example.org/relay" // log message
 872   }
 873 ]
 874 ```
 875
 876 ## `POST /api/pleroma/admin/reload_emoji`
 877
 878 ### Reload the instance's custom emoji
 879
 880 - Authentication: required
 881 - Params: None
 882 - Response: JSON, "ok" and 200 status