Skip to main content
Version: Beta

WatchlistMutation

type WatchlistMutation {
  create(
    name: String!
    companyIds: [String!]!
    shared: Boolean!
    userId: Int
    isFavourite: Boolean
  ): Watchlist!
  patch(
    watchlist: UpdateWatchlistInput!
  ): Watchlist!
  addCompanies(
    watchlist: UpdateWatchlistCompaniesInput!
  ): [String!]!
  removeCompanies(
    watchlist: UpdateWatchlistCompaniesInput!
  ): [String!]!
  delete(
    id: Int!
  ): WatchlistMutationResult!
  deleteWatchlists(
    ids: [Int!]!
  ): [Int!]
}

Fields​

WatchlistMutation.create ● Watchlist! non-null object​

Create a watchlist with the given name and a list of AS ID. @exposed

WatchlistMutation.create.name ● String! non-null scalar​

Name of the watchlist

WatchlistMutation.create.companyIds ● [String!]! non-null scalar​

List of company Ids. The company id could be AS ID, ticker code or ISIN.

WatchlistMutation.create.shared ● Boolean! non-null scalar​

share watchlist with other users

WatchlistMutation.create.userId ● Int scalar​

Owner of the watchlist, specify if you want to create this watchlist for someone else. Only available for watchlist admins.

WatchlistMutation.create.isFavourite ● Boolean scalar​

Watchlist favourite status. If true, then user has marked this watchlist as his favourite

WatchlistMutation.patch ● Watchlist! non-null object​

Update the watchlist partially by watchlist ID @exposed

WatchlistMutation.patch.watchlist ● UpdateWatchlistInput! non-null input​

Watchlist Input

WatchlistMutation.addCompanies ● [String!]! non-null scalar​

Add new companies to watchlist @exposed

WatchlistMutation.addCompanies.watchlist ● UpdateWatchlistCompaniesInput! non-null input​

Watchlist id and list of company ids

WatchlistMutation.removeCompanies ● [String!]! non-null scalar​

Remove companies from watchlist @exposed

WatchlistMutation.removeCompanies.watchlist ● UpdateWatchlistCompaniesInput! non-null input​

Watchlist id and list of company ids

WatchlistMutation.delete ● WatchlistMutationResult! non-null object​

Delete watchlist with id @exposed

WatchlistMutation.delete.id ● Int! non-null scalar​

Watchlist ID

WatchlistMutation.deleteWatchlists ● [Int!] list scalar​

Bulk mutation to delete watchlists by ids. It returns the ids of the successfully deleted watchlists. @exposed

WatchlistMutation.deleteWatchlists.ids ● [Int!]! non-null scalar​

Returned by​

watchlist mutation