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
• 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

unreleased

• 4.4 annual reports API Add year in review feature to web UI mastodon#32709

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
  • 4.3.0 removed entirely

---

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
• attribution domains

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

[ThisIsMissEm]

@trwnh we can remove all references to crypto from this todo list, as we completely removed crypto APIs for 4.3.0 — e.g., /api/v1/crypto (the scope has already been removed)

[trwnh]

@ThisIsMissEm there's only one reference and it's to note that it was added in 3.2.0 but commented out. i guess if we ever do document it we can then say it was removed entirely in 4.3.0? maybe just a link to the PR will suffice for interested people

[ThisIsMissEm]

@trwnh I would not bother documenting it: it was never used anywhere, never documented, never promoted, and I'm not sure if we even knew if it was feature complete?

[trwnh]

@ThisIsMissEm "documenting" in this case doesn't have to be full API docs, it could just be a one-line mention that this existed at some point even if never used. think of it as a sort of "historical footnote"

[ThisIsMissEm]

@trwnh yeah, and I'm saying that I don't think we even need that footnote for something that was never ready for use. No client support unless you somehow found it in the codebase, and even then it wasn't clear how you actually used it. Additionally adding it now may conflict with potential E2EE from the taskforce on that.

[ThisIsMissEm]

Maybe here we could add a line about deprecating that crypto scope though? https://docs.joinmastodon.org/api/oauth-scopes/#versions