{"slug":"mastodon-api","name":"Mastodon API","host":"mastodon.social","site":"https://mastodon.social","category":"social","docsUrl":null,"sources":[{"kind":"changelog","url":"https://raw.githubusercontent.com/mastodon/mastodon/main/CHANGELOG.md"},{"kind":"archive","url":"https://docs.joinmastodon.org/methods/accounts/"},{"kind":"archive","url":"https://docs.joinmastodon.org/methods/filters/"},{"kind":"archive","url":"https://docs.joinmastodon.org/methods/instance/"},{"kind":"archive","url":"https://docs.joinmastodon.org/methods/media/"},{"kind":"archive","url":"https://docs.joinmastodon.org/methods/suggestions/"},{"kind":"archive","url":"https://docs.joinmastodon.org/methods/trends/"}],"url":"https://www.okapi.bot/providers/mastodon-api/","json":"https://www.okapi.bot/api/v1/providers/mastodon-api.json","breakingChanges":[{"slug":"get-api-v1-instance-is-deprecated","api":"mastodon-api","title":"GET /api/v1/instance is deprecated","kind":"version_retirement","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":null,"scope":null,"calls":["GET /api/v1/instance"],"method":"GET","path":"/api/v1/instance","source":{"url":"https://docs.joinmastodon.org/methods/instance/","kind":"archive"},"quote":"View server information (v1) deprecated GET /api/v1/instance HTTP / 1.1 Obtain general information about the server. See api/v2/instance instead.","migration":"Call GET /api/v2/instance.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:21:59.970Z","updatedAt":"2026-10-23T10:21:59.970Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/mastodon-api/breaking-changes/get-api-v1-instance-is-deprecated/"},{"slug":"get-api-v1-suggestions-is-deprecated","api":"mastodon-api","title":"GET /api/v1/suggestions is deprecated","kind":"version_retirement","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":null,"scope":null,"calls":["GET /api/v1/suggestions"],"method":"GET","path":"/api/v1/suggestions","source":{"url":"https://docs.joinmastodon.org/methods/suggestions/","kind":"archive"},"quote":"View follow suggestions (v1) deprecated GET /api/v1/suggestions HTTP / 1.1","migration":"Call GET /api/v2/suggestions.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:22:05.714Z","updatedAt":"2026-10-23T10:22:05.714Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/mastodon-api/breaking-changes/get-api-v1-suggestions-is-deprecated/"},{"slug":"get-api-v1-trends-is-deprecated","api":"mastodon-api","title":"GET /api/v1/trends is deprecated","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":null,"scope":null,"calls":["GET /api/v1/trends"],"method":"GET","path":"/api/v1/trends","source":{"url":"https://docs.joinmastodon.org/methods/trends/","kind":"archive"},"quote":"method signature changed from GET /api/v1/trends to GET /api/v1/trends/tags . The former is a deprecated alias that may be removed in the future.","migration":"Call GET /api/v1/trends/tags.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:22:07.659Z","updatedAt":"2026-10-23T10:22:07.659Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/mastodon-api/breaking-changes/get-api-v1-trends-is-deprecated/"},{"slug":"post-api-v1-accounts-is-deprecated","api":"mastodon-api","title":"POST /api/v1/accounts is deprecated","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":null,"scope":null,"calls":["POST /api/v1/accounts"],"method":"POST","path":"/api/v1/accounts","source":{"url":"https://docs.joinmastodon.org/methods/accounts/","kind":"archive"},"quote":"5.0.0 - deprecated in favor of the OAuth sign-up flow","migration":"Send users through the OAuth sign-up flow (GET /oauth/authorize) instead of registering accounts by API.","migrationChange":null,"needsDecision":"Moving sign-up into the OAuth flow changes the app's onboarding, not only a call.","text":null,"publishedAt":"2026-10-23T10:22:09.591Z","updatedAt":"2026-10-23T10:22:09.591Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/mastodon-api/breaking-changes/post-api-v1-accounts-is-deprecated/"},{"slug":"post-api-v1-media-is-deprecated","api":"mastodon-api","title":"POST /api/v1/media is deprecated","kind":"version_retirement","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":null,"scope":null,"calls":["POST /api/v1/media"],"method":"POST","path":"/api/v1/media","source":{"url":"https://docs.joinmastodon.org/methods/media/","kind":"archive"},"quote":"3.1.3 - deprecated in favor of POST /api/v2/media , which is equal to v1 in all aspects, except it returns HTTP 202","migration":"Upload with POST /api/v2/media and poll GET /api/v1/media/{id} until the url is set.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:22:03.837Z","updatedAt":"2026-10-23T10:22:03.837Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/mastodon-api/breaking-changes/post-api-v1-media-is-deprecated/"},{"slug":"the-v1-filters-api-is-deprecated","api":"mastodon-api","title":"The v1 filters API is deprecated","kind":"version_retirement","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":null,"scope":null,"calls":["/api/v1/filters*"],"method":null,"path":"/api/v1/filters*","source":{"url":"https://docs.joinmastodon.org/methods/filters/","kind":"archive"},"quote":"View your filters deprecated GET /api/v1/filters HTTP / 1.1 Returns: List of V1::Filter OAuth: User token + read:filters Version history: 2.4.3 - added 4.0.0 - deprecated.","migration":"Manage filters with the v2 filters API (/api/v2/filters).","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:22:01.859Z","updatedAt":"2026-10-23T10:22:01.859Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/mastodon-api/breaking-changes/the-v1-filters-api-is-deprecated/"}]}