currently undocumented

[trwnh]

webhooks

• 4.0.0 admin webhooks Add administrative webhooks mastodon#18510
• 4.1.0 account.approved webhook Add webhook account.approved mastodon#22938
• 4.2.0 report.updated Add report.updated webhook mastodon#24211

api

• 4.1.0 hide_collections param on PATCH account/update_credentials Allow changing hide_collections setting with the api mastodon#22790
• 4.1.0 roles on Account entity Add roles attribute to Account entities in REST API mastodon#23255
  • Incorrect handling of "highlighted" property on a "role" mastodon#28327
• 4.1.0 requested_by on Relationship entity Add follow request banner on account header mastodon#20785
• 4.1.0 policy on WebPushSubscription entity Add missing policy attribute to WebPushSubscriptionSerializer mastodon#23210
• 4.1.0 reading:autoplay:gifs on api/v1/preferences (but not update_credentials?) https://github.com/mastodon/mastodon/pull/22706/files
• 4.1.0 use RoleSerializer for Admin::Account Fix unserialized role on account entities in admin API mastodon#23290
  • Incorrect handling of "highlighted" property on a "role" mastodon#28327
• 4.1.0 notifications limit raised from 15/30 to 40/80 Change notifications per page from 15 to 40 in REST API mastodon#23348
• 4.1.0 api rate limit per account 300 -> 1500 (new limit 300 per token) Change rate limits to 1,500/5m per user, 300/5m per app mastodon#23347
• 4.1.0 streaming/metrics Add metrics endpoint to streaming API mastodon#23388
• 4.1.0 configuration.urls.status on api/v2/instance (the changelog is wrong, it claims v1 instead) Add setting for status page URL mastodon#23390
• 4.1.0 PUT /api/v1/statuses/:id now takes an extra media_attributes[] array parameter with the id of the updated media and their updated description, focus, and thumbnail Add support for editing media description and focus point of already-posted statuses mastodon#20878
• 4.2 safeguard_mentions on POST /api/v1/statuses Add API parameter to safeguard unexpect mentions in new posts mastodon#18350
• 4.2 memorial on Account entity Add memorial attribute to REST API mastodon#23591
• 4.2 trends management api Add trend management to admin API mastodon#24257
• 4.2 statuses/:id/history now returns at least one item when status is edited (the latest edit, at least) Change /api/v1/statuses/:id/history to always return at least one item mastodon#25510
• 4.2 mark conversation unread Add POST /api/v1/conversations/:id/unread mastodon#25509
• 4.2 forward_to_domains on POST /api/v1/reports Add forward_to_domains parameter to POST /api/v1/reports mastodon#25866
• 4.2 api/v1/instance/languages Add GET /api/v1/instance/languages to REST API mastodon#24443
• 4.2 CredentialAccount entity now includes more params Add hide_collections, discoverable and indexable attributes to credentials API mastodon#26998

unreleased

• 4.3 hide_collections on Account entity (used to show a different placeholder text) Fix Web UI not displaying appropriate explanation when a user hides their follows/followers mastodon#27791
• 4.3 allow_with_approval on email_domain_blocks API Add ability to require approval when users sign up using specific email domains mastodon#28468
• 4.3 Add api/v1/annual_reports Add annual reports for accounts mastodon#28693
• 4.3 Add digest to admin/domain_blocks Return domain block digests from admin domain blocks API mastodon#29092
• 4.3 sources property on api/v2/suggestions Change source attribute of Suggestion entity in /api/v2/suggestions back to a string mastodon#29108
• 4.3 notification requests and policies Add notification policies and notification requests mastodon#29366
  • 4.3 notification policies v2 Revamp notification policy options mastodon#31343
• 4.3 api/v1/timelines/link Add timeline of public posts about a trending link to REST API mastodon#30381
• 4.3 filtered attribute on notifications Add optional filtered attribute to notification entities in REST API mastodon#31011

things to test / document

• setting an invalid in_reply_to_id when doing POST /api/v1/statuses "Publish new status" docs don't specify possible error messages mastodon#13473

env

• 4.1.0 SIDEKIQ_CONCURRENCY Add environment variable to configure sidekiq concurrency mastodon#19589
• 4.1.0 DB_POOL Add database pool configuration over DB_POOL to streaming API mastodon#23470
• 4.1.0 MIN_THREADS Add ability to set minimum Puma threads with MIN_THREADS environment variable mastodon#21048

tootctl

• 4.1.0 media remove has new flags Add command to remove avatar and header images of inactive remote accounts from the local database mastodon#22149
• 4.1.0 accounts delete has new flags Add --email and --dry-run options to tootctl accounts delete mastodon#22328
• 4.1.0 accounts migrate Add tootctl accounts migrate mastodon#22330
• 4.1.0 accounts prune Implement tootctl accounts prune mastodon#18397
• 4.1.0 domains purge Add tootctl domains purge options to select subdomains and keep domain blocks mastodon#22063
• 4.2 new option for ip_blocks tootctl Add ability to block sign-ups from IP using the CLI mastodon#24870
• 4.2 tootctl accounts create has new flag --approve tootctl: add --approve option to tootctl accounts create mastodon#24533
• 4.2 tootctl accounts approve --number sorting was not guaranteed; now it is Fix tootctl accounts approve --number N not aproving N earliest registrations mastodon#24605

???

• 3.3.0 object storage failure now returns 503 in some API methods
• 3.2.0 /api/v1/crypto added but commented out

---

user guide

• "lock account" is now "require follow requests"
• "list this account on the directory" is now "suggest account to others"
• "hide your network" is now "hide your social graph"
• change order of dropdown menu on posts to be more intuitive in web UI
• change option labels on edit profile page
• change max image dimensions (previously 1280px square, then 1920x1080 unless Change image matrix size limit from 1920×1080px to 4096×4096px mastodon#23322 is merged, but then Change media upload limits and remove client-side resizing mastodon#23726 got merged)
• can now upload webp, wave, avif, heic
• custom emoji limit raised from 50kb to 256kb
• authentication history
• automatically delete old posts
• filter search results by author, using from: syntax
• hint about missing media attachment descriptions
• timed mutes
• private boosts
• explore page
• relationship manager
• hashtag normalization
• full text search params

admin guide

• figure out what's out of date, if any
• 4.0.0 authorized_fetch tips need to be updated?
• figure out SSO stuff
• install guide - prefer SMTP_TLS over SMTP_ENABLE_STARTTLS? SMTP configuration incorrect in installer - with fix mastodon#23180
• OpenID Connect support Allow login through OpenID Connect mastodon#16221

project dev guide

client dev guide

technical

• add CONTRIBUTING.md
• note that mf2 (microformats 2) is removed?
• nodeinfo?
• rss?
• clarify stuff around ld sigs
• clarify update_credentials vs preferences (especially when it comes to changing those values via PUT/PATCH) Link between /api/v1/preferences and /api/v1/accounts/update_credentials #1152
• clarify that ids are not "string representations of numbers" Proposal: Relax the requirement that IDs must be "string representations of numbers" mastodon#25244
• 4.2 toot:indexable flag Add support for indexable attribute on remote actors mastodon#26485
• 4.2 memorial now federates as toot:memorial Add support for federating memorial attribute  mastodon#26583

[andypiper]

@trwnh I started to check a few of these off based on some of the recent doc PRs (thinking the list items could be switched over to checklist items). Thanks for keeping this list here!

[andypiper]

Now switched to checklist format 👍🏻 just for convenience of checking things off as updates are merged.

[ThisIsMissEm]

FYI, I'm tracking all the unreleased OAuth changes in #1445

[ThisIsMissEm]

@colleenpridemore at the bottom of the email from github there's an unsubscribe link, or on web in the sidebar of this issue you can manage your subscription – I can't managed that for you

[ThisIsMissEm]

Docs for 4.3 Add digest to admin/domain_blocks mastodon/mastodon#29092 are in #1417 which is merged.

[ThisIsMissEm]

On 4.1.0 streaming/metrics, I've started docs here, since between 4.1.0 and now, we've switched Streaming to use the proper prometheus module: #1213

I also have a grafana dashboard for Streaming metrics, but I don't know how to make this distributable; but that could go in dist/ in the main repo then

[ThisIsMissEm]

Another undocumented endpoint seems to be Api::V1::Timelines::LinkController at GET /api/v1/timelines/link

[aaaaalbert]

Since 325dc1f, you may tick off CONTRIBUTING.md.

[Reeceeboii]

https://docs.joinmastodon.org/entities/Instance/#registrations

registrations[url] is currently undocumented (/app/serializers/rest/instance_serializer.rb#L106)

[shuuji3]

For reference, the above registrations[url] was introduced by this PR: mastodon/mastodon#25014