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