createComment will create a Comment as the current logged in User.

createCommentReply will create a Comment as the current logged in User that is in reply to another Comment.

editComment will allow the author of a comment to change the body within the time allotment.

updateSettings will update the Settings for the given Tenant.

rotateSSOSigningSecret can be used to rotate a given active SigningSecret.

deactivateSSOSigningSecret will deactivate a given deactivated SigningSecret.

deleteSSOSigningSecret will delete a given inactive SigningSecret.

createCommentReaction will create a Reaction authored by the current logged in User on a Comment.

removeCommentReaction will remove a Reaction authored by the current logged in User on a Comment if it exists.

createCommentDontAgree will create a DontAgree authored by the current logged in User on a Comment.

removeCommentDontAgree will remove a DontAgree authored by the current logged in User on a Comment if it exists.

createCommentFlag will create a Flag authored by the current logged in User on a given Comment.

featureComment will mark a given Comment as featured.

unfeatureComment will remove the featured tag from a Comment that is featured.

createStory will create the provided Story.

updateStory will update the given Story.

updateStory will update the given Story's settings.

closeStory will close the given story for commenting.

openStory will open the given story for commenting.

mergeStories will merge two stories together, merging their comment streams. This operation is irreversible.

removeStory will remove the given Story.

scrapeStory will scrape the given Story and update the scraped metadata.

approveComment will mark the Comment as APPROVED.

rejectComment will mark the Comment as REJECTED.

inviteUsers will send emails to the users with a new account at the designated role.

setUsername will set the username on the current User if they have not set one before. This mutation will fail if the username is already set.

updateBio will update the users bio.

updateUsername will update the users username.

setEmail will set the email address on the current User if they have not set one already. This mutation will fail if the email address is already set.

setPassword will set the password on the current User if they have not set one already. This mutation will fail if the password is already set.

updatePassword allows the current logged in User to change their password if they already have one associated with them.

requestAccountDeletion allows the current logged in User to request to delete their account.

deleteUserAccount will delete the target user now.

cancelAccountDeletion allows the current logged in User to cancel the request to delete their account

createToken allows an administrator to create a Token based on the current logged in User.

deactivateToken will deactivate the current logged in User's Token based on the input.

updateUserUsername allows administrators to update a given User's username to the one provided.

updateEmail will update the current users email address.

updateNotificationSettings can be used to update the notification settings for the current logged in user.

updateUserMediaSettings can be used to update the media preferences for the current logged in user.

updateUserEmail allows administrators to update a given User's email address to the one provided.

updateUserAvatar allows administrators to update a given User's avatar to the one provided.

updateUserRole will update a given User's role.

promoteUser will allow the viewer to add one or many scopes that applies to the viewer. If the target user was not already a site moderator, their role is set to site moderator.

demoteUser will allow the viewer to remove one or many scopes that applies to the viewer and the target user. If the target user does not have any remaining scopes, they are set to commenter.

updateUserModerationScopes will update the moderation scopes for a given user. This is used to limit the scopes for which a given moderator can moderate if they also have the moderator role.

banUser will ban a specific User from interacting with Comments.

removeUserBan will remove an active ban from a User if they have one.

suspendUser will suspend a specific User from interacting with Comments.

warnUser will warn a user and prevent them from commenting until they acknowledge

removeUserWarning will remove a user warning

acknowledgWarning will remove a warning

removeUserSuspension will remove an active suspension from a User if they have one.

ignoreUser will mark the given User as ignored by the current logged in User.

removeUserIgnore will remove the given User from the ignored user list from the current logged in User.

requestCommentsDownload allows a user to request to download their comments.

requestUserCommentsDownload allows a user to request to download their comments.

premodUser sets a user to mandatory premod

removeUserPremod removes a user from mandatory premod

createModeratorNote creates a note on a user account.

deleteModeratorNote deletes a note on a user account.

enableFeatureFlag will enable a given FEATURE_FLAG.

disableFeatureFlag will disable a given FEATURE_FLAG

createAnnouncement creates a global announcement.

deleteAnnouncement removes a global announcement.

createWebhookEndpoint will create a new WebhookEndpoint.

updateWebhookEndpoint will update a WebhookEndpoint.

enableWebhookEndpoint will enable a WebhookEndpoint to recieve new events.

disableWebhookEndpoint will disable a WebhookEndpoint from recieving new events.

deleteWebhookEndpoint will delete a WebhookEndpoint.

rotateWebhookEndpointSigningSecret will roll the current active secret to a new key.

createExternalModerationPhase will create a new ExternalModerationPhase.

updateExternalModerationPhase will update a ExternalModerationPhase.

enableExternalModerationPhase will enable a ExternalModerationPhase to recieve new comments.

disableExternalModerationPhase will disable a ExternalModerationPhase from recieving new comments.

deleteExternalModerationPhase will delete a ExternalModerationPhase.

rotateExternalModerationPhaseSigningSecret will roll the current active secret to a new key.

updateStoryMode will set the story mode.

addStoryExpert adds an expert to a story.

removeStoryExpert removes an expert from a story.

testSMTP sends a test email.

comment returns a specific comment.

comments returns a filtered comments connection that can be paginated. This is a fairly expensive edge to filter against, moderation queues should utlilize the dedicated edges for more optimized responses.

story is a specific article that can be identified by either an ID or a URL.

stream will load a specific story that can be identified by either an ID or a URL and will create the story if that feature is enabled.

stories returns filtered stories that can be paginated.

user will return the user referenced by their ID.

TODO: evaluate adding a profile based lookup.

users returns filtered users that can be paginated.

TODO: evaluate adding status based filtering.

viewer is the current logged in User. If no user is currently logged in, it will return null. This is the only nullable field that can be returned that depends on the authentication state that will not throw an error.

settings is the Settings for a given Tenant.

discoverOIDCConfiguration will discover the OpenID Connect configuration based on the provided issuer. Discovery is not supported on all providers, and is described in the OpenID Connect Discovery 1.0 incorporating errata set 1:

https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderConfig

If the provider does not support discovery, the response will be null.

debugScrapeStoryMetadata will return the information that Coral was able to scrape from the given URL. No data will be saved related to the Story based on this scrape.

moderationQueues returns the set of ModerationQueues that are available for all stories or if given the story identified by the storyID.

sections will return the unique sections used by this Tenant.

activeStories is the list of most recently commented on stories identified by their lastCommentedAt field

webhookEndpint will return a specific WebhookEndpoint if it exists.

queues returns information on queues used in Coral to manage

externalModerationPhase will return a specific ExternalModerationPhase if it exists.

clientMutationId is required for Relay support.

user is the possibly modified User.

reaction returns the counts for the reaction action on an item.

dontAgree returns the counts for the dontAgree action on an item. This edge is restricted to administrators and moderators.

flag returns the counts for the flag action on an item. This edge is restricted to administrators and moderators.

reaction is true when a reaction action was left on an item.

dontAgree is true when a dontAgree action was left on an item.

flag is true when a flag action was left on an item.

clientMutationId is required for Relay support.

story is the resultant story the expert was added to.

enabled when True will enable the integration.

ipBased when True will enable IP-based spam detection.

The key for the Akismet integration.

The site (blog) for the Akismet integration.

id is a canonical identifier for this Annoucnement, used to dismiss on front-end.

content is the content displayed for the announcement.

createdAt is the creation date.

disableAt is the computed date at which announcement will be invalid.

duration determines how long the announcement will be valid for.

comment is the Comment that was approved.

moderationQueues will return the selected moderation queues. If the storyID is provided, it will filter the moderation queues for only comments in that Story.

clientMutationId is required for Relay support.

integrations are the set of configurations for the variations of authentication solutions.

sessionDuration determines the duration in seconds for which an access token is valid

local stores configuration related to email/password based logins.

sso stores configuration related to Single Sign On based logins.

oidc stores configuration related to OpenID Connect based logins.

google stores configuration related to Google based logins.

facebook stores configuration related to Facebook based logins.

active when true, indicates that the given user is banned.

sites is a list of sites that the user has been site banned on.

history is the list of all ban events against a specific User.

active when true, indicates that the given user is banned.

createdBy is the User that suspended the User. If null, the then the given User was banned by the system.

createdAt is the time that the given User was banned.

message is sent to banned user via email.

sites are set when the ban was created to perform a site specific ban.

user is the possibly modified User.

clientMutationId is required for Relay support.

user is the possibly modified User.

clientMutationId is required for Relay support.

enabled when true, enables the character count moderation phase.

min is the smallest length of a Comment that may be posted.

max is the largest length of a Comment that may be posted.

auto when true will configure the automatic close on each story as they are created based on the current configured timeout option.

timeout is the amount of seconds from the createdAt timestamp that a given story will be considered closed.

message when provided will be the message that shows when the comment stream is closed for commenting.

story is the Story that was possibly updated.

clientMutationId is required for Relay support.

id is the identifier of the Comment.

body is the content of the Comment, and is an alias to the body of the currentRevision.body.

revision is the current revision of the Comment's body.

revisionHistory stores the previous CommentRevision's, with the most recent edit last.

createdAt is the date in which the Comment was created.

author is the User that authored the Comment.

status represents the Comment's current status.

statusHistory returns a CommentModerationActionConnection that will list the history of moderator actions performed on the Comment, with the most recent last.

parentCount is the number of direct parents for this Comment. Currently this value is the same as depth.

depth is the number of levels that a given comment is deep.

replyCount is the number of replies. Only direct replies to this Comment are counted. Removed comments are included in this count.

replies will return the replies to this Comment.

parent is the immediate parent of a given comment.

rootParent is the highest level parent Comment. This Comment would have been left on the Story itself.

parents returns a CommentsConnection that allows accessing direct parents of the given Comment.

editing returns details about the edit status of a Comment.

actionCounts stores the counts of all the actions for the Comment.

reactions is the actual Flags that were left by the Users or the system.

flags is the actual Flags that were left by the Users or the system.

viewerActionPresence stores the presence information for all the actions left by the current User on this Comment.

story is the Story that the Comment was written on.

The permalink for this comment.

tags are the list of tags assigned to the Comment.

deleted is whether the comment has been deleted.

canModerate returns true if the current user can moderate this Comment.

site is the Site referenced by the Story for this Comment.

rating is the optional rating that is attached to the Comment.

totalPublished will return the count of all published Comments.

tags stores the counts of all the Tags against Comment's on this Story.

statuses stores the counts of all the statuses against Comments on this Story.

node is the Comment for this edge.

cursor is used in pagination.

changeUsername when true, non-sso user may change username every 14 days

downloadComments when true, user may download their comment history

deleteAccount when true, non-sso user may permanently delete their account

revision is the moderated CommentRevision.

status represents the status that was assigned by the moderator.

moderator is the User that performed the Moderator action. If null, this means that the system has assigned the moderation status.

createdAt is the time that the CommentModerationAction was created.

edges are a subset of CommentModerationActionEdge's.

nodes is a list of CommentModerationAction's.

pageInfo is information to aid in pagination.

node is the CommentModerationAction for this edge.

cursor is used in pagination.

id is the identifier of the CommentRevision.

comment is the reference to the original Comment associated with the current Comment.

actionCounts stores the counts of all the actions for the CommentRevision specifically.

body is the content of the CommentRevision. If null, it indicates that the body text was deleted.

media is the optional media object attached to this revision.

metadata stores details on a CommentRevision.

createdAt is the time that the CommentRevision was created.

perspective stores metadata associated with the pipeline analysis of this revision's body.

wordList metadata stores extra status details about what occurred during word list analysis of this comment revision.

score is the value detected from the perspective API. This is returned as the percentage chance it would be considered toxic and can be compared to the defined threshold value.

timedOut is whether the wordlist analysis timed out when this revision of the comment was sent through the moderation phases.

edges are a subset of CommentEdge's.

nodes is a list of Comment's.

pageInfo is information to aid in pagination.

The comment is not PREMOD, but was not applied a moderation status by a moderator.

The comment has been approved by a moderator.

The comment has been rejected by a moderator.

The comment was created while the stories premoderation option was on, and new comments that haven't been moderated yet are referred to as "premoderated" or "premod" comments.

SYSTEM_WITHHELD represents a comment that was withheld by the system because it was flagged by an internal process for further review.

FEATURED is the count of Comment's with the FEATURED tag.

UNANSWERED is the count of Comment's with the UNANSWERED tag.

REVIEW is the count of Comment's with the REVIEW tag.

QUESTION is the count of Comment's with the QUESTION tag.

enable set to true will show the guidelines above the message box.

content of the guidelines.

clientMutationId is required for Relay support.

comment is the Comment that the DontAgree was created on.

clientMutationId is required for Relay support.

comment is the Comment that the Flag was created on.

clientMutationId is required for Relay support.

edge is the possibly created comment edge.

clientMutationId is required for Relay support.

comment is the Comment that the Reaction was created on.

clientMutationId is required for Relay support.

edge is the possibly created comment edge.

clientMutationId is required for Relay support.

clientMutationId is required for Relay support.

phase is the ExternalModerationPhase that we just created.

settings is the updated settings also containing the new phase.

clientMutationId is required for Relay support.

createdBy is the moderator who created the note user is the updated user.

clientMutationId is required for Relay support.

site is the Site that was newly created.

story is the Story that was possibly created.

clientMutationId is required for Relay support.

user is the possibly modified User.

token is the Token that was created.

signedToken is the signed Token associated with the account.

clientMutationId is required for Relay support.

clientMutationId is required for Relay support.

endpoint is the endpoint that we just created.

settings is the updated settings also containing the new endpoint.

phases is all the external moderation phases for this Tenant.

clientMutationId is required for Relay support.

settings is the Settings that the SSO secret was regenerated on.

user is the possibly modified User.

token is the Token that was deleted.

clientMutationId is required for Relay support.

clientMutationId is required for Relay support.

clientMutationId is required for Relay support.

phase is the ExternalModerationPhase that we just deleted.

clientMutationId is required for Relay support.

user is the updated user.

clientMutationId is required for Relay support.

settings is the Settings that the SSO secret was regenerated on.

user is the User that was deleted.

clientMutationId is required for Relay support.

clientMutationId is required for Relay support.

endpoint is the endpoint that we just deleted.

clientMutationId is required for Relay support.

user is the possibly modified User.

enabled when true will disable commenting site-wide.

message will be shown above the comment stream while commenting is disabled site-wide.

clientMutationId is required for Relay support.

phase is the ExternalModerationPhase that we just disabled.

clientMutationId is required for Relay support.

flags is the current set of flags enabled.

clientMutationId is required for Relay support.

endpoint is the endpoint that we just disabled.

issuer is defined as the issuer in:

https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMetadata

authorizationURL is defined as the authorization_endpoint in:

https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMetadata

tokenURL is defined as the token_endpoint in:

https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMetadata

jwksURI is defined as the jwks_uri in:

https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMetadata

total is the total number of dontAgree actions against a given item.

comment is the possibly edited comment.

clientMutationId is required for Relay support.

edited will be True when the Comment has been edited in the past.

editableUntil is the time that the comment is editable until. This will return null if the current viewer is not the author of the Comment.

enabled when true, will enable the emailing functionality in Coral.

clientMutationId is required for Relay support.

phase is the ExternalModerationPhase that we just enabled.

clientMutationId is required for Relay support.

flags is the current set of flags enabled.

clientMutationId is required for Relay support.

endpoint is the endpoint that we just enabled.

akismet provides integration with the Akismet Spam detection service.

perspective provides integration with the Perspective API comment analysis platform.

external provides integration details for external moderation phases that can be used in the moderation pipeline.

url is the URL of a YouTube video.

extension is the file extension

width is the width of the YouTube video in pixels.

height is the height of the YouTube video in pixels.

enabled is true when external media objects are enabled.

id identifies this particular External Moderation Phase.

name is the name assigned to this ExternalModerationPhase for identification purposes.

enabled when true, will use this phase in the moderation pipeline.

url is the actual URL that should be called.

format is the format of the comment body sent.

timeout is the number of milliseconds that this moderation is maximum expected to take before it is skipped.

signingSecret is the secret used to sign outgoing requests to the url during the moderation pipeline.

enabled, when true, will enable Facebook as an authentication integration.

allowRegistration when true will allow users that have not signed up before with this authentication integration to sign up.

targetFilter will restrict where the authentication integration should be displayed. If the value of targetFilter is null, then the authentication integration should be displayed in all targets.

clientID is the Client Identifier as provided by the Facebook Developer Console.

clientSecret is the Client Secret as provided by the Facebook Developer Console.

callbackURL is the URL that the user should be redirected to in order to continue the authentication flow. This field is not stored, and is instead computed from the Tenant.

redirectURL is the URL that the user should be redirected to in order to start an authentication flow with the given integration. This field is not stored, and is instead computed from the Tenant.

comment is the Comment that was featured.

clientMutationId is required for Relay support.

moderationQueues will return the selected moderation queues. If the storyID is provided, it will filter the moderation queues for only comments in that Story.

flagger is the User that created the Flag. If this is null, then the system created the Flag.

reason is the selected reason why the Flag is being created. If the reason is not defined, or existed from a previous version of Coral, it will return null to avoid errors.

additionalDetails stores information from the User as to why the Flag was created or is relevant.

total is the total number of flags against a given item.

reasons stores the counts for the various reasons that an item could be flagged for.

node is the Flag for this edge.

cursor is used in pagination.

edges are a subset of FlagEdge's.

nodes is a list of Flags.

pageInfo is information to aid in pagination.

url is the URL to a image of the GIF.

original is the URL to a image of the GIF.

still is a thumbnail preview of the GIF.

video is a URL to the mp4 video of the GIF.

width is the width of the GIF in pixels.

height is the height of the GIF in pixels.

title is the title of the GIF.

enabled is true when gif search via giphy and giphy media objects are enabled.

maximum allowed rating for gifs, g, pg, pg-13, r.

key is the API key for Giphy.

enabled, when true, will enable Google as an authentication integration.

allowRegistration when true will allow users that have not signed up before with this authentication integration to sign up.

targetFilter will restrict where the authentication integration should be displayed. If the value of targetFilter is null, then the authentication integration should be displayed in all targets.

clientID is the Client Identifier as provided by the Google API Console.

clientSecret is the Client Secret as provided by the Google API Console.

callbackURL is the URL that the user should be redirected to in order to continue the authentication flow. This field is not stored, and is instead computed from the Tenant.

redirectURL is the URL that the user should be redirected to in order to start an authentication flow with the given integration. This field is not stored, and is instead computed from the Tenant.

user is the User that we just ignored.

clientMutationId is required for Relay support.

id is the identifier for the Invite.

email is the email address that will be assigned and used for the invited User.

role is the USER_ROLE that the User will be assigned upon account creation.

createdBy is the User that created the Invite.

createdAt is the time that the Invite was created on.

invites is the references to the invited Users.

clientMutationId is required for Relay support.

configurable when false indicates that live updates cannot be modified.

enabled when true will allow live updates.

allowRegistration when true will allow users that have not signed up before with this authentication integration to sign up.

targetFilter will restrict where the authentication integration should be displayed. If the value of targetFilter is null, then the authentication integration should be displayed in all targets.

twitter is the configuration for Twitter support.

youtube is the configuration for YouTube support.

giphy is the configuration for Giphy support.

external is the configuration for external images.

story is the Story that all the source stories were merged into.

clientMutationId is required for Relay support.

id is a canonical identifier for this specific moderation queue.

count will return the number of Comments that are in this queue.

comments are the comments on the ModerationQueue.

unmoderated will return a ModerationQueue for all Comments that have not been moderated yet.

reported will return a ModerationQueue for all Comments that have been published, have not been moderated by a human yet, and have been reported by a User via a flag.

pending will return a ModerationQueue for all Comments that were held back by the system and require moderation in order to be published.

id is the identifier of the Note.

body is the content of the Note

createdAt is the date in which the Note was created.

createdBy is the Moderator that authored the Note.

premodEnabled ensures that new commenters' comments are pre-moderated until they have enough approved comments

approvedCommentsThreshold is the number of comments a user must have approved before their comments do not require premoderation

enabled, when true, allows the integration to be enabled.

allowRegistration when true will allow users that have not signed up before with this authentication integration to sign up.

targetFilter will restrict where the authentication integration should be displayed. If the value of targetFilter is null, then the authentication integration should be displayed in all targets.

name is the label assigned to reference the provider of the OIDC integration, and will be used in situations where the name of the provider needs to be displayed, like the login button.

callbackURL is the URL that the user should be redirected to in order to continue the authentication flow with the given integration. This field is not stored, and is instead computed from the Tenant.

redirectURL is the URL that the user should be redirected to in order to start an authentication flow with the given integration. This field is not stored, and is instead computed from the Tenant.

clientID is the Client Identifier as defined in:

https://tools.ietf.org/html/rfc6749#section-2.2

clientSecret is the Client Secret as defined in:

https://tools.ietf.org/html/rfc6749#section-2.3.1

authorizationURL is defined as the authorization_endpoint in:

https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMetadata

tokenURL is defined as the token_endpoint in:

https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMetadata

jwksURI is defined as the jwks_uri in:

https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMetadata

issuer is defined as the issuer in:

https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMetadata

story is the Story that was possibly updated.

clientMutationId is required for Relay support.

name is the name of the organization.

contactEmail is the email of the organization.

url is the URL to the organizations home page.

Indicates that there are more nodes after this subset.

Included for legacy Relay reasons. Always set to false.

Included for legacy Relay reasons. Always set to null.

Specifies the last node's cursor for forwards pagination.

enabled when True will enable the integration.

The endpoint that Coral should use to communicate with the perspective API.

The key for the Perspective API integration.

The threshold that given a specific toxic comment score, the comment will be marked by Coral as toxic.

model is the Perspective model to use.

When True, comments sent will not be stored by the Google Perspective API.

When True, comment moderation decisions will be sent to the Google Perspective API to help improve the comment analysis algorithms.

active when true, indicates that the given user is set to pre-mod.

history is the list of all suspension events against a specific User.

active when true, indicates that the given user is premodded.

createdBy is the user that flagged the commenter as pre-mod

createdAt is the time the user was set to pre-mod

user is the possibly modified User.

clientMutationId is required for Relay support.

clientMutationId is required for Relay support.

user is the possibly modified User.

counts is the current counts associated with the Queue.

waiting is the number of jobs that are in line to be processed.

active is the number of jobs that are being activly processed.

delayed is the number of jobs that have been delayed due to a failure and are waiting for a backoff.

mailer is the Queue associated with the Mailer queue.

scraper is the Queue associated with the Scraper queue.

notifier is the Queue associated with the Notifier queue.

webhook is the Queue associated with the Webhook queue.

rejector is the Queue associated with the Rejector queue.

total is the total number of reactions against a given item.

icon is the string representing the icon to be used for the reactions.

iconActive is the string representing the icon that should be used when the icon should be considered active.

label is the string placed beside the reaction icon to provide better context.

labelActive is the string placed beside the reaction icon to provide better context when it has been selected.

sortLabel is the string placed inside of the sort menu to sort for comment with most reactions.

color is the hex color code that can be used to change the color of the button.

node is the Flag for this edge.

cursor is used in pagination.

edges are a subset of FlagEdge's.

nodes is a list of Flags.

pageInfo is information to aid in pagination.

statuses stores the counts of all the statuses against Comments by a User within the timeFrame configured.

enabled when true will pre-moderate users new comments once they have reached the trigger rejection rate.

timeFrame specifies the number of seconds that comments from a given User will be taken into account when computing their rejection rate.

triggerRejectionRate specifies the percentage of comments that a given User may have before their comments will then be placed into pre-moderation until the rejection rate decreases.

comment is the Comment that was rejected.

moderationQueues will return the selected moderation queues. If the storyID is provided, it will filter the moderation queues for only comments in that Story.

clientMutationId is required for Relay support.

comment is the Comment that the DontAgree was removed on.

clientMutationId is required for Relay support.

comment is the Comment that the Reaction was removed on.

clientMutationId is required for Relay support.

user is the possibly modified User.

clientMutationId is required for Relay support.

clientMutationId is required for Relay support.

story is the resultant story the expert was removed from.

story is the Story that was possibly removed.

clientMutationId is required for Relay support.

user is the possibly modified User.

clientMutationId is required for Relay support.

user is the User that we removed the ignore from.

clientMutationId is required for Relay support.

user is the possibly modified User.

clientMutationId is required for Relay support.

clientMutationId is required for Relay support.

user is the possibly modified User.

user is the possibly modified User.

clientMutationId is required for Relay support.

clientMutationId is required for Relay support.

clientMutationId is required for Relay support.

archiveURL is the archive url

clientMutationId is required for Relay support.

phase is the ExternalModerationPhase that we just updated.

clientMutationId is required for Relay support.

settings is the Settings that the SSO secret was regenerated on.

clientMutationId is required for Relay support.

endpoint is the endpoint that we just updated.

enabled when true turns on basic RTE features including bold, italic, quote, and bullet list.

strikethrough when true turns on the strikethrough feature.

spoiler when true turns on the spoiler feature.

sarcasm when true turns on the sarcasm feature.

story is the Story that was possibly scraped.

clientMutationId is required for Relay support.

user is the possibly modified User.

clientMutationId is required for Relay support.

user is the possibly modified User.

clientMutationId is required for Relay support.

id is a canonical identifier for this Tenant.

domain is the domain that is associated with this Tenant.

webhooks store the webhook configuration.

webhookEvents returns all the events that can trigger webhooks.

staticURI if configured, is the static URI used to serve static files from.

locale is the specified locale for this Tenant.

live provides configuration options related to live updates for stories on this site.

moderation is the moderation mode for all Stories on the site.

communityGuidelines will be shown in the comments stream.

premodLinksEnable will put all comments that contain links into premod.

closeCommenting contains settings related to the automatic closing of commenting on Stories.

customCSSURL is the URL of the custom CSS used to display on the frontend.

disableCommenting will disable commenting site-wide.

editCommentWindowLength is the length of time (in seconds) after a comment is posted that it can still be edited by the author.

charCount stores the character count moderation settings.

organization stores information about the organization behind this specific instance of Coral.

email is the set of credentials and settings associated with the organization.

slack is the configuration for slack communication

wordList will return a given list of words.

auth contains all the settings related to authentication and authorization.

integrations contains all the external integrations that can be enabled.

recentCommentHistory is the set of settings related to how automatic pre-moderation is controlled.

reaction specifies the configuration for reactions.

staff specifies the configuration for the staff badges assigned to users with any role above COMMENTER.

accountFeatures stores the configuration for commenter account features.

stories stores the configuration around stories.

media is the configuration media content attached to Comment's.

featureFlags provides the enabled feature flags.

createdAt is the time that the Settings was created at.

newCommenters is the configuration for how new commenters comments are treated.

premoderateSuspectWords when enabled will cause any comments that contain suspect words to be sent to pre-moderation to be reviewed by a moderator prior to being presented in stream.

announcement is the currently active Announcement.

multisite is whether multiple sites exist for this tenant.

rte is the configuration of the Rich-Text-Editor.

memberBios is whether members can define a bio for their account.

user is the possibly modified User.

clientMutationId is required for Relay support.

kid is the identifier for the key used when verifying tokens issued by the provider.

secret is the actual underlying secret used to verify the tokens with.

createdAt is the date that the key was created at.

lastUsedAt is the time that the

rotatedAt is the time that the token was rotated out.

inactiveAt is the date that the token can no longer be used to validate tokens.

id is the identifier of the Site.

name is the name of the Site.

allowedOrigins are the allowed origins for embeds.

canModerate when true indicates that the current user can moderate comments left on this Site.

topStories will return stories that have had the most comments within the last 24 hours on this Site.

createdAt is when the site was created.

node is the Site for this edge.

cursor is used in pagination.

edges are a subset of SiteEdge's.

nodes is a list of Site's.

pageInfo is information to aid in pagination.

enabled is whether this Slack channel is enabled to send comments to its correlated web hook

name is the name assigned to the Slack channel

hookURL defines the URL that comments will be sent to

triggers are the filters of types of comments that will be sent to the correlated channel

reportedComments is whether this channel will receive reported comments

pendingComments is whether this channel will receive pending comments

featuredComments is whether this channel will receive featured comments

allComents is whether the channel will receive all comments

staffComments is whether the channel will receive staff comments

channels is the set of Slack channels configured to receive comments

allowRegistration when true will allow users that have not signed up before with this authentication integration to sign up.

targetFilter will restrict where the authentication integration should be displayed. If the value of targetFilter is null, then the authentication integration should be displayed in all targets.

signingSecrets are the different SigningSecret's used by this Tenant.

key is the secret that is used to sign tokens.

keyGeneratedAt is the Time that the key was effective from.

label is the string used when displaying the STAFF badge to users.

staffLabel is the string used when displaying the STAFF badge to users.

moderatorLabel is the string used when displaying the MODERATOR badge to users.

adminLabel is the string used when displaying the ADMIN badge to users

edges are a subset of StoryEdge's.

nodes is a list of Story's.

pageInfo is information to aid in pagination.

id is the identifier of the Story.

status is the status of the Story.

url is the url that the Story is located on.

metadata stores the scraped metadata from the Story page.

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.

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

comments are the comments on the Story.

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

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

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

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

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

createdAt is the date that the Story was created at.

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

lastCommentedAt is the last time someone commented on this story.

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

site is the site associated with the story

viewerCount is the number of viewers active on this Story.

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

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

scraping stores configuration around story scraping.

disableLazy when true, will only allow lookups of stories created via the API.

node is the Story for this edge.

cursor is used in pagination.

enable when true will enable the Message Box on the comment stream.

icon when set will reference the string for the Message box used by the Message Box.

content when set contains the actual markup for the Message Box.

title stores the scraped title from the Story page.

author stores the scraped author from the Story page.

description stores the scraped description from the Story page.

image stores the scraped image from the Story page.

publishedAt stores the scraped publication date from the Story page.

modifiedAt stores the scraped modified date from the Story page.

section stores the scraped section from the Story page.

average refers to the average rating across all ratings for the Story from published comments.

count refers to the number of ratings that have been submitted that contributes to the average.

enabled, when true, enables stories to be scraped. When disabled, stories will only be looked up instead, and must be created via the API directly.

proxyURL when specified, allows scraping requests to use the provided proxy. All requests will then be passed through the appropriote proxy as parsed by the proxy-agent package.

customUserAgent when specified will override the user agent used by fetch requests made during the scraping process.

live provides configuration options related to live updates on this Story.

moderation determines whether or not this is a PRE or POST moderated story.

premodLinksEnable will put all comments that contain links into premod.

messageBox stores settings related to the Story Message Box.

mode is the specified mode that the story should be updated with.

experts are used during Q&A mode to assign users to answer questions on a Q&A stream. It is an optional parameter and is only used when the story stream is in Q&A mode.

user is the possibly modified User.

clientMutationId is required for Relay support.

active when true, indicates that the given user is suspended.

until is the time that the current user suspension is over.

history is the list of all suspension events against a specific User.

active is true when the given suspension status time range applies now.

from is the time range that the suspension is active for.

createdBy is the User that suspended the User. If null, the then the given User was suspended by the system.

createdAt is the time that the suspension was created at.

modifiedBy is the User that cancelled/edited the suspension. If null, then the suspension has not been cancelled/edited, or has been edited by the system.

modifiedAt is the time that the suspension was cancelled/edited. If null, then the suspension has not been cancelled/edited.

message is sent to suspended user via email.

code is the machine representation of the tag name.

createdBy is the User that assigned the Tag. This is null when the Tag is assigned by the System.

createdAt is the time that the Tag was assigned on.

start is the time that the time range started on.

finish is the time that the time range finished at.

url is the URL of a Twitter tweet.

width is the width of the Twitter tweet in pixels.

enabled is true when twitter media objects are enabled.

comment is the Comment that was unfeatured.

clientMutationId is required for Relay support.

user is the possibly modified User.

clientMutationId is required for Relay support.

user is the possibly modified User.

clientMutationId is required for Relay support.

clientMutationId is required for Relay support.

phase is the ExternalModerationPhase that we just updated.

user is the possibly modified User.

clientMutationId is required for Relay support.

user is the possibly modified User.

clientMutationId is required for Relay support.

settings is the updated Settings.

clientMutationId is required for Relay support.

clientMutationId is required for Relay support.

site is the newly updated Site.

clientMutationId is required for Relay support.

story is the resultant story that Q&A was enabled on.

story is the Story that was possibly updated.

clientMutationId is required for Relay support.

story is the Story that was possibly updated.

clientMutationId is required for Relay support.

user is the possibly modified User.

clientMutationId is required for Relay support.

user is the possibly modified User.

clientMutationId is required for Relay support.

user is the possibly modified User.

clientMutationId is required for Relay support.

user is the possibly modified User.

clientMutationId is required for Relay support.

clientMutationId is required for Relay support.

user is the possibly modified User.

user is the possibly modified User.

clientMutationId is required for Relay support.

clientMutationId is required for Relay support.

endpoint is the endpoint that we just created.

id is the identifier of the User.

username is the name of the User visible to other Users.

avatar is the url to the avatar for a specific User.

badges are user display badges

email is the current email address for the User.

duplicateEmail is set on users that have a matching email with another user in the database. Only relevant during the account completion process.

emailVerified when true indicates that the given email address has been verified.

profiles is the array of profiles assigned to the user.

role is the current role of the User.

moderatorNotes are notes left by moderators about the User.

ignoreable is a computed property based on the user's role. Typically, users with elevated privileges aren't allowed to be ignored.

comments are the comments written by the User.

allComments are comments regardless of visibility status.

rejectedComments are comments that have been rejected.

ongoingDiscussions are stories where the given user has written comments in sorted by their last comment date.

recentCommentHistory returns recent commenting history by the User.

commentModerationActionHistory returns a CommentModerationActionConnection that this User has created.

status stores the user status information regarding moderation state.

tokens lists the access tokens associated with the account.

ignoredUsers will return the list of ignored users.

notifications stores the notification settings for the given User.

createdAt is the time that the User was created at.

lastDownloadedAt the last time the user made a download request of their account data.

scheduledDeletionDate is the time when the User is scheduled to be deleted.

deletedAt is the time when the User was deleted.

moderationScopes describes the scopes for moderation. These only apply when the user has a MODERATOR role.

ssoURL is the url for managing sso account

mediaSettings are the user's preferences around media stream behaviour.

bio is a user-defined biography.

node is the User for this edge.

cursor is used in pagination.

unfurlEmbeds is whether the user has chosen to immediately show embed contents without having to click "Show Tweet", "Show GIF", etc.

scoped returns true when the moderator has a scoped moderation role, and cannot moderate organization wide.

sites (when not null) list the sites that the user is only allowed to moderate on. When null, it means that the user is allowed to moderate on all sites.

username is the username that was assigned

createdBy is the user that created this username

createdAt is the time the username was created

history is the list of all usernames for this user

onReply, when true, will enable notifications to be sent to users that have replies to their comments.

onFeatured, when true, will enable notifications to be sent to users that have their comment's featured.

onStaffReplies when true, will enable notifications to be sent to users that have a staff member reply to their comments. These notifications will supercede notifications that would have been sent for a basic reply notification.

onModeration when true, will enable notifications to be sent to users when a comment that they wrote that was previously unpublished, becomes published due to a moderator action.

digestFrequency is the frequency to send notifications.

edges are a subset of UserEdge's.

nodes is a list of User's.

pageInfo is information to aid in pagination.

current represents the current statuses applied to the User.

username stores the history of username changes for this user

banned stores the user banned status as well as the history of changes.

suspension stores the user suspension status as well as the history of changes.

premod stores the user premod status as well as the history of changes.

warning stores the user warning status as well as the history of warnings

active when true, indicates that the given user has been warned but has not acknowledged it.

message is the current message for the warning on the User.

history will return the status history items for warnings.

active when true, indicates that the given user has been warned but has not acknowledged the warning.

createdBy is the user that warned the commenter

createdAt is the time the user was warned

acknowledgedAt is the time the commenter acknowledged the warning. if null then the warning has not been acknowledged

message is the custom message sent to the commenter

clientMutationId is required for Relay support.

user is the possibly modified User.

endpoints is all the configured endpoints that should receive events.

id is the unique identifier for this specific endpoint.

enabled when true will enable events to be sent to this endpoint.