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