Class Mastodon

Implements

MegalodonInterface

Index

Constructors

Properties

Methods

acceptFollowRequest addAccountsToList addReactionToAnnouncement blockAccount blockDomain bookmarkStatus cancel cancelScheduledStatus createApp createEmojiReaction createFeaturedTag createFilter createList deleteAccountsFromList deleteConversation deleteEmojiReaction deleteFeaturedTag deleteFilter deleteList deletePushSubscription deleteStatus directStreaming dismissInstanceAnnouncement dismissNotification dismissNotifications editStatus favouriteStatus fetchAccessToken followAccount followTag generateAuthUrl getAccount getAccountFavourites getAccountFollowers getAccountFollowing getAccountLists getAccountsInList getAccountStatuses getBlocks getBookmarks getConversationTimeline getDomainBlocks getEmojiReaction getEmojiReactions getEndorsements getFavourites getFeaturedTags getFilter getFilters getFollowedTags getFollowRequests getHomeTimeline getIdentityProof getInstance getInstanceActivity getInstanceAnnouncements getInstanceCustomEmojis getInstanceDirectory getInstancePeers getInstanceTrends getList getLists getListTimeline getLocalTimeline getMarkers getMedia getMutes getNotification getNotifications getPoll getPreferences getPublicTimeline getPushSubscription getRelationship getRelationships getScheduledStatus getScheduledStatuses getStatus getStatusContext getStatusFavouritedBy getStatusRebloggedBy getStatusSource getSuggestedTags getSuggestions getTag getTagTimeline listStreaming localStreaming lookupAccount muteAccount muteStatus pinAccount pinStatus postStatus publicStreaming readConversation readNotifications reblogStatus refreshToken registerAccount registerApp rejectFollowRequest removeReactionFromAnnouncement report revokeToken saveMarkers scheduleStatus search searchAccount setAccountNote streamingURL subscribeAccount subscribePushNotification tagStreaming unblockAccount unblockDomain unbookmarkStatus unfavouriteStatus unfollowAccount unfollowTag unmuteAccount unmuteStatus unpinAccount unpinStatus unreblogStatus unsubscribeAccount updateCredentials updateFilter updateList updateMedia updatePushSubscription uploadMedia userStreaming verifyAccountCredentials verifyAppCredentials votePoll

Constructors

constructor

new Mastodon(baseUrl, accessToken?, userAgent?): Mastodon
Parameters
- baseUrl: string
  hostname or base URL
- accessToken: null | string = null
  access token from OAuth2 authorization
- userAgent: null | string = DEFAULT_UA
  UserAgent is specified in header on request.
Returns Mastodon
- Defined in megalodon/src/mastodon.ts:25

Properties

baseUrl

baseUrl: string

client

client: Interface

Methods

acceptFollowRequest

acceptFollowRequest(id): Promise<Response<Relationship>>
POST /api/v1/follow_requests/:id/authorize
Parameters
- id: string
  Target account ID.
Returns Promise<Response<Relationship>>
Relationship.
Implementation of MegalodonInterface.acceptFollowRequest
- Defined in megalodon/src/mastodon.ts:1310

addAccountsToList

addAccountsToList(id, account_ids): Promise<Response<{}>>
POST /api/v1/lists/:id/accounts
Parameters
- id: string
  Target list ID.
- account_ids: string[]
  Array of account IDs to add to the list.
Returns Promise<Response<{}>>
Implementation of MegalodonInterface.addAccountsToList
- Defined in megalodon/src/mastodon.ts:2642

addReactionToAnnouncement

addReactionToAnnouncement(id, name): Promise<Response<Record<never, never>>>
PUT /api/v1/announcements/:id/reactions/:name
Parameters
- id: string
  The ID of the Announcement in the database.
- name: string
  Unicode emoji, or the shortcode of a custom emoji.
Returns Promise<Response<Record<never, never>>>
Implementation of MegalodonInterface.addReactionToAnnouncement
- Defined in megalodon/src/mastodon.ts:3134

blockAccount

blockAccount(id): Promise<Response<Relationship>>
POST /api/v1/accounts/:id/block
Parameters
- id: string
  The account ID.
Returns Promise<Response<Relationship>>
Relationship
Implementation of MegalodonInterface.blockAccount
- Defined in megalodon/src/mastodon.ts:650

blockDomain

blockDomain(domain): Promise<Response<{}>>
POST/api/v1/domain_blocks
Parameters
- domain: string
  Domain to block.
Returns Promise<Response<{}>>
Implementation of MegalodonInterface.blockDomain
- Defined in megalodon/src/mastodon.ts:1057

bookmarkStatus

bookmarkStatus(id): Promise<Response<Status>>
POST /api/v1/statuses/:id/bookmark
Parameters
- id: string
  The target status id.
Returns Promise<Response<Status>>
Status.
Implementation of MegalodonInterface.bookmarkStatus
- Defined in megalodon/src/mastodon.ts:1883

cancel

cancel(): void
Cancel all requests in this instance.

Returns void
void
Implementation of MegalodonInterface.cancel
- Defined in megalodon/src/mastodon.ts:38

cancelScheduledStatus

cancelScheduledStatus(id): Promise<Response<{}>>
DELETE /api/v1/scheduled_statuses/:id
Parameters
- id: string
  Target scheduled status ID.
Returns Promise<Response<{}>>
Implementation of MegalodonInterface.cancelScheduledStatus
- Defined in megalodon/src/mastodon.ts:2167

createApp

createApp(client_name, options): Promise<AppData>
Call /api/v1/apps

Create an application.
Parameters
- client_name: string
  your application's name
- options: Partial<{
      redirect_uris: string;
      scopes: string[];
      website: string;
  }>
  Form Data
Returns Promise<AppData>
Implementation of MegalodonInterface.createApp
- Defined in megalodon/src/mastodon.ts:72

createEmojiReaction

createEmojiReaction(_id, _emoji): Promise<Response<Status>>
React to a post with a unicode emoji.
Parameters
- _id: string
- _emoji: string
Returns Promise<Response<Status>>
Status.
Implementation of MegalodonInterface.createEmojiReaction
- Defined in megalodon/src/mastodon.ts:3151

createFeaturedTag

createFeaturedTag(name): Promise<Response<FeaturedTag>>
POST /api/v1/featured_tags
Parameters
- name: string
  Target hashtag name.
Returns Promise<Response<FeaturedTag>>
FeaturedTag.
Implementation of MegalodonInterface.createFeaturedTag
- Defined in megalodon/src/mastodon.ts:1391

createFilter

createFilter(phrase, context, options?): Promise<Response<Filter>>
POST /api/v1/filters
Parameters
- phrase: string
  Text to be filtered.
- context: string[]
  Array of enumerable strings home, notifications, public, thread, account. At least one context must be specified.
- Optionaloptions: {
      expires_in?: string;
      irreversible?: boolean;
      whole_word?: boolean;
  }
  - Optionalexpires_in?: string
    ISO 8601 Datetime for when the filter expires.
  - Optionalirreversible?: boolean
    Should the server irreversibly drop matching entities from home and notifications?
  - Optionalwhole_word?: boolean
    Consider word boundaries?
Returns Promise<Response<Filter>>
Filter
Implementation of MegalodonInterface.createFilter
- Defined in megalodon/src/mastodon.ts:1114

createList

createList(title): Promise<Response<List>>
POST /api/v1/lists
Parameters
- title: string
  List name.
Returns Promise<Response<List>>
List.
Implementation of MegalodonInterface.createList
- Defined in megalodon/src/mastodon.ts:2553

deleteAccountsFromList

deleteAccountsFromList(id, account_ids): Promise<Response<{}>>
DELETE /api/v1/lists/:id/accounts
Parameters
- id: string
  Target list ID.
- account_ids: string[]
  Array of account IDs to add to the list.
Returns Promise<Response<{}>>
Implementation of MegalodonInterface.deleteAccountsFromList
- Defined in megalodon/src/mastodon.ts:2654

deleteConversation

deleteConversation(id): Promise<Response<{}>>
DELETE /api/v1/conversations/:id
Parameters
- id: string
  Target conversation ID.
Returns Promise<Response<{}>>
Implementation of MegalodonInterface.deleteConversation
- Defined in megalodon/src/mastodon.ts:2499

deleteEmojiReaction

deleteEmojiReaction(_id, _emoji): Promise<Response<Status>>
Remove a reaction to a post with a unicode emoji.
Parameters
- _id: string
- _emoji: string
Returns Promise<Response<Status>>
Status.
Implementation of MegalodonInterface.deleteEmojiReaction
- Defined in megalodon/src/mastodon.ts:3158

deleteFeaturedTag

deleteFeaturedTag(id): Promise<Response<{}>>
DELETE /api/v1/featured_tags/:id
Parameters
- id: string
  Target featured tag id.
Returns Promise<Response<{}>>
Empty
Implementation of MegalodonInterface.deleteFeaturedTag
- Defined in megalodon/src/mastodon.ts:1409

deleteFilter

deleteFilter(id): Promise<Response<Filter>>
DELETE /api/v1/filters/:id
Parameters
- id: string
  The filter ID.
Returns Promise<Response<Filter>>
Removed filter.
Implementation of MegalodonInterface.deleteFilter
- Defined in megalodon/src/mastodon.ts:1206

deleteList

deleteList(id): Promise<Response<{}>>
DELETE /api/v1/lists/:id
Parameters
- id: string
  Target list ID.
Returns Promise<Response<{}>>
Implementation of MegalodonInterface.deleteList
- Defined in megalodon/src/mastodon.ts:2589

deletePushSubscription

deletePushSubscription(): Promise<Response<{}>>
DELETE /api/v1/push/subscription

Returns Promise<Response<{}>>
Implementation of MegalodonInterface.deletePushSubscription
- Defined in megalodon/src/mastodon.ts:2893

deleteStatus

deleteStatus(id): Promise<Response<Status>>
DELETE /api/v1/statuses/:id
Parameters
- id: string
  The target status id.
Returns Promise<Response<Status>>
Status
Implementation of MegalodonInterface.deleteStatus
- Defined in megalodon/src/mastodon.ts:1734

directStreaming

directStreaming(): Promise<Streaming>
Returns Promise<Streaming>
Implementation of MegalodonInterface.directStreaming
- Defined in megalodon/src/mastodon.ts:3215

dismissInstanceAnnouncement

dismissInstanceAnnouncement(id): Promise<Response<Record<never, never>>>
POST /api/v1/announcements/:id/dismiss
Parameters
- id: string
  The ID of the Announcement in the database.
Returns Promise<Response<Record<never, never>>>
Implementation of MegalodonInterface.dismissInstanceAnnouncement
- Defined in megalodon/src/mastodon.ts:3124

dismissNotification

dismissNotification(id): Promise<Response<{}>>
POST /api/v1/notifications/:id/dismiss
Parameters
- id: string
  Target notification ID.
Returns Promise<Response<{}>>
Implementation of MegalodonInterface.dismissNotification
- Defined in megalodon/src/mastodon.ts:2805

dismissNotifications

dismissNotifications(): Promise<Response<{}>>
POST /api/v1/notifications/clear

Returns Promise<Response<{}>>
Implementation of MegalodonInterface.dismissNotifications
- Defined in megalodon/src/mastodon.ts:2796

editStatus

editStatus(id, options): Promise<Response<Status>>
PUT /api/v1/statuses/:id * *
Parameters
- id: string
  The target status id. *
- options: {
      media_ids?: string[];
      poll?: {
          expires_in?: number;
          hide_totals?: boolean;
          multiple?: boolean;
          options?: string[];
      };
      sensitive?: boolean;
      spoiler_text?: string;
      status?: string;
  }
  - Optionalmedia_ids?: string[]
  - Optionalpoll?: {
        expires_in?: number;
        hide_totals?: boolean;
        multiple?: boolean;
        options?: string[];
    }
    - Optionalexpires_in?: number
    - Optionalhide_totals?: boolean
    - Optionalmultiple?: boolean
    - Optionaloptions?: string[]
  - Optionalsensitive?: boolean
  - Optionalspoiler_text?: string
  - Optionalstatus?: string
Returns Promise<Response<Status>>
Status
Implementation of MegalodonInterface.editStatus
- Defined in megalodon/src/mastodon.ts:1664

favouriteStatus

favouriteStatus(id): Promise<Response<Status>>
POST /api/v1/statuses/:id/favourite
Parameters
- id: string
  The target status id.
Returns Promise<Response<Status>>
Status.
Implementation of MegalodonInterface.favouriteStatus
- Defined in megalodon/src/mastodon.ts:1827

fetchAccessToken

fetchAccessToken(client_id, client_secret, code, redirect_uri?): Promise<TokenData>
POST /oauth/token

Fetch OAuth access token. Get an access token based client_id and client_secret and authorization code.
Parameters
- client_id: null | string
  will be generated by #createApp or #registerApp
- client_secret: string
  will be generated by #createApp or #registerApp
- code: string
  will be generated by the link of #generateAuthUrl or #registerApp
- redirect_uri: string = NO_REDIRECT
  must be the same uri as the time when you register your OAuth application
Returns Promise<TokenData>
Implementation of MegalodonInterface.fetchAccessToken
- Defined in megalodon/src/mastodon.ts:151

followAccount

followAccount(id, options?): Promise<Response<Relationship>>
POST /api/v1/accounts/:id/follow
Parameters
- id: string
  The account ID.
- Optionaloptions: {
  reblog?: boolean;
  }
  - Optionalreblog?: boolean
Returns Promise<Response<Relationship>>
Relationship
Implementation of MegalodonInterface.followAccount
- Defined in megalodon/src/mastodon.ts:614

followTag

followTag(id): Promise<Response<Tag>>
POST /api/v1/tags/:id/follow
Parameters
- id: string
  Target hashtag id.
Returns Promise<Response<Tag>>
Tag
Implementation of MegalodonInterface.followTag
- Defined in megalodon/src/mastodon.ts:1510

generateAuthUrl

generateAuthUrl(clientId, clientSecret, options): Promise<string>
Generate authorization url using OAuth2.
Parameters
- clientId: string
  your OAuth app's client ID
- clientSecret: string
  your OAuth app's client Secret
- options: Partial<{
  redirect_uri: null | string;
  scope: string[];
  }>
  as property, redirect_uri and scope are available, and must be the same as when you register your app
Returns Promise<string>
- Defined in megalodon/src/mastodon.ts:103

getAccount

getAccount(id): Promise<Response<Account>>
GET /api/v1/accounts/:id
Parameters
- id: string
  The account ID.
Returns Promise<Response<Account>>
An account.
Implementation of MegalodonInterface.getAccount
- Defined in megalodon/src/mastodon.ts:341

getAccountFavourites

getAccountFavourites(_id, _options?): Promise<Response<Status[]>>
Favourites timeline of any user.
Parameters
- _id: string
- Optional_options: {
      limit?: number;
      max_id?: string;
      since_id?: string;
  }
  - Optionallimit?: number
  - Optionalmax_id?: string
  - Optionalsince_id?: string
Returns Promise<Response<Status[]>>
Array of statuses.
Implementation of MegalodonInterface.getAccountFavourites
- Defined in megalodon/src/mastodon.ts:426

getAccountFollowers

getAccountFollowers(id, options?): Promise<Response<Account[]>>
GET /api/v1/accounts/:id/followers
Parameters
- id: string
  The account ID.
- Optionaloptions: {
      get_all?: boolean;
      limit?: number;
      max_id?: string;
      since_id?: string;
      sleep_ms?: number;
  }
  - Optionalget_all?: boolean
  - Optionallimit?: number
    Max number of results to return. Defaults to 40.
  - Optionalmax_id?: string
    Return results older than ID.
  - Optionalsince_id?: string
    Return results newer than ID.
  - Optionalsleep_ms?: number
Returns Promise<Response<Account[]>>
The array of accounts.
Implementation of MegalodonInterface.getAccountFollowers
- Defined in megalodon/src/mastodon.ts:483

getAccountFollowing

getAccountFollowing(id, options?): Promise<Response<Account[]>>
GET /api/v1/accounts/:id/following
Parameters
- id: string
  The account ID.
- Optionaloptions: {
      get_all?: boolean;
      limit?: number;
      max_id?: string;
      since_id?: string;
      sleep_ms?: number;
  }
  - Optionalget_all?: boolean
  - Optionallimit?: number
    Max number of results to return. Defaults to 40.
  - Optionalmax_id?: string
    Return results older than ID.
  - Optionalsince_id?: string
    Return results newer than ID.
  - Optionalsleep_ms?: number
Returns Promise<Response<Account[]>>
The array of accounts.
Implementation of MegalodonInterface.getAccountFollowing
- Defined in megalodon/src/mastodon.ts:523

getAccountLists

getAccountLists(id): Promise<Response<List[]>>
GET /api/v1/accounts/:id/lists
Parameters
- id: string
  The account ID.
Returns Promise<Response<List[]>>
The array of lists.
Implementation of MegalodonInterface.getAccountLists
- Defined in megalodon/src/mastodon.ts:585

getAccountsInList

getAccountsInList(id, options?): Promise<Response<Account[]>>
GET /api/v1/lists/:id/accounts
Parameters
- id: string
  Target list ID.
- Optionaloptions: {
      limit?: number;
      max_id?: string;
      since_id?: string;
  }
  - Optionallimit?: number
    Max number of results to return.
  - Optionalmax_id?: string
    Return results older than ID.
  - Optionalsince_id?: string
    Return results newer than ID.
Returns Promise<Response<Account[]>>
Array of accounts.
Implementation of MegalodonInterface.getAccountsInList
- Defined in megalodon/src/mastodon.ts:2603

getAccountStatuses

getAccountStatuses(id, options?): Promise<Response<Status[]>>
GET /api/v1/accounts/:id/statuses
Parameters
- id: string
  The account ID.
- Optionaloptions: {
      exclude_reblogs?: boolean;
      exclude_replies?: boolean;
      limit?: number;
      max_id?: string;
      min_id?: string;
      only_media: boolean;
      pinned?: boolean;
      since_id?: string;
  }
  - Optionalexclude_reblogs?: boolean
    Return statuses which exclude reblogs.
  - Optionalexclude_replies?: boolean
    Return statuses which exclude replies.
  - Optionallimit?: number
    Max number of results to return. Defaults to 20.
  - Optionalmax_id?: string
    Return results older than ID.
  - Optionalmin_id?: string
    Return results newer than ID.
  - only_media: boolean
    Show only statuses with media attached? Defaults to false.
  - Optionalpinned?: boolean
    Return statuses which include pinned statuses.
  - Optionalsince_id?: string
    Return results newer than ID but starting with most recent.
Returns Promise<Response<Status[]>>
Account's statuses.
Implementation of MegalodonInterface.getAccountStatuses
- Defined in megalodon/src/mastodon.ts:363

getBlocks

getBlocks(options?): Promise<Response<Account[]>>
GET /api/v1/blocks
Parameters
- Optionaloptions: {
      limit?: number;
      max_id?: string;
      min_id?: string;
  }
  - Optionallimit?: number
    Max number of results to return. Defaults to 40.
  - Optionalmax_id?: string
    Return results older than ID.
  - Optionalmin_id?: string
    Return results immediately newer than ID.
Returns Promise<Response<Account[]>>
Array of accounts.
Implementation of MegalodonInterface.getBlocks
- Defined in megalodon/src/mastodon.ts:993

getBookmarks

getBookmarks(options?): Promise<Response<Status[]>>
GET /api/v1/bookmarks
Parameters
- Optionaloptions: {
      limit?: number;
      max_id?: string;
      min_id?: string;
      since_id?: string;
  }
  - Optionallimit?: number
    Max number of results to return. Defaults to 40.
  - Optionalmax_id?: string
    Return results older than ID.
  - Optionalmin_id?: string
    Return results immediately newer than ID.
  - Optionalsince_id?: string
    Return results newer than ID.
Returns Promise<Response<Status[]>>
Array of statuses.
Implementation of MegalodonInterface.getBookmarks
- Defined in megalodon/src/mastodon.ts:871

getConversationTimeline

getConversationTimeline(options?): Promise<Response<Conversation[]>>
GET /api/v1/conversations
Parameters
- Optionaloptions: {
      limit?: number;
      max_id?: string;
      min_id?: string;
      since_id?: string;
  }
  - Optionallimit?: number
    Max number of results to return. Defaults to 20.
  - Optionalmax_id?: string
    Return results older than ID.
  - Optionalmin_id?: string
    Return results immediately newer than ID.
  - Optionalsince_id?: string
    Return results newer than ID.
Returns Promise<Response<Conversation[]>>
Array of statuses.
Implementation of MegalodonInterface.getConversationTimeline
- Defined in megalodon/src/mastodon.ts:2458

getDomainBlocks

getDomainBlocks(options?): Promise<Response<string[]>>
GET /api/v1/domain_blocks
Parameters
- Optionaloptions: {
      limit?: number;
      max_id?: string;
      min_id?: string;
  }
  - Optionallimit?: number
    Max number of results to return. Defaults to 40.
  - Optionalmax_id?: string
    Return results older than ID.
  - Optionalmin_id?: string
    Return results immediately newer than ID.
Returns Promise<Response<string[]>>
Array of domain name.
Implementation of MegalodonInterface.getDomainBlocks
- Defined in megalodon/src/mastodon.ts:1030

getEmojiReaction

getEmojiReaction(_id, _emoji): Promise<Response<Reaction>>
Get an object of emoji to account mappings with accounts that reacted to the post for a specific emoji.
Parameters
- _id: string
- _emoji: string
Returns Promise<Response<Reaction>>
Reaction.
Implementation of MegalodonInterface.getEmojiReaction
- Defined in megalodon/src/mastodon.ts:3172

getEmojiReactions

getEmojiReactions(_id): Promise<Response<Reaction[]>>
Get an object of emoji to account mappings with accounts that reacted to the post.
Parameters
- _id: string
Returns Promise<Response<Reaction[]>>
Array of reaction.
Implementation of MegalodonInterface.getEmojiReactions
- Defined in megalodon/src/mastodon.ts:3165

getEndorsements

getEndorsements(options?): Promise<Response<Account[]>>
GET /api/v1/endorsements
Parameters
- Optionaloptions: {
      limit?: number;
      max_id?: string;
      since_id?: string;
  }
  - Optionallimit?: number
    Max number of results to return. Defaults to 40.
  - Optionalmax_id?: string
    Return results older than ID.
  - Optionalsince_id?: string
    Return results newer than ID.
Returns Promise<Response<Account[]>>
Array of accounts.
Implementation of MegalodonInterface.getEndorsements
- Defined in megalodon/src/mastodon.ts:1343

getFavourites

getFavourites(options?): Promise<Response<Status[]>>
GET /api/v1/favourites
Parameters
- Optionaloptions: {
      limit?: number;
      max_id?: string;
      min_id?: string;
  }
  - Optionallimit?: number
    Max number of results to return. Defaults to 40.
  - Optionalmax_id?: string
    Return results older than ID.
  - Optionalmin_id?: string
    Return results immediately newer than ID.
Returns Promise<Response<Status[]>>
Array of statuses.
Implementation of MegalodonInterface.getFavourites
- Defined in megalodon/src/mastodon.ts:919

getFeaturedTags

getFeaturedTags(): Promise<Response<FeaturedTag[]>>
GET /api/v1/featured_tags

Returns Promise<Response<FeaturedTag[]>>
Array of featured tag.
Implementation of MegalodonInterface.getFeaturedTags
- Defined in megalodon/src/mastodon.ts:1377

getFilter

getFilter(id): Promise<Response<Filter>>
GET /api/v1/filters/:id
Parameters
- id: string
  The filter ID.
Returns Promise<Response<Filter>>
Filter.
Implementation of MegalodonInterface.getFilter
- Defined in megalodon/src/mastodon.ts:1096

getFilters

getFilters(): Promise<Response<Filter[]>>
GET /api/v1/filters

Returns Promise<Response<Filter[]>>
Array of filters.
Implementation of MegalodonInterface.getFilters
- Defined in megalodon/src/mastodon.ts:1082

getFollowedTags

getFollowedTags(): Promise<Response<Tag[]>>
GET /api/v1/followed_tags

Returns Promise<Response<Tag[]>>
Array of Tag.
Implementation of MegalodonInterface.getFollowedTags
- Defined in megalodon/src/mastodon.ts:1450

getFollowRequests

getFollowRequests(limit?): Promise<Response<Account[]>>
GET /api/v1/follow_requests
Parameters
- Optionallimit: number
  Maximum number of results.
Returns Promise<Response<Account[]>>
Array of account.
Implementation of MegalodonInterface.getFollowRequests
- Defined in megalodon/src/mastodon.ts:1284

getHomeTimeline

getHomeTimeline(options?): Promise<Response<Status[]>>
GET /api/v1/timelines/home
Parameters
- Optionaloptions: {
      limit?: number;
      local?: boolean;
      max_id?: string;
      min_id?: string;
      since_id?: string;
  }
  - Optionallimit?: number
    Max number of results to return. Defaults to 20.
  - Optionallocal?: boolean
    Show only local statuses? Defaults to false.
  - Optionalmax_id?: string
    Return results older than ID.
  - Optionalmin_id?: string
    Return results immediately newer than ID.
  - Optionalsince_id?: string
    Return results newer than ID.
Returns Promise<Response<Status[]>>
Array of statuses.
Implementation of MegalodonInterface.getHomeTimeline
- Defined in megalodon/src/mastodon.ts:2355

getIdentityProof

getIdentityProof(id): Promise<Response<IdentityProof[]>>
GET /api/v1/accounts/:id/identity_proofs
Parameters
- id: string
  The account ID.
Returns Promise<Response<IdentityProof[]>>
Array of IdentityProof
Implementation of MegalodonInterface.getIdentityProof
- Defined in megalodon/src/mastodon.ts:599

getInstance

getInstance(): Promise<Response<Instance>>
GET /api/v1/instance

Returns Promise<Response<Instance>>
Implementation of MegalodonInterface.getInstance
- Defined in megalodon/src/mastodon.ts:2991

getInstanceActivity

getInstanceActivity(): Promise<Response<Activity[]>>
GET /api/v1/instance/activity

Returns Promise<Response<Activity[]>>
Implementation of MegalodonInterface.getInstanceActivity
- Defined in megalodon/src/mastodon.ts:3009

getInstanceAnnouncements

getInstanceAnnouncements(): Promise<Response<Announcement[]>>
GET /api/v1/announcements

Returns Promise<Response<Announcement[]>>
Array of announcements.
Implementation of MegalodonInterface.getInstanceAnnouncements
- Defined in megalodon/src/mastodon.ts:3111

getInstanceCustomEmojis

getInstanceCustomEmojis(): Promise<Response<Emoji[]>>
GET /api/v1/custom_emojis

Returns Promise<Response<Emoji[]>>
Array of emojis.
Implementation of MegalodonInterface.getInstanceCustomEmojis
- Defined in megalodon/src/mastodon.ts:3095

getInstanceDirectory

getInstanceDirectory(options?): Promise<Response<Account[]>>
GET /api/v1/directory
Parameters
- Optionaloptions: {
      limit?: number;
      local?: boolean;
      offset?: number;
      order?: "active" | "new";
  }
  - Optionallimit?: number
    How many accounts to load. Default 40.
  - Optionallocal?: boolean
    Only return local accounts.
  - Optionaloffset?: number
    How many accounts to skip before returning results. Default 0.
  - Optionalorder?: "active" | "new"
    Order of results.
Returns Promise<Response<Account[]>>
Array of accounts.
Implementation of MegalodonInterface.getInstanceDirectory
- Defined in megalodon/src/mastodon.ts:3051

getInstancePeers

getInstancePeers(): Promise<Response<string[]>>
GET /api/v1/instance/peers

Returns Promise<Response<string[]>>
Implementation of MegalodonInterface.getInstancePeers
- Defined in megalodon/src/mastodon.ts:3002

getInstanceTrends

getInstanceTrends(limit?): Promise<Response<Tag[]>>
GET /api/v1/trends
Parameters
- Optionallimit: null | number
  Maximum number of results to return. Defaults to 10.
Returns Promise<Response<Tag[]>>
Implementation of MegalodonInterface.getInstanceTrends
- Defined in megalodon/src/mastodon.ts:3025

getList

getList(id): Promise<Response<List>>
GET /api/v1/lists/:id
Parameters
- id: string
  Target list ID.
Returns Promise<Response<List>>
List.
Implementation of MegalodonInterface.getList
- Defined in megalodon/src/mastodon.ts:2539

getLists

getLists(): Promise<Response<List[]>>
GET /api/v1/lists

Returns Promise<Response<List[]>>
Array of lists.
Implementation of MegalodonInterface.getLists
- Defined in megalodon/src/mastodon.ts:2525

getListTimeline

getListTimeline(list_id, options?): Promise<Response<Status[]>>
GET /api/v1/timelines/list/:list_id
Parameters
- list_id: string
  Local ID of the list in the database.
- Optionaloptions: {
      limit?: number;
      max_id?: string;
      min_id?: string;
      since_id?: string;
  }
  - Optionallimit?: number
    Max number of results to return. Defaults to 20.
  - Optionalmax_id?: string
    Return results older than ID.
  - Optionalmin_id?: string
    Return results immediately newer than ID.
  - Optionalsince_id?: string
    Return results newer than ID.
Returns Promise<Response<Status[]>>
Array of statuses.
Implementation of MegalodonInterface.getListTimeline
- Defined in megalodon/src/mastodon.ts:2407

getLocalTimeline

getLocalTimeline(options?): Promise<Response<Status[]>>
GET /api/v1/timelines/public
Parameters
- Optionaloptions: {
      limit?: number;
      max_id?: string;
      min_id?: string;
      only_media?: boolean;
      since_id?: string;
  }
  - Optionallimit?: number
    Max number of results to return. Defaults to 20.
  - Optionalmax_id?: string
    Return results older than ID.
  - Optionalmin_id?: string
    Return results immediately newer than ID.
  - Optionalonly_media?: boolean
    Show only statuses with media attached? Defaults to false.
  - Optionalsince_id?: string
    Return results newer than ID.
Returns Promise<Response<Status[]>>
Array of statuses.
Implementation of MegalodonInterface.getLocalTimeline
- Defined in megalodon/src/mastodon.ts:2238

getMarkers

getMarkers(timeline): Promise<Response<Marker | Record<never, never>>>
GET /api/v1/markers
Parameters
- timeline: string[]
Returns Promise<Response<Marker | Record<never, never>>>
Marker or empty object.
Implementation of MegalodonInterface.getMarkers
- Defined in megalodon/src/mastodon.ts:2669

getMedia

getMedia(id): Promise<Response<Attachment>>
GET /api/v1/media/:id
Parameters
- id: string
  Target media ID.
Returns Promise<Response<Attachment>>
Attachment
Implementation of MegalodonInterface.getMedia
- Defined in megalodon/src/mastodon.ts:1998

getMutes

getMutes(options?): Promise<Response<Account[]>>
GET /api/v1/mutes
Parameters
- Optionaloptions: {
      limit?: number;
      max_id?: string;
      min_id?: string;
  }
  - Optionallimit?: number
    Max number of results to return. Defaults to 40.
  - Optionalmax_id?: string
    Return results older than ID.
  - Optionalmin_id?: string
    Return results immediately newer than ID.
Returns Promise<Response<Account[]>>
Array of accounts.
Implementation of MegalodonInterface.getMutes
- Defined in megalodon/src/mastodon.ts:956

getNotification

getNotification(id): Promise<Response<Notification>>
GET /api/v1/notifications/:id
Parameters
- id: string
  Target notification ID.
Returns Promise<Response<Notification>>
Notification.
Implementation of MegalodonInterface.getNotification
- Defined in megalodon/src/mastodon.ts:2784

getNotifications

getNotifications(options?): Promise<Response<Notification[]>>
GET /api/v1/notifications
Parameters
- Optionaloptions: {
      account_id?: string;
      exclude_types?: string[];
      limit?: number;
      max_id?: string;
      min_id?: string;
      since_id?: string;
  }
  - Optionalaccount_id?: string
    Return only notifications received from this account.
  - Optionalexclude_types?: string[]
    Array of types to exclude.
  - Optionallimit?: number
    Max number of results to return. Defaults to 20.
  - Optionalmax_id?: string
    Return results older than ID.
  - Optionalmin_id?: string
    Return results immediately newer than ID.
  - Optionalsince_id?: string
    Return results newer than ID.
Returns Promise<Response<Notification[]>>
Array of notifications.
Implementation of MegalodonInterface.getNotifications
- Defined in megalodon/src/mastodon.ts:2726

getPoll

getPoll(id): Promise<Response<Poll>>
GET /api/v1/polls/:id
Parameters
- id: string
  Target poll ID.
Returns Promise<Response<Poll>>
Poll
Implementation of MegalodonInterface.getPoll
- Defined in megalodon/src/mastodon.ts:2052

getPreferences

getPreferences(): Promise<Response<Preferences>>
GET /api/v1/preferences

Returns Promise<Response<Preferences>>
Preferences.
Implementation of MegalodonInterface.getPreferences
- Defined in megalodon/src/mastodon.ts:1434

getPublicTimeline

getPublicTimeline(options?): Promise<Response<Status[]>>
GET /api/v1/timelines/public
Parameters
- Optionaloptions: {
      limit?: number;
      max_id?: string;
      min_id?: string;
      only_media?: boolean;
      since_id?: string;
  }
  - Optionallimit?: number
    Max number of results to return. Defaults to 20.
  - Optionalmax_id?: string
    Return results older than ID.
  - Optionalmin_id?: string
    Return results immediately newer than ID.
  - Optionalonly_media?: boolean
    Show only statuses with media attached? Defaults to false.
  - Optionalsince_id?: string
    Return results newer than ID.
Returns Promise<Response<Status[]>>
Array of statuses.
Implementation of MegalodonInterface.getPublicTimeline
- Defined in megalodon/src/mastodon.ts:2184

getPushSubscription

getPushSubscription(): Promise<Response<PushSubscription>>
GET /api/v1/push/subscription

Returns Promise<Response<PushSubscription>>
PushSubscription.
Implementation of MegalodonInterface.getPushSubscription
- Defined in megalodon/src/mastodon.ts:2856

getRelationship

getRelationship(id): Promise<Response<Relationship>>
GET /api/v1/accounts/relationships
Parameters
- id: string
  The account ID.
Returns Promise<Response<Relationship>>
Relationship
Implementation of MegalodonInterface.getRelationship
- Defined in megalodon/src/mastodon.ts:760

getRelationships

getRelationships(ids): Promise<Response<Relationship[]>>
GET /api/v1/accounts/relationships
Parameters
- ids: string[]
  Array of account IDs.
Returns Promise<Response<Relationship[]>>
Array of Relationship.
Implementation of MegalodonInterface.getRelationships
- Defined in megalodon/src/mastodon.ts:778

getScheduledStatus

getScheduledStatus(id): Promise<Response<ScheduledStatus>>
GET /api/v1/scheduled_statuses/:id
Parameters
- id: string
  Target status ID.
Returns Promise<Response<ScheduledStatus>>
ScheduledStatus.
Implementation of MegalodonInterface.getScheduledStatus
- Defined in megalodon/src/mastodon.ts:2133

getScheduledStatuses

getScheduledStatuses(options?): Promise<Response<ScheduledStatus[]>>
GET /api/v1/scheduled_statuses
Parameters
- Optionaloptions: {
      limit?: null | number;
      max_id?: null | string;
      min_id?: null | string;
      since_id?: null | string;
  }
  - Optionallimit?: null | number
    Max number of results to return. Defaults to 20.
  - Optionalmax_id?: null | string
    Return results older than ID.
  - Optionalmin_id?: null | string
    Return results immediately newer than ID.
  - Optionalsince_id?: null | string
    Return results newer than ID.
Returns Promise<Response<ScheduledStatus[]>>
Array of scheduled statuses.
Implementation of MegalodonInterface.getScheduledStatuses
- Defined in megalodon/src/mastodon.ts:2091

getStatus

getStatus(id): Promise<Response<Status>>
GET /api/v1/statuses/:id
Parameters
- id: string
  The target status id.
Returns Promise<Response<Status>>
Status
Implementation of MegalodonInterface.getStatus
- Defined in megalodon/src/mastodon.ts:1650

getStatusContext

getStatusContext(id, options?): Promise<Response<Context>>
GET /api/v1/statuses/:id/context

Get parent and child statuses.
Parameters
- id: string
  The target status id.
- Optionaloptions: {
      limit?: number;
      max_id?: string;
      since_id?: string;
  }
  - Optionallimit?: number
  - Optionalmax_id?: string
  - Optionalsince_id?: string
Returns Promise<Response<Context>>
Context
Implementation of MegalodonInterface.getStatusContext
- Defined in megalodon/src/mastodon.ts:1749

getStatusFavouritedBy

getStatusFavouritedBy(id): Promise<Response<Account[]>>
GET /api/v1/statuses/:id/favourited_by
Parameters
- id: string
  The target status id.
Returns Promise<Response<Account[]>>
Array of accounts.
Implementation of MegalodonInterface.getStatusFavouritedBy
- Defined in megalodon/src/mastodon.ts:1813

getStatusRebloggedBy

getStatusRebloggedBy(id): Promise<Response<Account[]>>
GET /api/v1/statuses/:id/reblogged_by
Parameters
- id: string
  The target status id.
Returns Promise<Response<Account[]>>
Array of accounts.
Implementation of MegalodonInterface.getStatusRebloggedBy
- Defined in megalodon/src/mastodon.ts:1799

getStatusSource

getStatusSource(id): Promise<Response<StatusSource>>
GET /api/v1/statuses/:id/source

Obtain the source properties for a status so that it can be edited.
Parameters
- id: string
  The target status id.
Returns Promise<Response<StatusSource>>
StatusSource
Implementation of MegalodonInterface.getStatusSource
- Defined in megalodon/src/mastodon.ts:1785

getSuggestedTags

getSuggestedTags(): Promise<Response<Tag[]>>
GET /api/v1/featured_tags/suggestions

Returns Promise<Response<Tag[]>>
Array of tag.
Implementation of MegalodonInterface.getSuggestedTags
- Defined in megalodon/src/mastodon.ts:1418

getSuggestions

getSuggestions(limit?): Promise<Response<Account[]>>
GET /api/v1/suggestions
Parameters
- Optionallimit: number
  Maximum number of results.
Returns Promise<Response<Account[]>>
Array of accounts.
Implementation of MegalodonInterface.getSuggestions
- Defined in megalodon/src/mastodon.ts:1467

getTag

getTag(id): Promise<Response<Tag>>
GET /api/v1/tags/:id
Parameters
- id: string
  Target hashtag id.
Returns Promise<Response<Tag>>
Tag
Implementation of MegalodonInterface.getTag
- Defined in megalodon/src/mastodon.ts:1496

getTagTimeline

getTagTimeline(hashtag, options?): Promise<Response<Status[]>>
GET /api/v1/timelines/tag/:hashtag
Parameters
- hashtag: string
  Content of a #hashtag, not including # symbol.
- Optionaloptions: {
      limit?: number;
      local?: boolean;
      max_id?: string;
      min_id?: string;
      only_media?: boolean;
      since_id?: string;
  }
  - Optionallimit?: number
    Max number of results to return. Defaults to 20.
  - Optionallocal?: boolean
    Show only local statuses? Defaults to false.
  - Optionalmax_id?: string
    Return results older than ID.
  - Optionalmin_id?: string
    Return results immediately newer than ID.
  - Optionalonly_media?: boolean
    Show only statuses with media attached? Defaults to false.
  - Optionalsince_id?: string
    Return results newer than ID.
Returns Promise<Response<Status[]>>
Array of statuses.
Implementation of MegalodonInterface.getTagTimeline
- Defined in megalodon/src/mastodon.ts:2294

listStreaming

listStreaming(list_id): Promise<Streaming>
Parameters
- list_id: string
Returns Promise<Streaming>
Implementation of MegalodonInterface.listStreaming
- Defined in megalodon/src/mastodon.ts:3210

localStreaming

localStreaming(): Promise<Streaming>
Returns Promise<Streaming>
Implementation of MegalodonInterface.localStreaming
- Defined in megalodon/src/mastodon.ts:3200

lookupAccount

lookupAccount(acct): Promise<Response<Account>>
GET /api/v1/accounts/lookup
Parameters
- acct: string
  The username or Webfinger address to lookup.
Returns Promise<Response<Account>>
Account.
Implementation of MegalodonInterface.lookupAccount
- Defined in megalodon/src/mastodon.ts:850

muteAccount

muteAccount(id, notifications?): Promise<Response<Relationship>>
POST /api/v1/accounts/:id/mute
Parameters
- id: string
  The account ID.
- notifications: boolean = true
  Mute notifications in addition to statuses.
Returns Promise<Response<Relationship>>
Relationship
Implementation of MegalodonInterface.muteAccount
- Defined in megalodon/src/mastodon.ts:679

muteStatus

muteStatus(id): Promise<Response<Status>>
POST /api/v1/statuses/:id/mute
Parameters
- id: string
  The target status id.
Returns Promise<Response<Status>>
Status
Implementation of MegalodonInterface.muteStatus
- Defined in megalodon/src/mastodon.ts:1911

pinAccount

pinAccount(id): Promise<Response<Relationship>>
POST /api/v1/accounts/:id/pin
Parameters
- id: string
  The account ID.
Returns Promise<Response<Relationship>>
Relationship
Implementation of MegalodonInterface.pinAccount
- Defined in megalodon/src/mastodon.ts:711

pinStatus

pinStatus(id): Promise<Response<Status>>
POST /api/v1/statuses/:id/pin
Parameters
- id: string
  The target status id.
Returns Promise<Response<Status>>
Status
Implementation of MegalodonInterface.pinStatus
- Defined in megalodon/src/mastodon.ts:1938

postStatus

postStatus(status, options): Promise<Response<Status | ScheduledStatus>>
POST /api/v1/statuses
Parameters
- status: string
  Text content of status.
- options: {
      in_reply_to_id?: string;
      language?: string;
      media_ids?: string[];
      poll?: {
          expires_in: number;
          hide_totals?: boolean;
          multiple?: boolean;
          options: string[];
      };
      quote_id?: string;
      scheduled_at?: string;
      sensitive?: boolean;
      spoiler_text?: string;
      visibility?: StatusVisibility;
  }
  - Optionalin_reply_to_id?: string
    ID of the status being replied to, if status is a reply.
  - Optionallanguage?: string
    ISO 639 language code for this status.
  - Optionalmedia_ids?: string[]
    Array of Attachment ids.
  - Optionalpoll?: {
        expires_in: number;
        hide_totals?: boolean;
        multiple?: boolean;
        options: string[];
    }
    Poll object.
    - expires_in: number
    - Optionalhide_totals?: boolean
    - Optionalmultiple?: boolean
    - options: string[]
  - Optionalquote_id?: string
    ID of the status being quoted to, if status is a quote.
  - Optionalscheduled_at?: string
    ISO 8601 Datetime at which to schedule a status.
  - Optionalsensitive?: boolean
    Mark status and attached media as sensitive?
  - Optionalspoiler_text?: string
    Text to be shown as a warning or subject before the actual content.
  - Optionalvisibility?: StatusVisibility
    Visibility of the posted status.
Returns Promise<Response<Status | ScheduledStatus>>
Status. When options.scheduled_at is present, ScheduledStatus is returned instead.
Implementation of MegalodonInterface.postStatus
- Defined in megalodon/src/mastodon.ts:1550

publicStreaming

publicStreaming(): Promise<Streaming>
Returns Promise<Streaming>
Implementation of MegalodonInterface.publicStreaming
- Defined in megalodon/src/mastodon.ts:3195

readConversation

readConversation(id): Promise<Response<Conversation>>
POST /api/v1/conversations/:id/read
Parameters
- id: string
  Target conversation ID.
Returns Promise<Response<Conversation>>
Conversation.
Implementation of MegalodonInterface.readConversation
- Defined in megalodon/src/mastodon.ts:2509

readNotifications

readNotifications(_options): Promise<Response<{}>>
Mark as read all unread notifications.
Parameters
- _options: {
  id?: string;
  max_id?: string;
  }
  - Optionalid?: string
  - Optionalmax_id?: string
Returns Promise<Response<{}>>
Implementation of MegalodonInterface.readNotifications
- Defined in megalodon/src/mastodon.ts:2809

reblogStatus

reblogStatus(id): Promise<Response<Status>>
POST /api/v1/statuses/:id/reblog
Parameters
- id: string
  The target status id.
Returns Promise<Response<Status>>
Status.
Implementation of MegalodonInterface.reblogStatus
- Defined in megalodon/src/mastodon.ts:1855

refreshToken

refreshToken(client_id, client_secret, refresh_token): Promise<TokenData>
POST /oauth/token

Revoke an OAuth token.
Parameters
- client_id: string
  will be generated by #createApp or #registerApp
- client_secret: string
  will be generated by #createApp or #registerApp
- refresh_token: string
Returns Promise<TokenData>
Implementation of MegalodonInterface.refreshToken
- Defined in megalodon/src/mastodon.ts:179

registerAccount

registerAccount(username, email, password, agreement, locale, reason?): Promise<Response<Token>>
POST /api/v1/accounts
Parameters
- username: string
  Username for the account.
- email: string
  Email for the account.
- password: string
  Password for the account.
- agreement: boolean
  Whether the user agrees to the local rules, terms, and policies.
- locale: string
  The language of the confirmation email that will be sent
- Optionalreason: null | string
  Text that will be reviewed by moderators if registrations require manual approval.
Returns Promise<Response<Token>>
An account token.
Implementation of MegalodonInterface.registerAccount
- Defined in megalodon/src/mastodon.ts:220

registerApp

registerApp(client_name, options): Promise<AppData>
Call /api/v1/apps

Create an application.
Parameters
- client_name: string
  your application's name
- options: Partial<{
      redirect_uris: string;
      scopes: string[];
      website: string;
  }>
  Form Data
Returns Promise<AppData>
Implementation of MegalodonInterface.registerApp
- Defined in megalodon/src/mastodon.ts:49

rejectFollowRequest

rejectFollowRequest(id): Promise<Response<Relationship>>
POST /api/v1/follow_requests/:id/reject
Parameters
- id: string
  Target account ID.
Returns Promise<Response<Relationship>>
Relationship.
Implementation of MegalodonInterface.rejectFollowRequest
- Defined in megalodon/src/mastodon.ts:1324

removeReactionFromAnnouncement

removeReactionFromAnnouncement(id, name): Promise<Response<Record<never, never>>>
DELETE /api/v1/announcements/:id/reactions/:name
Parameters
- id: string
  The ID of the Announcement in the database.
- name: string
  Unicode emoji, or the shortcode of a custom emoji.
Returns Promise<Response<Record<never, never>>>
Implementation of MegalodonInterface.removeReactionFromAnnouncement
- Defined in megalodon/src/mastodon.ts:3144

report

report(account_id, options?): Promise<Response<Report>>
POST /api/v1/reports
Parameters
- account_id: string
  Target account ID.
- Optionaloptions: {
      category?: Category;
      comment: string;
      forward?: boolean;
      rule_ids?: number[];
      status_ids?: string[];
  }
  - Optionalcategory?: Category
    Specify if the report is due to spam, violation of enumerated instance rules, or some other reason. Defaults to other. Will be set to violation if rule_ids[] is provided (regardless of any category value you provide).
  - comment: string
    The reason for the report. Default maximum of 1000 characters.
  - Optionalforward?: boolean
    If the account is remote, should the report be forwarded to the remote admin?
  - Optionalrule_ids?: number[]
    For violation category reports, specify the ID of the exact rules broken. Rules and their IDs are available via GET /api/v1/instance/rules and GET /api/v1/instance.
  - Optionalstatus_ids?: string[]
    Array of Statuses ids to attach to the report.
Returns Promise<Response<Report>>
Report
Implementation of MegalodonInterface.report
- Defined in megalodon/src/mastodon.ts:1228

revokeToken

revokeToken(client_id, client_secret, token): Promise<Response<{}>>
POST /oauth/revoke

Revoke an OAuth token.
Parameters
- client_id: string
  will be generated by #createApp or #registerApp
- client_secret: string
  will be generated by #createApp or #registerApp
- token: string
  will be get #fetchAccessToken
Returns Promise<Response<{}>>
Implementation of MegalodonInterface.revokeToken
- Defined in megalodon/src/mastodon.ts:198

saveMarkers

saveMarkers(options?): Promise<Response<Marker>>
POST /api/v1/markers
Parameters
- Optionaloptions: {
      home?: {
          last_read_id: string;
      };
      notifications?: {
          last_read_id: string;
      };
  }
  - Optionalhome?: {
    last_read_id: string;
    }
    Marker position of the last read status ID in home timeline.
    - last_read_id: string
  - Optionalnotifications?: {
    last_read_id: string;
    }
    Marker position of the last read notification ID in notifications.
    - last_read_id: string
Returns Promise<Response<Marker>>
Marker.
Implementation of MegalodonInterface.saveMarkers
- Defined in megalodon/src/mastodon.ts:2688

scheduleStatus

scheduleStatus(id, scheduled_at?): Promise<Response<ScheduledStatus>>
PUT /api/v1/scheduled_statuses/:id
Parameters
- id: string
  Target scheduled status ID.
- Optionalscheduled_at: null | string
  ISO 8601 Datetime at which the status will be published.
Returns Promise<Response<ScheduledStatus>>
ScheduledStatus.
Implementation of MegalodonInterface.scheduleStatus
- Defined in megalodon/src/mastodon.ts:2148

search

search(q, options?): Promise<Response<Results>>
GET /api/v2/search
Parameters
- q: string
  The search query.
- Optionaloptions: {
      account_id?: string;
      exclude_unreviewed?: boolean;
      following?: boolean;
      limit?: number;
      max_id?: string;
      min_id?: string;
      offset?: number;
      resolve?: boolean;
      type?: "accounts" | "hashtags" | "statuses";
  }
  - Optionalaccount_id?: string
    If provided, statuses returned will be authored only by this account.
  - Optionalexclude_unreviewed?: boolean
    Filter out unreviewed tags? Defaults to false.
  - Optionalfollowing?: boolean
    Only include accounts that the user is following. Defaults to false.
  - Optionallimit?: number
    Maximum number of results to load, per type. Defaults to 20. Max 40.
  - Optionalmax_id?: string
    Return results older than this id.
  - Optionalmin_id?: string
    Return results immediately newer than this id.
  - Optionaloffset?: number
  - Optionalresolve?: boolean
    Attempt WebFinger lookup. Defaults to false.
  - Optionaltype?: "accounts" | "hashtags" | "statuses"
Returns Promise<Response<Results>>
Results.
Implementation of MegalodonInterface.search
- Defined in megalodon/src/mastodon.ts:2914

searchAccount

searchAccount(q, options?): Promise<Response<Account[]>>
GET /api/v1/accounts/search
Parameters
- q: string
  Search query.
- Optionaloptions: {
      following?: boolean;
      limit?: number;
      max_id?: string;
      resolve?: boolean;
      since_id?: string;
  }
  - Optionalfollowing?: boolean
  - Optionallimit?: number
    Max number of results to return. Defaults to 40.
  - Optionalmax_id?: string
    Return results older than ID.
  - Optionalresolve?: boolean
  - Optionalsince_id?: string
    Return results newer than ID.
Returns Promise<Response<Account[]>>
The array of accounts.
Implementation of MegalodonInterface.searchAccount
- Defined in megalodon/src/mastodon.ts:799

setAccountNote

setAccountNote(id, note?): Promise<Response<Relationship>>
POST /api/v1/accounts/:id/note
Parameters
- id: string
- Optionalnote: string
Returns Promise<Response<Relationship>>
Relationship
Implementation of MegalodonInterface.setAccountNote
- Defined in megalodon/src/mastodon.ts:740

streamingURL

streamingURL(): Promise<string>
Returns Promise<string>
Implementation of MegalodonInterface.streamingURL
- Defined in megalodon/src/mastodon.ts:3182

subscribeAccount

subscribeAccount(id): Promise<Response<Relationship>>
POST /api/v1/accounts/:id/follow
Parameters
- id: string
  Target account ID.
Returns Promise<Response<Relationship>>
Relationship.
Implementation of MegalodonInterface.subscribeAccount
- Defined in megalodon/src/mastodon.ts:446

subscribePushNotification

subscribePushNotification(subscription, data?): Promise<Response<PushSubscription>>
POST /api/v1/push/subscription
Parameters
- subscription: {
      endpoint: string;
      keys: {
          auth: string;
          p256dh: string;
      };
  }
  - endpoint: string
  - keys: {
    auth: string;
    p256dh: string;
    }
    - auth: string
    - p256dh: string
- Optionaldata: null | {
      alerts: {
          favourite?: boolean;
          follow?: boolean;
          mention?: boolean;
          poll?: boolean;
          reblog?: boolean;
      };
  }
Returns Promise<Response<PushSubscription>>
PushSubscription.
Implementation of MegalodonInterface.subscribePushNotification
- Defined in megalodon/src/mastodon.ts:2832

tagStreaming

tagStreaming(tag): Promise<Streaming>
Parameters
- tag: string
Returns Promise<Streaming>
Implementation of MegalodonInterface.tagStreaming
- Defined in megalodon/src/mastodon.ts:3205

unblockAccount

unblockAccount(id): Promise<Response<Relationship>>
POST /api/v1/accounts/:id/unblock
Parameters
- id: string
  The account ID.
Returns Promise<Response<Relationship>>
RElationship
Implementation of MegalodonInterface.unblockAccount
- Defined in megalodon/src/mastodon.ts:664

unblockDomain

unblockDomain(domain): Promise<Response<{}>>
DELETE /api/v1/domain_blocks
Parameters
- domain: string
  Domain to unblock
Returns Promise<Response<{}>>
Implementation of MegalodonInterface.unblockDomain
- Defined in megalodon/src/mastodon.ts:1068

unbookmarkStatus

unbookmarkStatus(id): Promise<Response<Status>>
POST /api/v1/statuses/:id/unbookmark
Parameters
- id: string
  The target status id.
Returns Promise<Response<Status>>
Status.
Implementation of MegalodonInterface.unbookmarkStatus
- Defined in megalodon/src/mastodon.ts:1897

unfavouriteStatus

unfavouriteStatus(id): Promise<Response<Status>>
POST /api/v1/statuses/:id/unfavourite
Parameters
- id: string
  The target status id.
Returns Promise<Response<Status>>
Status.
Implementation of MegalodonInterface.unfavouriteStatus
- Defined in megalodon/src/mastodon.ts:1841

unfollowAccount

unfollowAccount(id): Promise<Response<Relationship>>
POST /api/v1/accounts/:id/unfollow
Parameters
- id: string
  The account ID.
Returns Promise<Response<Relationship>>
Relationship
Implementation of MegalodonInterface.unfollowAccount
- Defined in megalodon/src/mastodon.ts:636

unfollowTag

unfollowTag(id): Promise<Response<Tag>>
POST /api/v1/tags/:id/unfollow
Parameters
- id: string
  Target hashtag id.
Returns Promise<Response<Tag>>
Tag
Implementation of MegalodonInterface.unfollowTag
- Defined in megalodon/src/mastodon.ts:1524

unmuteAccount

unmuteAccount(id): Promise<Response<Relationship>>
POST /api/v1/accounts/:id/unmute
Parameters
- id: string
  The account ID.
Returns Promise<Response<Relationship>>
Relationship
Implementation of MegalodonInterface.unmuteAccount
- Defined in megalodon/src/mastodon.ts:697

unmuteStatus

unmuteStatus(id): Promise<Response<Status>>
POST /api/v1/statuses/:id/unmute
Parameters
- id: string
  The target status id.
Returns Promise<Response<Status>>
Status
Implementation of MegalodonInterface.unmuteStatus
- Defined in megalodon/src/mastodon.ts:1925

unpinAccount

unpinAccount(id): Promise<Response<Relationship>>
POST /api/v1/accounts/:id/unpin
Parameters
- id: string
  The account ID.
Returns Promise<Response<Relationship>>
Relationship
Implementation of MegalodonInterface.unpinAccount
- Defined in megalodon/src/mastodon.ts:725

unpinStatus

unpinStatus(id): Promise<Response<Status>>
POST /api/v1/statuses/:id/unpin
Parameters
- id: string
  The target status id.
Returns Promise<Response<Status>>
Status
Implementation of MegalodonInterface.unpinStatus
- Defined in megalodon/src/mastodon.ts:1952

unreblogStatus

unreblogStatus(id): Promise<Response<Status>>
POST /api/v1/statuses/:id/unreblog
Parameters
- id: string
  The target status id.
Returns Promise<Response<Status>>
Status.
Implementation of MegalodonInterface.unreblogStatus
- Defined in megalodon/src/mastodon.ts:1869

unsubscribeAccount

unsubscribeAccount(id): Promise<Response<Relationship>>
POST /api/v1/accounts/:id/follow
Parameters
- id: string
  Target account ID.
Returns Promise<Response<Relationship>>
Relationship.
Implementation of MegalodonInterface.unsubscribeAccount
- Defined in megalodon/src/mastodon.ts:463

updateCredentials

updateCredentials(options?): Promise<Response<Account>>
PATCH /api/v1/accounts/update_credentials
Parameters
- Optionaloptions: {
      avatar?: string;
      bot?: boolean;
      discoverable?: boolean;
      display_name?: string;
      fields_attributes?: {
          name: string;
          value: string;
      }[];
      header?: string;
      locked?: boolean;
      note?: string;
      source?: {
          language?: string;
          privacy?: string;
          sensitive?: boolean;
      };
  }
  - Optionalavatar?: string
  - Optionalbot?: boolean
  - Optionaldiscoverable?: boolean
  - Optionaldisplay_name?: string
  - Optionalfields_attributes?: {
    name: string;
    value: string;
    }[]
  - Optionalheader?: string
  - Optionallocked?: boolean
  - Optionalnote?: string
  - Optionalsource?: {
        language?: string;
        privacy?: string;
        sensitive?: boolean;
    }
    - Optionallanguage?: string
    - Optionalprivacy?: string
    - Optionalsensitive?: boolean
Returns Promise<Response<Account>>
An account.
Implementation of MegalodonInterface.updateCredentials
- Defined in megalodon/src/mastodon.ts:265

updateFilter

updateFilter(id, phrase, context, options?): Promise<Response<Filter>>
PUT /api/v1/filters/:id
Parameters
- id: string
  The filter ID.
- phrase: string
  Text to be filtered.
- context: string[]
  Array of enumerable strings home, notifications, public, thread, account. At least one context must be specified.
- Optionaloptions: {
      expires_in?: string;
      irreversible?: boolean;
      whole_word?: boolean;
  }
  - Optionalexpires_in?: string
    ISO 8601 Datetime for when the filter expires.
  - Optionalirreversible?: boolean
    Should the server irreversibly drop matching entities from home and notifications?
  - Optionalwhole_word?: boolean
    Consider word boundaries?
Returns Promise<Response<Filter>>
Filter
Implementation of MegalodonInterface.updateFilter
- Defined in megalodon/src/mastodon.ts:1162

updateList

updateList(id, title): Promise<Response<List>>
PUT /api/v1/lists/:id
Parameters
- id: string
  Target list ID.
- title: string
  New list name.
Returns Promise<Response<List>>
List.
Implementation of MegalodonInterface.updateList
- Defined in megalodon/src/mastodon.ts:2572

updateMedia

updateMedia(id, options?): Promise<Response<Attachment>>
PUT /api/v1/media/:id
Parameters
- id: string
  Target media ID.
- Optionaloptions: {
      description?: string;
      file?: any;
      focus?: string;
  }
  - Optionaldescription?: string
    A plain-text description of the media.
  - Optionalfile?: any
    The file to be attached, using multipart form data.
  - Optionalfocus?: string
    Two floating points (x,y), comma-delimited, ranging from -1.0 to 1.0.
Returns Promise<Response<Attachment>>
Attachment
Implementation of MegalodonInterface.updateMedia
- Defined in megalodon/src/mastodon.ts:2016

updatePushSubscription

updatePushSubscription(data?): Promise<Response<PushSubscription>>
PUT /api/v1/push/subscription
Parameters
- Optionaldata: null | {
      alerts: {
          favourite?: boolean;
          follow?: boolean;
          mention?: boolean;
          poll?: boolean;
          reblog?: boolean;
      };
  }
Returns Promise<Response<PushSubscription>>
PushSubscription.
Implementation of MegalodonInterface.updatePushSubscription
- Defined in megalodon/src/mastodon.ts:2874

uploadMedia

uploadMedia(file, options?): Promise<Response<Attachment | AsyncAttachment>>
POST /api/v2/media
Parameters
- file: any
  The file to be attached, using multipart form data.
- Optionaloptions: {
  description?: string;
  focus?: string;
  }
  - Optionaldescription?: string
    A plain-text description of the media.
  - Optionalfocus?: string
    Two floating points (x,y), comma-delimited, ranging from -1.0 to 1.0.
Returns Promise<Response<Attachment | AsyncAttachment>>
Attachment
Implementation of MegalodonInterface.uploadMedia
- Defined in megalodon/src/mastodon.ts:1971

userStreaming

userStreaming(): Promise<Streaming>
Returns Promise<Streaming>
Implementation of MegalodonInterface.userStreaming
- Defined in megalodon/src/mastodon.ts:3190

verifyAccountCredentials

verifyAccountCredentials(): Promise<Response<Account>>
GET /api/v1/accounts/verify_credentials

Returns Promise<Response<Account>>
Account.
Implementation of MegalodonInterface.verifyAccountCredentials
- Defined in megalodon/src/mastodon.ts:252

verifyAppCredentials

verifyAppCredentials(): Promise<Response<Application>>
GET /api/v1/apps/verify_credentials

Returns Promise<Response<Application>>
An Application
Implementation of MegalodonInterface.verifyAppCredentials
- Defined in megalodon/src/mastodon.ts:134

votePoll

votePoll(id, choices): Promise<Response<Poll>>
POST /api/v1/polls/:id/votes
Parameters
- id: string
  Target poll ID.
- choices: number[]
  Array of own votes containing index for each option (starting from 0).
Returns Promise<Response<Poll>>
Poll
Implementation of MegalodonInterface.votePoll
- Defined in megalodon/src/mastodon.ts:2067

Class Mastodon

Implements

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

Returns Mastodon

Properties

baseUrl

client

Methods

acceptFollowRequest

Parameters

Returns Promise<Response<Relationship>>

addAccountsToList

Parameters

Returns Promise<Response<{}>>

addReactionToAnnouncement

Parameters

Returns Promise<Response<Record<never, never>>>

blockAccount

Parameters

Returns Promise<Response<Relationship>>

blockDomain

Parameters

Returns Promise<Response<{}>>

bookmarkStatus

Parameters

Returns Promise<Response<Status>>

cancel

Returns void

cancelScheduledStatus

Parameters

Returns Promise<Response<{}>>

createApp

Parameters

Returns Promise<AppData>

createEmojiReaction

Parameters

Returns Promise<Response<Status>>

createFeaturedTag

Parameters

Returns Promise<Response<FeaturedTag>>

createFilter

Parameters

Optionalexpires_in?: string

Optionalirreversible?: boolean

Optionalwhole_word?: boolean

Returns Promise<Response<Filter>>

createList

Parameters

Returns Promise<Response<List>>

deleteAccountsFromList

Parameters

Returns Promise<Response<{}>>

deleteConversation

Parameters

Returns Promise<Response<{}>>

deleteEmojiReaction

Parameters

Returns Promise<Response<Status>>

deleteFeaturedTag

Parameters

Returns Promise<Response<{}>>

deleteFilter

Parameters

Returns Promise<Response<Filter>>

deleteList

Parameters

Returns Promise<Response<{}>>

deletePushSubscription

Returns Promise<Response<{}>>

deleteStatus

Parameters

Returns Promise<Response<Status>>

directStreaming

Returns Promise<Streaming>

`Optional`expires_in?: string

`Optional`irreversible?: boolean

`Optional`whole_word?: boolean

`Optional`media_ids?: string[]

`Optional`poll?: {
expires_in?: number;
hide_totals?: boolean;
multiple?: boolean;
options?: string[];
}

`Optional`expires_in?: number

`Optional`hide_totals?: boolean

`Optional`multiple?: boolean

`Optional`options?: string[]

`Optional`sensitive?: boolean

`Optional`spoiler_text?: string

`Optional`status?: string

`Optional`reblog?: boolean

`Optional`limit?: number

`Optional`max_id?: string

`Optional`since_id?: string

`Optional`get_all?: boolean

`Optional`limit?: number

`Optional`max_id?: string

`Optional`since_id?: string

`Optional`sleep_ms?: number

`Optional`get_all?: boolean

`Optional`limit?: number

`Optional`max_id?: string

`Optional`since_id?: string

`Optional`sleep_ms?: number

`Optional`limit?: number

`Optional`max_id?: string

`Optional`since_id?: string