Skip to main content

Story

Story is an Article or Page where Comments are written on by Users.

type Story {
  id: ID!
  status: STORY_STATUS!
  url: String!
  metadata: StoryMetadata
  scrapedAt: Time
  featuredComments(
    first: Int = 10
    orderBy: COMMENT_SORT = CREATED_AT_DESC
    after: Cursor
  ): CommentsConnection!
  comments(
    first: Int = 20
    orderBy: COMMENT_SORT = CREATED_AT_DESC
    after: Cursor
    refreshStream: Boolean
    rating: Int
    tag: TAG
  ): CommentsConnection!
  commentActionCounts: ActionCounts!
  moderationQueues: ModerationQueues!
  closedAt: Time
  isClosed: Boolean!
  isArchiving: Boolean!
  isArchived: Boolean!
  isUnarchiving: Boolean!
  commentCounts: CommentCounts!
  createdAt: Time!
  settings: StorySettings!
  lastCommentedAt: Time
  canModerate: Boolean!
  site: Site!
  viewerCount: Int
  ratings: StoryRatings
  viewerRating: Comment
  cached: Boolean
}

Fields​

Story.id ● ID! non-null scalar​

id is the identifier of the Story.

Story.status ● STORY_STATUS! non-null enum​

status is the status of the Story.

Story.url ● String! non-null scalar​

url is the url that the Story is located on.

Story.metadata ● StoryMetadata object​

metadata stores the scraped metadata from the Story page.

Story.scrapedAt ● Time scalar​

scrapedAt is the Time that the Story had it's metadata scraped at. If the time is null, the Story has not been scraped yet.

Story.featuredComments ● CommentsConnection! non-null object​

featuredComments are the Comments with the FEATURED tag on the Story.

Story.featuredComments.first ● Int scalar​
Story.featuredComments.orderBy ● COMMENT_SORT enum​
Story.featuredComments.after ● Cursor scalar​

Story.comments ● CommentsConnection! non-null object​

comments are the comments on the Story.

Story.comments.first ● Int scalar​
Story.comments.orderBy ● COMMENT_SORT enum​
Story.comments.after ● Cursor scalar​
Story.comments.refreshStream ● Boolean scalar​
Story.comments.rating ● Int scalar​

rating allows filtering for comments with a specific rating. If this feature has not been enabled on this tenant or story, this option has no effect.

Story.comments.tag ● TAG enum​

This is a workaround to allow filtering for current Q&A functionality. This is used to filter on UNANSWERED to populate its corresponding Unanswered questions tab. In the future, we want a dedicated edge for unansweredComments.

Story.commentActionCounts ● ActionCounts! non-null object​

commentActionCounts stores the counts of all the actions against this Story and it's Comments.

Story.moderationQueues ● ModerationQueues! non-null object​

moderationQueues returns the set of ModerationQueues that are available for this Story.

Story.closedAt ● Time scalar​

closedAt is the Time that the Story is closed for commenting. If null or in the future, the story is not yet closed.

Story.isClosed ● Boolean! non-null scalar​

isClosed returns true when the Story is currently closed for commenting.

Story.isArchiving ● Boolean! non-null scalar​

isArchiving returns true when the Story is currently in the process of being archived. A story must always be closed (isClosed: true) when it is archiving.

Story.isArchived ● Boolean! non-null scalar​

isArchived returns true when the Story is current archived. A story must always be closed (isClosed: true) when it is archived.

Story.isUnarchiving ● Boolean! non-null scalar​

isUnarchiving returns true when a story is in-between being unarchived and is yet to be fully unarchived.

Story.commentCounts ● CommentCounts! non-null object​

commentCounts stores all the counts of Comments that are left on the Comment.

Story.createdAt ● Time! non-null scalar​

createdAt is the date that the Story was created at.

Story.settings ● StorySettings! non-null object​

settings is the set of Settings on a Story that inherit from the global settings.

Story.lastCommentedAt ● Time scalar​

lastCommentedAt is the last time someone commented on this story.

Story.canModerate ● Boolean! non-null scalar​

canModerate returns true if the current user can moderate comments on this Story.

Story.site ● Site! non-null object​

site is the site associated with the story

Story.viewerCount ● Int scalar​

viewerCount is the number of viewers active on this Story.

Story.ratings ● StoryRatings object​

ratings is information about ratings that is attached to this story by published comments.

Story.viewerRating ● Comment object​

viewerRating is the Comment with a rating that the viewer has already added to this story.

Story.cached ● Boolean scalar​

cached returns whether a story's stream is currently cached in redis or not.

Returned By​

activeStories query ● story query ● stream query

Member Of​

AddStoryExpertPayload object ● ArchiveStoriesPayload object ● CacheStoryPayload object ● CloseStoryPayload object ● Comment object ● CreateStoryPayload object ● InvalidateCachedStoryPayload object ● MergeStoriesPayload object ● OpenStoryPayload object ● RefreshStoryCountsPayload object ● RemoveStoryExpertPayload object ● RemoveStoryPayload object ● ScrapeStoryPayload object ● Site object ● StoriesConnection object ● StoryEdge object ● UnarchiveStoriesPayload object ● UpdateStoryModePayload object ● UpdateStoryPayload object ● UpdateStorySettingsPayload object ● User object