Class Pleroma

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 Pleroma(baseUrl, accessToken?, userAgent?): Pleroma
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 Pleroma
- Defined in megalodon/src/pleroma.ts:24

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/pleroma.ts:1289

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/pleroma.ts:2610

addReactionToAnnouncement

addReactionToAnnouncement(_id, _name): Promise<Response<Record<never, never>>>
PUT /api/v1/announcements/:id/reactions/:name
Parameters
- _id: string
- _name: string
Returns Promise<Response<Record<never, never>>>
Implementation of MegalodonInterface.addReactionToAnnouncement
- Defined in megalodon/src/pleroma.ts:3121

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/pleroma.ts:645

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/pleroma.ts:1036

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/pleroma.ts:1851

cancel

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

Returns void
void
Implementation of MegalodonInterface.cancel
- Defined in megalodon/src/pleroma.ts:37

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/pleroma.ts:2135

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/pleroma.ts:70

createEmojiReaction

createEmojiReaction(id, emoji): Promise<Response<Status>>
PUT /api/v1/pleroma/statuses/:status_id/reactions/:emoji
Parameters
- id: string
  Target status ID.
- emoji: string
  Reaction emoji string. This string is raw unicode emoji or custom emoji name (not shortcode).
Returns Promise<Response<Status>>
Implementation of MegalodonInterface.createEmojiReaction
- Defined in megalodon/src/pleroma.ts:3150

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/pleroma.ts:1370

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/pleroma.ts:1093

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/pleroma.ts:2521

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/pleroma.ts:2622

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/pleroma.ts:2467

deleteEmojiReaction

deleteEmojiReaction(id, emoji): Promise<Response<Status>>
DELETE /api/v1/pleroma/statuses/:status_id/reactions/:emoji
Parameters
- id: string
  Target status ID.
- emoji: string
  Reaction emoji string. This string is raw unicode emoji or custom emoji name (not shortcode).
Returns Promise<Response<Status>>
Implementation of MegalodonInterface.deleteEmojiReaction
- Defined in megalodon/src/pleroma.ts:3166

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/pleroma.ts:1388

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/pleroma.ts:1185

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/pleroma.ts:2557

deletePushSubscription

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

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

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/pleroma.ts:1702

directStreaming

directStreaming(): Promise<WebSocket>
Returns Promise<WebSocket>
Implementation of MegalodonInterface.directStreaming
- Defined in megalodon/src/pleroma.ts:3237

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/pleroma.ts:3111

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/pleroma.ts:2773

dismissNotifications

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

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

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/pleroma.ts:1632

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/pleroma.ts:1795

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/pleroma.ts:149

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/pleroma.ts:609

followTag

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

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/pleroma.ts:101

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/pleroma.ts:340

getAccountFavourites

getAccountFavourites(id, options?): Promise<Response<Status[]>>
GET /api/v1/pleroma/accounts/:id/favourites
Parameters
- id: string
  Target account ID.
- Optionaloptions: {
      limit?: number;
      max_id?: string;
      since_id?: string;
  }
  - Optionallimit?: number
    Max number of results to return.
  - Optionalmax_id?: string
    Return results order than ID.
  - Optionalsince_id?: string
    Return results newer than ID.
Returns Promise<Response<Status[]>>
Array of statuses.
Implementation of MegalodonInterface.getAccountFavourites
- Defined in megalodon/src/pleroma.ts:429

getAccountFollowers

getAccountFollowers(id, options?): Promise<Response<Account[]>>
GET /api/v1/accounts/:id/followers
Parameters
- id: string
  The account ID.
- 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[]>>
The array of accounts.
Implementation of MegalodonInterface.getAccountFollowers
- Defined in megalodon/src/pleroma.ts:499

getAccountFollowing

getAccountFollowing(id, options?): Promise<Response<Account[]>>
GET /api/v1/accounts/:id/following
Parameters
- id: string
  The account ID.
- 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[]>>
The array of accounts.
Implementation of MegalodonInterface.getAccountFollowing
- Defined in megalodon/src/pleroma.ts:541

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/pleroma.ts:580

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/pleroma.ts:2571

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;
      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.
  - Optionalonly_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/pleroma.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/pleroma.ts:972

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/pleroma.ts:851

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/pleroma.ts:2426

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/pleroma.ts:1009

getEmojiReaction

getEmojiReaction(id, emoji): Promise<Response<Reaction>>
GET /api/v1/pleroma/statuses/:status_id/reactions/:emoji
Parameters
- id: string
  Target status ID.
- emoji: string
  Reaction emoji string. This string is raw unicode emoji or custom emoji name (not shortcode).
Returns Promise<Response<Reaction>>
Implementation of MegalodonInterface.getEmojiReaction
- Defined in megalodon/src/pleroma.ts:3193

getEmojiReactions

getEmojiReactions(id): Promise<Response<Reaction[]>>
GET /api/v1/pleroma/statuses/:status_id/reactions
Parameters
- id: string
  Target status ID.
Returns Promise<Response<Reaction[]>>
Implementation of MegalodonInterface.getEmojiReactions
- Defined in megalodon/src/pleroma.ts:3179

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/pleroma.ts:1322

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/pleroma.ts:898

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/pleroma.ts:1356

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/pleroma.ts:1075

getFilters

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

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

getFollowedTags

getFollowedTags(): Promise<Response<Tag[]>>
View all followed tags.

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

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/pleroma.ts:1263

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/pleroma.ts:2323

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/pleroma.ts:594

getInstance

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

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

getInstanceActivity

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

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

getInstanceAnnouncements

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

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

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/pleroma.ts:3082

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/pleroma.ts:3038

getInstancePeers

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

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

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/pleroma.ts:3012

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/pleroma.ts:2507

getLists

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

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

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/pleroma.ts:2375

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/pleroma.ts:2206

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/pleroma.ts:2637

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/pleroma.ts:1966

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/pleroma.ts:935

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/pleroma.ts:2752

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/pleroma.ts:2694

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/pleroma.ts:2020

getPreferences

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

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

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/pleroma.ts:2152

getPushSubscription

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

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

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/pleroma.ts:741

getRelationships

getRelationships(ids): Promise<Response<Relationship[]>>
Get multiple relationships in one method
Parameters
- ids: string[]
  Array of account IDs.
Returns Promise<Response<Relationship[]>>
Array of Relationship.
Implementation of MegalodonInterface.getRelationships
- Defined in megalodon/src/pleroma.ts:759

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/pleroma.ts:2101

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/pleroma.ts:2059

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/pleroma.ts:1618

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/pleroma.ts:1717

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/pleroma.ts:1781

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/pleroma.ts:1767

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/pleroma.ts:1753

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/pleroma.ts:1397

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/pleroma.ts:1440

getTag

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

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/pleroma.ts:2262

listStreaming

listStreaming(list_id): Promise<WebSocket>
Parameters
- list_id: string
Returns Promise<WebSocket>
Implementation of MegalodonInterface.listStreaming
- Defined in megalodon/src/pleroma.ts:3232

localStreaming

localStreaming(): Promise<WebSocket>
Returns Promise<WebSocket>
Implementation of MegalodonInterface.localStreaming
- Defined in megalodon/src/pleroma.ts:3222

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/pleroma.ts:831

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/pleroma.ts:674

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/pleroma.ts:1879

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/pleroma.ts:706

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/pleroma.ts:1906

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?:
          | "direct"
          | "private"
          | "public"
          | "unlisted";
  }
  - 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?:
        | "direct"
        | "private"
        | "public"
        | "unlisted"
    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/pleroma.ts:1520

publicStreaming

publicStreaming(): Promise<WebSocket>
Returns Promise<WebSocket>
Implementation of MegalodonInterface.publicStreaming
- Defined in megalodon/src/pleroma.ts:3217

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/pleroma.ts:2477

readNotifications

readNotifications(options): Promise<Response<{}>>
POST /api/v1/pleroma/notifcations/read
Parameters
- options: {
  id?: string;
  max_id?: string;
  }
  - Optionalid?: string
  - Optionalmax_id?: string
Returns Promise<Response<{}>>
Array of notifications
Implementation of MegalodonInterface.readNotifications
- Defined in megalodon/src/pleroma.ts:2784

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/pleroma.ts:1823

refreshToken

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

Refresh OAuth access token. Send refresh token and get new access 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
  will be get #fetchAccessToken
Returns Promise<TokenData>
Implementation of MegalodonInterface.refreshToken
- Defined in megalodon/src/pleroma.ts:178

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/pleroma.ts:219

registerApp

registerApp(client_name, options): Promise<AppData>
First, call createApp to get client_id and client_secret. Next, call generateAuthUrl to get authorization url.
Parameters
- client_name: string
  Form Data, which is sent to /api/v1/apps
- options: Partial<{
      redirect_uris: string;
      scopes: string[];
      website: string;
  }>
  Form Data, which is sent to /api/v1/apps. and properties should be snake_case
Returns Promise<AppData>
Implementation of MegalodonInterface.registerApp
- Defined in megalodon/src/pleroma.ts:47

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/pleroma.ts:1303

removeReactionFromAnnouncement

removeReactionFromAnnouncement(_id, _name): Promise<Response<Record<never, never>>>
DELETE /api/v1/announcements/:id/reactions/:name
Parameters
- _id: string
- _name: string
Returns Promise<Response<Record<never, never>>>
Implementation of MegalodonInterface.removeReactionFromAnnouncement
- Defined in megalodon/src/pleroma.ts:3134

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/pleroma.ts:1207

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/pleroma.ts:197

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/pleroma.ts:2656

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/pleroma.ts:2116

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"
    Enum of search target.
Returns Promise<Response<Results>>
Results.
Implementation of MegalodonInterface.search
- Defined in megalodon/src/pleroma.ts:2901

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/pleroma.ts:780

setAccountNote

setAccountNote(_id): Promise<Response<Relationship>>
Sets a private note on a user.
Parameters
- _id: string
Returns Promise<Response<Relationship>>
Relationship
Implementation of MegalodonInterface.setAccountNote
- Defined in megalodon/src/pleroma.ts:728

streamingURL

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

subscribeAccount

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

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/pleroma.ts:2819

tagStreaming

tagStreaming(tag): Promise<WebSocket>
Parameters
- tag: string
Returns Promise<WebSocket>
Implementation of MegalodonInterface.tagStreaming
- Defined in megalodon/src/pleroma.ts:3227

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/pleroma.ts:659

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/pleroma.ts:1047

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/pleroma.ts:1865

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/pleroma.ts:1809

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/pleroma.ts:631

unfollowTag

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

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/pleroma.ts:692

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/pleroma.ts:1893

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/pleroma.ts:720

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/pleroma.ts:1920

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/pleroma.ts:1837

unsubscribeAccount

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

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/pleroma.ts:264

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/pleroma.ts:1141

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/pleroma.ts:2540

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/pleroma.ts:1984

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/pleroma.ts:2861

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/pleroma.ts:1939

userStreaming

userStreaming(): Promise<WebSocket>
Returns Promise<WebSocket>
Implementation of MegalodonInterface.userStreaming
- Defined in megalodon/src/pleroma.ts:3212

verifyAccountCredentials

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

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

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/pleroma.ts:132

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/pleroma.ts:2035

Class Pleroma

Implements

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

Returns Pleroma

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

`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`limit?: number

`Optional`max_id?: string

`Optional`since_id?: string

`Optional`limit?: number

`Optional`max_id?: string

`Optional`since_id?: string

`Optional`limit?: number

`Optional`max_id?: string

`Optional`since_id?: string

`Optional`exclude_reblogs?: boolean

`Optional`exclude_replies?: boolean