Connectors

Social & Media

Mastodon

Decentralized social network: post statuses, manage follows, and read timelines
Mastodon API referenceAPI checked August 17, 2026
Signs in with
API token
Runs on
Cloud or On-Prem Worker
Operations
342
Ready-made triggers
0

Connect Mastodon

  1. In Neblex open Connect › Connections and click New Connection.
  2. Search for Mastodon and give the connection a clear name.
  3. Fill in the fields. Secret values are encrypted and never shown again.
  4. Click Test, then Create Connection.
FieldWhat to enter
Instance hostRequiredYour Mastodon instance host, e.g. mastodon.social.
Access tokenOptionalSecretOAuth access token (user, app, or admin-scoped). Required for Bearer operations and optional for Anonymous public operations; authorized-fetch instances may require Bearer.

Use it in a flow

  1. Open a flow, open the node library and search for Mastodon.
  2. Drag it onto the canvas and choose an Operation and your connection.
  3. Map the operation's fields from earlier steps, or click Map with Matt.
  4. Use Test this step to see what it returns, then save.

To start a flow from Mastodon without a ready-made trigger: a Poll for changes trigger can check one of its list operations on a schedule and pass on only what is new; if Mastodon can send webhooks, a Webhook trigger receives them at its own URL.

Operations

342 operations in 58 groups. Each one is a step you can add to a flow.

Accounts39
Block accountpost_api_v1_accounts__id__blockPOSTBlocks the given account.
Check relationships to other accountsget_api_v1_accounts_relationshipsGETFind out whether a given account is followed, blocked, muted, etc.
Feature account on your profilepost_api_v1_accounts__id__endorsePOSTAdd the given account to the user's featured profiles.
Feature account on your profilepost_api_v1_accounts__id__pinPOSTAdd the given account to the user's featured profiles.
Find familiar followersget_api_v1_accounts_familiar_followersGETObtain a list of all accounts that follow a given account, filtered for accounts you follow.
Follow accountpost_api_v1_accounts__id__followPOSTFollow the given account.
Follow accountpost_api_v1_accounts__id__followFormPOSTFollow the given account.
Get accountget_api_v1_accounts__id_GETView information about a profile.
Get accountget_api_v1_accounts__id_AnonymousGETView information about a profile.
Get account's featured tagsget_api_v1_accounts__id__featured_tagsGETTags featured by this account.
Get account's featured tagsget_api_v1_accounts__id__featured_tagsAnonymousGETTags featured by this account.
Get account's followersget_api_v1_accounts__id__followersGETAccounts which follow the given account, if network is not hidden by the account owner.
Get account's followersget_api_v1_accounts__id__followersAnonymousGETAccounts which follow the given account, if network is not hidden by the account owner.
Get account's followingget_api_v1_accounts__id__followingGETAccounts which the given account is following, if network is not hidden by the account owner.
Get account's followingget_api_v1_accounts__id__followingAnonymousGETAccounts which the given account is following, if network is not hidden by the account owner.
Get account's statusesget_api_v1_accounts__id__statusesGETStatuses posted to the given account.
Get account's statusesget_api_v1_accounts__id__statusesAnonymousGETStatuses posted to the given account.
Get featured accountsget_api_v1_accounts__id__endorsementsGETAccounts that the user is currently featuring on their profile.
Get featured accountsget_api_v1_accounts__id__endorsementsAnonymousGETAccounts that the user is currently featuring on their profile.
Get lists containing this accountget_api_v1_accounts__id__listsGETUser lists that you have added this account to.
Get multiple accountsget_api_v1_accountsGETView information about multiple profiles.
Get multiple accountsget_api_v1_accountsAnonymousGETView information about multiple profiles.
Identity proofsget_api_v1_accounts__id__identity_proofsGETReturns: Array of IdentityProof\
Lookup account ID from WebFinger addressget_api_v1_accounts_lookupGETQuickly lookup a username to see if it is available, skipping WebFinger resolution.
Mute accountpost_api_v1_accounts__id__mutePOSTMute the given account.
Mute accountpost_api_v1_accounts__id__muteFormPOSTMute the given account.
Register an accountpost_api_v1_accountsPOSTCreates a user and account records.
Register an accountpost_api_v1_accountsFormPOSTCreates a user and account records.
Remove account from followerspost_api_v1_accounts__id__remove_from_followersPOSTRemove the given account from your followers.
Search for matching accountsget_api_v1_accounts_searchGETSearch for matching accounts by username or display name.
Set private note on profilepost_api_v1_accounts__id__notePOSTSets a private note on a user.
Set private note on profilepost_api_v1_accounts__id__noteFormPOSTSets a private note on a user.
Unblock accountpost_api_v1_accounts__id__unblockPOSTUnblock the given account.
Unfeature account from profilepost_api_v1_accounts__id__unendorsePOSTRemove the given account from the user's featured profiles.
Unfeature account from profilepost_api_v1_accounts__id__unpinPOSTRemove the given account from the user's featured profiles.
Unfollow accountpost_api_v1_accounts__id__unfollowPOSTUnfollow the given account.
Unmute accountpost_api_v1_accounts__id__unmutePOSTUnmute the given account.
Update account credentialspatch_api_v1_accounts_update_credentialsPATCHUpdate the user's display and preferences.
Verify account credentialsget_api_v1_accounts_verify_credentialsGETTest to make sure that the user token works.
Admin15
Approve a pending accountpost_api_v1_admin_accounts__id__approvePOSTApprove the given local account if it is currently pending approval.
Assign report to selfpost_api_v1_admin_reports__id__assign_to_selfPOSTClaim the handling of this report to yourself.
Enable a currently disabled accountpost_api_v1_admin_accounts__id__enablePOSTRe-enable a local account whose login is currently disabled.
Mark report as resolvedpost_api_v1_admin_reports__id__resolvePOSTMark a report as resolved with no further action taken.
Perform an action against an accountpost_api_v1_admin_accounts__id__actionPOSTPerform an action against an account and log this action in the moderation history.
Perform an action against an accountpost_api_v1_admin_accounts__id__actionFormPOSTPerform an action against an account and log this action in the moderation history.
Reject a pending accountpost_api_v1_admin_accounts__id__rejectPOSTReject the given local account if it is currently pending approval.
Reopen a closed reportpost_api_v1_admin_reports__id__reopenPOSTReopen a currently closed report, if it is closed.
Unassign reportpost_api_v1_admin_reports__id__unassignPOSTUnassign a report so that someone else can claim it.
Unsilence an accountpost_api_v1_admin_accounts__id__unsilencePOSTUnsilence an account if it is currently silenced.
Unsuspend an accountpost_api_v1_admin_accounts__id__unsuspendPOSTUnsuspend a currently suspended account.
View a single reportget_api_v1_admin_reports__id_GETReturns: Admin::Report\
View a specific accountget_api_v1_admin_accounts__id_GETView admin-level information about the given account.
View accounts (v1)get_api_v1_admin_accountsGETView all accounts, optionally matching certain criteria for filtering, up to 100 at a time.
View all reportsget_api_v1_admin_reportsGETView information about all reports.
Admin Accounts3
Delete an accountdelete_api_v1_admin_accounts__id_DELETEPermanently delete data for a suspended account.
Unmark an account as sensitivepost_api_v1_admin_accounts__id__unsensitivePOSTStops marking an account's posts as sensitive, if it was previously flagged as sensitive.
View accounts (v2)get_api_v2_admin_accountsGETView all accounts, optionally matching certain criteria for filtering, up to 100 at a time.
Admin Domain Blocks7
Block a domain from federatingpost_api_v1_admin_domain_blocksPOSTAdd a domain to the list of domains blocked from federating.
Block a domain from federatingpost_api_v1_admin_domain_blocksFormPOSTAdd a domain to the list of domains blocked from federating.
Get a single blocked domainget_api_v1_admin_domain_blocks__id_GETReturns: Admin::DomainBlock\
List all blocked domainsget_api_v1_admin_domain_blocksGETShow information about all blocked domains.
Remove a domain blockdelete_api_v1_admin_domain_blocks__id_DELETELift a block against a domain.
Update a domain blockput_api_v1_admin_domain_blocks__id_PUTChange parameters for an existing domain block.
Update a domain blockput_api_v1_admin_domain_blocks__id_FormPUTChange parameters for an existing domain block.
Admin Reports2
Update a reportput_api_v1_admin_reports__id_PUTChange metadata for a report.
Update a reportput_api_v1_admin_reports__id_FormPUTChange metadata for a report.
Admin Trends3
View trending linksget_api_v1_admin_trends_linksGETLinks that have been shared more than others, including unapproved and unreviewed links.
View trending statusesget_api_v1_admin_trends_statusesGETStatuses that have been interacted with more than others, including unapproved and unreviewed statuses.
View trending tagsget_api_v1_admin_trends_tagsGETTags that are being used more frequently within the past week, including unapproved and unreviewed tags.
Announcements4
Add a reaction to an announcementput_api_v1_announcements__id__reactions__name_PUTReact to an announcement with an emoji.
Dismiss an announcementpost_api_v1_announcements__id__dismissPOSTAllows a user to mark the announcement as read.
Remove a reaction from an announcementdelete_api_v1_announcements__id__reactions__name_DELETEUndo a react emoji to an announcement.
View all announcementsget_api_v1_announcementsGETSee all currently active announcements set by admins.
Annual Reports5
Generate a new annual report {generate}post_api_v1_annual_reports__year__generatePOSTGenerate the user's annual report for the specified year.
Get a single annual reportget_api_v1_annual_reports__year_GETReturns the current user's generated annual report for the given year, if it exists.
Get all annual reportsget_api_v1_annual_reportsGETReturns all of the current user's generated annual reports, if any.
Get the state of an annual reportget_api_v1_annual_reports__year__stateGETReturns the state of the annual report for the current user and given year.
Mark an annual report as readpost_api_v1_annual_reports__year__readPOSTMarks the user's generated annual report for the given year as read.
Apps5
Create an applicationpost_api_v1_appsPOSTCreate a new application to obtain OAuth2 credentials.
Create an applicationpost_api_v1_appsAnonymousPOSTCreate a new application to obtain OAuth2 credentials.
Create an applicationpost_api_v1_appsFormPOSTCreate a new application to obtain OAuth2 credentials.
Create an applicationpost_api_v1_appsFormAnonymousPOSTCreate a new application to obtain OAuth2 credentials.
Verify your app worksget_api_v1_apps_verify_credentialsGETConfirm that the app's OAuth2 credentials work.
Authorize2
Authorize a userget_oauth_authorizeGETDisplays an authorization form to the user.
Authorize a userget_oauth_authorizeAnonymousGETDisplays an authorization form to the user.
Blocks1
View blocked usersget_api_v1_blocksGETReturns your blocked accounts.
Bookmarks1
View bookmarked statusesget_api_v1_bookmarksGETStatuses the user has bookmarked.
Canonical Email Blocks7
Block a canonical emailpost_api_v1_admin_canonical_email_blocksPOSTReturns: Admin::CanonicalEmailBlock\
Block a canonical emailpost_api_v1_admin_canonical_email_blocksFormPOSTReturns: Admin::CanonicalEmailBlock\
Delete a canonical email blockdelete_api_v1_admin_canonical_email_blocks__id_DELETEReturns: Admin::CanonicalEmailBlock\
List all canonical email blocksget_api_v1_admin_canonical_email_blocksGETReturns: Array of Admin::CanonicalEmailBlock\
Show a single canonical email blockget_api_v1_admin_canonical_email_blocks__id_GETReturns: Admin::CanonicalEmailBlock\
Testpost_api_v1_admin_canonical_email_blocks_testPOSTCanoniocalize and hash an email address.
Testpost_api_v1_admin_canonical_email_blocks_testFormPOSTCanoniocalize and hash an email address.
Collections14
Add an account to a Collectionpost_api_v1_collections__collection_id__itemsPOSTAdd an account to a Collection.
Add an account to a Collectionpost_api_v1_collections__collection_id__itemsFormPOSTAdd an account to a Collection.
Create a Collectionpost_api_v1_collectionsPOSTCreate a new Collection.
Create a Collectionpost_api_v1_collectionsFormPOSTCreate a new Collection.
Delete a Collectiondelete_api_v1_collections__id_DELETEDelete a Collection.
Get a single Collectionget_api_v1_collections__id_GETReturns: CollectionWithAccounts\
Get a single Collectionget_api_v1_collections__id_AnonymousGETReturns: CollectionWithAccounts\
Get all Collections from a given accountget_api_v1_accounts__account_id__collectionsGETReturns: Collections\
Get all Collections from a given accountget_api_v1_accounts__account_id__collectionsAnonymousGETReturns: Collections\
Get all Collections the current account is featured inget_api_v1_accounts__account_id__in_collectionsGETReturns: Collections\
Remove account from a Collectiondelete_api_v1_collections__collection_id__items__id_DELETERemove an account from a Collection.
Revoke inclusion in a Collectionpost_api_v1_collections__collection_id__items__id__revokePOSTRemove the current user from a Collection created by a different user.
Update a Collectionpatch_api_v1_collections__id_PATCHUpdate an existing Collection.
Update a Collectionpatch_api_v1_collections__id_FormPATCHUpdate an existing Collection.
Conversations3
Mark a conversation as readpost_api_v1_conversations__id__readPOSTReturns: Conversation\
Remove a conversationdelete_api_v1_conversations__id_DELETERemoves a conversation from your list of conversations.
View all conversationsget_api_v1_conversationsGETReturns: Array of Conversation\
Custom Emojis2
View all custom emojiget_api_v1_custom_emojisGETReturns custom emojis that are available on the server.
View all custom emojiget_api_v1_custom_emojisAnonymousGETReturns custom emojis that are available on the server.
Dimensions2
Get dimensional datapost_api_v1_admin_dimensionsPOSTObtain information about popularity of certain accounts, servers, languages, etc.
Get dimensional datapost_api_v1_admin_dimensionsFormPOSTObtain information about popularity of certain accounts, servers, languages, etc.
Directory2
View profile directoryget_api_v1_directoryGETList accounts visible in the directory.
View profile directoryget_api_v1_directoryAnonymousGETList accounts visible in the directory.
Domain Allows5
Allow a domain to federatepost_api_v1_admin_domain_allowsPOSTAdd a domain to the list of domains allowed to federate, to be used when the instance is in allow-list federation mode.
Allow a domain to federatepost_api_v1_admin_domain_allowsFormPOSTAdd a domain to the list of domains allowed to federate, to be used when the instance is in allow-list federation mode.
Delete an allowed domaindelete_api_v1_admin_domain_allows__id_DELETEDelete a domain from the allowed domains list.
Get a single allowed domainget_api_v1_admin_domain_allows__id_GETReturns: Admin::DomainAllow\
List all allowed domainsget_api_v1_admin_domain_allowsGETShow information about all allowed domains.
Domain Blocks5
Block a domainpost_api_v1_domain_blocksPOSTBlock a domain to change interactions with that domain's server:
Block a domainpost_api_v1_domain_blocksFormPOSTBlock a domain to change interactions with that domain's server:
Get domain blocksget_api_v1_domain_blocksGETView domains the user has blocked.
Unblock a domaindelete_api_v1_domain_blocksDELETERemove a domain block, if it exists in the user's array of blocked domains.
Unblock a domaindelete_api_v1_domain_blocksFormDELETERemove a domain block, if it exists in the user's array of blocked domains.
Email Domain Blocks5
Block an email domain from signupspost_api_v1_admin_email_domain_blocksPOSTAdd a domain to the list of email domains blocked from signups.
Block an email domain from signupspost_api_v1_admin_email_domain_blocksFormPOSTAdd a domain to the list of email domains blocked from signups.
Delete an email domain blockdelete_api_v1_admin_email_domain_blocks__id_DELETELift a block against an email domain.
Get a single blocked email domainget_api_v1_admin_email_domain_blocks__id_GETReturns: Admin::EmailDomainBlock\
List all blocked email domainsget_api_v1_admin_email_domain_blocksGETShow information about all email domains blocked from signing up.
Emails2
Resend confirmation emailpost_api_v1_emails_confirmationsPOSTResend a new confirmation email.
Resend confirmation emailpost_api_v1_emails_confirmationsFormPOSTResend a new confirmation email.
Endorsements1
View currently featured profilesget_api_v1_endorsementsGETAccounts that the user is currently featuring on their profile.
Experimental async refreshes1
Get Status of Async Refreshget_api_v1_alpha_async_refreshes__id_GETSometimes an API request might not return the expected results or not all possible results as either a background job is already running to (re-)create these results or the request...
Favourites1
View favourited statusesget_api_v1_favouritesGETStatuses the user has favourited.
Featured Tags5
Feature a tagpost_api_v1_featured_tagsPOSTPromote a hashtag on your profile.
Feature a tagpost_api_v1_featured_tagsFormPOSTPromote a hashtag on your profile.
Unfeature a tagdelete_api_v1_featured_tags__id_DELETEStop promoting a hashtag on your profile.
View suggested tags to featureget_api_v1_featured_tags_suggestionsGETShows up to 10 recently-used tags.
View your featured tagsget_api_v1_featured_tagsGETList all hashtags featured on your profile.
Filters26
Add a keyword to a filterpost_api_v2_filters__filter_id__keywordsPOSTAdd the given keyword to the specified filter group
Add a keyword to a filterpost_api_v2_filters__filter_id__keywordsFormPOSTAdd the given keyword to the specified filter group
Add a status to a filter grouppost_api_v2_filters__filter_id__statusesPOSTAdd a status filter to the current filter group.
Add a status to a filter grouppost_api_v2_filters__filter_id__statusesFormPOSTAdd a status filter to the current filter group.
Create a filterpost_api_v1_filtersPOSTReturns: V1::Filter\
Create a filterpost_api_v1_filtersFormPOSTReturns: V1::Filter\
Create a filterpost_api_v2_filtersPOSTCreate a filter group with the given parameters.
Create a filterpost_api_v2_filtersFormPOSTCreate a filter group with the given parameters.
Delete a filterdelete_api_v2_filters__id_DELETEDelete a filter group with the given id.
Edit a keyword within a filterput_api_v2_filters_keywords__id_PUTUpdate the given filter keyword.
Edit a keyword within a filterput_api_v2_filters_keywords__id_FormPUTUpdate the given filter keyword.
Remove a filterdelete_api_v1_filters__id_DELETEReturns: Empty\
Remove a status from a filter groupdelete_api_v2_filters_statuses__id_DELETERemove a status filter from the current filter group.
Remove keywords from a filterdelete_api_v2_filters_keywords__id_DELETEDeletes the given filter keyword.
Update a filterput_api_v1_filters__id_PUTReplaces a filter's parameters in-place.
Update a filterput_api_v1_filters__id_FormPUTReplaces a filter's parameters in-place.
Update a filterput_api_v2_filters__id_PUTUpdate a filter group with the given parameters.
Update a filterput_api_v2_filters__id_FormPUTUpdate a filter group with the given parameters.
View a single filterget_api_v1_filters__id_GETReturns: V1::Filter\
View a single keywordget_api_v2_filters_keywords__id_GETGet one filter keyword by the given id.
View a single status filterget_api_v2_filters_statuses__id_GETObtain a single status filter.
View a specific filterget_api_v2_filters__id_GETObtain a single filter group owned by the current user.
View all filtersget_api_v2_filtersGETObtain a list of all filter groups for the current user.
View all status filtersget_api_v2_filters__filter_id__statusesGETObtain a list of all status filters within this filter group.
View keywords added to a filterget_api_v2_filters__filter_id__keywordsGETList all keywords attached to the current filter group.
View your filtersget_api_v1_filtersGETReturns: List of V1::Filter\
Follow Requests3
Accept follow requestpost_api_v1_follow_requests__account_id__authorizePOSTReturns: Relationship\
Reject follow requestpost_api_v1_follow_requests__account_id__rejectPOSTReturns: Relationship\
View pending follow requestsget_api_v1_follow_requestsGETReturns: Array of Account\
Followed Tags1
View all followed tagsget_api_v1_followed_tagsGETList your followed hashtags.
Grouped notifications5
Dismiss a single notification grouppost_api_v2_notifications__group_key__dismissPOSTDismiss a single notification group from the server.
Get a single notification groupget_api_v2_notifications__group_key_GETView information about a specific notification group with a given group key.
Get accounts of all notifications in a notification groupget_api_v2_notifications__group_key__accountsGETReturns: Array of Account\
Get all grouped notificationsget_api_v2_notificationsGETReturn grouped notifications concerning the user.
Get the number of unread notificationsget_api_v2_notifications_unread_countGETGet the (capped) number of unread notification groups for the current user.
Health2
Get basic health status as JSONget_healthGETResponses other than HTTP 200 should be interpreted as some element of the web process not being healthy.
Get basic health status as JSONget_healthAnonymousGETResponses other than HTTP 200 should be interpreted as some element of the web process not being healthy.
Instance20
List of connected domainsget_api_v1_instance_peersGETDomains that this server is aware of.
List of connected domainsget_api_v1_instance_peersAnonymousGETDomains that this server is aware of.
List of rulesget_api_v1_instance_rulesGETRules that the users of this service should follow.
List of rulesget_api_v1_instance_rulesAnonymousGETRules that the users of this service should follow.
View a specific version of the terms of serviceget_api_v1_instance_terms_of_service__date_GETObtain the contents of this server's terms of service, for a specified date, if configured.
View a specific version of the terms of serviceget_api_v1_instance_terms_of_service__date_AnonymousGETObtain the contents of this server's terms of service, for a specified date, if configured.
View extended descriptionget_api_v1_instance_extended_descriptionGETObtain an extended description of this server.
View extended descriptionget_api_v1_instance_extended_descriptionAnonymousGETObtain an extended description of this server.
View moderated serversget_api_v1_instance_domain_blocksGETObtain a list of domains that have been blocked.
View moderated serversget_api_v1_instance_domain_blocksAnonymousGETObtain a list of domains that have been blocked.
View privacy policyget_api_v1_instance_privacy_policyGETObtain the contents of this server's privacy policy.
View privacy policyget_api_v1_instance_privacy_policyAnonymousGETObtain the contents of this server's privacy policy.
View server information (v1)get_api_v1_instanceGETObtain general information about the server.
View server information (v1)get_api_v1_instanceAnonymousGETObtain general information about the server.
View terms of serviceget_api_v1_instance_terms_of_serviceGETObtain the contents of this server's terms of service, if configured.
View terms of serviceget_api_v1_instance_terms_of_serviceAnonymousGETObtain the contents of this server's terms of service, if configured.
View translation languagesget_api_v1_instance_translation_languagesGETTranslation language pairs supported by the translation engine used by the server.
View translation languagesget_api_v1_instance_translation_languagesAnonymousGETTranslation language pairs supported by the translation engine used by the server.
Weekly activityget_api_v1_instance_activityGETServer activity over the last 3 months, binned weekly.
Weekly activityget_api_v1_instance_activityAnonymousGETServer activity over the last 3 months, binned weekly.
Ip Blocks7
Block an IP address range from signing uppost_api_v1_admin_ip_blocksPOSTAdd an IP address range to the list of IP blocks.
Block an IP address range from signing uppost_api_v1_admin_ip_blocksFormPOSTAdd an IP address range to the list of IP blocks.
Delete an IP blockdelete_api_v1_admin_ip_blocks__id_DELETELift a block against an IP range.
Get a single IP blockget_api_v1_admin_ip_blocks__id_GETShow information about a single IP block.
List all IP blocksget_api_v1_admin_ip_blocksGETShow information about all blocked IP ranges.
Update a domain blockput_api_v1_admin_ip_blocks__id_PUTChange parameters for an existing IP block.
Update a domain blockput_api_v1_admin_ip_blocks__id_FormPUTChange parameters for an existing IP block.
Lists11
Add accounts to a listpost_api_v1_lists__id__accountsPOSTAdd accounts to the given list.
Create a listpost_api_v1_listsPOSTCreate a new list.
Create a listpost_api_v1_listsFormPOSTCreate a new list.
Delete a listdelete_api_v1_lists__id_DELETEReturns: Empty\
Remove accounts from listdelete_api_v1_lists__id__accountsDELETERemove accounts from the given list.
Remove accounts from listdelete_api_v1_lists__id__accountsFormDELETERemove accounts from the given list.
Show a single listget_api_v1_lists__id_GETFetch the list with the given ID.
Update a listput_api_v1_lists__id_PUTChange the properties of a list.
Update a listput_api_v1_lists__id_FormPUTChange the properties of a list.
View accounts in a listget_api_v1_lists__id__accountsGETReturns: Array of Account\
View your listsget_api_v1_listsGETFetch all lists that the user owns.
Markers3
Get saved timeline positionsget_api_v1_markersGETGet current positions in timelines.
Save your position in a timelinepost_api_v1_markersPOSTSave current position in timeline.
Save your position in a timelinepost_api_v1_markersFormPOSTSave current position in timeline.
Measures2
Get measurable datapost_api_v1_admin_measuresPOSTObtain statistical measures for your server.
Get measurable datapost_api_v1_admin_measuresFormPOSTObtain statistical measures for your server.
Media4
Get media attachmentget_api_v1_media__id_GETGet a media attachment, before it is attached to a status and posted, but after it is accepted for processing.
Update media attachmentput_api_v1_media__id_PUTUpdate a MediaAttachment's parameters, before it is attached to a status and posted.
Upload media as an attachment (async)post_api_v2_mediaPOSTCreates a media attachment to be used with a new status.
Upload media as an attachment (v1)post_api_v1_mediaPOSTCreates an attachment to be used with a new status.
Mutes1
View muted accountsget_api_v1_mutesGETAccounts the user has muted.
Notifications13
Accept a single notification requestpost_api_v1_notifications_requests__id__acceptPOSTAccept a notification request, which merges the filtered notifications from that user back into the main notification and accepts any future notification from them.
Accept multiple notification requestspost_api_v1_notifications_requests_acceptPOSTAccepts multiple notification requests, which merges the filtered notifications from those users back into the main notifications and accepts any future notification from them.
Dismiss a single notificationpost_api_v1_notifications__id__dismissPOSTDismiss a single notification from the server.
Dismiss a single notification requestpost_api_v1_notifications_requests__id__dismissPOSTDismiss a notification request, which hides it and prevent it from contributing to the pending notification requests count.
Dismiss all notificationspost_api_v1_notifications_clearPOSTClear all notifications from the server.
Dismiss multiple notification requestspost_api_v1_notifications_requests_dismissPOSTDismiss multiple notification requests, which hides them and prevent them from contributing to the pending notification requests count.
Get a single notificationget_api_v1_notifications__id_GETView information about a notification with a given ID.
Get a single notification requestget_api_v1_notifications_requests__id_GETView information about a notification request with a given ID.
Get all notification requestsget_api_v1_notifications_requestsGETNotification requests for notifications filtered by the user's policy.
Get all notificationsget_api_v1_notificationsGETNotifications concerning the user.
Get the filtering policy for notificationsget_api_v2_notifications_policyGETNotifications filtering policy for the user.
Get the number of unread notificationsget_api_v1_notifications_unread_countGETGet the (capped) number of unread notifications for the current user.
Update the filtering policy for notificationspatch_api_v2_notifications_policyPATCHUpdate the user's notifications filtering policy.
Notifications Alpha4
Dismiss a single notification grouppost_api_v2_alpha_notifications__group_key__dismissPOSTDismiss a single notification group from the server.
Get a single notification groupget_api_v2_alpha_notifications__group_key_GETView information about a specific notification group with a given group key.
Get all grouped notificationsget_api_v2_alpha_notificationsGETReturn grouped notifications concerning the user.
Get the number of unread notificationsget_api_v2_alpha_notifications_unread_countGETGet the (capped) number of unread notification groups for the current user.
OAuth3
Discover OAuth Server Configurationget_.well-known_oauth-authorization-serverGETReturns the OAuth 2 Authorization Server Metadata for the Mastodon server, as defined by RFC 8414.
Discover OAuth Server Configurationget_.well-known_oauth-authorization-serverAnonymousGETReturns the OAuth 2 Authorization Server Metadata for the Mastodon server, as defined by RFC 8414.
Retrieve user informationget_oauth_userinfoGETRetrieves standardised OIDC claims about the currently authenticated user.\
Oembed2
Get OEmbed info as JSONget_api_oembedGETReturns: OEmbed metadata\
Get OEmbed info as JSONget_api_oembedAnonymousGETReturns: OEmbed metadata\
Polls4
View a pollget_api_v1_polls__id_GETView a poll attached to a status.
View a pollget_api_v1_polls__id_AnonymousGETView a poll attached to a status.
Vote on a pollpost_api_v1_polls__id__votesPOSTVote on a poll attached to a status.
Vote on a pollpost_api_v1_polls__id__votesFormPOSTVote on a poll attached to a status.
Preferences1
View user preferencesget_api_v1_preferencesGETPreferences defined by the user in their account settings.
Profile3
Delete profile avatardelete_api_v1_profile_avatarDELETEReturns: CredentialAccount\
Delete profile headerdelete_api_v1_profile_headerDELETEReturns: CredentialAccount\
Get current user profileget_api_v1_profileGETReturns: Profile\
Push6
Change types of notificationsput_api_v1_push_subscriptionPUTUpdates the current push subscription.
Change types of notificationsput_api_v1_push_subscriptionFormPUTUpdates the current push subscription.
Get current subscriptionget_api_v1_push_subscriptionGETView the PushSubscription currently associated with this access token.
Remove current subscriptiondelete_api_v1_push_subscriptionDELETERemoves the current Web Push API subscription.
Subscribe to push notificationspost_api_v1_push_subscriptionPOSTAdd a Web Push API subscription to receive notifications.
Subscribe to push notificationspost_api_v1_push_subscriptionFormPOSTAdd a Web Push API subscription to receive notifications.
Reports2
File a reportpost_api_v1_reportsPOSTReport problematic accounts and contents to your moderators.
File a reportpost_api_v1_reportsFormPOSTReport problematic accounts and contents to your moderators.
Retention2
Calculate retention datapost_api_v1_admin_retentionPOSTGenerate a retention data report for a given time period and bucket.
Calculate retention datapost_api_v1_admin_retentionFormPOSTGenerate a retention data report for a given time period and bucket.
Revoke4
Revoke a tokenpost_oauth_revokePOSTRevoke an access token to make it no longer valid for use.
Revoke a tokenpost_oauth_revokeAnonymousPOSTRevoke an access token to make it no longer valid for use.
Revoke a tokenpost_oauth_revokeFormPOSTRevoke an access token to make it no longer valid for use.
Revoke a tokenpost_oauth_revokeFormAnonymousPOSTRevoke an access token to make it no longer valid for use.
Scheduled Statuses5
Cancel a scheduled statusdelete_api_v1_scheduled_statuses__id_DELETEReturns: Empty\
Update a scheduled status's publishing dateput_api_v1_scheduled_statuses__id_PUTReturns: ScheduledStatus\
Update a scheduled status's publishing dateput_api_v1_scheduled_statuses__id_FormPUTReturns: ScheduledStatus\
View a single scheduled statusget_api_v1_scheduled_statuses__id_GETReturns: ScheduledStatus\
View scheduled statusesget_api_v1_scheduled_statusesGETReturns: Array of ScheduledStatus\
Search2
Perform a searchget_api_v2_searchGETPerform a search for content in accounts, statuses and hashtags with the given parameters.
Perform a searchget_api_v2_searchAnonymousGETPerform a search for content in accounts, statuses and hashtags with the given parameters.
Statuses35
Bookmark a statuspost_api_v1_statuses__id__bookmarkPOSTPrivately bookmark a status.
Boost a statuspost_api_v1_statuses__id__reblogPOSTReshare a status on your own profile.
Boost a statuspost_api_v1_statuses__id__reblogFormPOSTReshare a status on your own profile.
Delete a statusdelete_api_v1_statuses__id_DELETEDelete one of your own statuses.
Edit a statusput_api_v1_statuses__id_PUTEdit a given status to change its text, sensitivity, media attachments, or poll.
Edit a statusput_api_v1_statuses__id_FormPUTEdit a given status to change its text, sensitivity, media attachments, or poll.
Edit a status' interaction policiesput_api_v1_statuses__id__interaction_policyPUTEdit a given status to change its interaction policies.
Edit a status' interaction policiesput_api_v1_statuses__id__interaction_policyFormPUTEdit a given status to change its interaction policies.
Favourite a statuspost_api_v1_statuses__id__favouritePOSTAdd a status to your favourites list.
Get parent and child statuses in contextget_api_v1_statuses__id__contextGETView statuses above and below this status in the thread.
Get parent and child statuses in contextget_api_v1_statuses__id__contextAnonymousGETView statuses above and below this status in the thread.
Mute a conversationpost_api_v1_statuses__id__mutePOSTDo not receive notifications for the thread that this status is part of.
Pin status to profilepost_api_v1_statuses__id__pinPOSTFeature one of your own public statuses at the top of your profile.
Post a new statuspost_api_v1_statusesPOSTPublish a status with the given parameters.
Post a new statuspost_api_v1_statusesFormPOSTPublish a status with the given parameters.
Revoke a quote postpost_api_v1_statuses__id__quotes__quoting_status_id__revokePOSTRevoke quote authorization of status quoting status id, detaching status id.
See quotes of a statusget_api_v1_statuses__id__quotesGETView quotes of a status.
See who boosted a statusget_api_v1_statuses__id__reblogged_byGETView who boosted a given status.
See who boosted a statusget_api_v1_statuses__id__reblogged_byAnonymousGETView who boosted a given status.
See who favourited a statusget_api_v1_statuses__id__favourited_byGETView who favourited a given status.
See who favourited a statusget_api_v1_statuses__id__favourited_byAnonymousGETView who favourited a given status.
Translate a statuspost_api_v1_statuses__id__translatePOSTTranslate the status content into some language.
Translate a statuspost_api_v1_statuses__id__translateFormPOSTTranslate the status content into some language.
Undo bookmark of a statuspost_api_v1_statuses__id__unbookmarkPOSTRemove a status from your private bookmarks.
Undo boost of a statuspost_api_v1_statuses__id__unreblogPOSTUndo a reshare of a status.
Undo favourite of a statuspost_api_v1_statuses__id__unfavouritePOSTRemove a status from your favourites list.
Unmute a conversationpost_api_v1_statuses__id__unmutePOSTStart receiving notifications again for the thread that this status is part of.
Unpin status from profilepost_api_v1_statuses__id__unpinPOSTUnfeature a status from the top of your profile.
View a single statusget_api_v1_statuses__id_GETObtain information about a status.
View a single statusget_api_v1_statuses__id_AnonymousGETObtain information about a status.
View edit history of a statusget_api_v1_statuses__id__historyGETGet all known versions of a status, including the initial and current states.
View edit history of a statusget_api_v1_statuses__id__historyAnonymousGETGet all known versions of a status, including the initial and current states.
View multiple statusesget_api_v1_statusesGETObtain information about multiple statuses.
View multiple statusesget_api_v1_statusesAnonymousGETObtain information about multiple statuses.
View status sourceget_api_v1_statuses__id__sourceGETObtain the source properties for a status so that it can be edited.
Streaming2
Check if the server is aliveget_api_v1_streaming_healthGETVerify that the streaming service is alive before connecting to it
Check if the server is aliveget_api_v1_streaming_healthAnonymousGETVerify that the streaming service is alive before connecting to it
Suggestions3
Remove a suggestiondelete_api_v1_suggestions__account_id_DELETERemove an account from follow suggestions.
View follow suggestions (v1)get_api_v1_suggestionsGETAccounts the user has had past positive interactions with, but is not yet following.
View follow suggestions (v2)get_api_v2_suggestionsGETAccounts that are promoted by staff, or that the user has had past positive interactions with, but is not yet following.
Tags6
Feature a hashtagpost_api_v1_tags__id__featurePOSTFeature the hashtag on your profile.
Follow a hashtagpost_api_v1_tags__name__followPOSTFollow a hashtag.
Unfeature a hashtagpost_api_v1_tags__id__unfeaturePOSTStop featuring the hashtag on your profile.
Unfollow a hashtagpost_api_v1_tags__name__unfollowPOSTUnfollow a hashtag.
View information about a single tagget_api_v1_tags__name_GETShow a hashtag and its associated information
View information about a single tagget_api_v1_tags__name_AnonymousGETShow a hashtag and its associated information
Timelines8
View hashtag timelineget_api_v1_timelines_tag__hashtag_GETView public statuses containing the given hashtag.
View hashtag timelineget_api_v1_timelines_tag__hashtag_AnonymousGETView public statuses containing the given hashtag.
View home timelineget_api_v1_timelines_homeGETView statuses from followed users and hashtags.
View link timelineget_api_v1_timelines_linkGETView public statuses containing a link to the specified currently-trending article.
View link timelineget_api_v1_timelines_linkAnonymousGETView public statuses containing a link to the specified currently-trending article.
View list timelineget_api_v1_timelines_list__list_id_GETView statuses in the given list timeline.
View public timelineget_api_v1_timelines_publicGETView public statuses.
View public timelineget_api_v1_timelines_publicAnonymousGETView public statuses.
Token4
Obtain a tokenpost_oauth_tokenPOSTObtain an access token, to be used during API calls that are not public.
Obtain a tokenpost_oauth_tokenAnonymousPOSTObtain an access token, to be used during API calls that are not public.
Obtain a tokenpost_oauth_tokenFormPOSTObtain an access token, to be used during API calls that are not public.
Obtain a tokenpost_oauth_tokenFormAnonymousPOSTObtain an access token, to be used during API calls that are not public.
Trends6
View trending linksget_api_v1_trends_linksGETLinks that have been shared more than others.
View trending linksget_api_v1_trends_linksAnonymousGETLinks that have been shared more than others.
View trending statusesget_api_v1_trends_statusesGETStatuses that have been interacted with more than others.
View trending statusesget_api_v1_trends_statusesAnonymousGETStatuses that have been interacted with more than others.
View trending tagsget_api_v1_trends_tagsGETTags that are being used more frequently within the past week.
View trending tagsget_api_v1_trends_tagsAnonymousGETTags that are being used more frequently within the past week.