Elium's GraphQL Schema
Queries
instance
Description
Get information about the global Instance configuration and settings
Response
Returns an Instance
Example
Query
query instance {
instance {
actions {
...InstanceActionsFragment
}
availablePlans {
...InstancePlanFragment
}
baseUrl
chargebee {
...InstanceChargebeeFragment
}
configuration {
...InstanceConfigurationFragment
}
contacts {
...InstanceContactsFragment
}
contentLanguages
contentLangs {
...LanguageFragment
}
disabledStandardContent
disabledUsersForSuccession {
...UserConnectionFragment
}
usersWithSuccession {
...UserConnectionFragment
}
duplicatedAssets {
...DuplicatedAssetConnectionFragment
}
disclaimer
domain
downloadLimits {
...InstanceDownloadLimitsFragment
}
emailPipelines {
...EmailPipelineConnectionFragment
}
features {
...InstanceFeaturesFragment
}
exportCSVRole
activityDigestFrequency
fullstory {
...InstanceFullstoryFragment
}
googleAnalytics {
...InstanceGoogleAnalyticsFragment
}
graphqlSubscriptionsUrl
graphqlVersion
id
intercom {
...InstanceIntercomFragment
}
labFeatures {
...LabFeatureFragment
}
limits {
...InstanceLimitsFragment
}
mailto
microsoftTeams {
...InstanceMicrosoftTeamsFragment
}
mixpanel {
...InstanceMixpanelFragment
}
name
onboardingCompleted
onboardingCompletedSteps
realtimeUrl
refiner {
...InstanceRefinerFragment
}
release
passwordSettings {
...InstancePasswordSettingsFragment
}
sandboxGapiUrl
sandboxOneDrivePickerUrl
sandboxUrl
sharePoint {
...InstanceSharePointFragment
}
officeOnline
slack {
...InstanceSlackFragment
}
spaceGroups {
...SpaceGroupConnectionFragment
}
ssoConfig {
...InstanceSsoConfigFragment
}
scimConfig {
...InstanceScimConfigFragment
}
connectedApps {
...ConnectedAppConnectionFragment
}
approvals {
...StoryApprovalConnectionFragment
}
publicSharedStories {
...StoryConnectionFragment
}
spaces {
...SpaceConnectionFragment
}
statistics {
...InstanceStatisticsFragment
}
subscription {
...InstanceSubscriptionFragment
}
answerFeedbacks {
...AnswerConnectionFragment
}
answerFeedbacksExport
searchFeedbacks {
...SearchFeedbackConnectionFragment
}
sharedAlerts {
...AlertConnectionFragment
}
sharedAlertsSubscribers {
... on User {
...UserFragment
}
... on Team {
...TeamFragment
}
}
summaryStats
successorsWithContent {
...UserConnectionFragment
}
timezones
teams {
...TeamConnectionFragment
}
teamsCSV
spaceListCSV
spaceMembershipCSV
theme {
...InstanceThemeFragment
}
uiLanguage
uiLanguages
uiLangs {
...LanguageFragment
}
usage {
...InstanceUsageFragment
}
users {
...UserConnectionFragment
}
uuid
workplace {
...InstanceWorkplaceFragment
}
exports {
...InstanceExportConnectionFragment
}
appLaunchers {
...AppLauncherConnectionFragment
}
smartFeeds {
...SmartFeedConnectionFragment
}
smartAssistants {
...SmartAssistantConnectionFragment
}
storyAlerts {
...StoryAlertConnectionFragment
}
organizations {
...OrganizationFragment
}
auditLogExportURL
}
}
Response
{
"data": {
"instance": {
"actions": InstanceActions,
"availablePlans": [InstancePlan],
"baseUrl": "http://www.test.com/",
"chargebee": InstanceChargebee,
"configuration": InstanceConfiguration,
"contacts": InstanceContacts,
"contentLanguages": [{}],
"contentLangs": [Language],
"disabledStandardContent": ["abc123"],
"disabledUsersForSuccession": UserConnection,
"usersWithSuccession": UserConnection,
"duplicatedAssets": DuplicatedAssetConnection,
"disclaimer": false,
"domain": "abc123",
"downloadLimits": InstanceDownloadLimits,
"emailPipelines": EmailPipelineConnection,
"features": InstanceFeatures,
"exportCSVRole": "ADMINISTRATOR",
"activityDigestFrequency": "DEFAULT",
"fullstory": InstanceFullstory,
"googleAnalytics": InstanceGoogleAnalytics,
"graphqlSubscriptionsUrl": "http://www.test.com/",
"graphqlVersion": "xyz789",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"intercom": InstanceIntercom,
"labFeatures": [LabFeature],
"limits": InstanceLimits,
"mailto": "test@test.com",
"microsoftTeams": InstanceMicrosoftTeams,
"mixpanel": InstanceMixpanel,
"name": "xyz789",
"onboardingCompleted": true,
"onboardingCompletedSteps": [
"xyz789"
],
"realtimeUrl": "http://www.test.com/",
"refiner": InstanceRefiner,
"release": "xyz789",
"passwordSettings": InstancePasswordSettings,
"sandboxGapiUrl": "http://www.test.com/",
"sandboxOneDrivePickerUrl": "http://www.test.com/",
"sandboxUrl": "http://www.test.com/",
"sharePoint": InstanceSharePoint,
"officeOnline": true,
"slack": InstanceSlack,
"spaceGroups": SpaceGroupConnection,
"ssoConfig": InstanceSsoConfig,
"scimConfig": InstanceScimConfig,
"connectedApps": ConnectedAppConnection,
"approvals": StoryApprovalConnection,
"publicSharedStories": StoryConnection,
"spaces": SpaceConnection,
"statistics": InstanceStatistics,
"subscription": InstanceSubscription,
"answerFeedbacks": AnswerConnection,
"answerFeedbacksExport": "http://www.test.com/",
"searchFeedbacks": SearchFeedbackConnection,
"sharedAlerts": AlertConnection,
"sharedAlertsSubscribers": [User],
"summaryStats": {},
"successorsWithContent": UserConnection,
"timezones": [Timezone],
"teams": TeamConnection,
"teamsCSV": "http://www.test.com/",
"spaceListCSV": "http://www.test.com/",
"spaceMembershipCSV": "http://www.test.com/",
"theme": InstanceTheme,
"uiLanguage": "fr",
"uiLanguages": [{}],
"uiLangs": [Language],
"usage": InstanceUsage,
"users": UserConnection,
"uuid": "xyz789",
"workplace": InstanceWorkplace,
"exports": InstanceExportConnection,
"appLaunchers": AppLauncherConnection,
"smartFeeds": SmartFeedConnection,
"smartAssistants": SmartAssistantConnection,
"storyAlerts": StoryAlertConnection,
"organizations": [Organization],
"auditLogExportURL": "http://www.test.com/"
}
}
}
instanceActivationToken
Description
Get informations about InstanceActivation using a Token. Used only when creating a free trial
Response
Returns an InstanceActivationToken
Arguments
Name | Description |
---|---|
token - UUID!
|
Token to activate the instance, provided by the activation email |
Example
Query
query instanceActivationToken($token: UUID!) {
instanceActivationToken(token: $token) {
email
errorCode
lang
mixpanelToken
mixpanelHost
}
}
Variables
{
"token": "7aac93c5-a56c-4528-b43e-457834a796c9"
}
Response
{
"data": {
"instanceActivationToken": {
"email": "test@test.com",
"errorCode": "EXISTING_USER",
"lang": "abc123",
"mixpanelToken": "xyz789",
"mixpanelHost": "xyz789"
}
}
}
instanceAuth
Description
Information for the different Authentication methods and related login screen
Response
Returns an InstanceAuthentication
Example
Query
query instanceAuth {
instanceAuth {
basic {
...InstanceAuthenticationMethodFragment
}
disclaimers {
...TranslatedRichContentFragment
}
hasDisclaimer
instanceName
uuid
accentColor
headerColor
headerTextLightness
logoImageUrl
introText
isCustomDisclaimer
mobileEnabled
mixpanel {
...PublicInstanceMixpanelFragment
}
saml2 {
...InstanceAuthenticationMethodFragment
}
sso {
...InstanceAuthenticationMethodFragment
}
}
}
Response
{
"data": {
"instanceAuth": {
"basic": InstanceAuthenticationMethod,
"disclaimers": [TranslatedRichContent],
"hasDisclaimer": true,
"instanceName": "xyz789",
"uuid": "xyz789",
"accentColor": "#CCCCCC",
"headerColor": "#CCCCCC",
"headerTextLightness": "DARK",
"logoImageUrl": "http://www.test.com/",
"introText": "<html>Hello <h1>world</h1></html>",
"isCustomDisclaimer": true,
"mobileEnabled": true,
"mixpanel": PublicInstanceMixpanel,
"saml2": InstanceAuthenticationMethod,
"sso": InstanceAuthenticationMethod
}
}
}
integrations
Description
Get all integrations of the instance
Response
Returns an Integrations
Example
Query
query integrations {
integrations {
microsoftTeams {
...MicrosoftTeamsIntegrationFragment
}
slack {
...SlackIntegrationFragment
}
sharePoint {
...SharePointIntegrationFragment
}
}
}
Response
{
"data": {
"integrations": {
"microsoftTeams": MicrosoftTeamsIntegration,
"slack": SlackIntegration,
"sharePoint": SharePointIntegration
}
}
}
me
Description
The currently authenticated user.
Response
Returns a Me
Example
Query
query me {
me {
actions {
...MeActionsFragment
}
activities {
...ActivityConnectionFragment
}
aiCompletion
annotations {
...AnnotationConnectionFragment
}
smartConversations {
...SmartConversationConnectionFragment
}
alerts {
...AlertFragment
}
sharedAlerts {
...AlertConnectionFragment
}
myAlerts {
...AlertConnectionFragment
}
analytics {
...MeAnalyticsFragment
}
answer {
...MeAnswerFragment
}
appLaunchers {
...AppLauncherFragment
}
bookmarks {
...StoryConnectionFragment
}
boxes {
...BoxFragment
}
completeStories {
...StoryFragment
}
contentFeed {
...StoryConnectionFragment
}
contentFromSuccessions {
...StoryConnectionFragment
}
deviceTokens {
...MeDeviceTokenFragment
}
directory {
...DirectorySearchResponseFragment
}
drafts {
...StoryConnectionFragment
}
events {
...StoryConnectionFragment
}
facets {
...FacetFragment
}
feed {
...ActivityFeedItemConnectionFragment
}
globalPinnedStories {
...StoryFragment
}
globalSchemaAttributes {
...SchemaAttributeFragment
}
id
mention {
... on User {
...UserFragment
}
... on Space {
...SpaceFragment
}
... on Team {
...TeamFragment
}
}
ownedContentWithAnnotations {
...StoryConnectionFragment
}
myContent {
...StoryConnectionFragment
}
notifications {
...NotificationConnectionFragment
}
notificationsPreferences {
...MeNotificationsPreferencesFragment
}
personalContent {
...StoryConnectionFragment
}
preferences {
...MePreferencesFragment
}
presenceToken
quickSearch {
...QuickSearchResponseFragment
}
recents {
...StoryFragment
}
schemas {
...StorySchemaFragment
}
search {
...StorySearchResponseFragment
}
searchGlobalTags {
...TagResultFragment
}
searchTags {
...TagResultFragment
}
searchHashtags {
...HashtagResultFragment
}
hashtags {
...HashtagConnectionFragment
}
smartFeeds {
...SmartFeedConnectionFragment
}
smartAssistants {
...SmartAssistantConnectionFragment
}
spaceGroups {
...SpaceGroupConnectionFragment
}
spaces {
...SpaceConnectionFragment
}
storiesByAsset {
...StoryFragment
}
storyAlerts {
...StoryAlertConnectionFragment
}
subscriptionToken
unreadDiscussionsCount
user {
...UserFragment
}
}
}
Response
{
"data": {
"me": {
"actions": MeActions,
"activities": ActivityConnection,
"aiCompletion": "abc123",
"annotations": AnnotationConnection,
"smartConversations": SmartConversationConnection,
"alerts": [Alert],
"sharedAlerts": AlertConnection,
"myAlerts": AlertConnection,
"analytics": MeAnalytics,
"answer": MeAnswer,
"appLaunchers": [AppLauncher],
"bookmarks": StoryConnection,
"boxes": [Box],
"completeStories": [Story],
"contentFeed": StoryConnection,
"contentFromSuccessions": StoryConnection,
"deviceTokens": [MeDeviceToken],
"directory": DirectorySearchResponse,
"drafts": StoryConnection,
"events": StoryConnection,
"facets": [Facet],
"feed": ActivityFeedItemConnection,
"globalPinnedStories": [Story],
"globalSchemaAttributes": [SchemaAttribute],
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"mention": [User],
"ownedContentWithAnnotations": StoryConnection,
"myContent": StoryConnection,
"notifications": NotificationConnection,
"notificationsPreferences": MeNotificationsPreferences,
"personalContent": StoryConnection,
"preferences": MePreferences,
"presenceToken": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"quickSearch": QuickSearchResponse,
"recents": [Story],
"schemas": [StorySchema],
"search": StorySearchResponse,
"searchGlobalTags": [TagResult],
"searchTags": [TagResult],
"searchHashtags": [HashtagResult],
"hashtags": HashtagConnection,
"smartFeeds": SmartFeedConnection,
"smartAssistants": SmartAssistantConnection,
"spaceGroups": SpaceGroupConnection,
"spaces": SpaceConnection,
"storiesByAsset": [Story],
"storyAlerts": StoryAlertConnection,
"subscriptionToken": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"unreadDiscussionsCount": 987,
"user": User
}
}
}
node
Description
Get any node object via the Graphql unique ID
nodes
Description
Get a list of node objects via their ids. see node
resolver
organization
Description
Get an organization via the the subdomain For SSO configuration, for example
Response
Returns an Organization
Arguments
Name | Description |
---|---|
subdomain - String!
|
DNS subdomain of the organization |
Example
Query
query organization($subdomain: String!) {
organization(subdomain: $subdomain) {
id
subdomain
name
created
saml2Enabled
transparentAuth
allowCreate
metadata
metadataUrl
assertionsSigned
messagesSigned
signatureAlgorithm
digestAlgorithm
}
}
Variables
{"subdomain": "abc123"}
Response
{
"data": {
"organization": {
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"subdomain": "xyz789",
"name": "abc123",
"created": "2016-10-07T01:08:03.420Z",
"saml2Enabled": false,
"transparentAuth": true,
"allowCreate": true,
"metadata": "abc123",
"metadataUrl": "http://www.test.com/",
"assertionsSigned": true,
"messagesSigned": false,
"signatureAlgorithm": "RSA_SHA1",
"digestAlgorithm": "SHA1"
}
}
}
publicInstance
Description
Publicly available Instance informations you must provide a valid access token to access it
Response
Returns a PublicInstance
Arguments
Name | Description |
---|---|
token - String!
|
Mandatory access token to access the public content provided by the StoryShare URL |
Example
Query
query publicInstance($token: String!) {
publicInstance(token: $token) {
name
uuid
accentColor
headerColor
headerTextLightness
logoImageUrl
googleAnalyticsTrackingId
baseUrl
domain
release
mixpanel {
...PublicInstanceMixpanelFragment
}
sandboxUrl
}
}
Variables
{"token": "abc123"}
Response
{
"data": {
"publicInstance": {
"name": "xyz789",
"uuid": "xyz789",
"accentColor": "#CCCCCC",
"headerColor": "#CCCCCC",
"headerTextLightness": "DARK",
"logoImageUrl": "http://www.test.com/",
"googleAnalyticsTrackingId": "abc123",
"baseUrl": "http://www.test.com/",
"domain": "abc123",
"release": "abc123",
"mixpanel": PublicInstanceMixpanel,
"sandboxUrl": "http://www.test.com/"
}
}
}
publicStory
Description
Fetch a publicly shared content by token and lang
Response
Returns a PublicStory
Example
Query
query publicStory(
$token: String!,
$lang: Lang
) {
publicStory(
token: $token,
lang: $lang
) {
lang
availableLangs
assets {
...PublicAssetFragment
}
mainAsset {
...PublicAssetFragment
}
layoutMode
hideReadTime
body {
...RichContentFragment
}
created
title
attributes {
...PublicAttributeFragment
}
builtins {
...BuiltinAttributeFragment
}
}
}
Variables
{
"token": "xyz789",
"lang": "fr"
}
Response
{
"data": {
"publicStory": {
"lang": "fr",
"availableLangs": [{}],
"assets": [PublicAsset],
"mainAsset": PublicAsset,
"layoutMode": "SMALL",
"hideReadTime": true,
"body": RichContent,
"created": "2016-10-07T01:08:03.420Z",
"title": "xyz789",
"attributes": [PublicAttribute],
"builtins": [BuiltinAttribute]
}
}
}
space
Description
Get a space via the the slug (integer id)
Example
Query
query space($slug: Int!) {
space(slug: $slug) {
actions {
...SpaceActionsFragment
}
activities {
...ActivityConnectionFragment
}
administrators {
...UserConnectionFragment
}
approvers {
...UserConnectionFragment
}
approvals {
...StoryApprovalConnectionFragment
}
additionalViewsStories {
...StoryConnectionFragment
}
adminsCount
analytics {
...SpaceAnalyticsFragment
}
backdrop
boxes {
...BoxFragment
}
color
contentFeed {
...StoryConnectionFragment
}
contentStats {
...SpaceContentStatsFragment
}
defaultExpiration
defaultRole
deletedStories {
...DeletedStoryConnectionFragment
}
description
descriptions
directory {
...DirectorySearchResponseFragment
}
facets {
...FacetFragment
}
feed {
...ActivityFeedItemConnectionFragment
}
headerImage
headerImageDigest
id
intro {
...RichContentFragment
}
intros {
...TranslatedRichContentFragment
}
isDefault
isApprovalMandatory
meRole
meFavorited
membersAddCompletion {
... on User {
...UserFragment
}
... on Team {
...TeamFragment
}
... on Space {
...SpaceFragment
}
}
membersCount
membersDownload
name
names
notifyAdminsOnPost
notifyMembersOnPost
pendingMembers {
...UserFragment
}
pinnedStories {
...StoryFragment
}
previewImage
promoted
promotedImage
promotedImageDigest
rootFolder {
...FolderFragment
}
schemas {
...StorySchemaFragment
}
search {
...StorySearchResponseFragment
}
showEmbeddedWebsite
showPopularTiles
showPopularUsers
showRecentUsers
showRecomendedUsers
showTopContributors
slug
spaceGroup {
...SpaceGroupFragment
}
spaceMembers {
...SpaceMemberConnectionFragment
}
spaceUsers {
...UserConnectionFragment
}
status
suggestedTags {
...TagFragment
}
tabs {
...SpaceTabFragment
}
tags {
...TagFragment
}
thumbnailImage
thumbnailImageDigest
type
}
}
Variables
{"slug": 987}
Response
{
"data": {
"space": {
"actions": SpaceActions,
"activities": ActivityConnection,
"administrators": UserConnection,
"approvers": UserConnection,
"approvals": StoryApprovalConnection,
"additionalViewsStories": StoryConnection,
"adminsCount": 987,
"analytics": SpaceAnalytics,
"backdrop": false,
"boxes": [Box],
"color": "#CCCCCC",
"contentFeed": StoryConnection,
"contentStats": SpaceContentStats,
"defaultExpiration": "ONE_MONTH",
"defaultRole": "ADMIN",
"deletedStories": DeletedStoryConnection,
"description": "abc123",
"descriptions": {"en": "a Name", "fr": "Un Nom"},
"directory": DirectorySearchResponse,
"facets": [Facet],
"feed": ActivityFeedItemConnection,
"headerImage": "http://www.test.com/",
"headerImageDigest": "xyz789",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"intro": RichContent,
"intros": [TranslatedRichContent],
"isDefault": false,
"isApprovalMandatory": true,
"meRole": "ADMIN",
"meFavorited": false,
"membersAddCompletion": [User],
"membersCount": 123,
"membersDownload": "http://www.test.com/",
"name": "abc123",
"names": {"en": "a Name", "fr": "Un Nom"},
"notifyAdminsOnPost": true,
"notifyMembersOnPost": true,
"pendingMembers": [User],
"pinnedStories": [Story],
"previewImage": "http://www.test.com/",
"promoted": ["NOT_PROMOTED"],
"promotedImage": "http://www.test.com/",
"promotedImageDigest": "xyz789",
"rootFolder": Folder,
"schemas": [StorySchema],
"search": StorySearchResponse,
"showEmbeddedWebsite": "http://www.test.com/",
"showPopularTiles": false,
"showPopularUsers": true,
"showRecentUsers": false,
"showRecomendedUsers": false,
"showTopContributors": true,
"slug": 987,
"spaceGroup": SpaceGroup,
"spaceMembers": SpaceMemberConnection,
"spaceUsers": UserConnection,
"status": "CLOSED",
"suggestedTags": [Tag],
"tabs": [SpaceTab],
"tags": [Tag],
"thumbnailImage": "http://www.test.com/",
"thumbnailImageDigest": "xyz789",
"type": "PUBLIC"
}
}
}
spaceGroup
Description
Get a space group via the slug (integer id)
Response
Returns a SpaceGroup
Arguments
Name | Description |
---|---|
slug - ID!
|
Number id of the space group to load |
Example
Query
query spaceGroup($slug: ID!) {
spaceGroup(slug: $slug) {
actions {
...SpaceGroupActionsFragment
}
backdrop
color
headerImage
headerImageDigest
id
name
names
slug
spaces {
...SpaceConnectionFragment
}
thumbnailImage
thumbnailImageDigest
}
}
Variables
{"slug": "eWVhaCByaWdodCBpdCdzIGI2NA=="}
Response
{
"data": {
"spaceGroup": {
"actions": SpaceGroupActions,
"backdrop": true,
"color": "#CCCCCC",
"headerImage": "http://www.test.com/",
"headerImageDigest": "abc123",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"name": "abc123",
"names": {"en": "a Name", "fr": "Un Nom"},
"slug": "abc123",
"spaces": SpaceConnection,
"thumbnailImage": "http://www.test.com/",
"thumbnailImageDigest": "abc123"
}
}
}
statusStory
Description
Get a story or a status(kp3) via the slug Deprecated
Example
Query
query statusStory($slug: Int!) {
statusStory(slug: $slug) {
actions {
...StoryActionsFragment
}
added
analytics {
...StoryAnalyticsFragment
}
annotations {
...AnnotationConnectionFragment
}
bookmarked
approval {
...StoryApprovalFragment
}
commenters {
...UserConnectionFragment
}
comments {
...CommentConnectionFragment
}
contributors {
...UserConnectionFragment
}
diffVersions {
...StoryVersionsDiffFragment
}
editVersion {
...StoryVersionFragment
}
editVersionUUID
event {
...EventFragment
}
expireAt
followed
followers {
...UserConnectionFragment
}
globallyPinned
grants {
...StoryGrantFragment
}
hasSpace
hashtags {
...HashtagFragment
}
id
invitables {
...InvitableConnectionFragment
}
invitations {
...InvitationConnectionFragment
}
inviteContributors {
...UserFragment
}
isPublished
isSpaceClosed
lastExpiration {
...StoryExpirationHistoryFragment
}
layoutMode
hideReadTime
legacy
liked
likers {
...UserConnectionFragment
}
pinned
publicUrl
publicSharedBy {
...UserFragment
}
publicShared
relateds {
...StoryConnectionFragment
}
reshared
resharedAs {
...StoryFragment
}
resharedAsCount
resharedFrom {
...StoryFragment
}
restricted
schema {
...StorySchemaFragment
}
confidentialContent
share {
...ShareFragment
}
slug
space {
...SpaceFragment
}
status
subscriptionToken
suggestedTags {
...TagFragment
}
tags {
...TagFragment
}
type
updated
user {
...UserFragment
}
usersPermission {
...UserFragment
}
valid
version {
...StoryVersionFragment
}
versions {
...StoryVersionConnectionFragment
}
viewers {
...UserConnectionFragment
}
visibility
watchToken
lock {
...StoryLockFragment
}
}
}
Variables
{"slug": 987}
Response
{
"data": {
"statusStory": {
"actions": StoryActions,
"added": "2016-10-07T01:08:03.420Z",
"analytics": StoryAnalytics,
"annotations": AnnotationConnection,
"bookmarked": true,
"approval": StoryApproval,
"commenters": UserConnection,
"comments": CommentConnection,
"contributors": UserConnection,
"diffVersions": StoryVersionsDiff,
"editVersion": StoryVersion,
"editVersionUUID": "7aac93c5-a56c-4528-b43e-457834a796c9",
"event": Event,
"expireAt": "2016-10-07T01:08:03.420Z",
"followed": true,
"followers": UserConnection,
"globallyPinned": true,
"grants": [StoryGrant],
"hasSpace": false,
"hashtags": [Hashtag],
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"invitables": InvitableConnection,
"invitations": InvitationConnection,
"inviteContributors": [User],
"isPublished": true,
"isSpaceClosed": true,
"lastExpiration": StoryExpirationHistory,
"layoutMode": "SMALL",
"hideReadTime": false,
"legacy": false,
"liked": true,
"likers": UserConnection,
"pinned": false,
"publicUrl": "http://www.test.com/",
"publicSharedBy": User,
"publicShared": "2016-10-07T01:08:03.420Z",
"relateds": StoryConnection,
"reshared": false,
"resharedAs": [Story],
"resharedAsCount": 123,
"resharedFrom": Story,
"restricted": true,
"schema": StorySchema,
"confidentialContent": false,
"share": Share,
"slug": 123,
"space": Space,
"status": "DELETED",
"subscriptionToken": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"suggestedTags": [Tag],
"tags": [Tag],
"type": "abc123",
"updated": "2016-10-07T01:08:03.420Z",
"user": User,
"usersPermission": [User],
"valid": false,
"version": StoryVersion,
"versions": StoryVersionConnection,
"viewers": UserConnection,
"visibility": "PRIVATE",
"watchToken": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"lock": StoryLock
}
}
}
story
Description
Get a story via its slug (integer id)
Example
Query
query story($slug: Int!) {
story(slug: $slug) {
actions {
...StoryActionsFragment
}
added
analytics {
...StoryAnalyticsFragment
}
annotations {
...AnnotationConnectionFragment
}
bookmarked
approval {
...StoryApprovalFragment
}
commenters {
...UserConnectionFragment
}
comments {
...CommentConnectionFragment
}
contributors {
...UserConnectionFragment
}
diffVersions {
...StoryVersionsDiffFragment
}
editVersion {
...StoryVersionFragment
}
editVersionUUID
event {
...EventFragment
}
expireAt
followed
followers {
...UserConnectionFragment
}
globallyPinned
grants {
...StoryGrantFragment
}
hasSpace
hashtags {
...HashtagFragment
}
id
invitables {
...InvitableConnectionFragment
}
invitations {
...InvitationConnectionFragment
}
inviteContributors {
...UserFragment
}
isPublished
isSpaceClosed
lastExpiration {
...StoryExpirationHistoryFragment
}
layoutMode
hideReadTime
legacy
liked
likers {
...UserConnectionFragment
}
pinned
publicUrl
publicSharedBy {
...UserFragment
}
publicShared
relateds {
...StoryConnectionFragment
}
reshared
resharedAs {
...StoryFragment
}
resharedAsCount
resharedFrom {
...StoryFragment
}
restricted
schema {
...StorySchemaFragment
}
confidentialContent
share {
...ShareFragment
}
slug
space {
...SpaceFragment
}
status
subscriptionToken
suggestedTags {
...TagFragment
}
tags {
...TagFragment
}
type
updated
user {
...UserFragment
}
usersPermission {
...UserFragment
}
valid
version {
...StoryVersionFragment
}
versions {
...StoryVersionConnectionFragment
}
viewers {
...UserConnectionFragment
}
visibility
watchToken
lock {
...StoryLockFragment
}
}
}
Variables
{"slug": 123}
Response
{
"data": {
"story": {
"actions": StoryActions,
"added": "2016-10-07T01:08:03.420Z",
"analytics": StoryAnalytics,
"annotations": AnnotationConnection,
"bookmarked": true,
"approval": StoryApproval,
"commenters": UserConnection,
"comments": CommentConnection,
"contributors": UserConnection,
"diffVersions": StoryVersionsDiff,
"editVersion": StoryVersion,
"editVersionUUID": "7aac93c5-a56c-4528-b43e-457834a796c9",
"event": Event,
"expireAt": "2016-10-07T01:08:03.420Z",
"followed": true,
"followers": UserConnection,
"globallyPinned": false,
"grants": [StoryGrant],
"hasSpace": false,
"hashtags": [Hashtag],
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"invitables": InvitableConnection,
"invitations": InvitationConnection,
"inviteContributors": [User],
"isPublished": true,
"isSpaceClosed": false,
"lastExpiration": StoryExpirationHistory,
"layoutMode": "SMALL",
"hideReadTime": false,
"legacy": true,
"liked": true,
"likers": UserConnection,
"pinned": true,
"publicUrl": "http://www.test.com/",
"publicSharedBy": User,
"publicShared": "2016-10-07T01:08:03.420Z",
"relateds": StoryConnection,
"reshared": false,
"resharedAs": [Story],
"resharedAsCount": 987,
"resharedFrom": Story,
"restricted": true,
"schema": StorySchema,
"confidentialContent": true,
"share": Share,
"slug": 987,
"space": Space,
"status": "DELETED",
"subscriptionToken": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"suggestedTags": [Tag],
"tags": [Tag],
"type": "xyz789",
"updated": "2016-10-07T01:08:03.420Z",
"user": User,
"usersPermission": [User],
"valid": false,
"version": StoryVersion,
"versions": StoryVersionConnection,
"viewers": UserConnection,
"visibility": "PRIVATE",
"watchToken": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"lock": StoryLock
}
}
}
storySchema
Description
Get a story schema via the slug
Response
Returns a StorySchema
Arguments
Name | Description |
---|---|
slug - Int!
|
Number id of the story schema to load |
Example
Query
query storySchema($slug: Int!) {
storySchema(slug: $slug) {
actions {
...StorySchemaActionsFragment
}
attributes {
... on SchemaSeparator {
...SchemaSeparatorFragment
}
... on SchemaAttribute {
...SchemaAttributeFragment
}
}
bodies {
...TranslatedRichContentFragment
}
body {
...RichContentFragment
}
builtins
color
coverAssetUsage
hasEvent
hasStructuredTitle
icon
id
installedGlobally
langs
mainAssetTypes
mainAssetUsage
name
names
placeholderTitle
placeholderTitles
slug
spaces {
...SpaceFragment
}
status
titleSeparator
}
}
Variables
{"slug": 123}
Response
{
"data": {
"storySchema": {
"actions": StorySchemaActions,
"attributes": [SchemaSeparator],
"bodies": [TranslatedRichContent],
"body": RichContent,
"builtins": ["AUTHOR"],
"color": "xyz789",
"coverAssetUsage": "HIDDEN",
"hasEvent": false,
"hasStructuredTitle": false,
"icon": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"installedGlobally": false,
"langs": ["fr"],
"mainAssetTypes": ["CLOUD_FILE"],
"mainAssetUsage": "HIDDEN",
"name": "abc123",
"names": {"en": "a Name", "fr": "Un Nom"},
"placeholderTitle": "xyz789",
"placeholderTitles": {"en": "a Name", "fr": "Un Nom"},
"slug": 987,
"spaces": [Space],
"status": "DELETED",
"titleSeparator": "COLON"
}
}
}
user
Description
Get a user via the slug (integer id)
Example
Query
query user($slug: Int!) {
user(slug: $slug) {
actions {
...UserActionsFragment
}
attributes {
...AttributeFragment
}
banner
builtins {
...BuiltinAttributeFragment
}
downloadsCount
primaryEmail
userName
commonSpaces {
...SpaceConnectionFragment
}
contentCount
cover
coverDigest
description
feed {
...ActivityFeedItemConnectionFragment
}
followed
followers {
...UserConnectionFragment
}
following {
...UserConnectionFragment
}
hasTwoFactorEnabled
hashtags {
...HashtagFragment
}
id
lastVisit
spacesWithUserContent {
...SuccessionFragment
}
successorContentCount
memberSince
mustEnableTwoFactor
name
photo
photoDigest
presence {
...UserPresenceFragment
}
registered
role
schema {
...UserSchemaFragment
}
search {
...StorySearchResponseFragment
}
slug
spaceContentCount
spaceWithSuccessionCount
status
tags {
...TagFragment
}
teams {
...TeamConnectionFragment
}
twoFactorSetupDate
watchToken
}
}
Variables
{"slug": 123}
Response
{
"data": {
"user": {
"actions": UserActions,
"attributes": [Attribute],
"banner": "http://www.test.com/",
"builtins": [BuiltinAttribute],
"downloadsCount": 987,
"primaryEmail": "test@test.com",
"userName": "xyz789",
"commonSpaces": SpaceConnection,
"contentCount": 123,
"cover": "http://www.test.com/",
"coverDigest": "xyz789",
"description": "xyz789",
"feed": ActivityFeedItemConnection,
"followed": true,
"followers": UserConnection,
"following": UserConnection,
"hasTwoFactorEnabled": false,
"hashtags": [Hashtag],
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"lastVisit": "2016-10-07T01:08:03.420Z",
"spacesWithUserContent": [Succession],
"successorContentCount": 123,
"memberSince": "2016-10-07T01:08:03.420Z",
"mustEnableTwoFactor": true,
"name": "abc123",
"photo": "http://www.test.com/",
"photoDigest": "abc123",
"presence": [UserPresence],
"registered": "2016-10-07T01:08:03.420Z",
"role": "ADMINISTRATOR",
"schema": UserSchema,
"search": StorySearchResponse,
"slug": 123,
"spaceContentCount": 123,
"spaceWithSuccessionCount": 987,
"status": "DELETED",
"tags": [Tag],
"teams": TeamConnection,
"twoFactorSetupDate": "2016-10-07T01:08:03.420Z",
"watchToken": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}
}
}
Mutations
alertCreate
Description
Create an Alert
based on search criterias
Response
Returns an AlertCreatePayload
Arguments
Name | Description |
---|---|
input - AlertCreateInput!
|
Required Parameter for the alertCreate Mutation |
Example
Query
mutation alertCreate($input: AlertCreateInput!) {
alertCreate(input: $input) {
alert {
...AlertFragment
}
clientMutationId
me {
...MeFragment
}
errors {
... on InvalidInputError {
...InvalidInputErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": AlertCreateInput}
Response
{
"data": {
"alertCreate": {
"alert": Alert,
"clientMutationId": "xyz789",
"me": Me,
"errors": [InvalidInputError]
}
}
}
alertDelete
Description
Delete an Alert
Response
Returns an AlertDeletePayload
Arguments
Name | Description |
---|---|
input - AlertDeleteInput!
|
Required Parameter for the alertDelete Mutation |
Example
Query
mutation alertDelete($input: AlertDeleteInput!) {
alertDelete(input: $input) {
clientMutationId
me {
...MeFragment
}
deletedIds
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": AlertDeleteInput}
Response
{
"data": {
"alertDelete": {
"clientMutationId": "abc123",
"me": Me,
"deletedIds": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"errors": [ObjectNotFoundError]
}
}
}
alertEdit
Description
Edit an existing Alert
Response
Returns an AlertEditPayload
Arguments
Name | Description |
---|---|
input - AlertEditInput!
|
Required Parameter for the alertEdit Mutation |
Example
Query
mutation alertEdit($input: AlertEditInput!) {
alertEdit(input: $input) {
alert {
...AlertFragment
}
clientMutationId
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
}
}
}
Variables
{"input": AlertEditInput}
Response
{
"data": {
"alertEdit": {
"alert": Alert,
"clientMutationId": "xyz789",
"errors": [PermissionError]
}
}
}
alertSubscriberAdd
Description
Add subscribers to an Alert
Response
Returns an AlertSubscriberAddPayload
Arguments
Name | Description |
---|---|
input - AlertSubscriberAddInput!
|
Required Parameter for the alertSubscriberAdd Mutation |
Example
Query
mutation alertSubscriberAdd($input: AlertSubscriberAddInput!) {
alertSubscriberAdd(input: $input) {
clientMutationId
subscribers {
...AlertSubscriberFragment
}
background
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": AlertSubscriberAddInput}
Response
{
"data": {
"alertSubscriberAdd": {
"clientMutationId": "abc123",
"subscribers": [AlertSubscriber],
"background": true,
"errors": [ObjectNotFoundError]
}
}
}
alertSubscriberRemove
Description
Remove subscribers of an Alert
Response
Returns an AlertSubscriberRemovePayload
Arguments
Name | Description |
---|---|
input - AlertSubscriberRemoveInput!
|
Required Parameter for the alertSubscriberRemove Mutation |
Example
Query
mutation alertSubscriberRemove($input: AlertSubscriberRemoveInput!) {
alertSubscriberRemove(input: $input) {
clientMutationId
deletedIds
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": AlertSubscriberRemoveInput}
Response
{
"data": {
"alertSubscriberRemove": {
"clientMutationId": "xyz789",
"deletedIds": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"errors": [ObjectNotFoundError]
}
}
}
alertSubscription
Description
Edit subscription (sending preferences) of an Alert
Response
Returns an AlertSubscriptionPayload
Arguments
Name | Description |
---|---|
input - AlertSubscriptionInput!
|
Required Parameter for the alertSubscription Mutation |
Example
Query
mutation alertSubscription($input: AlertSubscriptionInput!) {
alertSubscription(input: $input) {
alert {
...AlertFragment
}
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
}
}
}
Variables
{"input": AlertSubscriptionInput}
Response
{
"data": {
"alertSubscription": {
"alert": Alert,
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError]
}
}
}
analyticsSignal
Description
Send signal about read or impression made by a user
Response
Returns an AnalyticsSignalPayload
Arguments
Name | Description |
---|---|
input - AnalyticsSignalInput!
|
Required Parameter for the analyticsSignal Mutation |
Example
Query
mutation analyticsSignal($input: AnalyticsSignalInput!) {
analyticsSignal(input: $input) {
clientMutationId
me {
...MeFragment
}
}
}
Variables
{"input": AnalyticsSignalInput}
Response
{
"data": {
"analyticsSignal": {
"clientMutationId": "xyz789",
"me": Me
}
}
}
annotationCommentAdd
Description
Add a reply (AnnotationComment
) to an Annotation
requires AnnotationActions.reply
Response
Returns an AnnotationCommentAddPayload
Arguments
Name | Description |
---|---|
input - AnnotationCommentAddInput!
|
Required Input for the annotationCommentAdd Mutation |
Example
Query
mutation annotationCommentAdd($input: AnnotationCommentAddInput!) {
annotationCommentAdd(input: $input) {
clientMutationId
annotation {
...AnnotationFragment
}
commentEdge {
...AnnotationCommentEdgeFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": AnnotationCommentAddInput}
Response
{
"data": {
"annotationCommentAdd": {
"clientMutationId": "xyz789",
"annotation": Annotation,
"commentEdge": AnnotationCommentEdge,
"errors": [ObjectNotFoundError]
}
}
}
annotationCommentDelete
Description
Delete an AnnotationComment
requires AnnotationCommentActions.delete
Response
Returns an AnnotationCommentDeletePayload
Arguments
Name | Description |
---|---|
input - AnnotationCommentDeleteInput!
|
Required Input for the annotationCommentDelete Mutation |
Example
Query
mutation annotationCommentDelete($input: AnnotationCommentDeleteInput!) {
annotationCommentDelete(input: $input) {
clientMutationId
annotationCommentId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": AnnotationCommentDeleteInput}
Response
{
"data": {
"annotationCommentDelete": {
"clientMutationId": "xyz789",
"annotationCommentId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"errors": [ObjectNotFoundError]
}
}
}
annotationCommentEdit
Description
Edit an AnnotationComment
text content requires AnnotationCommentActions.edit
Response
Returns an AnnotationCommentEditPayload
Arguments
Name | Description |
---|---|
input - AnnotationCommentEditInput!
|
Required Input for the annotationCommentEdit Mutation |
Example
Query
mutation annotationCommentEdit($input: AnnotationCommentEditInput!) {
annotationCommentEdit(input: $input) {
clientMutationId
comment {
...AnnotationCommentFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": AnnotationCommentEditInput}
Response
{
"data": {
"annotationCommentEdit": {
"clientMutationId": "xyz789",
"comment": AnnotationComment,
"errors": [ObjectNotFoundError]
}
}
}
annotationCreate
Description
Create an Annotation
on a given Story requires StoryActions.annotate
Response
Returns an AnnotationCreatePayload
Arguments
Name | Description |
---|---|
input - AnnotationCreateInput!
|
Required Parameter for the annotationCreate Mutation |
Example
Query
mutation annotationCreate($input: AnnotationCreateInput!) {
annotationCreate(input: $input) {
clientMutationId
story {
...StoryFragment
}
annotationEdge {
...AnnotationEdgeFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
}
}
}
Variables
{"input": AnnotationCreateInput}
Response
{
"data": {
"annotationCreate": {
"clientMutationId": "xyz789",
"story": Story,
"annotationEdge": AnnotationEdge,
"errors": [ObjectNotFoundError]
}
}
}
annotationDelete
Description
Delete an Annotation
requires AnnotationActions.delete
Response
Returns an AnnotationDeletePayload
Arguments
Name | Description |
---|---|
input - AnnotationDeleteInput!
|
Required Parameter for the annotationDelete Mutation |
Example
Query
mutation annotationDelete($input: AnnotationDeleteInput!) {
annotationDelete(input: $input) {
clientMutationId
annotationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": AnnotationDeleteInput}
Response
{
"data": {
"annotationDelete": {
"clientMutationId": "xyz789",
"annotationId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"errors": [ObjectNotFoundError]
}
}
}
annotationEdit
Description
Edit an exisiting Annotation
on a story (resolve it or change the message for example) requires AnnotationActions.edit
or requires AnnotationActions.resolve
Response
Returns an AnnotationEditPayload
Arguments
Name | Description |
---|---|
input - AnnotationEditInput!
|
Required Parameter for the annotationEdit Mutation |
Example
Query
mutation annotationEdit($input: AnnotationEditInput!) {
annotationEdit(input: $input) {
clientMutationId
annotation {
...AnnotationFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": AnnotationEditInput}
Response
{
"data": {
"annotationEdit": {
"clientMutationId": "xyz789",
"annotation": Annotation,
"errors": [ObjectNotFoundError]
}
}
}
answerFeedback
Description
Give Feedback about an answer provided by me.answers
Response
Returns an AnswerFeedbackPayload
Arguments
Name | Description |
---|---|
input - AnswerFeedbackInput!
|
Required Parameter for the answerFeedback Mutation |
Example
Query
mutation answerFeedback($input: AnswerFeedbackInput!) {
answerFeedback(input: $input) {
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on UnconfiguredServiceError {
...UnconfiguredServiceErrorFragment
}
}
answer {
...AnswerFragment
}
}
}
Variables
{"input": AnswerFeedbackInput}
Response
{
"data": {
"answerFeedback": {
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError],
"answer": Answer
}
}
}
answerResolve
Description
Mark an Answer as resolved and provide a message to the user
Response
Returns an AnswerResolvePayload
Arguments
Name | Description |
---|---|
input - AnswerResolveInput!
|
Required Parameter for the answerResolve Mutation |
Example
Query
mutation answerResolve($input: AnswerResolveInput!) {
answerResolve(input: $input) {
clientMutationId
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on UnconfiguredServiceError {
...UnconfiguredServiceErrorFragment
}
}
answer {
...AnswerFragment
}
}
}
Variables
{"input": AnswerResolveInput}
Response
{
"data": {
"answerResolve": {
"clientMutationId": "xyz789",
"errors": [PermissionError],
"answer": Answer
}
}
}
answerSendForReview
Description
Send a Question and answers to Elium's team for review and improvement
Response
Returns an AnswerSendForReviewPayload
Arguments
Name | Description |
---|---|
input - AnswerSendForReviewInput!
|
Input of the mutation |
Example
Query
mutation answerSendForReview($input: AnswerSendForReviewInput!) {
answerSendForReview(input: $input) {
clientMutationId
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on UnconfiguredServiceError {
...UnconfiguredServiceErrorFragment
}
}
answer {
...AnswerFragment
}
}
}
Variables
{"input": AnswerSendForReviewInput}
Response
{
"data": {
"answerSendForReview": {
"clientMutationId": "abc123",
"errors": [PermissionError],
"answer": Answer
}
}
}
appLauncherCreate
Description
Create a new AppLauncher
object to be display for everybody or only list of team's users require InstanceActions.appLauncherEdit
Response
Returns an AppLauncherCreatePayload
Arguments
Name | Description |
---|---|
input - AppLauncherCreateInput!
|
Required Parameter for the appLauncherCreate Mutation |
Example
Query
mutation appLauncherCreate($input: AppLauncherCreateInput!) {
appLauncherCreate(input: $input) {
clientMutationId
edge {
...AppLauncherEdgeFragment
}
launcher {
...AppLauncherFragment
}
instance {
...InstanceFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": AppLauncherCreateInput}
Response
{
"data": {
"appLauncherCreate": {
"clientMutationId": "abc123",
"edge": AppLauncherEdge,
"launcher": AppLauncher,
"instance": Instance,
"errors": [ObjectNotFoundError]
}
}
}
appLauncherDelete
Description
Delete a single AppLauncher
object. require InstanceActions.appLauncherEdit
Response
Returns an AppLauncherDeletePayload
Arguments
Name | Description |
---|---|
input - AppLauncherDeleteInput!
|
Required Parameter for the appLauncherDelete Mutation |
Example
Query
mutation appLauncherDelete($input: AppLauncherDeleteInput!) {
appLauncherDelete(input: $input) {
clientMutationId
deletedId
instance {
...InstanceFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": AppLauncherDeleteInput}
Response
{
"data": {
"appLauncherDelete": {
"clientMutationId": "xyz789",
"deletedId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"instance": Instance,
"errors": [ObjectNotFoundError]
}
}
}
appLauncherEdit
Description
Edit an AppLauncher
object. require InstanceActions.appLauncherEdit
Response
Returns an AppLauncherEditPayload
Arguments
Name | Description |
---|---|
input - AppLauncherEditInput!
|
Required Parameter for the appLauncherEdit Mutation |
Example
Query
mutation appLauncherEdit($input: AppLauncherEditInput!) {
appLauncherEdit(input: $input) {
clientMutationId
launcher {
...AppLauncherFragment
}
instance {
...InstanceFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": AppLauncherEditInput}
Response
{
"data": {
"appLauncherEdit": {
"clientMutationId": "xyz789",
"launcher": AppLauncher,
"instance": Instance,
"errors": [ObjectNotFoundError]
}
}
}
appLauncherOrder
Description
Change the order in which the AppLauncher
should be displayed to users. require InstanceActions.appLauncherOrder
Response
Returns an AppLauncherOrderPayload
Arguments
Name | Description |
---|---|
input - AppLauncherOrderInput!
|
Required Parameter for the appLauncherOrder Mutation |
Example
Query
mutation appLauncherOrder($input: AppLauncherOrderInput!) {
appLauncherOrder(input: $input) {
clientMutationId
instance {
...InstanceFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": AppLauncherOrderInput}
Response
{
"data": {
"appLauncherOrder": {
"clientMutationId": "xyz789",
"instance": Instance,
"errors": [PermissionError]
}
}
}
assetPreview
Description
Get a preview of a given asset. Currently only CloudFile and CloudFolder are supported
Response
Returns an AssetPreviewPayload
Arguments
Name | Description |
---|---|
input - StoryAssetInput!
|
Required Parameter for the assetPreview Mutation |
Example
Query
mutation assetPreview($input: StoryAssetInput!) {
assetPreview(input: $input) {
asset {
...AssetFragment
}
clientMutationId
}
}
Variables
{"input": StoryAssetInput}
Response
{
"data": {
"assetPreview": {
"asset": Asset,
"clientMutationId": "abc123"
}
}
}
bulkStoryArchive
Description
Archive or Unarchive multiple stories. requires StoryActions.archive
or StoryActions.restore
on each of the stories
Response
Returns a BulkStoryArchivePayload
Arguments
Name | Description |
---|---|
input - BulkStoryArchiveInput!
|
Required Parameter for the bulkStoryArchive Mutation |
Example
Query
mutation bulkStoryArchive($input: BulkStoryArchiveInput!) {
bulkStoryArchive(input: $input) {
clientMutationId
touchedIds
skippedIds
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
}
me {
...MeFragment
}
}
}
Variables
{"input": BulkStoryArchiveInput}
Response
{
"data": {
"bulkStoryArchive": {
"clientMutationId": "xyz789",
"touchedIds": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"skippedIds": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"errors": [PermissionError],
"me": Me
}
}
}
bulkStoryDelete
Description
Delete Stories in bulk
Response
Returns a BulkStoryDeletePayload
Arguments
Name | Description |
---|---|
input - BulkStoryDeleteInput!
|
Required Parameter for the bulkStoryDelete Mutation |
Example
Query
mutation bulkStoryDelete($input: BulkStoryDeleteInput!) {
bulkStoryDelete(input: $input) {
clientMutationId
deletedIds
skippedIds
me {
...MeFragment
}
}
}
Variables
{"input": BulkStoryDeleteInput}
Response
{
"data": {
"bulkStoryDelete": {
"clientMutationId": "xyz789",
"deletedIds": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"skippedIds": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"me": Me
}
}
}
bulkStoryMove
Description
Move Stories in bulk
Response
Returns a BulkStoryMovePayload
Arguments
Name | Description |
---|---|
input - BulkStoryMoveInput!
|
Required Parameter for the bulkStoryMove Mutation |
Example
Query
mutation bulkStoryMove($input: BulkStoryMoveInput!) {
bulkStoryMove(input: $input) {
clientMutationId
movedIds
skippedIds
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
}
me {
...MeFragment
}
space {
...SpaceFragment
}
}
}
Variables
{"input": BulkStoryMoveInput}
Response
{
"data": {
"bulkStoryMove": {
"clientMutationId": "abc123",
"movedIds": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"skippedIds": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"errors": [PermissionError],
"me": Me,
"space": Space
}
}
}
bulkStorySchemaConvert
Description
Convert Multiple Stories to a Story
with a given StorySchema
Note: this only works for stories that are not already converted requires StoryActions.edit
on each of the stories
Response
Returns a BulkStorySchemaConvertPayload
Arguments
Name | Description |
---|---|
input - BulkStorySchemaConvertInput!
|
Required Parameter for the bulkStoryMove Mutation |
Example
Query
mutation bulkStorySchemaConvert($input: BulkStorySchemaConvertInput!) {
bulkStorySchemaConvert(input: $input) {
clientMutationId
touchedIds
skippedIds
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
}
me {
...MeFragment
}
}
}
Variables
{"input": BulkStorySchemaConvertInput}
Response
{
"data": {
"bulkStorySchemaConvert": {
"clientMutationId": "abc123",
"touchedIds": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"skippedIds": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"errors": [PermissionError],
"me": Me
}
}
}
checkPassword
Description
Verify if the password is correct with a registration token
Response
Returns a CheckPasswordPayload
Arguments
Name | Description |
---|---|
input - CheckPasswordInput!
|
Required Parameter for the checkPassword Mutation |
Example
Query
mutation checkPassword($input: CheckPasswordInput!) {
checkPassword(input: $input) {
clientMutationId
errors {
... on InvalidInputError {
...InvalidInputErrorFragment
}
... on InvalidPasswordError {
...InvalidPasswordErrorFragment
}
}
success
}
}
Variables
{"input": CheckPasswordInput}
Response
{
"data": {
"checkPassword": {
"clientMutationId": "xyz789",
"errors": [InvalidInputError],
"success": false
}
}
}
commentDelete
Description
Delete a comment. requires CommentActions.delete
Response
Returns a CommentDeletePayload
Arguments
Name | Description |
---|---|
input - CommentDeleteInput!
|
Required Parameter for the commentDelete Mutation |
Example
Query
mutation commentDelete($input: CommentDeleteInput!) {
commentDelete(input: $input) {
clientMutationId
id
deletedId
parent {
...StoryFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": CommentDeleteInput}
Response
{
"data": {
"commentDelete": {
"clientMutationId": "abc123",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"deletedId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"parent": Story,
"errors": [ObjectNotFoundError]
}
}
}
commentEdit
Description
Edit a comment. requires CommentActions.edit
Response
Returns a CommentEditPayload
Arguments
Name | Description |
---|---|
input - CommentEditInput!
|
Required Parameter for the commentEdit Mutation |
Example
Query
mutation commentEdit($input: CommentEditInput!) {
commentEdit(input: $input) {
clientMutationId
comment {
...CommentFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": CommentEditInput}
Response
{
"data": {
"commentEdit": {
"clientMutationId": "xyz789",
"comment": Comment,
"errors": [ObjectNotFoundError]
}
}
}
commentLike
Description
Like or unlike a specific comment
Response
Returns a CommentLikePayload
Arguments
Name | Description |
---|---|
input - CommentLikeInput!
|
Required Parameter for the commentLike Mutation |
Example
Query
mutation commentLike($input: CommentLikeInput!) {
commentLike(input: $input) {
clientMutationId
comment {
...CommentFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
}
}
}
Variables
{"input": CommentLikeInput}
Response
{
"data": {
"commentLike": {
"clientMutationId": "abc123",
"comment": Comment,
"errors": [ObjectNotFoundError]
}
}
}
commentPost
Description
Post a comment on a content Comment might be posted from different sources CommentSource
and can contain assets
Response
Returns a CommentPostPayload
Arguments
Name | Description |
---|---|
input - CommentPostInput!
|
Required Parameter for the commentPost Mutation |
Example
Query
mutation commentPost($input: CommentPostInput!) {
commentPost(input: $input) {
clientMutationId
commentEdge {
...CommentEdgeFragment
}
parent {
...StoryFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": CommentPostInput}
Response
{
"data": {
"commentPost": {
"clientMutationId": "xyz789",
"commentEdge": CommentEdge,
"parent": Story,
"errors": [ObjectNotFoundError]
}
}
}
connectedAppCreate
Description
Create a new ConnectedApp
Response
Returns a ConnectedAppCreatePayload
Arguments
Name | Description |
---|---|
input - ConnectedAppCreateInput!
|
Required Parameter for the connectedAppCreate Mutation |
Example
Query
mutation connectedAppCreate($input: ConnectedAppCreateInput!) {
connectedAppCreate(input: $input) {
clientMutationId
connectedApp {
...ConnectedAppFragment
}
edge {
...ConnectedAppEdgeFragment
}
instance {
...InstanceFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": ConnectedAppCreateInput}
Response
{
"data": {
"connectedAppCreate": {
"clientMutationId": "abc123",
"connectedApp": ConnectedApp,
"edge": ConnectedAppEdge,
"instance": Instance,
"errors": [ObjectNotFoundError]
}
}
}
connectedAppDelete
Description
Delete a single ConnectedApp
object.
Response
Returns a ConnectedAppDeletePayload
Arguments
Name | Description |
---|---|
input - ConnectedAppDeleteInput!
|
Required Parameter for the connectedAppDelete Mutation |
Example
Query
mutation connectedAppDelete($input: ConnectedAppDeleteInput!) {
connectedAppDelete(input: $input) {
clientMutationId
deletedId
instance {
...InstanceFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": ConnectedAppDeleteInput}
Response
{
"data": {
"connectedAppDelete": {
"clientMutationId": "xyz789",
"deletedId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"instance": Instance,
"errors": [ObjectNotFoundError]
}
}
}
connectedAppEdit
Description
Edit an ConnectedApp
object.
Response
Returns a ConnectedAppEditPayload
Arguments
Name | Description |
---|---|
input - ConnectedAppEditInput!
|
Required Parameter for the connectedAppEdit Mutation |
Example
Query
mutation connectedAppEdit($input: ConnectedAppEditInput!) {
connectedAppEdit(input: $input) {
clientMutationId
connectedApp {
...ConnectedAppFragment
}
instance {
...InstanceFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": ConnectedAppEditInput}
Response
{
"data": {
"connectedAppEdit": {
"clientMutationId": "xyz789",
"connectedApp": ConnectedApp,
"instance": Instance,
"errors": [ObjectNotFoundError]
}
}
}
contentLike
Description
Toggle Like status of a Story
Response
Returns a ContentLikePayload
Arguments
Name | Description |
---|---|
input - ContentLikeInput!
|
Required Parameter for the contentLike Mutation |
Example
Query
mutation contentLike($input: ContentLikeInput!) {
contentLike(input: $input) {
clientMutationId
content {
...NodeFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
}
}
}
Variables
{"input": ContentLikeInput}
Response
{
"data": {
"contentLike": {
"clientMutationId": "xyz789",
"content": Node,
"errors": [ObjectNotFoundError]
}
}
}
disableStandardContent
Description
Set the disabled standard content items within ['story file link event'] Standard content are hardcoded "fake schemas" in the front-end
Response
Returns a DisableStandardContentPayload
Arguments
Name | Description |
---|---|
input - DisableStandardContentInput!
|
Required Input for the disableStandardContent Mutation |
Example
Query
mutation disableStandardContent($input: DisableStandardContentInput!) {
disableStandardContent(input: $input) {
clientMutationId
instance {
...InstanceFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
}
}
}
Variables
{"input": DisableStandardContentInput}
Response
{
"data": {
"disableStandardContent": {
"clientMutationId": "xyz789",
"instance": Instance,
"errors": [PermissionError]
}
}
}
emailPipelineCreate
Description
Create a new EmailPipeline
object to ingest content in the platform require InstanceActions.emailPipelineEdit
Response
Returns an EmailPipelineCreatePayload
Arguments
Name | Description |
---|---|
input - EmailPipelineCreateInput!
|
Required Input for the emailPipelineCreate Mutation |
Example
Query
mutation emailPipelineCreate($input: EmailPipelineCreateInput!) {
emailPipelineCreate(input: $input) {
clientMutationId
pipeline {
...EmailPipelineFragment
}
instance {
...InstanceFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectAlreadyExistsError {
...ObjectAlreadyExistsErrorFragment
}
... on InvalidFormatError {
...InvalidFormatErrorFragment
}
}
}
}
Variables
{"input": EmailPipelineCreateInput}
Response
{
"data": {
"emailPipelineCreate": {
"clientMutationId": "xyz789",
"pipeline": EmailPipeline,
"instance": Instance,
"errors": [ObjectNotFoundError]
}
}
}
emailPipelineDelete
Description
Delete a single EmailPipeline
object. require InstanceActions.emailPipelineEdit
Response
Returns an EmailPipelineDeletePayload
Arguments
Name | Description |
---|---|
input - EmailPipelineDeleteInput!
|
Required Input for the emailPipelineDelete Mutation |
Example
Query
mutation emailPipelineDelete($input: EmailPipelineDeleteInput!) {
emailPipelineDelete(input: $input) {
clientMutationId
deletedId
instance {
...InstanceFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": EmailPipelineDeleteInput}
Response
{
"data": {
"emailPipelineDelete": {
"clientMutationId": "xyz789",
"deletedId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"instance": Instance,
"errors": [ObjectNotFoundError]
}
}
}
emailPipelineEdit
Description
Edit an EmailPipeline
object. require InstanceActions.emailPipelineEdit
Response
Returns an EmailPipelineEditPayload
Arguments
Name | Description |
---|---|
input - EmailPipelineEditInput!
|
Required Parameter for the emailPipelineEdit Mutation |
Example
Query
mutation emailPipelineEdit($input: EmailPipelineEditInput!) {
emailPipelineEdit(input: $input) {
clientMutationId
pipeline {
...EmailPipelineFragment
}
instance {
...InstanceFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectAlreadyExistsError {
...ObjectAlreadyExistsErrorFragment
}
... on InvalidFormatError {
...InvalidFormatErrorFragment
}
}
}
}
Variables
{"input": EmailPipelineEditInput}
Response
{
"data": {
"emailPipelineEdit": {
"clientMutationId": "xyz789",
"pipeline": EmailPipeline,
"instance": Instance,
"errors": [ObjectNotFoundError]
}
}
}
eventInvite
Description
Invite user to an Story
with event defined requires StoryActions.edit
Response
Returns an EventInvitePayload
Arguments
Name | Description |
---|---|
input - EventInviteInput!
|
Required Parameter for the eventInvite Mutation |
Example
Query
mutation eventInvite($input: EventInviteInput!) {
eventInvite(input: $input) {
clientMutationId
story {
...StoryFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
}
}
}
Variables
{"input": EventInviteInput}
Response
{
"data": {
"eventInvite": {
"clientMutationId": "abc123",
"story": Story,
"errors": [PermissionError]
}
}
}
eventRespond
Description
Respond to an event Invitation (RSVP)
Response
Returns an EventRespondPayload
Arguments
Name | Description |
---|---|
input - EventRespondInput!
|
Required Parameter for the eventRespond Mutation |
Example
Query
mutation eventRespond($input: EventRespondInput!) {
eventRespond(input: $input) {
clientMutationId
story {
...StoryFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
}
}
}
Variables
{"input": EventRespondInput}
Response
{
"data": {
"eventRespond": {
"clientMutationId": "abc123",
"story": Story,
"errors": [PermissionError]
}
}
}
facetCreate
Description
Create a facet (or category of tags)
Response
Returns a FacetCreatePayload
Arguments
Name | Description |
---|---|
input - FacetCreateInput!
|
Required Parameter for the facetCreate Mutation |
Example
Query
mutation facetCreate($input: FacetCreateInput!) {
facetCreate(input: $input) {
clientMutationId
facet {
...FacetFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
}
}
}
Variables
{"input": FacetCreateInput}
Response
{
"data": {
"facetCreate": {
"clientMutationId": "abc123",
"facet": Facet,
"errors": [PermissionError]
}
}
}
folderAddTag
Description
Add a tag on all the items in a Folder
Response
Returns a FolderAddTagPayload
Arguments
Name | Description |
---|---|
input - FolderAddTagInput!
|
Required Parameter for the folderAddTag Mutation |
Example
Query
mutation folderAddTag($input: FolderAddTagInput!) {
folderAddTag(input: $input) {
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": FolderAddTagInput}
Response
{
"data": {
"folderAddTag": {
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError]
}
}
}
folderDelete
Description
Delete a given Folder
Response
Returns a FolderDeletePayload
Arguments
Name | Description |
---|---|
input - FolderDeleteInput!
|
Required Parameter for the folderDelete Mutation |
Example
Query
mutation folderDelete($input: FolderDeleteInput!) {
folderDelete(input: $input) {
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
... on RootFolderRemoveError {
...RootFolderRemoveErrorFragment
}
}
}
}
Variables
{"input": FolderDeleteInput}
Response
{
"data": {
"folderDelete": {
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError]
}
}
}
folderMove
Description
Move the contents of a folder to another space or attribute the contents to another owner
Response
Returns a FolderMovePayload
Arguments
Name | Description |
---|---|
input - FolderMoveInput!
|
Required Parameter for the folderMove Mutation |
Example
Query
mutation folderMove($input: FolderMoveInput!) {
folderMove(input: $input) {
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
... on RootFolderRemoveError {
...RootFolderRemoveErrorFragment
}
}
}
}
Variables
{"input": FolderMoveInput}
Response
{
"data": {
"folderMove": {
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError]
}
}
}
hashtagCreate
Description
Create a Hashtag
(~ tag not linked to a category)
Response
Returns a HashtagCreatePayload
Arguments
Name | Description |
---|---|
input - HashtagCreateInput!
|
Required Parameter for the hashtagCreate Mutation |
Example
Query
mutation hashtagCreate($input: HashtagCreateInput!) {
hashtagCreate(input: $input) {
clientMutationId
hashtag {
...HashtagFragment
}
me {
...MeFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": HashtagCreateInput}
Response
{
"data": {
"hashtagCreate": {
"clientMutationId": "abc123",
"hashtag": Hashtag,
"me": Me,
"errors": [PermissionError]
}
}
}
instanceActivate
Description
Activates an instance after the provisioning is done.
You'll need to get a Token from the provisioning service to be able to activate the instance
Response
Returns an InstanceActivatePayload
Arguments
Name | Description |
---|---|
input - InstanceActivateInput!
|
Required Parameter for the instanceActivate Mutation |
Example
Query
mutation instanceActivate($input: InstanceActivateInput!) {
instanceActivate(input: $input) {
clientMutationId
errors {
... on InvalidInputError {
...InvalidInputErrorFragment
}
... on InvalidPlanError {
...InvalidPlanErrorFragment
}
... on InvalidPasswordError {
...InvalidPasswordErrorFragment
}
}
instance {
...InstanceFragment
}
user {
...UserFragment
}
}
}
Variables
{"input": InstanceActivateInput}
Response
{
"data": {
"instanceActivate": {
"clientMutationId": "abc123",
"errors": [InvalidInputError],
"instance": Instance,
"user": User
}
}
}
instanceCancelSubscription
Description
Cancels the subscription for an instance of the application. This mutation requires an InstanceCancelSubscriptionInput
object that specifies the details needed to cancel the subscription.
Response
Returns an InstanceCancelSubscriptionPayload
Arguments
Name | Description |
---|---|
input - InstanceCancelSubscriptionInput!
|
Required Input for the instanceCancelSubscription Mutation |
Example
Query
mutation instanceCancelSubscription($input: InstanceCancelSubscriptionInput!) {
instanceCancelSubscription(input: $input) {
clientMutationId
instance {
...InstanceFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": InstanceCancelSubscriptionInput}
Response
{
"data": {
"instanceCancelSubscription": {
"clientMutationId": "xyz789",
"instance": Instance,
"errors": [PermissionError]
}
}
}
instanceCompleteOnboadingStep
Description
Mark a step as completed (or skipped)
Response
Returns an InstanceCompleteOnboadingStepPayload
Arguments
Name | Description |
---|---|
input - InstanceCompleteOnboadingStepInput!
|
Required Input for the instanceCompleteOnboadingStep Mutation |
Example
Query
mutation instanceCompleteOnboadingStep($input: InstanceCompleteOnboadingStepInput!) {
instanceCompleteOnboadingStep(input: $input) {
clientMutationId
instance {
...InstanceFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
}
}
}
Variables
{"input": InstanceCompleteOnboadingStepInput}
Response
{
"data": {
"instanceCompleteOnboadingStep": {
"clientMutationId": "xyz789",
"instance": Instance,
"errors": [PermissionError]
}
}
}
instanceContactsUpdate
Description
Set A contact for the instance
Response
Returns an InstanceContactsUpdatePayload
Arguments
Name | Description |
---|---|
input - InstanceContactsUpdateInput!
|
Required Input for the instanceContactsUpdate Mutation |
Example
Query
mutation instanceContactsUpdate($input: InstanceContactsUpdateInput!) {
instanceContactsUpdate(input: $input) {
clientMutationId
contacts {
...InstanceContactsFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": InstanceContactsUpdateInput}
Response
{
"data": {
"instanceContactsUpdate": {
"clientMutationId": "abc123",
"contacts": InstanceContacts,
"errors": [PermissionError]
}
}
}
instanceDelete
Description
Delete the whole instance and every data with it
Response
Returns an InstanceDeletePayload
Arguments
Name | Description |
---|---|
input - InstanceDeleteInput!
|
Required Parameter for the instanceDelete Mutation |
Example
Query
mutation instanceDelete($input: InstanceDeleteInput!) {
instanceDelete(input: $input) {
clientMutationId
errors {
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": InstanceDeleteInput}
Response
{
"data": {
"instanceDelete": {
"clientMutationId": "abc123",
"errors": [PermissionError]
}
}
}
instanceDisclaimerSetup
Description
Setup instance disclaimer options
Response
Returns an InstanceDisclaimerSetupPayload
Arguments
Name | Description |
---|---|
input - InstanceDisclaimerSetupInput!
|
Required Input for the instanceDisclaimerSetup Mutation |
Example
Query
mutation instanceDisclaimerSetup($input: InstanceDisclaimerSetupInput!) {
instanceDisclaimerSetup(input: $input) {
clientMutationId
instance {
...InstanceFragment
}
instanceAuth {
...InstanceAuthenticationFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": InstanceDisclaimerSetupInput}
Response
{
"data": {
"instanceDisclaimerSetup": {
"clientMutationId": "xyz789",
"instance": Instance,
"instanceAuth": InstanceAuthentication,
"errors": [PermissionError]
}
}
}
instanceExport
Description
Launch an export of the instance internal use
Response
Returns an InstanceExportPayload
Arguments
Name | Description |
---|---|
input - InstanceExportInput!
|
Required Parameter for the instanceExport Mutation |
Example
Query
mutation instanceExport($input: InstanceExportInput!) {
instanceExport(input: $input) {
clientMutationId
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
}
instance {
...InstanceFragment
}
}
}
Variables
{"input": InstanceExportInput}
Response
{
"data": {
"instanceExport": {
"clientMutationId": "xyz789",
"errors": [PermissionError],
"instance": Instance
}
}
}
instanceFinishProvisionning
Description
Reset the steps done/skipped from the onboarding used mostly to reset the onboarding after the provisioning that completed severall steps
Response
Returns an InstanceFinishProvisionningPayload
Arguments
Name | Description |
---|---|
input - InstanceFinishProvisionningInput!
|
Required Input for the instanceFinishProvisionning Mutation |
Example
Query
mutation instanceFinishProvisionning($input: InstanceFinishProvisionningInput!) {
instanceFinishProvisionning(input: $input) {
clientMutationId
instance {
...InstanceFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": InstanceFinishProvisionningInput}
Response
{
"data": {
"instanceFinishProvisionning": {
"clientMutationId": "abc123",
"instance": Instance,
"errors": [PermissionError]
}
}
}
instanceGoogleAnalyticsUpdate
Description
Setup Google Analytics Integration's configuration
Response
Returns an InstanceGoogleAnalyticsUpdatePayload
Arguments
Name | Description |
---|---|
input - InstanceGoogleAnalyticsUpdateInput!
|
Required Input for the instanceGoogleAnalyticsUpdate Mutation |
Example
Query
mutation instanceGoogleAnalyticsUpdate($input: InstanceGoogleAnalyticsUpdateInput!) {
instanceGoogleAnalyticsUpdate(input: $input) {
clientMutationId
instance {
...InstanceFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": InstanceGoogleAnalyticsUpdateInput}
Response
{
"data": {
"instanceGoogleAnalyticsUpdate": {
"clientMutationId": "abc123",
"instance": Instance,
"errors": [PermissionError]
}
}
}
instanceGoogleDriveUpdate
Description
Setup Google Drive Integration's configuration
Response
Returns an InstanceGoogleDriveUpdatePayload
Arguments
Name | Description |
---|---|
input - InstanceGoogleDriveUpdateInput!
|
Required Input for the instanceGoogleDriveUpdate Mutation |
Example
Query
mutation instanceGoogleDriveUpdate($input: InstanceGoogleDriveUpdateInput!) {
instanceGoogleDriveUpdate(input: $input) {
clientMutationId
errors {
... on PermissionError {
...PermissionErrorFragment
}
}
instance {
...InstanceFragment
}
}
}
Variables
{"input": InstanceGoogleDriveUpdateInput}
Response
{
"data": {
"instanceGoogleDriveUpdate": {
"clientMutationId": "abc123",
"errors": [PermissionError],
"instance": Instance
}
}
}
instanceInvoiceUpdate
Description
Updates the invoice's reference with the newly given reference. Passing a None value will erase its value.
Response
Returns an InstanceInvoiceUpdatePayload
Arguments
Name | Description |
---|---|
input - InstanceInvoiceUpdateInput!
|
Required Input for the instanceInvoiceUpdate Mutation |
Example
Query
mutation instanceInvoiceUpdate($input: InstanceInvoiceUpdateInput!) {
instanceInvoiceUpdate(input: $input) {
clientMutationId
invoice {
...InstanceInvoiceFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": InstanceInvoiceUpdateInput}
Response
{
"data": {
"instanceInvoiceUpdate": {
"clientMutationId": "abc123",
"invoice": InstanceInvoice,
"errors": [PermissionError]
}
}
}
instanceLabFlagUpdate
Description
Toggles a Lab flag by name, after verifying that the flag is indeed admin-flippable
Response
Returns an InstanceLabFlagUpdatePayload
Arguments
Name | Description |
---|---|
input - InstanceLabFlagUpdateInput!
|
Required Input for the instanceLabFlagUpdate Mutation |
Example
Query
mutation instanceLabFlagUpdate($input: InstanceLabFlagUpdateInput!) {
instanceLabFlagUpdate(input: $input) {
clientMutationId
instance {
...InstanceFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
}
}
}
Variables
{"input": InstanceLabFlagUpdateInput}
Response
{
"data": {
"instanceLabFlagUpdate": {
"clientMutationId": "abc123",
"instance": Instance,
"errors": [PermissionError]
}
}
}
instanceMicrosoftTeamsUpdate
Description
Sets the value of the Microsoft Teams feature flag Setting this to False will disable all outbound Teams API calls
Response
Returns an InstanceMicrosoftTeamsUpdatePayload
Arguments
Name | Description |
---|---|
input - InstanceMicrosoftTeamsUpdateInput!
|
Required Input for the instanceMicrosoftTeamsUpdate Mutation |
Example
Query
mutation instanceMicrosoftTeamsUpdate($input: InstanceMicrosoftTeamsUpdateInput!) {
instanceMicrosoftTeamsUpdate(input: $input) {
clientMutationId
errors {
... on PermissionError {
...PermissionErrorFragment
}
}
instance {
...InstanceFragment
}
}
}
Variables
{"input": InstanceMicrosoftTeamsUpdateInput}
Response
{
"data": {
"instanceMicrosoftTeamsUpdate": {
"clientMutationId": "abc123",
"errors": [PermissionError],
"instance": Instance
}
}
}
instanceMobileAppDescriptionsUpdate
Description
Update the mobile app descriptions
Response
Returns an InstanceMobileAppDescriptionsUpdatePayload
Arguments
Name | Description |
---|---|
input - InstanceMobileAppDescriptionsUpdateInput!
|
Required Input for the instanceMobileAppDescriptionsUpdate Mutation |
Example
Query
mutation instanceMobileAppDescriptionsUpdate($input: InstanceMobileAppDescriptionsUpdateInput!) {
instanceMobileAppDescriptionsUpdate(input: $input) {
clientMutationId
instance {
...InstanceFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
}
}
}
Variables
{"input": InstanceMobileAppDescriptionsUpdateInput}
Response
{
"data": {
"instanceMobileAppDescriptionsUpdate": {
"clientMutationId": "abc123",
"instance": Instance,
"errors": [PermissionError]
}
}
}
instanceOfficeOnlineUpdate
Description
Enable Office 365 online Integration for end users You can then preview office files as well as edit them directly from the browser
Response
Returns an InstanceOfficeOnlineUpdatePayload
Arguments
Name | Description |
---|---|
input - InstanceOfficeOnlineUpdateInput!
|
Required Input for the instanceOfficeOnlineUpdate Mutation |
Example
Query
mutation instanceOfficeOnlineUpdate($input: InstanceOfficeOnlineUpdateInput!) {
instanceOfficeOnlineUpdate(input: $input) {
clientMutationId
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on LimitsViolationError {
...LimitsViolationErrorFragment
}
}
instance {
...InstanceFragment
}
}
}
Variables
{"input": InstanceOfficeOnlineUpdateInput}
Response
{
"data": {
"instanceOfficeOnlineUpdate": {
"clientMutationId": "xyz789",
"errors": [PermissionError],
"instance": Instance
}
}
}
instanceOneDriveUpdate
Description
Enable Onedrive Integration for end users You can then add Onedrive blocks in stories as well as importing files from admin
Response
Returns an InstanceOneDriveUpdatePayload
Arguments
Name | Description |
---|---|
input - InstanceOneDriveUpdateInput!
|
Required Input for the instanceOneDriveUpdate Mutation |
Example
Query
mutation instanceOneDriveUpdate($input: InstanceOneDriveUpdateInput!) {
instanceOneDriveUpdate(input: $input) {
clientMutationId
errors {
... on PermissionError {
...PermissionErrorFragment
}
}
instance {
...InstanceFragment
}
}
}
Variables
{"input": InstanceOneDriveUpdateInput}
Response
{
"data": {
"instanceOneDriveUpdate": {
"clientMutationId": "abc123",
"errors": [PermissionError],
"instance": Instance
}
}
}
instanceScimConfigUpdate
Description
Change instance SCIM configuration
Response
Returns an InstanceScimConfigUpdatePayload
Arguments
Name | Description |
---|---|
input - InstanceScimConfigUpdateInput!
|
Required Input for the instanceScimConfigUpdate Mutation |
Example
Query
mutation instanceScimConfigUpdate($input: InstanceScimConfigUpdateInput!) {
instanceScimConfigUpdate(input: $input) {
clientMutationId
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on LimitsViolationError {
...LimitsViolationErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
}
instance {
...InstanceFragment
}
}
}
Variables
{"input": InstanceScimConfigUpdateInput}
Response
{
"data": {
"instanceScimConfigUpdate": {
"clientMutationId": "xyz789",
"errors": [PermissionError],
"instance": Instance
}
}
}
instanceSettingsUpdate
Description
Change instance Settings, security, ... Requires me.actions.admin
Response
Returns an InstanceSettingsUpdatePayload!
Arguments
Name | Description |
---|---|
input - InstanceSettingsUpdateInput!
|
Required Input for the instanceSettingsUpdate Mutation |
Example
Query
mutation instanceSettingsUpdate($input: InstanceSettingsUpdateInput!) {
instanceSettingsUpdate(input: $input) {
clientMutationId
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on LimitsViolationError {
...LimitsViolationErrorFragment
}
}
instance {
...InstanceFragment
}
}
}
Variables
{"input": InstanceSettingsUpdateInput}
Response
{
"data": {
"instanceSettingsUpdate": {
"clientMutationId": "abc123",
"errors": [PermissionError],
"instance": Instance
}
}
}
instanceSlackUpdate
Description
Sets the value of the Slack feature flag Setting this to False will disable all outbound Slack API calls
Response
Returns an InstanceSlackUpdatePayload
Arguments
Name | Description |
---|---|
input - InstanceSlackUpdateInput!
|
Required Input for the instanceSlackUpdate Mutation |
Example
Query
mutation instanceSlackUpdate($input: InstanceSlackUpdateInput!) {
instanceSlackUpdate(input: $input) {
clientMutationId
errors {
... on PermissionError {
...PermissionErrorFragment
}
}
instance {
...InstanceFragment
}
}
}
Variables
{"input": InstanceSlackUpdateInput}
Response
{
"data": {
"instanceSlackUpdate": {
"clientMutationId": "abc123",
"errors": [PermissionError],
"instance": Instance
}
}
}
instanceSsoConfigUpdate
Description
Change instance SSO configuration
Response
Returns an InstanceSsoConfigUpdatePayload
Arguments
Name | Description |
---|---|
input - InstanceSsoConfigUpdateInput!
|
Required Input for the instanceSsoConfigUpdate Mutation |
Example
Query
mutation instanceSsoConfigUpdate($input: InstanceSsoConfigUpdateInput!) {
instanceSsoConfigUpdate(input: $input) {
clientMutationId
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on LimitsViolationError {
...LimitsViolationErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
... on InvalidFormatError {
...InvalidFormatErrorFragment
}
}
instance {
...InstanceFragment
}
}
}
Variables
{"input": InstanceSsoConfigUpdateInput}
Response
{
"data": {
"instanceSsoConfigUpdate": {
"clientMutationId": "xyz789",
"errors": [PermissionError],
"instance": Instance
}
}
}
instanceThemeUpdate
Description
Updates the theme settings for an instance of the application. Some of the settings need to have the white-labeling option in the plan
Response
Returns an InstanceThemeUpdatePayload
Arguments
Name | Description |
---|---|
input - InstanceThemeUpdateInput!
|
Required Input for the instanceThemeUpdate Mutation |
Example
Query
mutation instanceThemeUpdate($input: InstanceThemeUpdateInput!) {
instanceThemeUpdate(input: $input) {
clientMutationId
errors {
... on PermissionError {
...PermissionErrorFragment
}
}
instance {
...InstanceFragment
}
}
}
Variables
{"input": InstanceThemeUpdateInput}
Response
{
"data": {
"instanceThemeUpdate": {
"clientMutationId": "xyz789",
"errors": [PermissionError],
"instance": Instance
}
}
}
instanceUpdateSubscription
Description
Updates the subscription (billing) of the instance. You can change plan, seats but you will need a payment intent from Chargebee.
requires me.actions.billing
Response
Returns an InstanceUpdateSubscriptionPayload
Arguments
Name | Description |
---|---|
input - InstanceUpdateSubscriptionInput!
|
Required Input for the instanceUpdateSubscription Mutation |
Example
Query
mutation instanceUpdateSubscription($input: InstanceUpdateSubscriptionInput!) {
instanceUpdateSubscription(input: $input) {
clientMutationId
instance {
...InstanceFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on InvalidPlanError {
...InvalidPlanErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
... on InvalidPlanLimitsError {
...InvalidPlanLimitsErrorFragment
}
... on SubscriptionUpdateError {
...SubscriptionUpdateErrorFragment
}
}
}
}
Variables
{"input": InstanceUpdateSubscriptionInput}
Response
{
"data": {
"instanceUpdateSubscription": {
"clientMutationId": "abc123",
"instance": Instance,
"errors": [PermissionError]
}
}
}
instanceWorkplaceUpdate
Description
Updates the workplace settings for an instance of the application. This mutation requires an InstanceWorkplaceUpdateInput
object that specifies the new workplace settings to be applied.
Response
Returns an InstanceWorkplaceUpdatePayload
Arguments
Name | Description |
---|---|
input - InstanceWorkplaceUpdateInput!
|
Required Input for the instanceWorkplaceUpdate Mutation |
Example
Query
mutation instanceWorkplaceUpdate($input: InstanceWorkplaceUpdateInput!) {
instanceWorkplaceUpdate(input: $input) {
clientMutationId
errors {
... on PermissionError {
...PermissionErrorFragment
}
}
instance {
...InstanceFragment
}
}
}
Variables
{"input": InstanceWorkplaceUpdateInput}
Response
{
"data": {
"instanceWorkplaceUpdate": {
"clientMutationId": "xyz789",
"errors": [PermissionError],
"instance": Instance
}
}
}
meActivateTwoFactor
Description
Verify QrCode and if correct, persist and activate the 2FA for this user. verificationCode Should be a 6 number string it will be verified again the latest qrcode seen (see MePreferences.twoFactorCodeUrl
)
Response
Returns a MeActivateTwoFactorPayload
Arguments
Name | Description |
---|---|
input - MeActivateTwoFactorInput!
|
Required Input for the meActivateTwoFactor Mutation |
Example
Query
mutation meActivateTwoFactor($input: MeActivateTwoFactorInput!) {
meActivateTwoFactor(input: $input) {
clientMutationId
errors {
... on InvalidPasswordError {
...InvalidPasswordErrorFragment
}
}
me {
...MeFragment
}
}
}
Variables
{"input": MeActivateTwoFactorInput}
Response
{
"data": {
"meActivateTwoFactor": {
"clientMutationId": "xyz789",
"errors": [InvalidPasswordError],
"me": Me
}
}
}
meBookmarksClear
Description
Clear all the bookmarks of the current user
Response
Returns a MeBookmarksClearPayload
Arguments
Name | Description |
---|---|
input - MeBookmarksClearInput!
|
Required Parameter for the meBookmarksClear Mutation |
Example
Query
mutation meBookmarksClear($input: MeBookmarksClearInput!) {
meBookmarksClear(input: $input) {
clientMutationId
me {
...MeFragment
}
}
}
Variables
{"input": MeBookmarksClearInput}
Response
{
"data": {
"meBookmarksClear": {
"clientMutationId": "xyz789",
"me": Me
}
}
}
meDeviceTokenPublish
Description
Will send a PUSH notification to the registered device. This is used only for debugging purposes
Response
Returns a MeDeviceTokenPublishPayload
Arguments
Name | Description |
---|---|
input - MeDeviceTokenPublishInput!
|
Required Input for the meDeviceTokenPublish Mutation |
Example
Query
mutation meDeviceTokenPublish($input: MeDeviceTokenPublishInput!) {
meDeviceTokenPublish(input: $input) {
clientMutationId
deviceToken {
...MeDeviceTokenFragment
}
sent
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
}
}
}
Variables
{"input": MeDeviceTokenPublishInput}
Response
{
"data": {
"meDeviceTokenPublish": {
"clientMutationId": "xyz789",
"deviceToken": MeDeviceToken,
"sent": true,
"errors": [ObjectNotFoundError]
}
}
}
meDeviceTokenRegister
Description
Register a Mobile device for the current user. This will allow to send PUSH notifications to the device for example.
Response
Returns a MeDeviceTokenRegisterPayload
Arguments
Name | Description |
---|---|
input - MeDeviceTokenRegisterInput!
|
Required Input for the meDeviceTokenRegister Mutation |
Example
Query
mutation meDeviceTokenRegister($input: MeDeviceTokenRegisterInput!) {
meDeviceTokenRegister(input: $input) {
clientMutationId
deviceToken {
...MeDeviceTokenFragment
}
}
}
Variables
{"input": MeDeviceTokenRegisterInput}
Response
{
"data": {
"meDeviceTokenRegister": {
"clientMutationId": "xyz789",
"deviceToken": MeDeviceToken
}
}
}
meDeviceTokenUnregister
Description
Remove / de-associate a device from the current user. This will stop push notification to this device
Response
Returns a MeDeviceTokenUnregisterPayload
Arguments
Name | Description |
---|---|
input - MeDeviceTokenUnregisterInput!
|
Required Input for the meDeviceTokenUnregister Mutation |
Example
Query
mutation meDeviceTokenUnregister($input: MeDeviceTokenUnregisterInput!) {
meDeviceTokenUnregister(input: $input) {
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
}
me {
...MeFragment
}
}
}
Variables
{"input": MeDeviceTokenUnregisterInput}
Response
{
"data": {
"meDeviceTokenUnregister": {
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError],
"me": Me
}
}
}
meDisclaimerAccept
Description
Mark the "disclaimer" of the current user as accepted
Response
Returns a MeDisclaimerAcceptPayload
Arguments
Name | Description |
---|---|
input - MeDisclaimerAcceptInput!
|
Required Parameter for the meDisclaimerAccept Mutation |
Example
Query
mutation meDisclaimerAccept($input: MeDisclaimerAcceptInput!) {
meDisclaimerAccept(input: $input) {
clientMutationId
me {
...MeFragment
}
}
}
Variables
{"input": MeDisclaimerAcceptInput}
Response
{
"data": {
"meDisclaimerAccept": {
"clientMutationId": "abc123",
"me": Me
}
}
}
meNotificationsPreferences
Description
Update notification preferences for the current user
Response
Returns a MeNotificationsPreferencesPayload
Arguments
Name | Description |
---|---|
input - MeNotificationsPreferencesInput!
|
Required Input for the meNotificationsPreferences Mutation |
Example
Query
mutation meNotificationsPreferences($input: MeNotificationsPreferencesInput!) {
meNotificationsPreferences(input: $input) {
clientMutationId
me {
...MeFragment
}
}
}
Variables
{"input": MeNotificationsPreferencesInput}
Response
{
"data": {
"meNotificationsPreferences": {
"clientMutationId": "abc123",
"me": Me
}
}
}
mePasswordChange
Description
Change the password of the current user
Response
Returns a MePasswordChangePayload
Arguments
Name | Description |
---|---|
input - MePasswordChangeInput!
|
Required Parameter for the mePasswordChange Mutation |
Example
Query
mutation mePasswordChange($input: MePasswordChangeInput!) {
mePasswordChange(input: $input) {
clientMutationId
me {
...MeFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on InvalidPasswordError {
...InvalidPasswordErrorFragment
}
}
}
}
Variables
{"input": MePasswordChangeInput}
Response
{
"data": {
"mePasswordChange": {
"clientMutationId": "abc123",
"me": Me,
"errors": [PermissionError]
}
}
}
mePreferencesUpdate
Description
Update the user's application preferences (emails, language, ...)
Response
Returns a MePreferencesUpdatePayload
Arguments
Name | Description |
---|---|
input - MePreferencesUpdateInput!
|
Required Input for the mePreferencesUpdate Mutation |
Example
Query
mutation mePreferencesUpdate($input: MePreferencesUpdateInput!) {
mePreferencesUpdate(input: $input) {
clientMutationId
me {
...MeFragment
}
errors {
... on EmailAlreadyExistsError {
...EmailAlreadyExistsErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
}
}
}
Variables
{"input": MePreferencesUpdateInput}
Response
{
"data": {
"mePreferencesUpdate": {
"clientMutationId": "xyz789",
"me": Me,
"errors": [EmailAlreadyExistsError]
}
}
}
mePresenceUpdate
Description
Update user's presence status on a given device
Response
Returns a MePresenceUpdatePayload
Arguments
Name | Description |
---|---|
input - MePresenceUpdateInput!
|
Required Parameter for the mePresenceUpdate Mutation |
Example
Query
mutation mePresenceUpdate($input: MePresenceUpdateInput!) {
mePresenceUpdate(input: $input) {
clientMutationId
me {
...MeFragment
}
}
}
Variables
{"input": MePresenceUpdateInput}
Response
{
"data": {
"mePresenceUpdate": {
"clientMutationId": "xyz789",
"me": Me
}
}
}
meProfileSetupComplete
Description
Mark the profile setup as complete for the current user Thus the user can be considered as "onboarded" and fully setup
Response
Returns a MeProfileSetupCompletePayload
Arguments
Name | Description |
---|---|
input - MeProfileSetupCompleteInput!
|
Required Input for the meProfileSetupComplete Mutation |
Example
Query
mutation meProfileSetupComplete($input: MeProfileSetupCompleteInput!) {
meProfileSetupComplete(input: $input) {
clientMutationId
me {
...MeFragment
}
}
}
Variables
{"input": MeProfileSetupCompleteInput}
Response
{
"data": {
"meProfileSetupComplete": {
"clientMutationId": "abc123",
"me": Me
}
}
}
meRemoveTwoFactor
Description
Remove a two factor token for the current user. You'll need to pass current 2fa verificationCode, and current Password to make it work. Note: you can't remove the 2fa if it's mandatory on the platform, but you can meActivateTwoFactor again
Response
Returns a MeRemoveTwoFactorPayload
Arguments
Name | Description |
---|---|
input - MeRemoveTwoFactorInput!
|
Required Parameter for the meRemoveTwoFactor Mutation |
Example
Query
mutation meRemoveTwoFactor($input: MeRemoveTwoFactorInput!) {
meRemoveTwoFactor(input: $input) {
clientMutationId
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on InvalidPasswordError {
...InvalidPasswordErrorFragment
}
}
me {
...MeFragment
}
}
}
Variables
{"input": MeRemoveTwoFactorInput}
Response
{
"data": {
"meRemoveTwoFactor": {
"clientMutationId": "abc123",
"errors": [PermissionError],
"me": Me
}
}
}
meServiceReset
Description
Reset the token of a given service
Response
Returns a MeServiceResetPayload
Arguments
Name | Description |
---|---|
input - MeServiceResetInput!
|
Required Parameter for the meServiceReset Mutation |
Example
Query
mutation meServiceReset($input: MeServiceResetInput!) {
meServiceReset(input: $input) {
clientMutationId
me {
...MeFragment
}
}
}
Variables
{"input": MeServiceResetInput}
Response
{
"data": {
"meServiceReset": {
"clientMutationId": "abc123",
"me": Me
}
}
}
meServiceToken
Description
Obtain an Access token or refresh one for a given integration
Response
Returns a MeServiceTokenPayload
Arguments
Name | Description |
---|---|
input - MeServiceTokenInput!
|
Required Parameter for the meServiceToken Mutation |
Example
Query
mutation meServiceToken($input: MeServiceTokenInput!) {
meServiceToken(input: $input) {
accessToken
clientMutationId
expiresIn
errors {
... on InvalidInputError {
...InvalidInputErrorFragment
}
}
}
}
Variables
{"input": MeServiceTokenInput}
Response
{
"data": {
"meServiceToken": {
"accessToken": "abc123",
"clientMutationId": "abc123",
"expiresIn": 123,
"errors": [InvalidInputError]
}
}
}
meTokenReset
Description
Reset or Remove a token for a given service
Response
Returns a MeTokenResetPayload
Arguments
Name | Description |
---|---|
input - MeTokenResetInput!
|
Required Parameter for the meTokenReset Mutation |
Example
Query
mutation meTokenReset($input: MeTokenResetInput!) {
meTokenReset(input: $input) {
clientMutationId
me {
...MeFragment
}
}
}
Variables
{"input": MeTokenResetInput}
Response
{
"data": {
"meTokenReset": {
"clientMutationId": "abc123",
"me": Me
}
}
}
microsoftTeamsActivitiesConfigUpdate
Description
Updates the activities for which a message should be pushed to teams
Response
Arguments
Name | Description |
---|---|
input - MicrosoftTeamsActivitiesConfigUpdateInput!
|
Required Input for the microsoftTeamsActivitiesConfigUpdate Mutation |
Example
Query
mutation microsoftTeamsActivitiesConfigUpdate($input: MicrosoftTeamsActivitiesConfigUpdateInput!) {
microsoftTeamsActivitiesConfigUpdate(input: $input) {
clientMutationId
instance {
...InstanceFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
... on UnconfiguredServiceError {
...UnconfiguredServiceErrorFragment
}
}
}
}
Variables
{"input": MicrosoftTeamsActivitiesConfigUpdateInput}
Response
{
"data": {
"microsoftTeamsActivitiesConfigUpdate": {
"clientMutationId": "xyz789",
"instance": Instance,
"errors": [ObjectNotFoundError]
}
}
}
microsoftTeamsSpacesToChannelRemove
Description
Removes the "Elium space to Microsoft Teams channel mapping" (SpacesToChannelItem) if it exists
Response
Arguments
Name | Description |
---|---|
input - MicrosoftTeamsSpacesToChannelRemoveInput!
|
Required Input for the microsoftTeamsSpacesToChannelRemove Mutation |
Example
Query
mutation microsoftTeamsSpacesToChannelRemove($input: MicrosoftTeamsSpacesToChannelRemoveInput!) {
microsoftTeamsSpacesToChannelRemove(input: $input) {
clientMutationId
instance {
...InstanceFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": MicrosoftTeamsSpacesToChannelRemoveInput}
Response
{
"data": {
"microsoftTeamsSpacesToChannelRemove": {
"clientMutationId": "xyz789",
"instance": Instance,
"errors": [ObjectNotFoundError]
}
}
}
microsoftTeamsSpacesToChannelUpdate
Description
Add a Mapping between a space and a Microsoft Teams channel
Activities in the space will trigger a notification in the team channel depndening on the configuration. See teamActivitiesConfigUpdate
Response
Arguments
Name | Description |
---|---|
input - MicrosoftTeamsSpacesToChannelUpdateInput!
|
Required Input for the microsoftTeamsSpacesToChannelUpdate Mutation |
Example
Query
mutation microsoftTeamsSpacesToChannelUpdate($input: MicrosoftTeamsSpacesToChannelUpdateInput!) {
microsoftTeamsSpacesToChannelUpdate(input: $input) {
clientMutationId
instance {
...InstanceFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
... on UnconfiguredServiceError {
...UnconfiguredServiceErrorFragment
}
}
}
}
Variables
{"input": MicrosoftTeamsSpacesToChannelUpdateInput}
Response
{
"data": {
"microsoftTeamsSpacesToChannelUpdate": {
"clientMutationId": "xyz789",
"instance": Instance,
"errors": [ObjectNotFoundError]
}
}
}
microsoftTeamsTabEmbed
Description
Embed an Elium tab as a Teams Website tab (that will only work in the Teams desktop app, not the web app)
Response
Returns a MicrosoftTeamsTabEmbedPayload
Arguments
Name | Description |
---|---|
input - MicrosoftTeamsTabEmbedInput!
|
Required Input for the microsoftTeamsTabEmbed Mutation |
Example
Query
mutation microsoftTeamsTabEmbed($input: MicrosoftTeamsTabEmbedInput!) {
microsoftTeamsTabEmbed(input: $input) {
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
... on IntegrationError {
...IntegrationErrorFragment
}
... on UnconfiguredServiceError {
...UnconfiguredServiceErrorFragment
}
}
instance {
...InstanceFragment
}
}
}
Variables
{"input": MicrosoftTeamsTabEmbedInput}
Response
{
"data": {
"microsoftTeamsTabEmbed": {
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError],
"instance": Instance
}
}
}
notificationPin
Description
Pin/Unpin a notification Pining a notification will make it appear in the "pinned" list of notifications
Response
Returns a NotificationPinPayload
Arguments
Name | Description |
---|---|
input - NotificationPinInput!
|
Required Parameter for the notificationPin Mutation |
Example
Query
mutation notificationPin($input: NotificationPinInput!) {
notificationPin(input: $input) {
clientMutationId
me {
...MeFragment
}
notification {
...NotificationFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
}
}
}
Variables
{"input": NotificationPinInput}
Response
{
"data": {
"notificationPin": {
"clientMutationId": "xyz789",
"me": Me,
"notification": Notification,
"errors": [ObjectNotFoundError]
}
}
}
notificationsRead
Description
Mark a list of notifications as read
Response
Returns a NotificationsReadPayload
Arguments
Name | Description |
---|---|
input - NotificationsReadInput!
|
Required Parameter for the notificationsRead Mutation |
Example
Query
mutation notificationsRead($input: NotificationsReadInput!) {
notificationsRead(input: $input) {
clientMutationId
me {
...MeFragment
}
notifications {
...NotificationFragment
}
}
}
Variables
{"input": NotificationsReadInput}
Response
{
"data": {
"notificationsRead": {
"clientMutationId": "xyz789",
"me": Me,
"notifications": [Notification]
}
}
}
notificationsReadAll
Description
Mark ALL notifications as read
Response
Returns a NotificationsReadAllPayload
Arguments
Name | Description |
---|---|
input - NotificationsReadAllInput!
|
Required Input for the notificationsReadAll Mutation |
Example
Query
mutation notificationsReadAll($input: NotificationsReadAllInput!) {
notificationsReadAll(input: $input) {
clientMutationId
me {
...MeFragment
}
}
}
Variables
{"input": NotificationsReadAllInput}
Response
{
"data": {
"notificationsReadAll": {
"clientMutationId": "abc123",
"me": Me
}
}
}
notificationsSeenAll
Description
Mark All notifications as seen (seen notifications are not displayed in the "new" section of the notifications list)
Response
Returns a NotificationsSeenAllPayload
Arguments
Name | Description |
---|---|
input - NotificationsSeenAllInput!
|
Required Input for the notificationsSeenAll Mutation |
Example
Query
mutation notificationsSeenAll($input: NotificationsSeenAllInput!) {
notificationsSeenAll(input: $input) {
clientMutationId
me {
...MeFragment
}
}
}
Variables
{"input": NotificationsSeenAllInput}
Response
{
"data": {
"notificationsSeenAll": {
"clientMutationId": "xyz789",
"me": Me
}
}
}
notificationsUnread
Description
Mark a notification as unread Probably used for debugging purposes
Response
Returns a NotificationsUnreadPayload
Arguments
Name | Description |
---|---|
input - NotificationsUnreadInput!
|
Required Input for the notificationsUnread Mutation |
Example
Query
mutation notificationsUnread($input: NotificationsUnreadInput!) {
notificationsUnread(input: $input) {
clientMutationId
me {
...MeFragment
}
notifications {
...NotificationFragment
}
}
}
Variables
{"input": NotificationsUnreadInput}
Response
{
"data": {
"notificationsUnread": {
"clientMutationId": "abc123",
"me": Me,
"notifications": [Notification]
}
}
}
organizationCreate
Description
Create a new organization with default settings
Response
Returns an OrganizationCreatePayload
Arguments
Name | Description |
---|---|
input - OrganizationCreateInput!
|
Required Parameter for the organizationCreate Mutation |
Example
Query
mutation organizationCreate($input: OrganizationCreateInput!) {
organizationCreate(input: $input) {
clientMutationId
organization {
...OrganizationFragment
}
errors {
... on InvalidFormatError {
...InvalidFormatErrorFragment
}
... on ObjectAlreadyExistsError {
...ObjectAlreadyExistsErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": OrganizationCreateInput}
Response
{
"data": {
"organizationCreate": {
"clientMutationId": "xyz789",
"organization": Organization,
"errors": [InvalidFormatError]
}
}
}
organizationDelete
Description
Delete the specified organization
Response
Returns an OrganizationDeletePayload
Arguments
Name | Description |
---|---|
input - OrganizationDeleteInput!
|
Required Parameter for the organizationDelete Mutation |
Example
Query
mutation organizationDelete($input: OrganizationDeleteInput!) {
organizationDelete(input: $input) {
clientMutationId
deletedId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": OrganizationDeleteInput}
Response
{
"data": {
"organizationDelete": {
"clientMutationId": "xyz789",
"deletedId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"errors": [ObjectNotFoundError]
}
}
}
organizationUpdate
Description
Update the specified organization configuration and name
Response
Returns an OrganizationUpdatePayload
Arguments
Name | Description |
---|---|
input - OrganizationUpdateInput!
|
Required Parameter for the organizationUpdate Mutation |
Example
Query
mutation organizationUpdate($input: OrganizationUpdateInput!) {
organizationUpdate(input: $input) {
clientMutationId
organization {
...OrganizationFragment
}
errors {
... on InvalidFormatError {
...InvalidFormatErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": OrganizationUpdateInput}
Response
{
"data": {
"organizationUpdate": {
"clientMutationId": "xyz789",
"organization": Organization,
"errors": [InvalidFormatError]
}
}
}
schemaAttributeCreate
Description
Create a StorySchema
attribute you'll need schema edition right
Response
Returns a SchemaAttributeCreatePayload
Arguments
Name | Description |
---|---|
input - SchemaAttributeCreateInput!
|
Required Input for the schemaAttributeCreate Mutation |
Example
Query
mutation schemaAttributeCreate($input: SchemaAttributeCreateInput!) {
schemaAttributeCreate(input: $input) {
attribute {
...SchemaAttributeFragment
}
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
}
}
}
Variables
{"input": SchemaAttributeCreateInput}
Response
{
"data": {
"schemaAttributeCreate": {
"attribute": SchemaAttribute,
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError]
}
}
}
schemaAttributeDelete
Description
Delete a Template field, remove the field from all content
Response
Returns a SchemaAttributeDeletePayload
Arguments
Name | Description |
---|---|
input - SchemaAttributeDeleteInput!
|
Required Input for the schemaAttributeDelete Mutation |
Example
Query
mutation schemaAttributeDelete($input: SchemaAttributeDeleteInput!) {
schemaAttributeDelete(input: $input) {
attribute {
... on SchemaSeparator {
...SchemaSeparatorFragment
}
... on SchemaAttribute {
...SchemaAttributeFragment
}
}
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": SchemaAttributeDeleteInput}
Response
{
"data": {
"schemaAttributeDelete": {
"attribute": SchemaSeparator,
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError]
}
}
}
schemaAttributeOptionCreate
Description
Create a new value to be used in a SchemaAttribute
(applicable for attribute of TAG or TAG_LIST type => create a new tag in the facet)
Response
Returns a SchemaAttributeOptionCreatePayload
Arguments
Name | Description |
---|---|
input - SchemaAttributeOptionCreateInput!
|
Required Input for the schemaAttributeOptionCreate Mutation |
Example
Query
mutation schemaAttributeOptionCreate($input: SchemaAttributeOptionCreateInput!) {
schemaAttributeOptionCreate(input: $input) {
clientMutationId
option {
...SchemaAttributeOptionFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
}
}
}
Variables
{"input": SchemaAttributeOptionCreateInput}
Response
{
"data": {
"schemaAttributeOptionCreate": {
"clientMutationId": "abc123",
"option": SchemaAttributeOption,
"errors": [ObjectNotFoundError]
}
}
}
schemaAttributeUpdate
Description
Update a StorySchema
attribute (label, description) It's not possible to change the type of an attribute
Response
Returns a SchemaAttributeUpdatePayload
Arguments
Name | Description |
---|---|
input - SchemaAttributeUpdateInput!
|
Required Input for the schemaAttributeUpdate Mutation |
Example
Query
mutation schemaAttributeUpdate($input: SchemaAttributeUpdateInput!) {
schemaAttributeUpdate(input: $input) {
attribute {
... on SchemaSeparator {
...SchemaSeparatorFragment
}
... on SchemaAttribute {
...SchemaAttributeFragment
}
}
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
}
}
}
Variables
{"input": SchemaAttributeUpdateInput}
Response
{
"data": {
"schemaAttributeUpdate": {
"attribute": SchemaSeparator,
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError]
}
}
}
schemaSeparatorCreate
Description
Create a new SchemaSeparator
for display in a StorySchema
Response
Returns a SchemaSeparatorCreatePayload
Arguments
Name | Description |
---|---|
input - SchemaSeparatorCreateInput!
|
Required Input for the schemaSeparatorCreate Mutation |
Example
Query
mutation schemaSeparatorCreate($input: SchemaSeparatorCreateInput!) {
schemaSeparatorCreate(input: $input) {
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
}
separator {
...SchemaSeparatorFragment
}
}
}
Variables
{"input": SchemaSeparatorCreateInput}
Response
{
"data": {
"schemaSeparatorCreate": {
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError],
"separator": SchemaSeparator
}
}
}
searchFeedback
Description
Post a feedback about missing content in search results for your administrators.
Response
Returns a SearchFeedbackPayload
Arguments
Name | Description |
---|---|
input - SearchFeedbackInput!
|
Required Parameter for the searchFeedback Mutation |
Example
Query
mutation searchFeedback($input: SearchFeedbackInput!) {
searchFeedback(input: $input) {
clientMutationId
me {
...MeFragment
}
}
}
Variables
{"input": SearchFeedbackInput}
Response
{
"data": {
"searchFeedback": {
"clientMutationId": "xyz789",
"me": Me
}
}
}
searchHistoryPost
Description
Insert search query history for later use like stats and improvements
Response
Returns a SearchHistoryPostPayload
Arguments
Name | Description |
---|---|
input - SearchHistoryPostInput!
|
Required Parameter for the searchHistoryPost Mutation |
Example
Query
mutation searchHistoryPost($input: SearchHistoryPostInput!) {
searchHistoryPost(input: $input) {
clientMutationId
me {
...MeFragment
}
}
}
Variables
{"input": SearchHistoryPostInput}
Response
{
"data": {
"searchHistoryPost": {
"clientMutationId": "abc123",
"me": Me
}
}
}
slackActivitiesConfigUpdate
Description
Updates the activities for which a message should be pushed to Slack
Response
Returns a SlackActivitiesConfigUpdatePayload
Arguments
Name | Description |
---|---|
input - SlackActivitiesConfigUpdateInput!
|
Required Input for the slackActivitiesConfigUpdate Mutation |
Example
Query
mutation slackActivitiesConfigUpdate($input: SlackActivitiesConfigUpdateInput!) {
slackActivitiesConfigUpdate(input: $input) {
clientMutationId
instance {
...InstanceFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on UnconfiguredServiceError {
...UnconfiguredServiceErrorFragment
}
}
}
}
Variables
{"input": SlackActivitiesConfigUpdateInput}
Response
{
"data": {
"slackActivitiesConfigUpdate": {
"clientMutationId": "abc123",
"instance": Instance,
"errors": [PermissionError]
}
}
}
slackSpacesToChannelRemove
Description
Removes the "Elium space to Slack channel mapping" (SpacesToChannelItem) if it exists
Response
Returns a SlackSpacesToChannelRemovePayload
Arguments
Name | Description |
---|---|
input - SlackSpacesToChannelRemoveInput!
|
Required Input for the slackSpacesToChannelRemove Mutation |
Example
Query
mutation slackSpacesToChannelRemove($input: SlackSpacesToChannelRemoveInput!) {
slackSpacesToChannelRemove(input: $input) {
clientMutationId
instance {
...InstanceFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
... on UnconfiguredServiceError {
...UnconfiguredServiceErrorFragment
}
}
}
}
Variables
{"input": SlackSpacesToChannelRemoveInput}
Response
{
"data": {
"slackSpacesToChannelRemove": {
"clientMutationId": "abc123",
"instance": Instance,
"errors": [ObjectNotFoundError]
}
}
}
slackSpacesToChannelUpdate
Description
Add a Mapping between a space and a Slack channel.
Activities in the space will trigger a notification in the slack channel depndening on the configuration. See slackActivitiesConfigUpdate
Response
Returns a SlackSpacesToChannelUpdatePayload
Arguments
Name | Description |
---|---|
input - SlackSpacesToChannelUpdateInput!
|
Required Input for the slackSpacesToChannelUpdate Mutation |
Example
Query
mutation slackSpacesToChannelUpdate($input: SlackSpacesToChannelUpdateInput!) {
slackSpacesToChannelUpdate(input: $input) {
clientMutationId
instance {
...InstanceFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
... on UnconfiguredServiceError {
...UnconfiguredServiceErrorFragment
}
}
}
}
Variables
{"input": SlackSpacesToChannelUpdateInput}
Response
{
"data": {
"slackSpacesToChannelUpdate": {
"clientMutationId": "xyz789",
"instance": Instance,
"errors": [ObjectNotFoundError]
}
}
}
smartAssistantCreate
Description
Create a new SmartAssistant
require MeActions.smartAssistantsManage
to be able to create one.
Response
Returns a SmartAssistantCreatePayload
Arguments
Name | Description |
---|---|
input - SmartAssistantCreateInput!
|
Required Input for the smartAssistantCreate Mutation |
Example
Query
mutation smartAssistantCreate($input: SmartAssistantCreateInput!) {
smartAssistantCreate(input: $input) {
clientMutationId
errors {
... on InvalidInputError {
...InvalidInputErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
edge {
...SmartAssistantEdgeFragment
}
smartAssistant {
...SmartAssistantFragment
}
}
}
Variables
{"input": SmartAssistantCreateInput}
Response
{
"data": {
"smartAssistantCreate": {
"clientMutationId": "xyz789",
"errors": [InvalidInputError],
"edge": SmartAssistantEdge,
"smartAssistant": SmartAssistant
}
}
}
smartAssistantDelete
Description
Delete a SmartAssistant
require MeActions.smartAssistantsManage
to be able to remove it.
Response
Returns a SmartAssistantDeletePayload
Arguments
Name | Description |
---|---|
input - SmartAssistantDeleteInput!
|
Required Input for the smartAssistantDelete Mutation |
Example
Query
mutation smartAssistantDelete($input: SmartAssistantDeleteInput!) {
smartAssistantDelete(input: $input) {
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
deletedId
instance {
...InstanceFragment
}
}
}
Variables
{"input": SmartAssistantDeleteInput}
Response
{
"data": {
"smartAssistantDelete": {
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError],
"deletedId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"instance": Instance
}
}
}
smartAssistantOrder
Description
Order the list of SmartAssistant
require MeActions.smartAssistantsManage
Response
Returns a SmartAssistantOrderPayload
Arguments
Name | Description |
---|---|
input - SmartAssistantOrderInput!
|
Required Input for the smartAssistantOrder Mutation |
Example
Query
mutation smartAssistantOrder($input: SmartAssistantOrderInput!) {
smartAssistantOrder(input: $input) {
clientMutationId
errors {
... on PermissionError {
...PermissionErrorFragment
}
}
instance {
...InstanceFragment
}
}
}
Variables
{"input": SmartAssistantOrderInput}
Response
{
"data": {
"smartAssistantOrder": {
"clientMutationId": "xyz789",
"errors": [PermissionError],
"instance": Instance
}
}
}
smartAssistantUpdate
Description
Update a given SmartAssistant
require MeActions.smartAssistantsManage
to be able to edit one.
Response
Returns a SmartAssistantUpdatePayload
Arguments
Name | Description |
---|---|
input - SmartAssistantUpdateInput!
|
Required Input for the smartAssistantUpdate Mutation |
Example
Query
mutation smartAssistantUpdate($input: SmartAssistantUpdateInput!) {
smartAssistantUpdate(input: $input) {
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
}
smartAssistant {
...SmartAssistantFragment
}
}
}
Variables
{"input": SmartAssistantUpdateInput}
Response
{
"data": {
"smartAssistantUpdate": {
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError],
"smartAssistant": SmartAssistant
}
}
}
smartConversationArchive
Description
Archive a given SmartConversation
Response
Returns a SmartConversationArchivePayload
Arguments
Name | Description |
---|---|
input - SmartConversationArchiveInput!
|
Required Input for the smartConversationArchive Mutation |
Example
Query
mutation smartConversationArchive($input: SmartConversationArchiveInput!) {
smartConversationArchive(input: $input) {
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
}
smartConversation {
...SmartConversationFragment
}
}
}
Variables
{"input": SmartConversationArchiveInput}
Response
{
"data": {
"smartConversationArchive": {
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError],
"smartConversation": SmartConversation
}
}
}
smartConversationCreate
Description
Create a new SmartConversation
: Sesssion of a conversation with a SmartAssistant
Response
Returns a SmartConversationCreatePayload
Arguments
Name | Description |
---|---|
input - SmartConversationCreateInput!
|
Required Input for the smartConversationCreate Mutation |
Example
Query
mutation smartConversationCreate($input: SmartConversationCreateInput!) {
smartConversationCreate(input: $input) {
clientMutationId
errors {
... on InvalidInputError {
...InvalidInputErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on LimitsViolationError {
...LimitsViolationErrorFragment
}
}
smartConversation {
...SmartConversationFragment
}
edge {
...SmartConversationEdgeFragment
}
}
}
Variables
{"input": SmartConversationCreateInput}
Response
{
"data": {
"smartConversationCreate": {
"clientMutationId": "abc123",
"errors": [InvalidInputError],
"smartConversation": SmartConversation,
"edge": SmartConversationEdge
}
}
}
smartConversationDelete
Description
Delete a SmartConversation
Response
Returns a SmartConversationDeletePayload
Arguments
Name | Description |
---|---|
input - SmartConversationDeleteInput!
|
Required Input for the smartConversationDelete Mutation |
Example
Query
mutation smartConversationDelete($input: SmartConversationDeleteInput!) {
smartConversationDelete(input: $input) {
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
deletedId
instance {
...InstanceFragment
}
}
}
Variables
{"input": SmartConversationDeleteInput}
Response
{
"data": {
"smartConversationDelete": {
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError],
"deletedId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"instance": Instance
}
}
}
smartConversationPostMessage
Description
Append Messages to a given SmartConversation
Response
Returns a SmartConversationPostMessagePayload
Arguments
Name | Description |
---|---|
input - SmartConversationPostMessageInput!
|
Required Input for the smartConversationPostMessage Mutation |
Example
Query
mutation smartConversationPostMessage($input: SmartConversationPostMessageInput!) {
smartConversationPostMessage(input: $input) {
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
}
smartConversation {
...SmartConversationFragment
}
}
}
Variables
{"input": SmartConversationPostMessageInput}
Response
{
"data": {
"smartConversationPostMessage": {
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError],
"smartConversation": SmartConversation
}
}
}
smartConversationUpdate
Description
Update a given SmartConversation
Response
Returns a SmartConversationUpdatePayload
Arguments
Name | Description |
---|---|
input - SmartConversationUpdateInput!
|
Required Input for the smartConversationUpdate Mutation |
Example
Query
mutation smartConversationUpdate($input: SmartConversationUpdateInput!) {
smartConversationUpdate(input: $input) {
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
smartConversation {
...SmartConversationFragment
}
}
}
Variables
{"input": SmartConversationUpdateInput}
Response
{
"data": {
"smartConversationUpdate": {
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError],
"smartConversation": SmartConversation
}
}
}
smartFeedCreate
Description
Create a new SmartFeed
require MeActions.smartFeedsManage
to be able to create one.
Response
Returns a SmartFeedCreatePayload
Arguments
Name | Description |
---|---|
input - SmartFeedCreateInput!
|
Required Parameter for the smartFeedCreate Mutation |
Example
Query
mutation smartFeedCreate($input: SmartFeedCreateInput!) {
smartFeedCreate(input: $input) {
clientMutationId
errors {
... on InvalidInputError {
...InvalidInputErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
edge {
...SmartFeedEdgeFragment
}
smartFeed {
...SmartFeedFragment
}
}
}
Variables
{"input": SmartFeedCreateInput}
Response
{
"data": {
"smartFeedCreate": {
"clientMutationId": "abc123",
"errors": [InvalidInputError],
"edge": SmartFeedEdge,
"smartFeed": SmartFeed
}
}
}
smartFeedDelete
Description
Delete a SmartFeed
require MeActions.smartFeedsManage
to be able to remove it.
Response
Returns a SmartFeedDeletePayload
Arguments
Name | Description |
---|---|
input - SmartFeedDeleteInput!
|
Required Parameter for the smartFeedDelete Mutation |
Example
Query
mutation smartFeedDelete($input: SmartFeedDeleteInput!) {
smartFeedDelete(input: $input) {
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
deletedId
instance {
...InstanceFragment
}
}
}
Variables
{"input": SmartFeedDeleteInput}
Response
{
"data": {
"smartFeedDelete": {
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError],
"deletedId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"instance": Instance
}
}
}
smartFeedOrder
Description
Order the list of SmartFeed
require MeActions.smartFeedsManage
Response
Returns a SmartFeedOrderPayload
Arguments
Name | Description |
---|---|
input - SmartFeedOrderInput!
|
Required Parameter for the smartFeedOrder Mutation |
Example
Query
mutation smartFeedOrder($input: SmartFeedOrderInput!) {
smartFeedOrder(input: $input) {
clientMutationId
errors {
... on PermissionError {
...PermissionErrorFragment
}
}
instance {
...InstanceFragment
}
}
}
Variables
{"input": SmartFeedOrderInput}
Response
{
"data": {
"smartFeedOrder": {
"clientMutationId": "xyz789",
"errors": [PermissionError],
"instance": Instance
}
}
}
smartFeedUpdate
Description
Update a given SmartFeed
require MeActions.smartFeedsManage
to be able to edit one.
Response
Returns a SmartFeedUpdatePayload
Arguments
Name | Description |
---|---|
input - SmartFeedUpdateInput!
|
Required Parameter for the smartFeedUpdate Mutation |
Example
Query
mutation smartFeedUpdate($input: SmartFeedUpdateInput!) {
smartFeedUpdate(input: $input) {
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
}
smartFeed {
...SmartFeedFragment
}
}
}
Variables
{"input": SmartFeedUpdateInput}
Response
{
"data": {
"smartFeedUpdate": {
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError],
"smartFeed": SmartFeed
}
}
}
spaceAccept
Description
Accept or reject a space creation request (space with status Pending) (see spaceRequestAccept
to accept a members in an existing space)
Response
Returns a SpaceAcceptPayload
Arguments
Name | Description |
---|---|
input - SpaceAcceptInput!
|
Required Parameter for the spaceAccept Mutation |
Example
Query
mutation spaceAccept($input: SpaceAcceptInput!) {
spaceAccept(input: $input) {
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
}
space {
...SpaceFragment
}
rejectedId
}
}
Variables
{"input": SpaceAcceptInput}
Response
{
"data": {
"spaceAccept": {
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError],
"space": Space,
"rejectedId": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}
}
}
spaceAdd
Description
Create a new space. require MeActions.spaceAdd
or SpaceGroupActions.spaceAdd
depending on your input
Response
Returns a SpaceAddPayload
Arguments
Name | Description |
---|---|
input - SpaceAddInput!
|
Required Parameter for the spaceAdd Mutation |
Example
Query
mutation spaceAdd($input: SpaceAddInput!) {
spaceAdd(input: $input) {
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
space {
...SpaceFragment
}
}
}
Variables
{"input": SpaceAddInput}
Response
{
"data": {
"spaceAdd": {
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError],
"space": Space
}
}
}
spaceAddRequest
Description
Send a request to create a space. This will notify administrator of the platform. you need MeActions.spaceAddRequest
or SpaceGroupActions.spaceAddRequest
depending on your input
Response
Returns a SpaceAddRequestPayload
Arguments
Name | Description |
---|---|
input - SpaceAddRequestInput!
|
Required Parameter for the spaceAddRequest Mutation |
Example
Query
mutation spaceAddRequest($input: SpaceAddRequestInput!) {
spaceAddRequest(input: $input) {
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
space {
...SpaceFragment
}
}
}
Variables
{"input": SpaceAddRequestInput}
Response
{
"data": {
"spaceAddRequest": {
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError],
"space": Space
}
}
}
spaceChangeStatus
Description
Close an existing Space
you need SpaceActions.edit
to be able to close a space
Response
Returns a SpaceChangeStatusPayload
Arguments
Name | Description |
---|---|
input - SpaceChangeStatusInput!
|
Required Parameter for the spaceChangeStatus Mutation |
Example
Query
mutation spaceChangeStatus($input: SpaceChangeStatusInput!) {
spaceChangeStatus(input: $input) {
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
}
space {
...SpaceFragment
}
}
}
Variables
{"input": SpaceChangeStatusInput}
Response
{
"data": {
"spaceChangeStatus": {
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError],
"space": Space
}
}
}
spaceDelete
Description
Delete an existing Space
you need SpaceActions.delete
to be able to delete a space
Response
Returns a SpaceDeletePayload
Arguments
Name | Description |
---|---|
input - SpaceDeleteInput!
|
Required Parameter for the spaceDelete Mutation |
Example
Query
mutation spaceDelete($input: SpaceDeleteInput!) {
spaceDelete(input: $input) {
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
id
deletedId
}
}
Variables
{"input": SpaceDeleteInput}
Response
{
"data": {
"spaceDelete": {
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError],
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"deletedId": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}
}
}
spaceFavorite
Description
Favorite a space you are member of.
Response
Returns a SpaceFavoritePayload
Arguments
Name | Description |
---|---|
input - SpaceFavoriteInput!
|
Required Parameter for the spaceFavorite Mutation |
Example
Query
mutation spaceFavorite($input: SpaceFavoriteInput!) {
spaceFavorite(input: $input) {
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
space {
...SpaceFragment
}
}
}
Variables
{"input": SpaceFavoriteInput}
Response
{
"data": {
"spaceFavorite": {
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError],
"space": Space
}
}
}
spaceGroupAdd
Description
Create a new SpaceGroup you need MeActions.spaceGroupAdd
Response
Returns a SpaceGroupAddPayload
Arguments
Name | Description |
---|---|
input - SpaceGroupAddInput!
|
Required Parameter for the spaceGroupAdd Mutation |
Example
Query
mutation spaceGroupAdd($input: SpaceGroupAddInput!) {
spaceGroupAdd(input: $input) {
clientMutationId
errors {
... on PermissionError {
...PermissionErrorFragment
}
}
spaceGroup {
...SpaceGroupFragment
}
}
}
Variables
{"input": SpaceGroupAddInput}
Response
{
"data": {
"spaceGroupAdd": {
"clientMutationId": "abc123",
"errors": [PermissionError],
"spaceGroup": SpaceGroup
}
}
}
spaceGroupDelete
Description
Delete a SpaceGroup
you need SpaceGroupActions.edit
Response
Returns a SpaceGroupDeletePayload
Arguments
Name | Description |
---|---|
input - SpaceGroupDeleteInput!
|
Required Parameter for the spaceGroupDelete Mutation |
Example
Query
mutation spaceGroupDelete($input: SpaceGroupDeleteInput!) {
spaceGroupDelete(input: $input) {
clientMutationId
deletedId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": SpaceGroupDeleteInput}
Response
{
"data": {
"spaceGroupDelete": {
"clientMutationId": "xyz789",
"deletedId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"errors": [ObjectNotFoundError]
}
}
}
spaceGroupOrder
Description
Order SpaceGroups between each others
Response
Returns a SpaceGroupOrderPayload
Arguments
Name | Description |
---|---|
input - SpaceGroupOrderInput!
|
Required Parameter for the spaceGroupOrder Mutation |
Example
Query
mutation spaceGroupOrder($input: SpaceGroupOrderInput!) {
spaceGroupOrder(input: $input) {
clientMutationId
errors {
... on PermissionError {
...PermissionErrorFragment
}
}
spaceGroups {
...SpaceGroupFragment
}
}
}
Variables
{"input": SpaceGroupOrderInput}
Response
{
"data": {
"spaceGroupOrder": {
"clientMutationId": "xyz789",
"errors": [PermissionError],
"spaceGroups": [SpaceGroup]
}
}
}
spaceGroupUpdate
Description
Update a given SpaceGroup
's settings and configuration
Response
Returns a SpaceGroupUpdatePayload
Arguments
Name | Description |
---|---|
input - SpaceGroupUpdateInput!
|
Required Parameter for the spaceGroupUpdate Mutation |
Example
Query
mutation spaceGroupUpdate($input: SpaceGroupUpdateInput!) {
spaceGroupUpdate(input: $input) {
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
spaceGroup {
...SpaceGroupFragment
}
}
}
Variables
{"input": SpaceGroupUpdateInput}
Response
{
"data": {
"spaceGroupUpdate": {
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError],
"spaceGroup": SpaceGroup
}
}
}
spaceJoin
Description
Join a Space
requires Space.actions.join
, you'll then see news about this in your feeds. You may also use spaceRequest
for moderated spaces
Response
Returns a SpaceJoinPayload
Arguments
Name | Description |
---|---|
input - SpaceJoinInput!
|
Required Parameter for the spaceJoin Mutation |
Example
Query
mutation spaceJoin($input: SpaceJoinInput!) {
spaceJoin(input: $input) {
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
space {
...SpaceFragment
}
}
}
Variables
{"input": SpaceJoinInput}
Response
{
"data": {
"spaceJoin": {
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError],
"space": Space
}
}
}
spaceLeave
Description
Join a Space
requires Space.actions.leave
Response
Returns a SpaceLeavePayload
Arguments
Name | Description |
---|---|
input - SpaceLeaveInput!
|
Required Parameter for the spaceLeave Mutation |
Example
Query
mutation spaceLeave($input: SpaceLeaveInput!) {
spaceLeave(input: $input) {
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
space {
...SpaceFragment
}
}
}
Variables
{"input": SpaceLeaveInput}
Response
{
"data": {
"spaceLeave": {
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError],
"space": Space
}
}
}
spaceMemberAdd
Description
Add a new member(s) (User, Team) to a Space
Response
Returns a SpaceMemberAddPayload
Arguments
Name | Description |
---|---|
input - SpaceMemberAddInput!
|
Required Parameter for the spaceMemberAdd Mutation |
Example
Query
mutation spaceMemberAdd($input: SpaceMemberAddInput!) {
spaceMemberAdd(input: $input) {
background
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
member {
...SpaceMemberFragment
}
edge {
...SpaceMemberEdgeFragment
}
members {
...SpaceMemberFragment
}
}
}
Variables
{"input": SpaceMemberAddInput}
Response
{
"data": {
"spaceMemberAdd": {
"background": false,
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError],
"member": SpaceMember,
"edge": SpaceMemberEdge,
"members": [SpaceMember]
}
}
}
spaceMemberDelete
Description
Remove a SpaceMember
from a Space
Response
Returns a SpaceMemberDeletePayload
Arguments
Name | Description |
---|---|
input - SpaceMemberDeleteInput!
|
Required Parameter for the spaceMemberDelete Mutation |
Example
Query
mutation spaceMemberDelete($input: SpaceMemberDeleteInput!) {
spaceMemberDelete(input: $input) {
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
deletedId
deletedIds
}
}
Variables
{"input": SpaceMemberDeleteInput}
Response
{
"data": {
"spaceMemberDelete": {
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError],
"deletedId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"deletedIds": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
]
}
}
}
spaceMemberRole
Description
Change the role of a SpaceMember
in the Space
Response
Returns a SpaceMemberRolePayload
Arguments
Name | Description |
---|---|
input - SpaceMemberRoleInput!
|
Required Parameter for the spaceMemberRole Mutation |
Example
Query
mutation spaceMemberRole($input: SpaceMemberRoleInput!) {
spaceMemberRole(input: $input) {
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
}
member {
...SpaceMemberFragment
}
}
}
Variables
{"input": SpaceMemberRoleInput}
Response
{
"data": {
"spaceMemberRole": {
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError],
"member": SpaceMember
}
}
}
spaceOrder
Description
Order spaces in a SpaceGroup
. Spaces can Only be ordered inside their Common SaceGroups
Response
Returns a SpaceOrderPayload
Arguments
Name | Description |
---|---|
input - SpaceOrderInput!
|
Required Parameter for the spaceOrder Mutation |
Example
Query
mutation spaceOrder($input: SpaceOrderInput!) {
spaceOrder(input: $input) {
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
spaces {
...SpaceFragment
}
}
}
Variables
{"input": SpaceOrderInput}
Response
{
"data": {
"spaceOrder": {
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError],
"spaces": [Space]
}
}
}
spaceRequest
Description
Request membership to a space you can't join directly you need SpaceActions.request
to be able to request a space also see spaceJoin to join a space directly
Response
Returns a SpaceRequestPayload
Arguments
Name | Description |
---|---|
input - SpaceRequestInput!
|
Required Parameter for the spaceRequest Mutation |
Example
Query
mutation spaceRequest($input: SpaceRequestInput!) {
spaceRequest(input: $input) {
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
space {
...SpaceFragment
}
}
}
Variables
{"input": SpaceRequestInput}
Response
{
"data": {
"spaceRequest": {
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError],
"space": Space
}
}
}
spaceRequestAccept
Description
Accept or reject a member request to join a space (need SpaceActions.edit)
Response
Returns a SpaceRequestAcceptPayload
Arguments
Name | Description |
---|---|
input - SpaceRequestAcceptInput!
|
Required Parameter for the spaceRequestAccept Mutation |
Example
Query
mutation spaceRequestAccept($input: SpaceRequestAcceptInput!) {
spaceRequestAccept(input: $input) {
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
member {
...SpaceMemberFragment
}
space {
...SpaceFragment
}
}
}
Variables
{"input": SpaceRequestAcceptInput}
Response
{
"data": {
"spaceRequestAccept": {
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError],
"member": SpaceMember,
"space": Space
}
}
}
spaceStatus
Description
Change A given space Status to closed or open
Response
Returns a SpaceStatusPayload
Arguments
Name | Description |
---|---|
input - SpaceStatusInput!
|
Required Parameter for the spaceStatus Mutation |
Example
Query
mutation spaceStatus($input: SpaceStatusInput!) {
spaceStatus(input: $input) {
clientMutationId
space {
...SpaceFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
}
}
}
Variables
{"input": SpaceStatusInput}
Response
{
"data": {
"spaceStatus": {
"clientMutationId": "xyz789",
"space": Space,
"errors": [ObjectNotFoundError]
}
}
}
spaceTabDelete
Description
Delete a SpaceTab
of a given space
Response
Returns a SpaceTabDeletePayload
Arguments
Name | Description |
---|---|
input - SpaceTabDeleteInput!
|
Required Parameter for the spaceTabDelete Mutation |
Example
Query
mutation spaceTabDelete($input: SpaceTabDeleteInput!) {
spaceTabDelete(input: $input) {
clientMutationId
space {
...SpaceFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": SpaceTabDeleteInput}
Response
{
"data": {
"spaceTabDelete": {
"clientMutationId": "xyz789",
"space": Space,
"errors": [ObjectNotFoundError]
}
}
}
spaceTabOrder
Description
Order the SpaceTab
of a given space
Response
Returns a SpaceTabOrderPayload
Arguments
Name | Description |
---|---|
input - SpaceTabOrderInput!
|
Required Parameter for the spaceTabOrder Mutation |
Example
Query
mutation spaceTabOrder($input: SpaceTabOrderInput!) {
spaceTabOrder(input: $input) {
clientMutationId
space {
...SpaceFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": SpaceTabOrderInput}
Response
{
"data": {
"spaceTabOrder": {
"clientMutationId": "abc123",
"space": Space,
"errors": [ObjectNotFoundError]
}
}
}
spaceTabUpdate
Description
Update or create a SpaceTab. If you create a new one, don't pass an id
and make sure to give a type
Response
Returns a SpaceTabUpdatePayload
Arguments
Name | Description |
---|---|
input - SpaceTabUpdateInput!
|
Required Parameter for the spaceTabUpdate Mutation |
Example
Query
mutation spaceTabUpdate($input: SpaceTabUpdateInput!) {
spaceTabUpdate(input: $input) {
clientMutationId
space {
...SpaceFragment
}
spaceTab {
...SpaceTabFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
... on MissingTypeInputError {
...MissingTypeInputErrorFragment
}
}
}
}
Variables
{"input": SpaceTabUpdateInput}
Response
{
"data": {
"spaceTabUpdate": {
"clientMutationId": "abc123",
"space": Space,
"spaceTab": SpaceTab,
"errors": [ObjectNotFoundError]
}
}
}
spaceUnFavorite
Description
Remove a space from your favorites.
Response
Returns a SpaceUnFavoritePayload
Arguments
Name | Description |
---|---|
input - SpaceUnFavoriteInput!
|
Required Parameter for the spaceUnFavorite Mutation |
Example
Query
mutation spaceUnFavorite($input: SpaceUnFavoriteInput!) {
spaceUnFavorite(input: $input) {
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
space {
...SpaceFragment
}
}
}
Variables
{"input": SpaceUnFavoriteInput}
Response
{
"data": {
"spaceUnFavorite": {
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError],
"space": Space
}
}
}
spaceUnrequest
Description
Remove the request of a space creation
Response
Returns a SpaceUnrequestPayload
Arguments
Name | Description |
---|---|
input - SpaceUnrequestInput!
|
Required Parameter for the spaceUnrequest Mutation |
Example
Query
mutation spaceUnrequest($input: SpaceUnrequestInput!) {
spaceUnrequest(input: $input) {
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
}
space {
...SpaceFragment
}
}
}
Variables
{"input": SpaceUnrequestInput}
Response
{
"data": {
"spaceUnrequest": {
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError],
"space": Space
}
}
}
spaceUpdate
Description
Update the configuration of a given space (name, description, logo, etc.) need SpaceActions.edit
to be able to update a space
Response
Returns a SpaceUpdatePayload
Arguments
Name | Description |
---|---|
input - SpaceUpdateInput!
|
Required Parameter for the spaceUpdate Mutation |
Example
Query
mutation spaceUpdate($input: SpaceUpdateInput!) {
spaceUpdate(input: $input) {
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
space {
...SpaceFragment
}
}
}
Variables
{"input": SpaceUpdateInput}
Response
{
"data": {
"spaceUpdate": {
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError],
"space": Space
}
}
}
spaceUpdatePinned
Description
Update a list of "pinned" Stories
, that will appear at the top of the space
Response
Returns a SpaceUpdatePinnedPayload
Arguments
Name | Description |
---|---|
input - SpaceUpdatePinnedInput!
|
Required Parameter for the spaceUpdatePinned Mutation |
Example
Query
mutation spaceUpdatePinned($input: SpaceUpdatePinnedInput!) {
spaceUpdatePinned(input: $input) {
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
space {
...SpaceFragment
}
}
}
Variables
{"input": SpaceUpdatePinnedInput}
Response
{
"data": {
"spaceUpdatePinned": {
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError],
"space": Space
}
}
}
storyAlert
Description
Send an Alert to the given recipients. This includes, user ids, space ids and team ids all filtered by their permissions. this alert will be visible until either the user dismiss it or the alert is archived
Response
Returns a StoryAlertPayload
Arguments
Name | Description |
---|---|
input - StoryAlertInput!
|
Required Parameter for the storyAlert Mutation |
Example
Query
mutation storyAlert($input: StoryAlertInput!) {
storyAlert(input: $input) {
clientMutationId
story {
...StoryFragment
}
alert {
...StoryAlertFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
}
}
}
Variables
{"input": StoryAlertInput}
Response
{
"data": {
"storyAlert": {
"clientMutationId": "abc123",
"story": Story,
"alert": StoryAlert,
"errors": [PermissionError]
}
}
}
storyAlertArchive
Description
Archive an existing broadcast
note: this is mainly used with invite to read urgent broadcasts
Response
Returns a StoryAlertArchivePayload
Arguments
Name | Description |
---|---|
input - StoryAlertArchiveInput!
|
Required Parameter for the storyAlertArchive Mutation |
Example
Query
mutation storyAlertArchive($input: StoryAlertArchiveInput!) {
storyAlertArchive(input: $input) {
clientMutationId
alert {
...StoryAlertFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
}
}
}
Variables
{"input": StoryAlertArchiveInput}
Response
{
"data": {
"storyAlertArchive": {
"clientMutationId": "abc123",
"alert": StoryAlert,
"errors": [PermissionError]
}
}
}
storyAlertsRead
Description
Mark a StoryAlert
as read
Response
Returns a StoryAlertsReadPayload
Arguments
Name | Description |
---|---|
input - StoryAlertsReadInput!
|
Required Parameter for the storyAlertsRead Mutation |
Example
Query
mutation storyAlertsRead($input: StoryAlertsReadInput!) {
storyAlertsRead(input: $input) {
clientMutationId
readIds
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
}
}
}
Variables
{"input": StoryAlertsReadInput}
Response
{
"data": {
"storyAlertsRead": {
"clientMutationId": "abc123",
"readIds": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"errors": [PermissionError]
}
}
}
storyApprovalAssign
Description
Change the approver of a StoryApproval
.
Response
Returns a StoryApprovalAssignPayload
Arguments
Name | Description |
---|---|
input - StoryApprovalAssignInput!
|
Required Parameter for the storyApprovalAssign Mutation |
Example
Query
mutation storyApprovalAssign($input: StoryApprovalAssignInput!) {
storyApprovalAssign(input: $input) {
clientMutationId
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
... on LimitsViolationError {
...LimitsViolationErrorFragment
}
}
story {
...StoryFragment
}
approval {
...StoryApprovalFragment
}
}
}
Variables
{"input": StoryApprovalAssignInput}
Response
{
"data": {
"storyApprovalAssign": {
"clientMutationId": "abc123",
"errors": [PermissionError],
"story": Story,
"approval": StoryApproval
}
}
}
storyApprovalCancel
Description
Cancel a StoryApproval
.
Response
Returns a StoryApprovalCancelPayload
Arguments
Name | Description |
---|---|
input - StoryApprovalCancelInput!
|
Required Input for the storyApprovalCancel Mutation |
Example
Query
mutation storyApprovalCancel($input: StoryApprovalCancelInput!) {
storyApprovalCancel(input: $input) {
clientMutationId
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
... on LimitsViolationError {
...LimitsViolationErrorFragment
}
}
story {
...StoryFragment
}
approval {
...StoryApprovalFragment
}
}
}
Variables
{"input": StoryApprovalCancelInput}
Response
{
"data": {
"storyApprovalCancel": {
"clientMutationId": "xyz789",
"errors": [PermissionError],
"story": Story,
"approval": StoryApproval
}
}
}
storyApprovalEdit
Description
Change the status of a StoryApproval
.
Response
Returns a StoryApprovalEditPayload
Arguments
Name | Description |
---|---|
input - StoryApprovalEditInput!
|
Required Parameter for the storyApprovalEdit Mutation |
Example
Query
mutation storyApprovalEdit($input: StoryApprovalEditInput!) {
storyApprovalEdit(input: $input) {
clientMutationId
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
... on LimitsViolationError {
...LimitsViolationErrorFragment
}
}
story {
...StoryFragment
}
approval {
...StoryApprovalFragment
}
}
}
Variables
{"input": StoryApprovalEditInput}
Response
{
"data": {
"storyApprovalEdit": {
"clientMutationId": "abc123",
"errors": [PermissionError],
"story": Story,
"approval": StoryApproval
}
}
}
storyApprovalRequest
Description
Request an Approval on a given story.
This might need to be required to be able to publish your content. see Space.isApprovalMandatory
Response
Returns a StoryApprovalRequestPayload
Arguments
Name | Description |
---|---|
input - StoryApprovalRequestInput!
|
Required Input for the storyApprovalRequest Mutation |
Example
Query
mutation storyApprovalRequest($input: StoryApprovalRequestInput!) {
storyApprovalRequest(input: $input) {
clientMutationId
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on LimitsViolationError {
...LimitsViolationErrorFragment
}
}
story {
...StoryFragment
}
approval {
...StoryApprovalFragment
}
}
}
Variables
{"input": StoryApprovalRequestInput}
Response
{
"data": {
"storyApprovalRequest": {
"clientMutationId": "xyz789",
"errors": [PermissionError],
"story": Story,
"approval": StoryApproval
}
}
}
storyApprovalStatus
Description
Change the status of a StoryApproval
.
Response
Returns a StoryApprovalStatusPayload
Arguments
Name | Description |
---|---|
input - StoryApprovalStatusInput!
|
Required Parameter for the storyApprovalStatus Mutation |
Example
Query
mutation storyApprovalStatus($input: StoryApprovalStatusInput!) {
storyApprovalStatus(input: $input) {
clientMutationId
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
... on LimitsViolationError {
...LimitsViolationErrorFragment
}
}
story {
...StoryFragment
}
approval {
...StoryApprovalFragment
}
}
}
Variables
{"input": StoryApprovalStatusInput}
Response
{
"data": {
"storyApprovalStatus": {
"clientMutationId": "xyz789",
"errors": [PermissionError],
"story": Story,
"approval": StoryApproval
}
}
}
storyArchive
Description
Archive or Unarchive a story. archived
give the status (true: archived, false: unarchive)
Response
Returns a StoryArchivePayload
Arguments
Name | Description |
---|---|
input - StoryArchiveInput!
|
Required Parameter for the storyArchive Mutation |
Example
Query
mutation storyArchive($input: StoryArchiveInput!) {
storyArchive(input: $input) {
clientMutationId
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
}
story {
...StoryFragment
}
}
}
Variables
{"input": StoryArchiveInput}
Response
{
"data": {
"storyArchive": {
"clientMutationId": "abc123",
"errors": [PermissionError],
"story": Story
}
}
}
storyBookmark
Description
Mark a story as bookmarked or not for the current user this will allow you to find it easily in your bookmarks
Response
Returns a StoryBookmarkPayload
Arguments
Name | Description |
---|---|
input - StoryBookmarkInput!
|
Required Parameter for the storyBookmark Mutation |
Example
Query
mutation storyBookmark($input: StoryBookmarkInput!) {
storyBookmark(input: $input) {
clientMutationId
me {
...MeFragment
}
story {
...StoryFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
}
}
}
Variables
{"input": StoryBookmarkInput}
Response
{
"data": {
"storyBookmark": {
"clientMutationId": "abc123",
"me": Me,
"story": Story,
"errors": [ObjectNotFoundError]
}
}
}
storyBroadcast
Description
Send a broadcast (mail) to the given recipients. This includes, user ids and space ids all filtered by their permissions.
Response
Returns a StoryBroadcastPayload
Arguments
Name | Description |
---|---|
input - StoryBroadcastInput!
|
Required Parameter for the storyBroadcast Mutation |
Example
Query
mutation storyBroadcast($input: StoryBroadcastInput!) {
storyBroadcast(input: $input) {
clientMutationId
nRecipients
previews {
...StoryBroadcastPayloadPreviewFragment
}
story {
...StoryFragment
}
errors {
... on TooManyRecipientsError {
...TooManyRecipientsErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": StoryBroadcastInput}
Response
{
"data": {
"storyBroadcast": {
"clientMutationId": "xyz789",
"nRecipients": 987,
"previews": [StoryBroadcastPayloadPreview],
"story": Story,
"errors": [TooManyRecipientsError]
}
}
}
storyChangeOwner
Description
Change a Story
's owner This will affect the rights and visibility of the story
Response
Returns a StoryChangeOwnerPayload
Arguments
Name | Description |
---|---|
input - StoryChangeOwnerInput!
|
Required Parameter for the storyChangeOwner Mutation |
Example
Query
mutation storyChangeOwner($input: StoryChangeOwnerInput!) {
storyChangeOwner(input: $input) {
clientMutationId
story {
...StoryFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": StoryChangeOwnerInput}
Response
{
"data": {
"storyChangeOwner": {
"clientMutationId": "xyz789",
"story": Story,
"errors": [ObjectNotFoundError]
}
}
}
storyDelete
Description
Delete a Single Story
Response
Returns a StoryDeletePayload
Arguments
Name | Description |
---|---|
input - StoryDeleteInput!
|
Required Parameter for the storyDelete Mutation |
Example
Query
mutation storyDelete($input: StoryDeleteInput!) {
storyDelete(input: $input) {
clientMutationId
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
}
deletedId
id
me {
...MeFragment
}
}
}
Variables
{"input": StoryDeleteInput}
Response
{
"data": {
"storyDelete": {
"clientMutationId": "abc123",
"errors": [PermissionError],
"deletedId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"me": Me
}
}
}
storyDuplicate
Description
Create a duplicate of a given story. this will copy the title, body, assets, tags, and other attributes of the story
Response
Returns a StoryDuplicatePayload
Arguments
Name | Description |
---|---|
input - StoryDuplicateInput!
|
Required Parameter for the storyDuplicate Mutation |
Example
Query
mutation storyDuplicate($input: StoryDuplicateInput!) {
storyDuplicate(input: $input) {
clientMutationId
story {
...StoryFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on LockedContentError {
...LockedContentErrorFragment
}
}
}
}
Variables
{"input": StoryDuplicateInput}
Response
{
"data": {
"storyDuplicate": {
"clientMutationId": "abc123",
"story": Story,
"errors": [PermissionError]
}
}
}
storyEdit
Description
Create a new version a given story. the newly created version will be accessible using story.editVersion
Response
Returns a StoryEditPayload
Arguments
Name | Description |
---|---|
input - StoryEditInput!
|
Required Parameter for the storyEdit Mutation |
Example
Query
mutation storyEdit($input: StoryEditInput!) {
storyEdit(input: $input) {
clientMutationId
ignoredHashtags {
...HashtagFragment
}
ignoredTags {
...TagFragment
}
story {
...StoryFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on LockedContentError {
...LockedContentErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
... on StoryNoModificationsError {
...StoryNoModificationsErrorFragment
}
}
}
}
Variables
{"input": StoryEditInput}
Response
{
"data": {
"storyEdit": {
"clientMutationId": "abc123",
"ignoredHashtags": [Hashtag],
"ignoredTags": [Tag],
"story": Story,
"errors": [PermissionError]
}
}
}
storyExpire
Description
Mark a story Expiration date. If you put Null in expirationDate
, you'll cleanup the expiration
Response
Returns a StoryExpirePayload
Arguments
Name | Description |
---|---|
input - StoryExpireInput!
|
Required Parameter for the storyExpire Mutation |
Example
Query
mutation storyExpire($input: StoryExpireInput!) {
storyExpire(input: $input) {
clientMutationId
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
}
me {
...MeFragment
}
story {
...StoryFragment
}
refreshedStoryId
}
}
Variables
{"input": StoryExpireInput}
Response
{
"data": {
"storyExpire": {
"clientMutationId": "abc123",
"errors": [PermissionError],
"me": Me,
"story": Story,
"refreshedStoryId": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}
}
}
storyFollow
Description
Subscribe to a content. This will have effect on your notifications.
Response
Returns a StoryFollowPayload
Arguments
Name | Description |
---|---|
input - StoryFollowInput!
|
Required Parameter for the storyFollow Mutation |
Example
Query
mutation storyFollow($input: StoryFollowInput!) {
storyFollow(input: $input) {
clientMutationId
story {
...StoryFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
}
}
}
Variables
{"input": StoryFollowInput}
Response
{
"data": {
"storyFollow": {
"clientMutationId": "xyz789",
"story": Story,
"errors": [ObjectNotFoundError]
}
}
}
storyGrant
Description
Manage grants for a given Story
. You can add or remove additional visibilty for users
Response
Returns a StoryGrantPayload
Arguments
Name | Description |
---|---|
input - StoryGrantInput!
|
Required Parameter for the storyGrant Mutation |
Example
Query
mutation storyGrant($input: StoryGrantInput!) {
storyGrant(input: $input) {
clientMutationId
story {
...StoryFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on LockedContentError {
...LockedContentErrorFragment
}
}
}
}
Variables
{"input": StoryGrantInput}
Response
{
"data": {
"storyGrant": {
"clientMutationId": "abc123",
"story": Story,
"errors": [PermissionError]
}
}
}
storyInviteContributors
Description
Invite users to contribute to a content. This will send a notification with the message.but won't add any permission/special rights to the invited users. Users can be invited multiple times
Response
Returns a StoryInviteContributorsPayload
Arguments
Name | Description |
---|---|
input - StoryInviteContributorsInput!
|
Required Input for the storyInviteContributors Mutation |
Example
Query
mutation storyInviteContributors($input: StoryInviteContributorsInput!) {
storyInviteContributors(input: $input) {
clientMutationId
contributorEdges {
...UserEdgeFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
}
story {
...StoryFragment
}
}
}
Variables
{"input": StoryInviteContributorsInput}
Response
{
"data": {
"storyInviteContributors": {
"clientMutationId": "abc123",
"contributorEdges": [UserEdge],
"errors": [PermissionError],
"story": Story
}
}
}
storyLock
Description
Take a lock on a Story
for edition while the lock is active, nobody will be able to make new version on the content. see storyLockRefresh
and StoryEditInput.lockToken
Response
Returns a StoryLockPayload
Arguments
Name | Description |
---|---|
input - StoryLockInput!
|
Required Parameter for the storyLock Mutation |
Example
Query
mutation storyLock($input: StoryLockInput!) {
storyLock(input: $input) {
clientMutationId
story {
...StoryFragment
}
lock {
...StoryLockFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on StoryLockError {
...StoryLockErrorFragment
}
}
}
}
Variables
{"input": StoryLockInput}
Response
{
"data": {
"storyLock": {
"clientMutationId": "abc123",
"story": Story,
"lock": StoryLock,
"errors": [PermissionError]
}
}
}
storyLockRefresh
Description
Bump the expiration of a current StoryLock
the user has on a content you can also take a new one if the lock was expired
Response
Returns a StoryLockRefreshPayload
Arguments
Name | Description |
---|---|
input - StoryLockRefreshInput!
|
Required Parameter for the storyLockRefresh Mutation |
Example
Query
mutation storyLockRefresh($input: StoryLockRefreshInput!) {
storyLockRefresh(input: $input) {
clientMutationId
story {
...StoryFragment
}
lock {
...StoryLockFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on StoryLockError {
...StoryLockErrorFragment
}
}
}
}
Variables
{"input": StoryLockRefreshInput}
Response
{
"data": {
"storyLockRefresh": {
"clientMutationId": "abc123",
"story": Story,
"lock": StoryLock,
"errors": [PermissionError]
}
}
}
storyMigrate
Description
Deprecated do not use
Response
Returns a StoryMigratePayload
Arguments
Name | Description |
---|---|
input - StoryMigrateInput!
|
Required Parameter for the storyMigrate Mutation |
Example
Query
mutation storyMigrate($input: StoryMigrateInput!) {
storyMigrate(input: $input) {
clientMutationId
story {
...StoryFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
}
}
}
Variables
{"input": StoryMigrateInput}
Response
{
"data": {
"storyMigrate": {
"clientMutationId": "xyz789",
"story": Story,
"errors": [PermissionError]
}
}
}
storyPin
Description
Promote or Demote a story in the current Space or (if global
is true) for the whole platform. Promoting a story for the whole platform will respect stories visibility.
Pinning globally requires admin rights (Story.actions.pinGlobally) Note: isGlobal
might be flipped to notnull in a near future.
Response
Returns a StoryPinPayload
Arguments
Name | Description |
---|---|
input - StoryPinInput!
|
Required Parameter for the storyPin Mutation |
Example
Query
mutation storyPin($input: StoryPinInput!) {
storyPin(input: $input) {
clientMutationId
story {
...StoryFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
... on LockedContentError {
...LockedContentErrorFragment
}
}
}
}
Variables
{"input": StoryPinInput}
Response
{
"data": {
"storyPin": {
"clientMutationId": "xyz789",
"story": Story,
"errors": [PermissionError]
}
}
}
storyPing
Description
Send an Invitation to Read (in app + email) to the given recipients. This includes, user ids, space ids and team ids all filtered by their permissions.
Response
Returns a StoryPingPayload
Arguments
Name | Description |
---|---|
input - StoryPingInput!
|
Required Parameter for the storyPing Mutation |
Example
Query
mutation storyPing($input: StoryPingInput!) {
storyPing(input: $input) {
clientMutationId
story {
...StoryFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
}
}
}
Variables
{"input": StoryPingInput}
Response
{
"data": {
"storyPing": {
"clientMutationId": "xyz789",
"story": Story,
"errors": [PermissionError]
}
}
}
storyPost
Description
Create a new story.
Response
Returns a StoryPostPayload
Arguments
Name | Description |
---|---|
input - StoryPostInput!
|
Required Parameter for the storyPost Mutation |
Example
Query
mutation storyPost($input: StoryPostInput!) {
storyPost(input: $input) {
activityFeedItemEdge {
...ActivityFeedItemEdgeFragment
}
clientMutationId
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
}
me {
...MeFragment
}
space {
...SpaceFragment
}
story {
...StoryFragment
}
}
}
Variables
{"input": StoryPostInput}
Response
{
"data": {
"storyPost": {
"activityFeedItemEdge": ActivityFeedItemEdge,
"clientMutationId": "xyz789",
"errors": [PermissionError],
"me": Me,
"space": Space,
"story": Story
}
}
}
storyRelate
Description
Link a story to another story Some of the link are automatically added
Response
Returns a StoryRelatePayload
Arguments
Name | Description |
---|---|
input - StoryRelateInput!
|
Required Parameter for the storyRelate Mutation |
Example
Query
mutation storyRelate($input: StoryRelateInput!) {
storyRelate(input: $input) {
clientMutationId
story {
...StoryFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on LockedContentError {
...LockedContentErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": StoryRelateInput}
Response
{
"data": {
"storyRelate": {
"clientMutationId": "abc123",
"story": Story,
"errors": [ObjectNotFoundError]
}
}
}
storyRemoveTranslation
Description
Remove a translation from the latest version of a translated Story
Response
Returns a StoryRemoveTranslationPayload
Arguments
Name | Description |
---|---|
input - StoryRemoveTranslationInput!
|
Required Input for the storyRemoveTranslation Mutation |
Example
Query
mutation storyRemoveTranslation($input: StoryRemoveTranslationInput!) {
storyRemoveTranslation(input: $input) {
clientMutationId
story {
...StoryFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
... on LockedContentError {
...LockedContentErrorFragment
}
}
}
}
Variables
{"input": StoryRemoveTranslationInput}
Response
{
"data": {
"storyRemoveTranslation": {
"clientMutationId": "abc123",
"story": Story,
"errors": [ObjectNotFoundError]
}
}
}
storySchemaAttributeOrder
Description
Manually order the attributes of a StorySchema
Response
Returns a StorySchemaAttributeOrderPayload
Arguments
Name | Description |
---|---|
input - StorySchemaAttributeOrderInput!
|
Required Input for the storySchemaAttributeOrder Mutation |
Example
Query
mutation storySchemaAttributeOrder($input: StorySchemaAttributeOrderInput!) {
storySchemaAttributeOrder(input: $input) {
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
schema {
...StorySchemaFragment
}
me {
...MeFragment
}
}
}
Variables
{"input": StorySchemaAttributeOrderInput}
Response
{
"data": {
"storySchemaAttributeOrder": {
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError],
"schema": StorySchema,
"me": Me
}
}
}
storySchemaConvert
Description
Convert a regular story to Story with a template
Response
Returns a StorySchemaConvertPayload
Arguments
Name | Description |
---|---|
input - StorySchemaConvertInput!
|
Required Parameter for the storySchemaConvert Mutation |
Example
Query
mutation storySchemaConvert($input: StorySchemaConvertInput!) {
storySchemaConvert(input: $input) {
clientMutationId
story {
...StoryFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on LockedContentError {
...LockedContentErrorFragment
}
}
}
}
Variables
{"input": StorySchemaConvertInput}
Response
{
"data": {
"storySchemaConvert": {
"clientMutationId": "xyz789",
"story": Story,
"errors": [PermissionError]
}
}
}
storySchemaCreate
Description
Create A StorySchema
, also known as a Template
Response
Returns a StorySchemaCreatePayload
Arguments
Name | Description |
---|---|
input - StorySchemaCreateInput!
|
Required Parameter for the storySchemaCreate Mutation |
Example
Query
mutation storySchemaCreate($input: StorySchemaCreateInput!) {
storySchemaCreate(input: $input) {
clientMutationId
errors {
... on InvalidInputError {
...InvalidInputErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
schema {
...StorySchemaFragment
}
me {
...MeFragment
}
}
}
Variables
{"input": StorySchemaCreateInput}
Response
{
"data": {
"storySchemaCreate": {
"clientMutationId": "abc123",
"errors": [InvalidInputError],
"schema": StorySchema,
"me": Me
}
}
}
storySchemaDisable
Description
Mark A StorySchema
as disabled (not usable for regular user anymore)
Response
Returns a StorySchemaDisablePayload
Arguments
Name | Description |
---|---|
input - StorySchemaDisableInput!
|
Required Parameter for the storySchemaDisable Mutation |
Example
Query
mutation storySchemaDisable($input: StorySchemaDisableInput!) {
storySchemaDisable(input: $input) {
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
schema {
...StorySchemaFragment
}
me {
...MeFragment
}
}
}
Variables
{"input": StorySchemaDisableInput}
Response
{
"data": {
"storySchemaDisable": {
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError],
"schema": StorySchema,
"me": Me
}
}
}
storySchemaOrder
Description
Reorder the list of StorySchema
Response
Returns a StorySchemaOrderPayload
Arguments
Name | Description |
---|---|
input - StorySchemaOrderInput!
|
Required Parameter for the storySchemaOrder Mutation |
Example
Query
mutation storySchemaOrder($input: StorySchemaOrderInput!) {
storySchemaOrder(input: $input) {
clientMutationId
errors {
... on PermissionError {
...PermissionErrorFragment
}
}
me {
...MeFragment
}
schemas {
...StorySchemaFragment
}
}
}
Variables
{"input": StorySchemaOrderInput}
Response
{
"data": {
"storySchemaOrder": {
"clientMutationId": "abc123",
"errors": [PermissionError],
"me": Me,
"schemas": [StorySchema]
}
}
}
storySchemaUpdate
Description
Update Fields and configuration of a StorySchema
Response
Returns a StorySchemaUpdatePayload
Arguments
Name | Description |
---|---|
input - StorySchemaUpdateInput!
|
Required Parameter for the storySchemaUpdate Mutation |
Example
Query
mutation storySchemaUpdate($input: StorySchemaUpdateInput!) {
storySchemaUpdate(input: $input) {
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
schema {
...StorySchemaFragment
}
me {
...MeFragment
}
}
}
Variables
{"input": StorySchemaUpdateInput}
Response
{
"data": {
"storySchemaUpdate": {
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError],
"schema": StorySchema,
"me": Me
}
}
}
storySpace
Description
Change Space and visibility of a story
Response
Returns a StorySpacePayload
Arguments
Name | Description |
---|---|
input - StorySpaceInput!
|
Required Parameter for the storySpace Mutation |
Example
Query
mutation storySpace($input: StorySpaceInput!) {
storySpace(input: $input) {
activityFeedItemEdge {
...ActivityFeedItemEdgeFragment
}
clientMutationId
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on LockedContentError {
...LockedContentErrorFragment
}
}
ignoredHashtags {
...HashtagFragment
}
ignoredTags {
...TagFragment
}
me {
...MeFragment
}
space {
...SpaceFragment
}
story {
...StoryFragment
}
}
}
Variables
{"input": StorySpaceInput}
Response
{
"data": {
"storySpace": {
"activityFeedItemEdge": ActivityFeedItemEdge,
"clientMutationId": "abc123",
"errors": [PermissionError],
"ignoredHashtags": [Hashtag],
"ignoredTags": [Tag],
"me": Me,
"space": Space,
"story": Story
}
}
}
storyTag
Description
Edit tags of a story returns: ignoredTags
and ignoredHashtags
is filled with tags and hashtags that couldn't be set to the story (probably because of a schema field)
Response
Returns a StoryTagPayload
Arguments
Name | Description |
---|---|
input - StoryTagInput!
|
Required Parameter for the storyTag Mutation |
Example
Query
mutation storyTag($input: StoryTagInput!) {
storyTag(input: $input) {
clientMutationId
ignoredHashtags {
...HashtagFragment
}
ignoredTags {
...TagFragment
}
story {
...StoryFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on LockedContentError {
...LockedContentErrorFragment
}
}
}
}
Variables
{"input": StoryTagInput}
Response
{
"data": {
"storyTag": {
"clientMutationId": "xyz789",
"ignoredHashtags": [Hashtag],
"ignoredTags": [Tag],
"story": Story,
"errors": [PermissionError]
}
}
}
storyTranslate
Description
Enable the translation of a story add define the language of the original content. This operation is irreversible.
Response
Returns a StoryTranslatePayload
Arguments
Name | Description |
---|---|
input - StoryTranslateInput!
|
Required Parameter for the storyTranslate Mutation |
Example
Query
mutation storyTranslate($input: StoryTranslateInput!) {
storyTranslate(input: $input) {
clientMutationId
story {
...StoryFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on LockedContentError {
...LockedContentErrorFragment
}
}
}
}
Variables
{"input": StoryTranslateInput}
Response
{
"data": {
"storyTranslate": {
"clientMutationId": "abc123",
"story": Story,
"errors": [PermissionError]
}
}
}
storyUndelete
Description
Restore a story. Restricted space (or platform) administrators.
Response
Returns a StoryUndeletePayload
Arguments
Name | Description |
---|---|
input - StoryUndeleteInput!
|
Required Parameter for the storyUndelete Mutation |
Example
Query
mutation storyUndelete($input: StoryUndeleteInput!) {
storyUndelete(input: $input) {
clientMutationId
story {
...StoryFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
}
}
}
Variables
{"input": StoryUndeleteInput}
Response
{
"data": {
"storyUndelete": {
"clientMutationId": "abc123",
"story": Story,
"errors": [PermissionError]
}
}
}
storyUnlock
Description
Release a lock on a content, indicating nobody is working on that content anymore
Response
Returns a StoryUnlockPayload
Arguments
Name | Description |
---|---|
input - StoryUnlockInput!
|
Required Parameter for the storyUnlock Mutation |
Example
Query
mutation storyUnlock($input: StoryUnlockInput!) {
storyUnlock(input: $input) {
clientMutationId
story {
...StoryFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on StoryLockError {
...StoryLockErrorFragment
}
}
}
}
Variables
{"input": StoryUnlockInput}
Response
{
"data": {
"storyUnlock": {
"clientMutationId": "xyz789",
"story": Story,
"errors": [PermissionError]
}
}
}
storyVersionDelete
Description
Delete a story Version This will delete a version from the list of version. Current limitation is that you can't delete the latest published version requires story.actions.deleteVersion
Response
Returns a StoryVersionDeletePayload
Arguments
Name | Description |
---|---|
input - StoryVersionDeleteInput!
|
Required Parameter for the storyVersionDelete Mutation |
Example
Query
mutation storyVersionDelete($input: StoryVersionDeleteInput!) {
storyVersionDelete(input: $input) {
clientMutationId
deletedId
story {
...StoryFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
... on LockedContentError {
...LockedContentErrorFragment
}
}
}
}
Variables
{"input": StoryVersionDeleteInput}
Response
{
"data": {
"storyVersionDelete": {
"clientMutationId": "abc123",
"deletedId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"story": Story,
"errors": [PermissionError]
}
}
}
storyVersionRestore
Description
Restore a Story to a given version. This will create a new version on top, and restore ALL bodies, assets, highlight, attributes, titles of that given version requires story.actions.edit
Response
Returns a StoryVersionRestorePayload
Arguments
Name | Description |
---|---|
input - StoryVersionRestoreInput!
|
Required Input for the storyVersionRestore Mutation |
Example
Query
mutation storyVersionRestore($input: StoryVersionRestoreInput!) {
storyVersionRestore(input: $input) {
clientMutationId
story {
...StoryFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on LockedContentError {
...LockedContentErrorFragment
}
}
}
}
Variables
{"input": StoryVersionRestoreInput}
Response
{
"data": {
"storyVersionRestore": {
"clientMutationId": "xyz789",
"story": Story,
"errors": [PermissionError]
}
}
}
subscriptionRemove
Description
Remove GraphQL subscription (stop listening to events)
Response
Returns a SubscriptionRemovePayload
Arguments
Name | Description |
---|---|
input - SubscriptionRemoveInput!
|
Required Parameter for the subscriptionRemove Mutation |
Example
Query
mutation subscriptionRemove($input: SubscriptionRemoveInput!) {
subscriptionRemove(input: $input) {
clientMutationId
errors {
... on InvalidInputError {
...InvalidInputErrorFragment
}
}
}
}
Variables
{"input": SubscriptionRemoveInput}
Response
{
"data": {
"subscriptionRemove": {
"clientMutationId": "abc123",
"errors": [InvalidInputError]
}
}
}
tagCreate
Description
Create a single tag in the facet facetId
.
Response
Returns a TagCreatePayload
Arguments
Name | Description |
---|---|
input - TagCreateInput!
|
Required Parameter for the tagCreate Mutation |
Example
Query
mutation tagCreate($input: TagCreateInput!) {
tagCreate(input: $input) {
clientMutationId
tag {
...TagFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": TagCreateInput}
Response
{
"data": {
"tagCreate": {
"clientMutationId": "abc123",
"tag": Tag,
"errors": [ObjectNotFoundError]
}
}
}
tagDelete
Description
Remove a tag from the facet
Response
Returns a TagDeletePayload
Arguments
Name | Description |
---|---|
input - TagDeleteInput!
|
Required Parameter for the tagDelete Mutation |
Example
Query
mutation tagDelete($input: TagDeleteInput!) {
tagDelete(input: $input) {
clientMutationId
deletedId
tag {
...TagFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
... on InUseTagMutationError {
...InUseTagMutationErrorFragment
}
}
}
}
Variables
{"input": TagDeleteInput}
Response
{
"data": {
"tagDelete": {
"clientMutationId": "abc123",
"deletedId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"tag": Tag,
"errors": [ObjectNotFoundError]
}
}
}
tagUpdate
Description
Edit a Tag
name and Facet
Response
Returns a TagUpdatePayload
Arguments
Name | Description |
---|---|
input - TagUpdateInput!
|
Required Parameter for the tagUpdate Mutation |
Example
Query
mutation tagUpdate($input: TagUpdateInput!) {
tagUpdate(input: $input) {
clientMutationId
tag {
...TagFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
... on ObjectAlreadyExistsError {
...ObjectAlreadyExistsErrorFragment
}
}
}
}
Variables
{"input": TagUpdateInput}
Response
{
"data": {
"tagUpdate": {
"clientMutationId": "xyz789",
"tag": Tag,
"errors": [ObjectNotFoundError]
}
}
}
teamCreate
Description
Create a new team this require the correct plan: InstanceLimits.teams
as well as admin rights InstanceActions.teamEdit
Response
Returns a TeamCreatePayload
Arguments
Name | Description |
---|---|
input - TeamCreateInput!
|
Required Parameter for the teamCreate Mutation |
Example
Query
mutation teamCreate($input: TeamCreateInput!) {
teamCreate(input: $input) {
clientMutationId
team {
...TeamFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
... on LimitsViolationError {
...LimitsViolationErrorFragment
}
}
}
}
Variables
{"input": TeamCreateInput}
Response
{
"data": {
"teamCreate": {
"clientMutationId": "abc123",
"team": Team,
"errors": [PermissionError]
}
}
}
teamMemberAdd
Description
Add a new member(s) to a Team
this require the correct plan: InstanceLimits.teams
as well as admin rights InstanceActions.teamEdit
Response
Returns a TeamMemberAddPayload
Arguments
Name | Description |
---|---|
input - TeamMemberAddInput!
|
Required Parameter for the teamMemberAdd Mutation |
Example
Query
mutation teamMemberAdd($input: TeamMemberAddInput!) {
teamMemberAdd(input: $input) {
clientMutationId
team {
...TeamFragment
}
users {
...UserFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
... on LimitsViolationError {
...LimitsViolationErrorFragment
}
}
}
}
Variables
{"input": TeamMemberAddInput}
Response
{
"data": {
"teamMemberAdd": {
"clientMutationId": "abc123",
"team": Team,
"users": [User],
"errors": [PermissionError]
}
}
}
teamMemberDelete
Description
Remove a TeamMember
from a Team
this require the correct plan: InstanceLimits.teams
as well as admin rights InstanceActions.teamEdit
Response
Returns a TeamMemberDeletePayload
Arguments
Name | Description |
---|---|
input - TeamMemberDeleteInput!
|
Required Parameter for the teamMemberDelete Mutation |
Example
Query
mutation teamMemberDelete($input: TeamMemberDeleteInput!) {
teamMemberDelete(input: $input) {
clientMutationId
team {
...TeamFragment
}
deletedIds
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on InvalidInputError {
...InvalidInputErrorFragment
}
... on LimitsViolationError {
...LimitsViolationErrorFragment
}
}
}
}
Variables
{"input": TeamMemberDeleteInput}
Response
{
"data": {
"teamMemberDelete": {
"clientMutationId": "xyz789",
"team": Team,
"deletedIds": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"errors": [PermissionError]
}
}
}
teamUpdate
Description
Update the specified team configuration and name this require the correct plan: InstanceLimits.teams
as well as admin rights InstanceActions.teamEdit
Response
Returns a TeamUpdatePayload
Arguments
Name | Description |
---|---|
input - TeamUpdateInput!
|
Required Parameter for the teamUpdate Mutation |
Example
Query
mutation teamUpdate($input: TeamUpdateInput!) {
teamUpdate(input: $input) {
clientMutationId
team {
...TeamFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on LimitsViolationError {
...LimitsViolationErrorFragment
}
}
}
}
Variables
{"input": TeamUpdateInput}
Response
{
"data": {
"teamUpdate": {
"clientMutationId": "xyz789",
"team": Team,
"errors": [PermissionError]
}
}
}
teamsDelete
Description
Delete the specified teams this require the correct plan: InstanceLimits.teams
as well as admin rights InstanceActions.teamEdit
Response
Returns a TeamsDeletePayload
Arguments
Name | Description |
---|---|
input - TeamsDeleteInput!
|
Required Parameter for the teamsDelete Mutation |
Example
Query
mutation teamsDelete($input: TeamsDeleteInput!) {
teamsDelete(input: $input) {
clientMutationId
deletedIds
instance {
...InstanceFragment
}
errors {
... on PermissionError {
...PermissionErrorFragment
}
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on LimitsViolationError {
...LimitsViolationErrorFragment
}
}
}
}
Variables
{"input": TeamsDeleteInput}
Response
{
"data": {
"teamsDelete": {
"clientMutationId": "abc123",
"deletedIds": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"instance": Instance,
"errors": [PermissionError]
}
}
}
userCover
Description
Update the cover of a user profile.
Response
Returns a UserCoverPayload
Arguments
Name | Description |
---|---|
input - UserCoverInput!
|
The input parameters for updating a user's cover photo. |
Example
Query
mutation userCover($input: UserCoverInput!) {
userCover(input: $input) {
clientMutationId
user {
...UserFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": UserCoverInput}
Response
{
"data": {
"userCover": {
"clientMutationId": "abc123",
"user": User,
"errors": [ObjectNotFoundError]
}
}
}
userEdit
Description
Edit user profile information. (email, name, etc.)
Response
Returns a UserEditPayload
Arguments
Name | Description |
---|---|
input - UserEditInput!
|
The input parameters for editing user profile information. |
Example
Query
mutation userEdit($input: UserEditInput!) {
userEdit(input: $input) {
clientMutationId
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
... on AttributeError {
...AttributeErrorFragment
}
}
user {
...UserFragment
}
}
}
Variables
{"input": UserEditInput}
Response
{
"data": {
"userEdit": {
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError],
"user": User
}
}
}
userFollow
Description
Follow another user. deprecated
Response
Returns a UserFollowPayload
Arguments
Name | Description |
---|---|
input - UserFollowInput!
|
The input parameters for following another user. |
Example
Query
mutation userFollow($input: UserFollowInput!) {
userFollow(input: $input) {
clientMutationId
user {
...UserFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": UserFollowInput}
Response
{
"data": {
"userFollow": {
"clientMutationId": "xyz789",
"user": User,
"errors": [ObjectNotFoundError]
}
}
}
userPhoto
Description
Upload a photo for a user profile.
Response
Returns a UserPhotoPayload
Arguments
Name | Description |
---|---|
input - UserPhotoInput!
|
The input parameters for uploading a user's photo. |
Example
Query
mutation userPhoto($input: UserPhotoInput!) {
userPhoto(input: $input) {
clientMutationId
user {
...UserFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
}
}
}
Variables
{"input": UserPhotoInput}
Response
{
"data": {
"userPhoto": {
"clientMutationId": "abc123",
"user": User,
"errors": [ObjectNotFoundError]
}
}
}
userRegister
Description
Register a new user with a registration token received by email or via an URL link sent by an administrator. The user is already known but needs to be confirmed and configured.
@see userSignup
Response
Returns a UserRegisterPayload
Arguments
Name | Description |
---|---|
input - UserRegisterInput!
|
The input parameters for registering a new user. |
Example
Query
mutation userRegister($input: UserRegisterInput!) {
userRegister(input: $input) {
clientMutationId
user {
...UserFragment
}
errors {
... on InvalidInputError {
...InvalidInputErrorFragment
}
... on InvalidPasswordError {
...InvalidPasswordErrorFragment
}
}
}
}
Variables
{"input": UserRegisterInput}
Response
{
"data": {
"userRegister": {
"clientMutationId": "xyz789",
"user": User,
"errors": [InvalidInputError]
}
}
}
userSignup
Description
Sign up a new user with a registration token received by email if the platform is in "self service" mode where accounts are not pre configured @see userRegister
Response
Returns a UserSignupPayload
Arguments
Name | Description |
---|---|
input - UserSignupInput!
|
The input parameters for signing up a new user. |
Example
Query
mutation userSignup($input: UserSignupInput!) {
userSignup(input: $input) {
clientMutationId
user {
...UserFragment
}
errors {
... on InvalidInputError {
...InvalidInputErrorFragment
}
... on InvalidPasswordError {
...InvalidPasswordErrorFragment
}
}
}
}
Variables
{"input": UserSignupInput}
Response
{
"data": {
"userSignup": {
"clientMutationId": "xyz789",
"user": User,
"errors": [InvalidInputError]
}
}
}
userSuccessions
Description
Create, update or delete user succession for one or multiple spaces
Response
Returns a UserSuccessionsPayload
Arguments
Name | Description |
---|---|
input - UserSuccessionsInput!
|
Required Parameter for the userSuccessions Mutation |
Example
Query
mutation userSuccessions($input: UserSuccessionsInput!) {
userSuccessions(input: $input) {
clientMutationId
fromUser {
...UserFragment
}
errors {
... on ObjectNotFoundError {
...ObjectNotFoundErrorFragment
}
... on PermissionError {
...PermissionErrorFragment
}
... on LimitsViolationError {
...LimitsViolationErrorFragment
}
}
}
}
Variables
{"input": UserSuccessionsInput}
Response
{
"data": {
"userSuccessions": {
"clientMutationId": "abc123",
"fromUser": User,
"errors": [ObjectNotFoundError]
}
}
}
Subscriptions
annotationAdded
Description
Subscription about Annotation
beeing added on the a given Story
Response
Returns an AnnotationAddedPayload
Arguments
Name | Description |
---|---|
input - AnnotationAddedInput!
|
Required Parameter for the annotationAdded Subscription |
Example
Query
subscription annotationAdded($input: AnnotationAddedInput!) {
annotationAdded(input: $input) {
clientSubscriptionId
annotationEdge {
...AnnotationEdgeFragment
}
story {
...StoryFragment
}
}
}
Variables
{"input": AnnotationAddedInput}
Response
{
"data": {
"annotationAdded": {
"clientSubscriptionId": "abc123",
"annotationEdge": AnnotationEdge,
"story": Story
}
}
}
annotationCommentAdded
Description
Subscription about AnnotationComment
beeing added to the given Annotation
Response
Returns an AnnotationCommentAddedPayload
Arguments
Name | Description |
---|---|
input - AnnotationCommentAddedInput!
|
Required Input for the annotationCommentAdded Subscription |
Example
Query
subscription annotationCommentAdded($input: AnnotationCommentAddedInput!) {
annotationCommentAdded(input: $input) {
clientSubscriptionId
annotationCommentEdge {
...AnnotationCommentEdgeFragment
}
story {
...StoryFragment
}
}
}
Variables
{"input": AnnotationCommentAddedInput}
Response
{
"data": {
"annotationCommentAdded": {
"clientSubscriptionId": "xyz789",
"annotationCommentEdge": AnnotationCommentEdge,
"story": Story
}
}
}
annotationCommentDeleted
Description
Subscription about AnnotationComment
beeing deleted on a given Annotation
Response
Returns an AnnotationCommentDeletedPayload
Arguments
Name | Description |
---|---|
input - AnnotationCommentDeletedInput!
|
Required Input for the annotationCommentDeleted Subscription |
Example
Query
subscription annotationCommentDeleted($input: AnnotationCommentDeletedInput!) {
annotationCommentDeleted(input: $input) {
clientSubscriptionId
annotation {
...AnnotationFragment
}
annotationCommentId
}
}
Variables
{"input": AnnotationCommentDeletedInput}
Response
{
"data": {
"annotationCommentDeleted": {
"clientSubscriptionId": "abc123",
"annotation": Annotation,
"annotationCommentId": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}
}
}
annotationCommentEdited
Description
Subscription about AnnotationComment
beeing edited (~comment) on a given Annotation
Response
Returns an AnnotationCommentEditedPayload
Arguments
Name | Description |
---|---|
input - AnnotationCommentEditedInput!
|
Required Input for the annotationCommentEdited Subscription |
Example
Query
subscription annotationCommentEdited($input: AnnotationCommentEditedInput!) {
annotationCommentEdited(input: $input) {
clientSubscriptionId
annotationCommentEdge {
...AnnotationCommentEdgeFragment
}
annotationComment {
...AnnotationCommentFragment
}
story {
...StoryFragment
}
}
}
Variables
{"input": AnnotationCommentEditedInput}
Response
{
"data": {
"annotationCommentEdited": {
"clientSubscriptionId": "abc123",
"annotationCommentEdge": AnnotationCommentEdge,
"annotationComment": AnnotationComment,
"story": Story
}
}
}
annotationEdited
Description
Subscription about Annotation
beeing edited (change status, comment changed, ...) on the a given Story
Response
Returns an AnnotationEditedPayload
Arguments
Name | Description |
---|---|
input - AnnotationEditedInput!
|
Required Parameter for the annotationEdited Subscription |
Example
Query
subscription annotationEdited($input: AnnotationEditedInput!) {
annotationEdited(input: $input) {
clientSubscriptionId
annotationEdge {
...AnnotationEdgeFragment
}
annotation {
...AnnotationFragment
}
story {
...StoryFragment
}
}
}
Variables
{"input": AnnotationEditedInput}
Response
{
"data": {
"annotationEdited": {
"clientSubscriptionId": "xyz789",
"annotationEdge": AnnotationEdge,
"annotation": Annotation,
"story": Story
}
}
}
commentAdded
Description
Subscription about Comment
beeing added on a given Story
Response
Returns a CommentAddedPayload
Arguments
Name | Description |
---|---|
input - CommentAddedInput!
|
Required Parameter for the commentAdded Subscription |
Example
Query
subscription commentAdded($input: CommentAddedInput!) {
commentAdded(input: $input) {
clientSubscriptionId
commentEdge {
...CommentEdgeFragment
}
parent {
...StoryFragment
}
}
}
Variables
{"input": CommentAddedInput}
Response
{
"data": {
"commentAdded": {
"clientSubscriptionId": "abc123",
"commentEdge": CommentEdge,
"parent": Story
}
}
}
commentDeleted
Description
Subscribe to deletion of a comment
Response
Returns a CommentDeletedPayload
Arguments
Name | Description |
---|---|
input - CommentDeletedInput!
|
Required Parameter for the commentDeleted Subscription |
Example
Query
subscription commentDeleted($input: CommentDeletedInput!) {
commentDeleted(input: $input) {
clientSubscriptionId
error
id
parent {
...StoryFragment
}
}
}
Variables
{"input": CommentDeletedInput}
Response
{
"data": {
"commentDeleted": {
"clientSubscriptionId": "xyz789",
"error": "xyz789",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"parent": Story
}
}
}
commentEdited
Description
Subscribe to modifications done to a given comment's body or attachments
Response
Returns a CommentEditedPayload
Arguments
Name | Description |
---|---|
input - CommentEditedInput!
|
Required Parameter for the commentEdited Subscription |
Example
Query
subscription commentEdited($input: CommentEditedInput!) {
commentEdited(input: $input) {
clientSubscriptionId
comment {
...CommentFragment
}
}
}
Variables
{"input": CommentEditedInput}
Response
{
"data": {
"commentEdited": {
"clientSubscriptionId": "abc123",
"comment": Comment
}
}
}
contentLiked
Description
Subscribe when a single content is Liked or Unliked
Response
Returns a ContentLikedPayload
Arguments
Name | Description |
---|---|
input - ContentLikedInput!
|
Required Parameter for the contentLiked Subscription |
Example
Query
subscription contentLiked($input: ContentLikedInput!) {
contentLiked(input: $input) {
clientSubscriptionId
parent {
...NodeFragment
}
userEdge {
...UserEdgeFragment
}
}
}
Variables
{"input": ContentLikedInput}
Response
{
"data": {
"contentLiked": {
"clientSubscriptionId": "xyz789",
"parent": Node,
"userEdge": UserEdge
}
}
}
notificationAdded
Description
Subscribe to Newly added notifications of the current user
Response
Returns a NotificationAddedPayload
Arguments
Name | Description |
---|---|
input - NotificationAddedInput!
|
Required Parameter for the notificationAdded Subscription |
Example
Query
subscription notificationAdded($input: NotificationAddedInput!) {
notificationAdded(input: $input) {
clientSubscriptionId
me {
...MeFragment
}
notificationEdge {
...NotificationEdgeFragment
}
}
}
Variables
{"input": NotificationAddedInput}
Response
{
"data": {
"notificationAdded": {
"clientSubscriptionId": "abc123",
"me": Me,
"notificationEdge": NotificationEdge
}
}
}
notificationCount
Description
Subscribe to the changed of count of unread notifications of the current user
Response
Returns a NotificationCountPayload
Arguments
Name | Description |
---|---|
input - NotificationCountInput!
|
Required Parameter for the notificationCount Subscription |
Example
Query
subscription notificationCount($input: NotificationCountInput!) {
notificationCount(input: $input) {
clientSubscriptionId
me {
...MeFragment
}
}
}
Variables
{"input": NotificationCountInput}
Response
{
"data": {
"notificationCount": {
"clientSubscriptionId": "abc123",
"me": Me
}
}
}
notificationUpdated
Description
Subscribe to update of the user's single notification (reading status, ...)
Response
Returns a NotificationUpdatedPayload
Arguments
Name | Description |
---|---|
input - NotificationUpdatedInput!
|
Required Input for the notificationUpdated Subscription |
Example
Query
subscription notificationUpdated($input: NotificationUpdatedInput!) {
notificationUpdated(input: $input) {
clientSubscriptionId
me {
...MeFragment
}
notification {
...NotificationFragment
}
}
}
Variables
{"input": NotificationUpdatedInput}
Response
{
"data": {
"notificationUpdated": {
"clientSubscriptionId": "xyz789",
"me": Me,
"notification": Notification
}
}
}
onboardingStepCompleted
Description
Subscription to Instance to get an updated onboardingCompletedSteps and onboardingCompleted
Response
Returns an OnboardingStepCompletedPayload
Arguments
Name | Description |
---|---|
input - OnboardingStepCompletedInput!
|
Required Input for the onboardingStepCompleted Subscription |
Example
Query
subscription onboardingStepCompleted($input: OnboardingStepCompletedInput!) {
onboardingStepCompleted(input: $input) {
clientSubscriptionId
instance {
...InstanceFragment
}
}
}
Variables
{"input": OnboardingStepCompletedInput}
Response
{
"data": {
"onboardingStepCompleted": {
"clientSubscriptionId": "abc123",
"instance": Instance
}
}
}
storyAlertAdded
Description
Subscription to new enabled user side StoryAlerts.
Response
Returns a StoryAlertAddedPayload
Arguments
Name | Description |
---|---|
input - StoryAlertAddedInput!
|
Required Parameter for the storyAlertAdded Subscription |
Example
Query
subscription storyAlertAdded($input: StoryAlertAddedInput!) {
storyAlertAdded(input: $input) {
clientSubscriptionId
me {
...MeFragment
}
storyAlertEdge {
...StoryAlertEdgeFragment
}
}
}
Variables
{"input": StoryAlertAddedInput}
Response
{
"data": {
"storyAlertAdded": {
"clientSubscriptionId": "abc123",
"me": Me,
"storyAlertEdge": StoryAlertEdge
}
}
}
storyAlertUpdated
Description
Subscription to archived or marked as read StoryAlerts.
Response
Returns a StoryAlertUpdatedPayload
Arguments
Name | Description |
---|---|
input - StoryAlertUpdatedInput!
|
Required Parameter for the storyAlertUpdated Subscription |
Example
Query
subscription storyAlertUpdated($input: StoryAlertUpdatedInput!) {
storyAlertUpdated(input: $input) {
clientSubscriptionId
me {
...MeFragment
}
storyAlert {
...StoryAlertFragment
}
}
}
Variables
{"input": StoryAlertUpdatedInput}
Response
{
"data": {
"storyAlertUpdated": {
"clientSubscriptionId": "abc123",
"me": Me,
"storyAlert": StoryAlert
}
}
}
storyLocked
Description
Subscribe to Locking and unlocking of a Story
This is usually used to avoid multiple users editing the same content at the same time
Response
Returns a StoryLockedPayload
Arguments
Name | Description |
---|---|
input - StoryLockedInput!
|
Required Parameter for the storyLocked Subscription |
Example
Query
subscription storyLocked($input: StoryLockedInput!) {
storyLocked(input: $input) {
clientSubscriptionId
story {
...StoryFragment
}
lock {
...StoryLockFragment
}
}
}
Variables
{"input": StoryLockedInput}
Response
{
"data": {
"storyLocked": {
"clientSubscriptionId": "abc123",
"story": Story,
"lock": StoryLock
}
}
}
storyUpdated
Description
Subscription to Story edition. When a story recieve a new version.
Response
Returns a StoryUpdatedPayload
Arguments
Name | Description |
---|---|
input - StoryUpdatedInput!
|
Required Parameter for the storyUpdated Subscription |
Example
Query
subscription storyUpdated($input: StoryUpdatedInput!) {
storyUpdated(input: $input) {
clientSubscriptionId
story {
...StoryFragment
}
}
}
Variables
{"input": StoryUpdatedInput}
Response
{
"data": {
"storyUpdated": {
"clientSubscriptionId": "abc123",
"story": Story
}
}
}
userPresenceUpdated
Description
Subscribe to presence of a user on a given product (mobile, web, ...)
Response
Returns a UserPresenceUpdatedPayload
Arguments
Name | Description |
---|---|
input - UserPresenceUpdatedInput!
|
Required Input for the userPresenceUpdated Subscription |
Example
Query
subscription userPresenceUpdated($input: UserPresenceUpdatedInput!) {
userPresenceUpdated(input: $input) {
clientSubscriptionId
user {
...UserFragment
}
}
}
Variables
{"input": UserPresenceUpdatedInput}
Response
{
"data": {
"userPresenceUpdated": {
"clientSubscriptionId": "abc123",
"user": User
}
}
}
Types
ActiveContentItem
ActiveContentTableResult
Description
Results of Stat report of activity by contents ( Story
) Mimic the connection working type without beeing one see ActiveContentItem
Fields
Field Name | Description |
---|---|
endCursor - String
|
When paginating forwards, the cursor to continue. |
hasNextPage - Boolean
|
When paginating forwards, are there more items? |
nodes - [ActiveContentItem!]
|
A list of nodes. |
Example
{
"endCursor": "abc123",
"hasNextPage": false,
"nodes": [ActiveContentItem]
}
ActiveSpaceItem
Description
List of activity stats by space
Fields
Field Name | Description |
---|---|
space - Space
|
The referenced space |
stats - JSON
|
Different stats info about the space on a given period. Possible keys are likes(number of likes), comments(number of comments), views(number of views), unique_views(unique number of user that did a vie), posts(number of posts), publications(number of publications), updates(number of silent + new version), reshares(number of reshares), drafts(number of pending drafts) |
Example
{"space": Space, "stats": {}}
ActiveSpaceTableResult
Description
Results of Stat report of activity by space Mimic the connection working type without beeing one see ActiveSpaceItem
Fields
Field Name | Description |
---|---|
endCursor - String
|
When paginating forwards, the cursor to continue. |
hasNextPage - Boolean
|
When paginating forwards, are there more items? |
nodes - [ActiveSpaceItem!]
|
A list of nodes. |
Example
{
"endCursor": "abc123",
"hasNextPage": true,
"nodes": [ActiveSpaceItem]
}
ActiveUserEdge
Description
An edge in a connection.
Fields
Field Name | Description |
---|---|
cursor - String!
|
A cursor for use in pagination. |
node - ActiveUserItem!
|
The item at the end of the edge. |
Example
{
"cursor": "xyz789",
"node": ActiveUserItem
}
ActiveUserItem
Activity
Description
An activity event on the platform made by a user as displayed in the activity feed
Fields
Field Name | Description |
---|---|
created - IsoDateTime!
|
The time the action was initiated |
type - ActivityType!
|
Type of activity |
user - User
|
The user who initiated the event |
space - Space
|
The space associated with the activity event |
Possible Types
Activity Types |
---|
Example
{
"created": "2016-10-07T01:08:03.420Z",
"type": "SPACE_JOIN",
"user": User,
"space": Space
}
ActivityConnection
Description
List of results of Activity
Fields
Field Name | Description |
---|---|
edges - [ActivityEdge!]
|
A list of edges. |
pageInfo - PageInfo!
|
Information to aid in pagination. |
Example
{
"edges": [ActivityEdge],
"pageInfo": PageInfo
}
ActivityDigestOpenResult
Description
Statistics about the Emails sent by the platform
Fields
Field Name | Description |
---|---|
data - TimeSeries
|
Data limited to the filter defined by the above query. results are given as date, count datapoint in data field |
Example
{"data": [["2020-08-01T00:00:00Z", 12], ["2020-08-02T00:00:00Z", 13]]}
ActivityEdge
ActivityFeedItem
Description
One Story Item in an ActivityFeed old Style (react to comments & ...)
Fields
Field Name | Description |
---|---|
id - ID!
|
ID of the object. |
item - Story
|
The Story item in the feed |
published - IsoDateTime!
|
Date at which the item was created |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"item": Story,
"published": "2016-10-07T01:08:03.420Z"
}
ActivityFeedItemConnection
Description
List of results of ActivityFeedItem
Fields
Field Name | Description |
---|---|
edges - [ActivityFeedItemEdge!]
|
A list of edges. |
pageInfo - PageInfo!
|
Information to aid in pagination. |
Example
{
"edges": [ActivityFeedItemEdge],
"pageInfo": PageInfo
}
ActivityFeedItemEdge
Description
An edge in a connection.
Fields
Field Name | Description |
---|---|
cursor - String!
|
A cursor for use in pagination. |
node - ActivityFeedItem!
|
The item at the end of the edge. |
Example
{
"cursor": "xyz789",
"node": ActivityFeedItem
}
ActivityTab
Description
A SpaceTab is a sub-level navigation for a space. This provides a filtered / formated view of the contents in the space.
Fields
Field Name | Description |
---|---|
icon - OpaqueID
|
Icon representing the tab |
id - ID!
|
ID of the object. |
label - String!
|
The label of the tab for the current user's lang. |
labels - TranslatedString!
|
Translated names of the tab. |
slug - String!
|
Short human representation of the tab. |
Example
{
"icon": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"label": "abc123",
"labels": {"en": "a Name", "fr": "Un Nom"},
"slug": "xyz789"
}
ActivityType
Description
Type of activities recorded on the platform
Values
Enum Value | Description |
---|---|
|
A user join a Space |
|
A user leaves a Space |
|
A Like is added to a comment of a status |
|
A new comment is added to a status |
|
A new status is added |
|
A status is like |
|
A user archive a story |
|
A user change the owner of a story |
|
A like is added to a comment of a story |
|
A new comment is added to a post |
|
A new invitation to an event is sent |
|
A user was invited to contribute to a story |
|
A story is liked |
|
A user publish a story |
|
A user published a new version of a reshare of a story |
|
A user reshared a story |
|
A user restore a story |
|
A Story draft is saved |
|
A Story version is published |
|
A Story version is reshared |
|
User follow a user unused |
|
A user inherit contents from another user |
Example
"SPACE_JOIN"
AddressAttributeInput
Description
Input type for representing address Attribute
Example
{
"city": "xyz789",
"country": "abc123",
"extra": "xyz789",
"postCode": "xyz789",
"region": "xyz789",
"street": "xyz789"
}
AddressValue
Description
Type representing an address with various attributes.
Example
{
"city": "abc123",
"country": "xyz789",
"extra": "xyz789",
"postCode": "xyz789",
"region": "abc123",
"street": "xyz789"
}
AgendaBox
Alert
Description
An Alert is a configuration of a 'saved search' This can be used to export as an Atom(Rss) feed or be sent by email on schedule.
Fields
Field Name | Description |
---|---|
actions - AlertActions!
|
Indicate the list of actions available to the current user on this Object |
atomFeed - URL!
|
Atom feed of the contents of the alert |
description - String
|
Description text of the Alert filter |
hour - Int!
|
Hour scheduled for the alert sending (0 to 23) |
id - ID!
|
ID of the object. |
monthDays - [Int!]!
|
Day of the month scheduled for the alert sending (1 to 31) |
shared - Boolean!
|
Is the alert shared with multiple users Once shared, the alert but be edited via Admin only |
timezone - LegacyTimezone
|
Timezone at which the the alert is sent following hour field. Legacy format. Use timezoneKey instead
|
timezoneKey - Timezone
|
Timezone at which the the alert is sent following hour field. |
title - String
|
Title of the alert for organisational purpose |
weekDays - [Int!]!
|
Day of the week scheduled for the alert sending (1 to 7) |
owners - [User!]!
|
Criteria of the alert: Owner of the contents |
hashtags - [Hashtag!]!
|
Criteria of the alert: Hashtag of the contents |
tags - [Tag!]!
|
Criteria of the alert: Tags of the contents |
schemas - [StorySchema!]!
|
Criteria of the alert: StorySchema of the contents |
subtypes - [SubtypeResult!]!
|
Criteria of the alert: Subtype of the contents more or less deprecated |
spaces - [Space!]!
|
Criteria of the alert: Spaces of the contents |
query - String
|
Criteria of the alert: Query string of the search |
users - [User!]!
|
Criteria of the alert: Owner of the contents |
langs - [Lang!]!
|
Criteria of the alert: Lang of the contents |
facets - [Facet!]!
|
Criteria of the alert: Facets of the contents |
rsvps - [Rsvp!]!
|
Criteria of the alert: RSVP of the contents |
filters - [StorySearchFilter!]!
|
Criteria of the alert: search filters |
meSubscription - AlertSubscription
|
AlertSubscription for the current user on this Alert.
|
subscription - AlertSubscription
|
Deprecated, see meSubscription Use meSubscription instead
|
subscribers - AlertSubscriberConnection
|
List of Those are the explicit subscribers to the alert, either a The totalCount will then be the number of needs |
Arguments
|
|
subscriptions - AlertSubscriptionConnection
|
List of One The totalCount will then be the number of unique recipients of this needs |
Arguments
|
Example
{
"actions": AlertActions,
"atomFeed": "http://www.test.com/",
"description": "abc123",
"hour": 987,
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"monthDays": [987],
"shared": false,
"timezone": LegacyTimezone,
"timezoneKey": Timezone,
"title": "xyz789",
"weekDays": [123],
"owners": [User],
"hashtags": [Hashtag],
"tags": [Tag],
"schemas": [StorySchema],
"subtypes": [SubtypeResult],
"spaces": [Space],
"query": "abc123",
"users": [User],
"langs": ["fr"],
"facets": [Facet],
"rsvps": ["INVITED"],
"filters": ["ARCHIVED"],
"meSubscription": AlertSubscription,
"subscription": AlertSubscription,
"subscribers": AlertSubscriberConnection,
"subscriptions": AlertSubscriptionConnection
}
AlertActions
Description
Actions the user is allowed to do on the related Alert
Fields
Field Name | Description |
---|---|
delete - Boolean!
|
Delete the Alert required for alertDelete mutation |
edit - Boolean!
|
Edit the alert, title, schedule (but not subscribers) required for alertEdit mutation. |
manage - Boolean!
|
Manage the subscribers list (only for shared Alert ) required for Alert.subscribers and Alert.subscriptions resolvers. |
Example
{"delete": true, "edit": false, "manage": true}
AlertConnection
Description
List of results of Alert
Fields
Field Name | Description |
---|---|
edges - [AlertEdge!]
|
A list of edges. |
pageInfo - PageInfo!
|
Information to aid in pagination. |
totalCount - Int!
|
Identifies the total count of items in the connection. |
Example
{
"edges": [AlertEdge],
"pageInfo": PageInfo,
"totalCount": 987
}
AlertCreateErrors
Description
Error Type of the alertCreate
Mutation
Types
Union Types |
---|
Example
InvalidInputError
AlertCreateInput
Description
Input type for Mutation alertCreate
Fields
Input Field | Description |
---|---|
description - String
|
Description of the alert usage |
hour - Int!
|
Default configuration of sending schedule, hour (0-23) |
monthDays - [Int!]!
|
Default configuration of sending schedule, day of the month (1-31) |
query - StorySearchQuery!
|
Search Query of the alert all content matching the criterons will be notified in the alert |
timezone - Timezone
|
Timezone to evaluate the default sending schedule |
title - String!
|
Title of the alert |
weekDays - [Int!]!
|
Default configuration of sending schedule, days of the week (1-7) |
isShared - Boolean
|
Is Alert used as shared alert only sysadmins can create sharedAlerts |
subscriberIds - [ID!]!
|
Add subscribers to the alert, for shared alerts only Subscribers can be a User , a Team . Default = [] |
Example
{
"description": "xyz789",
"hour": 987,
"monthDays": [987],
"query": StorySearchQuery,
"timezone": Timezone,
"title": "xyz789",
"weekDays": [123],
"isShared": true,
"subscriberIds": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
]
}
AlertCreatePayload
Description
Return Type of Mutation alertCreate
Fields
Field Name | Description |
---|---|
alert - Alert
|
Newly created Alert |
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
me - Me
|
The current user |
errors - [AlertCreateErrors!]
|
Errors of the mutation. |
Example
{
"alert": Alert,
"clientMutationId": "xyz789",
"me": Me,
"errors": [InvalidInputError]
}
AlertDeleteErrors
Description
Error Type of the alertDelete
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
AlertDeleteInput
Description
Input type for Mutation alertDelete
Fields
Input Field | Description |
---|---|
ids - [ID!]!
|
List of Global Node IDs of the alerts to delete. Default = [] |
Example
{"ids": ["eWVhaCByaWdodCBpdCdzIGI2NA=="]}
AlertDeletePayload
Description
Return Type of Mutation alertDelete
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
me - Me
|
The current user |
deletedIds - [ID!]
|
Global Node ID of the deleted alert |
errors - [AlertDeleteErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"me": Me,
"deletedIds": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"errors": [ObjectNotFoundError]
}
AlertEdge
AlertEditErrors
Description
Error Type of the alertEdit
Mutation
Types
Union Types |
---|
Example
PermissionError
AlertEditInput
Description
Input type for Mutation alertEdit
Fields
Input Field | Description |
---|---|
description - String
|
Description of the alert usage |
hour - Int
|
Default configuration of sending schedule, hour (0-23) |
id - ID!
|
Global Node ID of the alert to delete |
monthDays - [Int!]
|
Default configuration of sending schedule, day of the month (1-31) |
timezone - Timezone
|
Timezone to evaluate the default sending schedule |
title - String
|
Title of the alert |
weekDays - [Int!]
|
Default configuration of sending schedule, days of the week (1-7) |
toShared - Boolean
|
Convert the alert to a shared alert Only possible for sysadmins shared alerts can be edited by sysadmin only |
Example
{
"description": "abc123",
"hour": 123,
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"monthDays": [987],
"timezone": Timezone,
"title": "abc123",
"weekDays": [987],
"toShared": true
}
AlertEditPayload
Description
Return Type of Mutation alertEdit
Fields
Field Name | Description |
---|---|
alert - Alert
|
Edited Alert |
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [AlertEditErrors!]
|
Errors of the mutation. |
Example
{
"alert": Alert,
"clientMutationId": "xyz789",
"errors": [PermissionError]
}
AlertOrderBy
Description
Ordering Options for Shared AlertConnection
Values
Enum Value | Description |
---|---|
|
Order by Title of the alert |
|
Order by description of the alert |
|
Order by Hour of sending the alert |
|
Order by the number of recipients |
Example
"TITLE"
AlertSubscriber
Description
A subscriber to an Alert
An Alert
has a list of subscribers, either a User
or a Team
(represented by AlertSubscriberMember
union) This list is what defines the recipients list. When sending the alert, teams will be expanded to include their members.
To retrieve the actual list of unique User
see Alert.subscriptions
Fields
Field Name | Description |
---|---|
id - ID!
|
ID of the object. |
member - AlertSubscriberMember
|
The user or team who is subscribed to the alert |
added - IsoDateTime!
|
The date and time when the member was added to the alert |
subscription - AlertSubscription
|
The AlertSubscription for this member (only User members have an AlertSubscription , otherwise this is null) |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"member": User,
"added": "2016-10-07T01:08:03.420Z",
"subscription": AlertSubscription
}
AlertSubscriberAddErrors
Description
Error Type of the alertSubscriberAdd
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
AlertSubscriberAddInput
Description
Input type for Mutation alertSubscriberAdd
Fields
Input Field | Description |
---|---|
id - ID!
|
Global Node ID of the Alert you want to add subscribers to |
subscriberIds - [ID!]
|
Global ID of the subscriber to add. ID can be an id of a User , Team or a Space (if it's a space, all member of that space will be added as subscribers) |
everyone - Boolean
|
Add Every enabled user to the alert (either subscriberIds or everyone should be provided) |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"subscriberIds": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"everyone": true
}
AlertSubscriberAddPayload
Description
Return Type of Mutation alertSubscriberAdd
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
subscribers - [AlertSubscriber!]
|
The newly added subscribers Note: if background is true, this list will be empty or partial |
background - Boolean
|
When adding a lot of subscribers (adding a Space for example), we will process the addition in background, thus not return the new subscribers directly this field indicate if the process is done in background, if true then subscribers will be none or partial |
errors - [AlertSubscriberAddErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "abc123",
"subscribers": [AlertSubscriber],
"background": true,
"errors": [ObjectNotFoundError]
}
AlertSubscriberConnection
Description
List of results of AlertSubscriber
Fields
Field Name | Description |
---|---|
edges - [AlertSubscriberEdge!]
|
A list of edges. |
pageInfo - PageInfo!
|
Information to aid in pagination. |
totalCount - Int!
|
Identifies the total count of items in the connection. |
Example
{
"edges": [AlertSubscriberEdge],
"pageInfo": PageInfo,
"totalCount": 123
}
AlertSubscriberEdge
Description
An edge in a connection.
Fields
Field Name | Description |
---|---|
cursor - String!
|
A cursor for use in pagination. |
node - AlertSubscriber!
|
The item at the end of the edge. |
Example
{
"cursor": "xyz789",
"node": AlertSubscriber
}
AlertSubscriberMember
AlertSubscriberRemoveErrors
Description
Error Type of the alertSubscriberRemove
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
AlertSubscriberRemoveInput
Description
Input type for Mutation alertSubscriberRemove
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"subscriberIds": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
]
}
AlertSubscriberRemovePayload
Description
Return Type of Mutation alertSubscriberRemove
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
deletedIds - [ID!]
|
The deleted AlertSubscriber IDs |
errors - [AlertSubscriberRemoveErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "abc123",
"deletedIds": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"errors": [ObjectNotFoundError]
}
AlertSubscription
Description
User
-specific settings on an Alert
While an Alert
is defined by its list of AlertSubscriber
, this object represents each unique User
preferences related to this alert, and so exists also for users subscribed through a Team
even if not explicitely subscribed via an AlertSubscriber
Fields
Field Name | Description |
---|---|
id - ID!
|
ID of the object. |
user - User
|
The user who is subscribed to the alert |
added - IsoDateTime!
|
Timestamp of earliest alert subscription |
viaTeams - Boolean!
|
Timestamp of earliest alert subscription |
customized - Boolean!
|
Whether this subscription overrides the default settings of the alert When true, one of hour, monthDays, weekDays will be non-null |
hour - Int
|
Hour of sending / evaluation of the alert When null, the Alert default is used |
monthDays - [Int!]
|
Days of the month when the alert is evaluated for the user (1-31) When null, the Alert default is used |
weekDays - [Int!]
|
Days of the week when the alert is evaluated for the user(1-7) When null, the Alert default is used |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"user": User,
"added": "2016-10-07T01:08:03.420Z",
"viaTeams": true,
"customized": true,
"hour": 123,
"monthDays": [987],
"weekDays": [987]
}
AlertSubscriptionConnection
Description
List of results of AlertSubscription
Fields
Field Name | Description |
---|---|
edges - [AlertSubscriptionEdge!]
|
A list of edges. |
pageInfo - PageInfo!
|
Information to aid in pagination. |
totalCount - Int!
|
Identifies the total count of items in the connection. |
Example
{
"edges": [AlertSubscriptionEdge],
"pageInfo": PageInfo,
"totalCount": 987
}
AlertSubscriptionEdge
Description
An edge in a connection.
Fields
Field Name | Description |
---|---|
cursor - String!
|
A cursor for use in pagination. |
node - AlertSubscription!
|
The item at the end of the edge. |
Example
{
"cursor": "xyz789",
"node": AlertSubscription
}
AlertSubscriptionErrors
Description
Error Type of the alertSubscription
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
AlertSubscriptionInput
Description
Input type for Mutation alertSubscription
Fields
Input Field | Description |
---|---|
hour - Int
|
Hour of sending / evaluation of the alert |
monthDays - [Int!]
|
Days of the month when the alert is evaluated for the user (1-31) |
id - ID!
|
Global Node ID of the Alert you want to customise subscription |
weekDays - [Int!]
|
Days of the week when the alert is evaluated for the user(1-7) |
Example
{
"hour": 123,
"monthDays": [123],
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"weekDays": [123]
}
AlertSubscriptionPayload
Description
Return Type of Mutation alertSubscription
Fields
Field Name | Description |
---|---|
alert - Alert
|
The resulting Alert |
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [AlertSubscriptionErrors!]
|
Errors of the mutation. |
Example
{
"alert": Alert,
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError]
}
AnalyticsSignal
Description
Type of the signal to send to record user's activity on the platform.
Values
Enum Value | Description |
---|---|
|
Correspond to a partial view, displayed amongst other content (like in a feed) no longer tracked |
|
Correspond to a full Content view. The user is looking at a single content item |
Example
"IMPRESSION"
AnalyticsSignalInput
Description
Input type for Mutation analyticsSignal
Fields
Input Field | Description |
---|---|
device - UserDevice
|
Device used to read/view the related content this will overide the detected value |
signal - AnalyticsSignal!
|
Type of "view" made by the user |
stories - [ID!]
|
List of content displayed |
Example
{
"device": "MOBILE",
"signal": "IMPRESSION",
"stories": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
]
}
AnalyticsSignalPayload
Annotation
Description
Annotation of the Story. An Annotation can be used to comment, suggest or react to content of a story
Fields
Field Name | Description |
---|---|
actions - AnnotationActions!
|
Indicate the list of actions available to the current user on this Object |
id - ID!
|
ID of the object. |
story - Story!
|
The annotated content |
lang - Lang
|
Lang of the annotated version of the story |
anchor - String!
|
Referenced Slate block UUID |
status - AnnotationStatus!
|
Life cycle Status of the annotation |
created - IsoDateTime!
|
Creation time of the annotation |
rich - RichContent
|
A rich comment text |
user - User
|
The user who has created the annotation |
comments - AnnotationCommentConnection
|
Get a list of comments about an annotation |
Example
{
"actions": AnnotationActions,
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"story": Story,
"lang": "fr",
"anchor": "abc123",
"status": "OPEN",
"created": "2016-10-07T01:08:03.420Z",
"rich": RichContent,
"user": User,
"comments": AnnotationCommentConnection
}
AnnotationActions
Description
Actions the user is allowed to do on the related Annotation
Object
Example
{"delete": true, "edit": true, "resolve": true, "reply": false}
AnnotationAddedInput
Description
Input type for annotationAdded Subscription
Example
{
"clientSubscriptionId": "abc123",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}
AnnotationAddedPayload
Description
Return Type the annotationAdded Subscription
Fields
Field Name | Description |
---|---|
clientSubscriptionId - String
|
A unique identifier for the client performing the subscription. |
annotationEdge - AnnotationEdge
|
The just added Annotation in an Edge |
story - Story
|
The related Story attached to the annotation |
Example
{
"clientSubscriptionId": "xyz789",
"annotationEdge": AnnotationEdge,
"story": Story
}
AnnotationComment
Description
A reaction to an annotation
Fields
Field Name | Description |
---|---|
actions - AnnotationCommentActions!
|
Indicate the list of actions available to the current user on this Object |
id - ID!
|
ID of the object. |
annotation - Annotation!
|
The related annotation |
rich - RichContent
|
A rich comment text |
user - User
|
The user who has created the comment |
created - IsoDateTime!
|
The creation time of the annotation's comment |
Example
{
"actions": AnnotationCommentActions,
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"annotation": Annotation,
"rich": RichContent,
"user": User,
"created": "2016-10-07T01:08:03.420Z"
}
AnnotationCommentActions
AnnotationCommentAddErrors
Description
Error Type of the annotationCommentAdd Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
AnnotationCommentAddInput
Description
Input type for Mutation annotationCommentAdd
Fields
Input Field | Description |
---|---|
annotationId - ID!
|
The global ID of the annotation |
comment - RichContentInput!
|
A comment about the annotation |
Example
{
"annotationId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"comment": RichContentInput
}
AnnotationCommentAddPayload
Description
Return Type of Mutation annotationCommentAdd
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
annotation - Annotation
|
The Edited Annotation |
commentEdge - AnnotationCommentEdge
|
The comment created |
errors - [AnnotationCommentAddErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "abc123",
"annotation": Annotation,
"commentEdge": AnnotationCommentEdge,
"errors": [ObjectNotFoundError]
}
AnnotationCommentAddedInput
Description
Input type for annotationCommentAdded Subscription
Example
{
"clientSubscriptionId": "abc123",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}
AnnotationCommentAddedPayload
Description
Return Type the annotationCommentAdded Subscription
Fields
Field Name | Description |
---|---|
clientSubscriptionId - String
|
A unique identifier for the client performing the subscription. |
annotationCommentEdge - AnnotationCommentEdge
|
The just added AnnotationComment in an Edge |
story - Story
|
The related Story attached to the annotation |
Example
{
"clientSubscriptionId": "xyz789",
"annotationCommentEdge": AnnotationCommentEdge,
"story": Story
}
AnnotationCommentConnection
Description
List of results of AnnotationComment
Fields
Field Name | Description |
---|---|
edges - [AnnotationCommentEdge!]
|
A list of edges. |
pageInfo - PageInfo!
|
Information to aid in pagination. |
totalCount - Int!
|
Identifies the total count of items in the connection. |
Example
{
"edges": [AnnotationCommentEdge],
"pageInfo": PageInfo,
"totalCount": 123
}
AnnotationCommentDeleteErrors
Description
Error Type of the annotationCommentDelete Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
AnnotationCommentDeleteInput
Description
Input type for Mutation annotationCommentDelete
Fields
Input Field | Description |
---|---|
annotationCommentId - ID!
|
The global ID of the AnnotationComment to delete |
Example
{
"annotationCommentId": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}
AnnotationCommentDeletePayload
Description
Return Type of Mutation annotationCommentDelete
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
annotationCommentId - ID
|
The deleted AnnotationComment ID |
errors - [AnnotationCommentDeleteErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "abc123",
"annotationCommentId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"errors": [ObjectNotFoundError]
}
AnnotationCommentDeletedInput
Description
Input type for annotationCommentDeleted Subscription
Example
{
"clientSubscriptionId": "xyz789",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}
AnnotationCommentDeletedPayload
Description
Return Type of the annotationCommentDeleted Subscription
Fields
Field Name | Description |
---|---|
clientSubscriptionId - String
|
A unique identifier for the client performing the subscription. |
annotation - Annotation
|
Annotation Linked to the deleted AnnotationComment ID
|
annotationCommentId - ID
|
The Global ID of the deleted AnnotationComment |
Example
{
"clientSubscriptionId": "abc123",
"annotation": Annotation,
"annotationCommentId": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}
AnnotationCommentEdge
Description
An edge in a connection.
Fields
Field Name | Description |
---|---|
cursor - String!
|
A cursor for use in pagination. |
node - AnnotationComment!
|
The item at the end of the edge. |
Example
{
"cursor": "abc123",
"node": AnnotationComment
}
AnnotationCommentEditErrors
Description
Error Type of the annotationCommentEdit Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
AnnotationCommentEditInput
Description
Input type for Mutation annotationCommentEdit
Fields
Input Field | Description |
---|---|
annotationCommentId - ID!
|
The global ID of the AnnotationComment |
comment - RichContentInput
|
the new comment about the AnnotationComment |
Example
{
"annotationCommentId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"comment": RichContentInput
}
AnnotationCommentEditPayload
Description
Return Type of Mutation annotationCommentEdit
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
comment - AnnotationComment
|
The edited comment |
errors - [AnnotationCommentEditErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "abc123",
"comment": AnnotationComment,
"errors": [ObjectNotFoundError]
}
AnnotationCommentEditedInput
Description
Input type for annotationCommentEdited Subscription
Example
{
"clientSubscriptionId": "abc123",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}
AnnotationCommentEditedPayload
Description
Return Type the annotationCommentEdited Subscription
Fields
Field Name | Description |
---|---|
clientSubscriptionId - String
|
A unique identifier for the client performing the subscription. |
annotationCommentEdge - AnnotationCommentEdge
|
The edited AnnotationComment in an Edge |
annotationComment - AnnotationComment
|
The edited AnnotationComment |
story - Story
|
The related Story attached to the annotation |
Example
{
"clientSubscriptionId": "xyz789",
"annotationCommentEdge": AnnotationCommentEdge,
"annotationComment": AnnotationComment,
"story": Story
}
AnnotationConnection
Description
List of results of Annotation
Fields
Field Name | Description |
---|---|
edges - [AnnotationEdge!]
|
A list of edges. |
pageInfo - PageInfo!
|
Information to aid in pagination. |
totalCount - Int!
|
Identifies the total count of items in the connection. |
Example
{
"edges": [AnnotationEdge],
"pageInfo": PageInfo,
"totalCount": 123
}
AnnotationCreateErrors
Description
Error Type of the annotationCreate Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
AnnotationCreateInput
Description
Input type for Mutation annotationCreate
Fields
Input Field | Description |
---|---|
storyId - ID!
|
The global ID of the annotated content |
lang - Lang
|
Lang of the Annotated version (null if untranslated) |
anchor - String!
|
Referenced Slate block UUID |
comment - RichContentInput!
|
A comment about the annotation |
Example
{
"storyId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"lang": "fr",
"anchor": "xyz789",
"comment": RichContentInput
}
AnnotationCreatePayload
Description
Return Type of Mutation annotationCreate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
story - Story
|
The annotated Story |
annotationEdge - AnnotationEdge
|
Newly created Annotation |
errors - [AnnotationCreateErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "abc123",
"story": Story,
"annotationEdge": AnnotationEdge,
"errors": [ObjectNotFoundError]
}
AnnotationDeleteErrors
Description
Error Type of the annotationDelete Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
AnnotationDeleteInput
Description
Input type for Mutation annotationDelete
Fields
Input Field | Description |
---|---|
annotationId - ID!
|
The global ID of the Annotation to delete |
Example
{
"annotationId": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}
AnnotationDeletePayload
Description
Return Type of Mutation annotationDelete
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
annotationId - ID
|
The deleted Annotation ID |
errors - [AnnotationDeleteErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"annotationId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"errors": [ObjectNotFoundError]
}
AnnotationEdge
Description
An edge in a connection.
Fields
Field Name | Description |
---|---|
cursor - String!
|
A cursor for use in pagination. |
node - Annotation!
|
The item at the end of the edge. |
Example
{
"cursor": "xyz789",
"node": Annotation
}
AnnotationEditErrors
Description
Error Type of the annotationEdit Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
AnnotationEditInput
Description
Input type for Mutation annotationEdit
Fields
Input Field | Description |
---|---|
annotationId - ID!
|
The global ID of the annotations |
status - AnnotationStatus
|
New status to assign |
comment - RichContentInput
|
A new comment about the annotation |
Example
{
"annotationId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"status": "OPEN",
"comment": RichContentInput
}
AnnotationEditPayload
Description
Return Type of Mutation annotationEdit
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
annotation - Annotation
|
Newly edited Annotation |
errors - [AnnotationEditErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"annotation": Annotation,
"errors": [ObjectNotFoundError]
}
AnnotationEditedInput
Description
Input type for annotationEdited Subscription
Example
{
"clientSubscriptionId": "xyz789",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}
AnnotationEditedPayload
Description
Return Type the annotationEdited Subscription
Fields
Field Name | Description |
---|---|
clientSubscriptionId - String
|
A unique identifier for the client performing the subscription. |
annotationEdge - AnnotationEdge
|
The edited Annotation in an Edge |
annotation - Annotation
|
The edited Annotation |
story - Story
|
The related Story attached to the annotation |
Example
{
"clientSubscriptionId": "xyz789",
"annotationEdge": AnnotationEdge,
"annotation": Annotation,
"story": Story
}
AnnotationStatus
Description
Lifecycle status of the Annotation
Values
Enum Value | Description |
---|---|
|
The annotation is Open and waiting for attention |
|
The annotation was marked as Resloved and should not be visible by default. |
Example
"OPEN"
Answer
Description
AI generated answer to a natual language question
Fields
Field Name | Description |
---|---|
id - ID!
|
ID of the object. |
text - String
|
The Generated text's answer if there was one (while answering you won't get an Answer at all) |
explain - JSON
|
Information about the answer generation |
created - IsoDateTime!
|
Creation date of the request to Answer |
sources - [AnswerSource!]!
|
Context of the answer from where the answer was generated |
Arguments
|
|
isCorrect - Boolean
|
Has the answer been marked as correct |
feedbackType - AnswerFeedbackType
|
The type of feedback, if the isCorrect is false |
feedbackMessage - String
|
The message associated with the negative feedback, if the isCorrect is false |
user - User
|
The user who asked the question |
question - String!
|
The question asked by the user |
isResolved - Boolean!
|
Has an admin marked the questionn as resolved (this happend when the user has marked as not Correct first) |
resolvedBy - User
|
User that has resolved the question if any |
resolvedDate - IsoDateTime
|
That at which the question was marked as resolved |
resolvedMessage - String
|
Message from the user resolving the Question to the user asking |
resolvedSources - [Story!]
|
Additional or new source the resolver wanted to point to |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"text": "xyz789",
"explain": {},
"created": "2016-10-07T01:08:03.420Z",
"sources": [Story],
"isCorrect": true,
"feedbackType": "NO_RESPONSE",
"feedbackMessage": "abc123",
"user": User,
"question": "abc123",
"isResolved": false,
"resolvedBy": User,
"resolvedDate": "2016-10-07T01:08:03.420Z",
"resolvedMessage": "abc123",
"resolvedSources": [Story]
}
AnswerAssetSource
AnswerConnection
Description
List of results of AnswerFeedbackConnection
Fields
Field Name | Description |
---|---|
edges - [AnswerEdge!]
|
A list of edges. |
pageInfo - PageInfo!
|
Information to aid in pagination. |
totalCount - Int!
|
Identifies the total count of items in the connection. |
Example
{
"edges": [AnswerEdge],
"pageInfo": PageInfo,
"totalCount": 987
}
AnswerEdge
AnswerFeedbackError
Description
Error Type of the answerFeedback
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
AnswerFeedbackInput
Description
Input type for Mutation answerFeedback
Fields
Input Field | Description |
---|---|
id - ID!
|
Global ID of the question asked, provided by me.anwser |
isCorrect - Boolean!
|
Is the answer provided correct |
feedbackType - AnswerFeedbackType
|
The type of feedback, if the isCorrect is false |
feedbackMessage - String
|
The message associated with the negative feedback, if the isCorrect is false |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"isCorrect": false,
"feedbackType": "NO_RESPONSE",
"feedbackMessage": "abc123"
}
AnswerFeedbackPayload
Description
Return Type of Mutation answerFeedback
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [AnswerFeedbackError!]
|
Errors of the mutation. |
answer - Answer
|
Related Answer question |
Example
{
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError],
"answer": Answer
}
AnswerFeedbackType
Description
Type of the negative feedback about an Anwser
Values
Enum Value | Description |
---|---|
|
The provided response does not contains an anwser |
|
The provided response is not relevant to the question or inexact |
|
The provided response is confusing or not precise enough |
|
The sources provided are not the best sources possible |
|
Other kind of feedback |
Example
"NO_RESPONSE"
AnswerLogMode
Description
Type of usage of Answer AI to determine how to log and handle the question and feedback loop
Values
Enum Value | Description |
---|---|
|
Regular mode used by the end user while doing a SmartAssistant request or Answer request |
|
Admin usage of the AI, for example to test or while configuring |
|
Usage of Answer AI for debugging, should not be logged or enter the feedback loop |
Example
"USER"
AnswerMethod
Description
Method of indexing for the Answer AI you probably don't want to change this
Values
Enum Value | Description |
---|---|
|
Old method of indexing, not much criteria available |
|
New method of indexing, more filter likes space, schema, etc |
Example
"V1"
AnswerResolveError
Description
Error Type of the answerFeedback
Mutation
Types
Union Types |
---|
Example
PermissionError
AnswerResolveInput
Description
Input type for Mutation answerResolve
Fields
Input Field | Description |
---|---|
id - ID!
|
Global ID of the question asked, provided by me.anwser |
isResolved - Boolean
|
Set Resolved status of the question |
resolveMessage - String
|
Message to send to the person that has ask the question (i.e: the correct answer) |
sources - [ID!]
|
Correct Sources of the resolved Answer |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"isResolved": false,
"resolveMessage": "abc123",
"sources": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
]
}
AnswerResolvePayload
Description
Return Type of Mutation answerResolve
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [AnswerResolveError!]
|
Errors of the mutation. |
answer - Answer
|
Related Answer question |
Example
{
"clientMutationId": "abc123",
"errors": [PermissionError],
"answer": Answer
}
AnswerSendForReviewError
Description
Error Type of the answerFeedback
Mutation
Types
Union Types |
---|
Example
PermissionError
AnswerSendForReviewInput
AnswerSendForReviewPayload
Description
Return Type of Mutation answerSendForReview
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [AnswerSendForReviewError!]
|
Errors of the mutation. |
answer - Answer
|
Related Answer question |
Example
{
"clientMutationId": "abc123",
"errors": [PermissionError],
"answer": Answer
}
AnswerSource
Description
Source of an answer might be a story content or a story asset
Types
Union Types |
---|
Example
Story
AppLauncher
Description
Quick Access item for user to open a given external link
Fields
Field Name | Description |
---|---|
id - ID!
|
ID of the object. |
href - String!
|
Link to the External Website pointed |
icon - URL
|
Url of the Applauncher icon displayed |
title - String!
|
Title of the AppLauncher for the current user's lang. |
titles - TranslatedString!
|
All defined titles of the AppLauncher |
teams - [Team!]
|
List of teams where the AppLauncher is defined (only defined if Only available when |
forEveryone - Boolean!
|
Is the applauncher available for everyone in the platform or only for given teams. |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"href": "xyz789",
"icon": "http://www.test.com/",
"title": "abc123",
"titles": {"en": "a Name", "fr": "Un Nom"},
"teams": [Team],
"forEveryone": true
}
AppLauncherConnection
Description
List of results of AppLauncher
Fields
Field Name | Description |
---|---|
edges - [AppLauncherEdge!]
|
A list of edges. |
pageInfo - PageInfo!
|
Information to aid in pagination. |
totalCount - Int!
|
Identifies the total count of items in the connection. |
Example
{
"edges": [AppLauncherEdge],
"pageInfo": PageInfo,
"totalCount": 987
}
AppLauncherCreateErrors
Description
Error Type of the appLauncherCreate Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
AppLauncherCreateInput
Description
Input type for Mutation appLauncherCreate
Fields
Input Field | Description |
---|---|
link - URLInput!
|
Link of the AppLauncher |
titles - TranslatedString!
|
Translated Title of the AppLauncher |
teams - [ID!]
|
List of Teams that will have access to the AppLauncher. Only when forEveryone =false |
forEveryone - Boolean!
|
Is the AppLauncher Visible to everyone or just to a list of team |
icon - File!
|
Icon file to display beside the Launcher |
Example
{
"link": URLInput,
"titles": {"en": "a Name", "fr": "Un Nom"},
"teams": ["eWVhaCByaWdodCBpdCdzIGI2NA=="],
"forEveryone": false,
"icon": "5ee411f1-6632-4388-b994-9fda4caf5c43"
}
AppLauncherCreatePayload
Description
Return Type of Mutation appLauncherCreate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
edge - AppLauncherEdge
|
The just added AppLauncher in an Edge |
launcher - AppLauncher
|
The Created AppLauncher |
instance - Instance
|
The currrent Instance |
errors - [AppLauncherCreateErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "abc123",
"edge": AppLauncherEdge,
"launcher": AppLauncher,
"instance": Instance,
"errors": [ObjectNotFoundError]
}
AppLauncherDeleteErrors
Description
Error Type of the appLauncherDelete
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
AppLauncherDeleteInput
Description
Input type for Mutation appLauncherDelete
Fields
Input Field | Description |
---|---|
id - ID!
|
The global ID of the AppLauncher to delete |
Example
{"id": "eWVhaCByaWdodCBpdCdzIGI2NA=="}
AppLauncherDeletePayload
Description
Return Type of Mutation appLauncherDelete
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
deletedId - ID
|
The deleted AppLauncher global ID |
instance - Instance
|
The currrent Instance |
errors - [AppLauncherDeleteErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "abc123",
"deletedId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"instance": Instance,
"errors": [ObjectNotFoundError]
}
AppLauncherEdge
Description
An edge in a connection.
Fields
Field Name | Description |
---|---|
cursor - String!
|
A cursor for use in pagination. |
node - AppLauncher!
|
The item at the end of the edge. |
Example
{
"cursor": "abc123",
"node": AppLauncher
}
AppLauncherEditErrors
Description
Error Type of the appLauncherEdit
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
AppLauncherEditInput
Description
Input type for Mutation appLauncherEdit
Fields
Input Field | Description |
---|---|
id - ID!
|
The global ID of the AppLauncher to edit |
link - URLInput
|
Link of the AppLauncher |
titles - TranslatedString
|
Translated Title of the AppLauncher |
teams - [ID!]
|
List of Teams that will have access to the AppLauncher. Only when forEveryone =false |
forEveryone - Boolean
|
Is the AppLauncher Visible to everyone or just to a list of team |
icon - File
|
Icon file to display beside the Launcher |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"link": URLInput,
"titles": {"en": "a Name", "fr": "Un Nom"},
"teams": ["eWVhaCByaWdodCBpdCdzIGI2NA=="],
"forEveryone": true,
"icon": "5ee411f1-6632-4388-b994-9fda4caf5c43"
}
AppLauncherEditPayload
Description
Return Type of Mutation AppLauncherEdit
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
launcher - AppLauncher
|
The edited AppLauncher |
instance - Instance
|
The currrent Instance |
errors - [AppLauncherEditErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"launcher": AppLauncher,
"instance": Instance,
"errors": [ObjectNotFoundError]
}
AppLauncherOrderErrors
Description
Error Type of the appLauncherOrder
Mutation
Types
Union Types |
---|
Example
PermissionError
AppLauncherOrderInput
Description
Input type for Mutation appLauncherOrder
Fields
Input Field | Description |
---|---|
ids - [ID!]!
|
Ordered list of AppLaunchers as seen by users |
Example
{"ids": ["eWVhaCByaWdodCBpdCdzIGI2NA=="]}
AppLauncherOrderPayload
Description
Return Type of Mutation appLauncherOrder
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
instance - Instance
|
The currrent Instance |
errors - [AppLauncherOrderErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "abc123",
"instance": Instance,
"errors": [PermissionError]
}
Asset
Description
The Asset interface represents a generic asset in A Content. For example a link bloc, a file, a user bloc, ...
Fields
Field Name | Description |
---|---|
slug - OpaqueID!
|
Identifier of the asset, you probably don't need it |
uuid - UUID!
|
The universally unique identifier of the asset. |
lang - Lang
|
The language of the asset. currently unused unused |
created - IsoDateTime!
|
The date and time when the asset was created. |
metadata - [AssetMetadata!]
|
The metadatas associated with the asset. |
Possible Types
Asset Types |
---|
Example
{
"slug": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"uuid": "7aac93c5-a56c-4528-b43e-457834a796c9",
"lang": "fr",
"created": "2016-10-07T01:08:03.420Z",
"metadata": [AssetMetadata]
}
AssetAntiVirusStatus
Description
AntiVirus Scan Status of an asset.
Values
Enum Value | Description |
---|---|
|
The antivirus is disabled |
|
An issue was found in the file. Appropriate measures must be taken |
|
the scan by the AV-scanning engine has not finished yet |
|
the engine has scan the file and it's considered safe |
|
the file was queued for scanned, but skipped for technical reasons (too large, ...) |
Example
"DISABLED"
AssetMetadata
Description
The AssetMetadata type represents metadata associated with an asset. An asset can have multiple key-value pairs of metadata.
Fields
Field Name | Description |
---|---|
key - AssetMetadataKey!
|
Key name of the metadata. |
value - JSON
|
The value of the metadata, which can be any JSON object depending of the key |
Example
{"key": "EMAIL_CC", "value": {}}
AssetMetadataInput
Description
The AssetMetadataInput type represents an input of metadata associated with an asset. An asset can have multiple key-value pairs of metadata.
Fields
Input Field | Description |
---|---|
key - AssetMetadataKey!
|
Key name of the metadata. |
value - JSON
|
The value of the metadata, which can be any JSON object depending of the key |
Example
{"key": "EMAIL_CC", "value": {}}
AssetMetadataKey
Description
The AssetMetadataKey enum defines a set of keys for accessing metadata about an asset.
Each key corresponds to a specific piece of metadata, such as the email subject or the URL provider name.
Values
Enum Value | Description |
---|---|
|
The email CC field, which contains the addresses of any carbon copy recipients. |
|
The date and time the email was sent. |
|
The email address of the sender. |
|
The email message ID, which is a unique identifier for the email. |
|
The subject of the email. |
|
The email address of the primary recipient. |
|
A description of the URL. |
|
The URL of the favicon (the small icon displayed in the browser tab) for the URL. |
|
The Display name of the provider URL (eg wikipedia.org for a wikipedia article) |
|
The name of the provider of the URL (e.g. "Wikipedia" for a wikipedia article). |
|
The URL of the provider's website (e.g. "https://fr.wikipedia.org" for a wikipedia article). |
|
The title of the page at the URL. |
Example
"EMAIL_CC"
AssetPreviewPayload
AssetResult
Description
The AssetResult type represents the result of a search query for an asset.
This type contains the asset itself, as well as highlighted versions of its snippets and title that can be used to show the search terms in context.
Fields
Field Name | Description |
---|---|
asset - Asset!
|
The asset that was found in the search query. |
highlightedSnippets - [HTML!]!
|
An array of highlighted versions of the asset's snippets, with the search terms highlighted in HTML. |
highlightedTitle - HTML
|
A highlighted version of the asset's title, with the search terms highlighted in HTML. |
main - Boolean!
|
A boolean value that indicates whether the asset is located in the main asset of the story. |
Example
{
"asset": Asset,
"highlightedSnippets": [
"<html>Hello <h1>world</h1></html>"
],
"highlightedTitle": "<html>Hello <h1>world</h1></html>",
"main": false
}
AssetType
Description
The AssetType enum defines a set of types for assets.
Each value in the enum corresponds to a specific type of asset, such as a cloud file or an email.
Values
Enum Value | Description |
---|---|
|
A file stored in the cloud (e.g. in Google Drive or Teams drive). see CloudFileAsset
|
|
A folder containing files in the cloud (e.g. in Google Drive or Teams drive). see CloudFolderAsset
|
|
An email message. see EmailAsset
|
|
A file on the user's local file system. see FileAsset
|
|
A Story object see StoryAsset
|
|
A URL that points to a webpage. sett URLAsset
|
|
A user of the application. see UserAsset
|
|
A drawing object made with Excalidraw see DrawingAsset
|
Example
"CLOUD_FILE"
Attribute
Description
Attribute & value of a content
Fields
Field Name | Description |
---|---|
key - String!
|
ID of the attribute in the schema |
schema - SchemaAttribute
|
Schema to which the attribute belongs |
type - ValueWrapperType!
|
Type of value stored in the attribute this or value (ValueWrapper)'s __typename will give you the type of the value |
value - ValueWrapper!
|
Value Of the attribute in the content |
Example
{
"key": "xyz789",
"schema": SchemaAttribute,
"type": "ADDRESS",
"value": StringWrapper
}
AttributeError
AttributeInput
Description
Input value for an Attribute
value attribution
Fields
Input Field | Description |
---|---|
key - String!
|
The key of the Attribute referenced |
type - ValueWrapperType!
|
The type of value wrapped by this attribute |
valueAddress - AddressAttributeInput
|
The value of the attribute if it is of type 'address' |
valueBoolean - Boolean
|
The value of the attribute if it is of type 'boolean' |
valueDatetime - IsoDateTime
|
The value of the attribute if it is of type 'datetime' |
valueFullName - FullNameAttributeInput
|
The value of the attribute if it is of type 'full name' |
valueInt - Int
|
The value of the attribute if it is of type 'integer' |
valueIntList - [Int!]
|
The value of the attribute if it is of type 'integer list' |
valueJson - JSON
|
The value of the attribute if it is of type 'json' |
valueString - String
|
The value of the attribute if it is of type 'string' |
valueStringList - [String!]
|
The value of the attribute if it is of type 'string list' |
valueTag - ID
|
The value of the attribute if it is of type 'tag' ID is a Node id of a Tag |
valueTagList - [ID!]
|
The value of the attribute if it is of type 'tag list' a list of Node id of a Tag |
valueUser - ID
|
The value of the attribute if it is of type 'user' ID is a Node id of a User |
valueUserList - [ID!]
|
The value of the attribute if it is of type 'user list' a list of Node id of a User |
Example
{
"key": "xyz789",
"type": "ADDRESS",
"valueAddress": AddressAttributeInput,
"valueBoolean": false,
"valueDatetime": "2016-10-07T01:08:03.420Z",
"valueFullName": FullNameAttributeInput,
"valueInt": 987,
"valueIntList": [987],
"valueJson": {},
"valueString": "xyz789",
"valueStringList": ["abc123"],
"valueTag": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"valueTagList": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"valueUser": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"valueUserList": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
]
}
Boolean
Description
The Boolean
scalar type represents true
or false
.
Example
true
BooleanWrapper
Description
Wrapper type for boolean values
Fields
Field Name | Description |
---|---|
valueBoolean - Boolean!
|
The boolean value |
Example
{"valueBoolean": false}
Box
BuiltinAttribute
Description
Builtin attribute with key-value pair
Fields
Field Name | Description |
---|---|
key - BuiltinAttributeKey!
|
The key of the builtin attribute |
type - ValueWrapperType!
|
The type of value wrapped by this attribute |
value - ValueWrapper!
|
The value of the builtin attribute |
Example
{
"key": "AUTHOR",
"type": "ADDRESS",
"value": StringWrapper
}
BuiltinAttributeInput
Description
Input type for builtin attribute
Fields
Input Field | Description |
---|---|
key - BuiltinAttributeKey!
|
The key of the builtin attribute |
type - ValueWrapperType!
|
The type of value wrapped by this attribute |
valueAddress - AddressAttributeInput
|
The value of the builtin attribute if it is of type 'address' |
valueDatetime - IsoDateTime
|
The value of the builtin attribute if it is of type 'datetime' |
valueEvent - EventAttributeInput
|
The value of the builtin attribute if it is of type 'event' |
valueFullName - FullNameAttributeInput
|
The value of the builtin attribute if it is of type 'full name' |
valueString - String
|
The value of the builtin attribute if it is of type 'string' |
valueJson - JSON
|
The value of the builtin attribute if it is JSON object |
Example
{
"key": "AUTHOR",
"type": "ADDRESS",
"valueAddress": AddressAttributeInput,
"valueDatetime": "2016-10-07T01:08:03.420Z",
"valueEvent": EventAttributeInput,
"valueFullName": FullNameAttributeInput,
"valueString": "xyz789",
"valueJson": {}
}
BuiltinAttributeKey
Description
Enum representing the available built-in attribute keys
Values
Enum Value | Description |
---|---|
|
Represents the author of the content as the "original author" (like Website author, ...) |
|
Represents the body or text content of the content |
|
Represents the cover asset (thumbnail picture) of the content |
|
Represents the event associated with the content |
|
Represents the location associated with the content |
|
Represents the main asset or featured image of the content |
|
Represents the order string used for sorting the content |
|
Represents the publication date of the content as original Publication date ( Website publication date, Article date, ...) |
|
Represents the publisher of the content |
|
Represents the source of the content (website, ...) |
|
Represents the title of the content |
|
Represents the user description associated with the content |
|
Represents the user emails associated with the content |
|
Represents the full name of the user associated with the content |
|
Represents the Key of a decision tree strucuture associated with a content |
|
Give a summary / abstract of the content |
Example
"AUTHOR"
BulkStoryArchiveErrors
Description
Error Type of the bulkStoryArchive
Mutation
Types
Union Types |
---|
Example
PermissionError
BulkStoryArchiveInput
BulkStoryArchivePayload
Description
Return Type of Mutation bulkStoryArchive
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
touchedIds - [ID!]
|
Global ID list of the archived/restored Story |
skippedIds - [ID!]
|
List of Story ID that couldn't be changed |
errors - [BulkStoryArchiveErrors!]
|
Errors of the mutation. |
me - Me
|
Reference to current user |
Example
{
"clientMutationId": "xyz789",
"touchedIds": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"skippedIds": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"errors": [PermissionError],
"me": Me
}
BulkStoryDeleteInput
BulkStoryDeletePayload
Description
Return Type of Mutation bulkStoryDelete
Example
{
"clientMutationId": "abc123",
"deletedIds": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"skippedIds": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"me": Me
}
BulkStoryMoveErrors
Description
Error Type of the bulkStoryMove
Mutation
Types
Union Types |
---|
Example
PermissionError
BulkStoryMoveInput
Description
Input type for Mutation bulkStoryMove
Example
{
"clientMutationId": "xyz789",
"ids": ["eWVhaCByaWdodCBpdCdzIGI2NA=="],
"space": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}
BulkStoryMovePayload
Description
Return Type of Mutation bulkStoryMove
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. |
movedIds - [ID!]
|
Global ID list of the moved Story |
skippedIds - [ID!]
|
List of Story ID that couldn't be moved |
errors - [BulkStoryMoveErrors!]
|
Errors of the mutation. |
me - Me
|
Reference to current user |
space - Space
|
The selected space to put the stories in |
Example
{
"clientMutationId": "abc123",
"movedIds": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"skippedIds": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"errors": [PermissionError],
"me": Me,
"space": Space
}
BulkStorySchemaConvertErrors
Description
Error Type of the bulkStorySchemaConvert
Mutation
Types
Union Types |
---|
Example
PermissionError
BulkStorySchemaConvertInput
Description
Input type for Mutation bulkStorySchemaConvert
Example
{
"ids": ["eWVhaCByaWdodCBpdCdzIGI2NA=="],
"schemaId": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}
BulkStorySchemaConvertPayload
Description
Return Type of Mutation bulkStorySchemaConvert
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
touchedIds - [ID!]
|
Global ID list of the edited Story |
skippedIds - [ID!]
|
List of Story ID that couldn't be edited |
errors - [BulkStorySchemaConvertErrors!]
|
Errors of the mutation. |
me - Me
|
Reference to current user |
Example
{
"clientMutationId": "xyz789",
"touchedIds": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"skippedIds": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"errors": [PermissionError],
"me": Me
}
CheckPasswordErrors
Description
Error Type of the checkPassword
Mutation
Types
Union Types |
---|
Example
InvalidInputError
CheckPasswordInput
CheckPasswordPayload
Description
Return Type of Mutation checkPassword
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [CheckPasswordErrors!]
|
Errors of the mutation. |
success - Boolean!
|
A boolean value indicating wherethere the password check was successful or not |
Example
{
"clientMutationId": "abc123",
"errors": [InvalidInputError],
"success": false
}
CloudDetails
Description
Details of a file stored in the cloud (e.g. in Google Drive or Teams drive).
Types
Union Types |
---|
Example
GoogleCloudDetails
CloudFileAsset
Description
Asset representing a file stored in the cloud (e.g. in Google Drive or Teams drive).
Fields
Field Name | Description |
---|---|
authenticated - Boolean!
|
True if a fetch token is defined in the backend to fetch this asset |
authorized - Boolean!
|
True if we sucessfully fetched the cloud item, false otherwise (auth issue, disconnected, wrong account, ...) |
cloudDriveId - OpaqueID
|
Id of the shared drive, only used by OneDrive ATM |
cloudId - OpaqueID
|
Id of the cloud item (file, folder, ...) as defined by the cloud provider |
cloudProvider - CloudProvider
|
Cloud provider of the item (Google Drive, OneDrive, ...) |
created - IsoDateTime!
|
Creation date of the current asset |
embedUrl - URL
|
URL of the embeddable content |
iconURL - URL
|
Icon of the file for the provider |
lang - Lang
|
The language of the asset. currently unused unused |
slug - OpaqueID!
|
Identifier of the asset, you probably don't need it |
metadata - [AssetMetadata!]
|
The metadatas associated with the asset. |
modifiedTime - IsoDateTime
|
Last modification time of the file |
name - String
|
Name of the file on the cloud provider |
owner - String
|
Name of the owner of the file on the cloud provider |
previewLargeUrl - URL
|
Large Preview image of the file on the cloud provider (attempt to be 1024x1024) |
previewUrl - URL
|
Small Preview image of the file on the cloud provider |
url - URL
|
Browsable Url of the file on the cloud provider |
uuid - UUID!
|
UUID of the asset as referenced in slate body |
Example
{
"authenticated": false,
"authorized": true,
"cloudDriveId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"cloudId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"cloudProvider": "GOOGLE_DRIVE",
"created": "2016-10-07T01:08:03.420Z",
"embedUrl": "http://www.test.com/",
"iconURL": "http://www.test.com/",
"lang": "fr",
"slug": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"metadata": [AssetMetadata],
"modifiedTime": "2016-10-07T01:08:03.420Z",
"name": "xyz789",
"owner": "xyz789",
"previewLargeUrl": "http://www.test.com/",
"previewUrl": "http://www.test.com/",
"url": "http://www.test.com/",
"uuid": "7aac93c5-a56c-4528-b43e-457834a796c9"
}
CloudFolderAsset
Description
An Asset representing a folder stored in the cloud (e.g. in Google Drive or Teams drive).
Fields
Field Name | Description |
---|---|
authenticated - Boolean!
|
True if a fetch token is defined in the backend to fetch this asset |
authorized - Boolean!
|
True if we sucessfully fetched the cloud item, false otherwise (auth issue, disconnected, wrong account, ...) |
cloudDriveId - OpaqueID
|
Id of the shared drive, only used by OneDrive ATM |
cloudId - OpaqueID
|
Id of the cloud item (file, folder, ...) as defined by the cloud provider |
cloudProvider - CloudProvider
|
Type of the cloud provider |
created - IsoDateTime!
|
Creation date of the current asset |
items - CloudFolderResult
|
Return a list of items in the folder. Fetched on demand for the current user (if he has a valid token saved) |
lang - Lang
|
The language of the asset. currently unused unused |
slug - OpaqueID!
|
Identifier of the asset, you probably don't need it |
metadata - [AssetMetadata!]
|
The metadatas associated with the asset. |
name - String
|
Name of the folder on the provider |
url - URL
|
Url to the folder |
uuid - UUID!
|
UUID of the asset as referenced in slate body |
Example
{
"authenticated": false,
"authorized": false,
"cloudDriveId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"cloudId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"cloudProvider": "GOOGLE_DRIVE",
"created": "2016-10-07T01:08:03.420Z",
"items": CloudFolderResult,
"lang": "fr",
"slug": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"metadata": [AssetMetadata],
"name": "abc123",
"url": "http://www.test.com/",
"uuid": "7aac93c5-a56c-4528-b43e-457834a796c9"
}
CloudFolderItem
Description
Item in a CloudFolderAsset
might be a file or a folder
Example
{
"iconURL": "http://www.test.com/",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"modifiedTime": "2016-10-07T01:08:03.420Z",
"name": "abc123",
"owner": "xyz789",
"url": "http://www.test.com/"
}
CloudFolderResult
Description
Result Page of a folder content fetch
Fields
Field Name | Description |
---|---|
endCursor - String
|
When paginating forwards, the cursor to continue. |
hasNextPage - Boolean
|
When paginating forwards, are there more items? |
nodes - [CloudFolderItem!]
|
A list of nodes. |
Example
{
"endCursor": "abc123",
"hasNextPage": true,
"nodes": [CloudFolderItem]
}
CloudProvider
Description
Describe the type of the CloudProvider
Values
Enum Value | Description |
---|---|
|
Google Drive |
|
Microsoft OneDrive |
Example
"GOOGLE_DRIVE"
Color
Description
A css valid CSS color
Example
"#CCCCCC"
ColorLightness
Description
Representation of the lightness of a color usage (for example the color of the header)
Values
Enum Value | Description |
---|---|
|
Indicates a dark color. |
|
Indicates a light color. |
Example
"DARK"
Comment
Description
A comment made by a user on a story.
Fields
Field Name | Description |
---|---|
actions - CommentActions!
|
Indicate the list of actions available to the current user on this Object. |
assets - [Asset!]!
|
The list of assets (images, videos, etc.) attached to the comment. |
id - ID!
|
The Node identifier of the comment. |
liked - Boolean!
|
Indicates whether the current user has liked the comment. |
likers - UserConnection
|
Retrieves the users who have liked the comment. |
parent - Story
|
The story that the comment is related to. |
posted - IsoDateTime!
|
The date and time when the comment was posted. |
rich - RichContent
|
The rich content (HTML, Slate, ...) of the comment. |
slug - Int!
|
A short human representation of the comment. |
source - CommentSource!
|
The source of the comment (e.g., web, API, mobile). |
subscriptionToken - OpaqueID
|
The token for subscribing to comment updates (deprecated). No longer available |
user - User
|
The user who made the comment. |
Example
{
"actions": CommentActions,
"assets": [Asset],
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"liked": false,
"likers": UserConnection,
"parent": Story,
"posted": "2016-10-07T01:08:03.420Z",
"rich": RichContent,
"slug": 987,
"source": "MAIL",
"subscriptionToken": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"user": User
}
CommentActions
CommentAddedInput
Description
Input type for commentAdded Subscription
Example
{
"clientSubscriptionId": "xyz789",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}
CommentAddedPayload
Description
Return Type the CommentAdded Subscription
Fields
Field Name | Description |
---|---|
clientSubscriptionId - String
|
A unique identifier for the client performing the subscription. |
commentEdge - CommentEdge
|
The just added Comment in an Edge |
parent - Story
|
The related Story attached to the comment |
Example
{
"clientSubscriptionId": "abc123",
"commentEdge": CommentEdge,
"parent": Story
}
CommentConnection
Description
List of results of Comment
Fields
Field Name | Description |
---|---|
edges - [CommentEdge!]
|
A list of edges. |
pageInfo - PageInfo!
|
Information to aid in pagination. |
totalCount - Int!
|
Identifies the total count of items in the connection. |
Example
{
"edges": [CommentEdge],
"pageInfo": PageInfo,
"totalCount": 987
}
CommentDeleteErrors
Description
Error Type of the commentDelete
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
CommentDeleteInput
Description
Input type for Mutation commentDelete
Fields
Input Field | Description |
---|---|
id - ID!
|
Node ID of the Comment to delete |
Example
{"id": "eWVhaCByaWdodCBpdCdzIGI2NA=="}
CommentDeletePayload
Description
Return Type of Mutation commentDelete
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
id - ID
|
Unused @deprecated use deletedId
|
deletedId - ID
|
Global ID of the deleted Comment |
parent - Story
|
Parent Object (Story ) from where the comment was deleted |
errors - [CommentDeleteErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "abc123",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"deletedId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"parent": Story,
"errors": [ObjectNotFoundError]
}
CommentDeletedInput
Description
Input type for commentDeleted Subscription
Example
{
"clientSubscriptionId": "abc123",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}
CommentDeletedPayload
Description
Return Type of commentDeleted Subscription
Example
{
"clientSubscriptionId": "xyz789",
"error": "xyz789",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"parent": Story
}
CommentEdge
CommentEditErrors
Description
Error Type of the commentEdit
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
CommentEditInput
Description
Input type for Mutation commentEdit
Fields
Input Field | Description |
---|---|
addedAssets - [StoryAssetInput!]
|
List of new Asset to add to the comment |
content - String
|
New Content of the comment in the format of the referenced Comment |
id - ID!
|
Node ID of the Comment to edit |
removedAssets - [UUID!]
|
List Of attached Asset to remove null if you don't want to remove assets |
Example
{
"addedAssets": [StoryAssetInput],
"content": "xyz789",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"removedAssets": [
"7aac93c5-a56c-4528-b43e-457834a796c9"
]
}
CommentEditPayload
Description
Return Type of Mutation commentEdit
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
comment - Comment
|
The just edited Comment object |
errors - [CommentEditErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"comment": Comment,
"errors": [ObjectNotFoundError]
}
CommentEditedInput
Description
Input type for commentEdited Subscription
Example
{
"clientSubscriptionId": "abc123",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}
CommentEditedPayload
CommentLikeActivity
Description
An Activity Log event: a comment was liked.
Fields
Field Name | Description |
---|---|
id - ID!
|
ID of the object. |
comment - Comment
|
Comment that was Liked by user |
created - IsoDateTime!
|
The time the action was initiated |
space - Space
|
The space associated with the activity event |
story - Story
|
Content on which the comment was posted |
type - ActivityType!
|
Type of activity |
user - User
|
The user who initiated the event |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"comment": Comment,
"created": "2016-10-07T01:08:03.420Z",
"space": Space,
"story": Story,
"type": "SPACE_JOIN",
"user": User
}
CommentLikeErrors
Description
Error Type of the commentLike
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
CommentLikeInput
CommentLikePayload
Description
Return Type of Mutation commentLike
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
comment - Comment
|
The just liked Comment object |
errors - [CommentLikeErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "abc123",
"comment": Comment,
"errors": [ObjectNotFoundError]
}
CommentPostActivity
Description
An Activity Log event: a comment was posted.
Fields
Field Name | Description |
---|---|
id - ID!
|
ID of the object. |
comment - Comment
|
Comment that was posted by user |
created - IsoDateTime!
|
The time the action was initiated |
space - Space
|
The space associated with the activity event |
story - Story
|
Story on which the comment was posted |
type - ActivityType!
|
Type of activity |
user - User
|
The user who initiated the event |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"comment": Comment,
"created": "2016-10-07T01:08:03.420Z",
"space": Space,
"story": Story,
"type": "SPACE_JOIN",
"user": User
}
CommentPostErrors
Description
Error Type of the commentPost
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
CommentPostInput
Description
Input type for Mutation commentPost
Fields
Input Field | Description |
---|---|
assets - [StoryAssetInput!]
|
List of attached assets to the comment |
parentId - ID!
|
The Global id of the Story where the comment is attached |
rich - RichContentInput
|
The comment as a RichContent |
source - CommentSource
|
Source device of the comment |
Example
{
"assets": [StoryAssetInput],
"parentId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"rich": RichContentInput,
"source": "MAIL"
}
CommentPostPayload
Description
Return Type of Mutation commentPost
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
commentEdge - CommentEdge
|
The just added Comment in an Edge |
parent - Story
|
The parent object -- story -- where the comment is attached |
errors - [CommentPostErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "abc123",
"commentEdge": CommentEdge,
"parent": Story,
"errors": [ObjectNotFoundError]
}
CommentResult
Description
Result of a comment matching a search query.
Example
{
"comment": Comment,
"highlightedSnippets": [
"<html>Hello <h1>world</h1></html>"
]
}
CommentSource
Description
Description of where the comment was posted
Values
Enum Value | Description |
---|---|
|
Comment was created via a response to a notification email |
|
Comment was created via the mobile app |
|
Comment was created via the web app |
Example
"MAIL"
Commentable
Description
Describe a commentable object
Fields
Field Name | Description |
---|---|
commenters - UserConnection
|
Retrieve a list of User who has commented the object |
comments - CommentConnection
|
Retrieve a list of comments on the object |
Possible Types
Commentable Types |
---|
Example
{
"commenters": UserConnection,
"comments": CommentConnection
}
ConnectedApp
Description
OAuth Application connected to the instance
Fields
Field Name | Description |
---|---|
id - ID!
|
ID of the object. |
clientId - String!
|
OAuth Client ID to use on token registration flow |
trusted - Boolean!
|
Wether or not users will be asked to grant access to the app |
created - IsoDateTime!
|
Creation date time of the ConnectedApp |
clientSecret - String!
|
Self-descriptive |
redirectUri - URL
|
The redirection URL where users will be redirected when they authorize this app |
defaultScope - String
|
The default scopoe when using this connected app |
title - String!
|
A title used to distinguish this connected app Shown when the user is asked to grant the app access to Elium |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"clientId": "abc123",
"trusted": false,
"created": "2016-10-07T01:08:03.420Z",
"clientSecret": "abc123",
"redirectUri": "http://www.test.com/",
"defaultScope": "abc123",
"title": "xyz789"
}
ConnectedAppConnection
Description
List of connected apps
Fields
Field Name | Description |
---|---|
edges - [ConnectedAppEdge!]
|
A list of edges. |
pageInfo - PageInfo!
|
Information to aid in pagination. |
totalCount - Int
|
Total number of connected apps |
Example
{
"edges": [ConnectedAppEdge],
"pageInfo": PageInfo,
"totalCount": 123
}
ConnectedAppCreateErrors
Description
Error Type of the connectedAppCreate Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
ConnectedAppCreateInput
Description
Input type for Mutation ConnectedAppCreate
Example
{
"title": "abc123",
"redirectUri": URLInput,
"trusted": false
}
ConnectedAppCreatePayload
Description
Return Type of Mutation connectedAppCreate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
connectedApp - ConnectedApp
|
The created ConnectedApp |
edge - ConnectedAppEdge
|
The just added ConnectedApp in an Edge |
instance - Instance
|
The currrent Instance |
errors - [ConnectedAppCreateErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "abc123",
"connectedApp": ConnectedApp,
"edge": ConnectedAppEdge,
"instance": Instance,
"errors": [ObjectNotFoundError]
}
ConnectedAppDeleteErrors
Description
Error Type of the connectedAppDelete
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
ConnectedAppDeleteInput
Description
Input type for Mutation connectedAppDelete
Fields
Input Field | Description |
---|---|
id - ID!
|
The global ID of the ConnectedApp to delete |
Example
{"id": "eWVhaCByaWdodCBpdCdzIGI2NA=="}
ConnectedAppDeletePayload
Description
Return Type of Mutation connectedAppDelete
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
deletedId - ID
|
The deleted ConnectedApp global ID |
instance - Instance
|
The currrent Instance |
errors - [ConnectedAppDeleteErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"deletedId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"instance": Instance,
"errors": [ObjectNotFoundError]
}
ConnectedAppEdge
Description
An edge in a connection.
Fields
Field Name | Description |
---|---|
cursor - String!
|
A cursor for use in pagination. |
node - ConnectedApp!
|
The item at the end of the edge. |
Example
{
"cursor": "xyz789",
"node": ConnectedApp
}
ConnectedAppEditErrors
Description
Error Type of the ConnectedAppEdit
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
ConnectedAppEditInput
Description
Input type for Mutation connectedAppEdit
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"title": "xyz789",
"redirectUri": URLInput,
"trusted": true
}
ConnectedAppEditPayload
Description
Return Type of Mutation connectedAppEdit
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
connectedApp - ConnectedApp
|
The edited ConnectedApp |
instance - Instance
|
The currrent Instance |
errors - [ConnectedAppEditErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "abc123",
"connectedApp": ConnectedApp,
"instance": Instance,
"errors": [ObjectNotFoundError]
}
ContentFeedTab
Description
A tab that dislays a content feed and an activity log scoped to that space.
Fields
Field Name | Description |
---|---|
icon - OpaqueID
|
Icon representing the tab |
id - ID!
|
ID of the object. |
label - String!
|
The label of the tab for the current user's lang. |
labels - TranslatedString!
|
Translated names of the tab. |
slug - String!
|
Short human representation of the tab. |
Example
{
"icon": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"label": "xyz789",
"labels": {"en": "a Name", "fr": "Un Nom"},
"slug": "abc123"
}
ContentLikeErrors
Description
Error Type of the contentLike
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
ContentLikeInput
ContentLikePayload
Description
Return Type of Mutation contentLike
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
content - Node
|
Reference to the liked content either a Story or a Comment |
errors - [ContentLikeErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"content": Node,
"errors": [ObjectNotFoundError]
}
ContentLikedInput
Description
Input type for contentLiked Subscription
Example
{
"clientSubscriptionId": "abc123",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}
ContentLikedPayload
Description
Return Type of contentLiked Subscription
Example
{
"clientSubscriptionId": "abc123",
"parent": Node,
"userEdge": UserEdge
}
ContributorsFilter
Description
Possible filters to limit contributor results
Values
Enum Value | Description |
---|---|
|
All contributors are returned (EFFECTIVE as well as INVITED ) |
|
Only contributors that have effectively contributed to the content are returned |
|
Only contributors that have been invited but haven't contributed to the content are returned |
Example
"ALL"
CreoleRichContent
Description
A Formated content using Creole Markup. https://github.com/jedie/python-creole/
Fields
Field Name | Description |
---|---|
creole - String
|
The content in Creole markup. |
format - RichFormat
|
Returns the format of the content. |
html - HTML
|
An html version (deprecated) Use previewHtml instead |
previewHtml - HTML
|
Returns a preview version of the content in HTML. |
text - String
|
Returns the content as text. |
Example
{
"creole": "xyz789",
"format": "CREOLE",
"html": "<html>Hello <h1>world</h1></html>",
"previewHtml": "<html>Hello <h1>world</h1></html>",
"text": "abc123"
}
DateInterval
Description
Specify the interval between the ticks
Values
Enum Value | Description |
---|---|
|
Make a tick every day |
|
Make a tick every Week |
|
Make a tick every Month |
Example
"DAY"
DatetimeWrapper
Description
Container type for Date values
Fields
Field Name | Description |
---|---|
valueDatetime - IsoDateTime!
|
The value of the attribute |
Example
{
"valueDatetime": "2016-10-07T01:08:03.420Z"
}
DeletedStory
Description
A story that is deleted
Fields
Field Name | Description |
---|---|
title - String
|
"The title of the story |
slug - Int!
|
The slug of the story |
deleted - IsoDateTime!
|
Timestamp of when the story was deleted |
deletedBy - User
|
User who deleted the story |
Example
{
"title": "abc123",
"slug": 123,
"deleted": "2016-10-07T01:08:03.420Z",
"deletedBy": User
}
DeletedStoryConnection
Description
List of results of DeletedStory
Fields
Field Name | Description |
---|---|
edges - [DeletedStoryEdge!]
|
A list of edges. |
pageInfo - PageInfo!
|
Information to aid in pagination. |
totalCount - Int!
|
Identifies the total count of items in the connection. |
Example
{
"edges": [DeletedStoryEdge],
"pageInfo": PageInfo,
"totalCount": 123
}
DeletedStoryEdge
Description
An edge in a connection.
Fields
Field Name | Description |
---|---|
cursor - String!
|
A cursor for use in pagination. |
node - DeletedStory!
|
The item at the end of the edge. |
Example
{
"cursor": "xyz789",
"node": DeletedStory
}
DiffError
Description
Represents possible errors that can occur during a Diff operations between versions.
Values
Enum Value | Description |
---|---|
|
The base format of the source or target is invalid. |
|
Indicates an unknown error occurred during diffing. |
Example
"INVALID"
DigestFrequency
Description
Defines the frequency at which a digest should be generated.
Values
Enum Value | Description |
---|---|
|
Default frequency, typically daily. |
|
Generate a digest every day. |
|
Generate a digest every Monday. |
|
Generate a digest every Monday and Wednesday. |
|
Generate a digest every month. |
|
Never generate a digest. |
Example
"DEFAULT"
DirectorySearchQuery
Description
Input type for querying the directory.
Fields
Input Field | Description |
---|---|
facets - [ID!]
|
Facets to filter the search by. |
hashtags - [ID!]
|
Hashtags to filter the search by. |
limit - Int!
|
Limit the number of results returned. Default is 10. Max 100. Default = 10 |
sort - DirectorySearchSort!
|
Sort order for the search results. Default is RELEVANCE. Default = RELEVANCE |
start - Int!
|
Start index for pagination. Default is 0. Default = 0 |
tags - [ID!]
|
Tags to filter the search by. |
text - String
|
Text to search for in the directory. |
Example
{
"facets": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"hashtags": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"limit": 987,
"sort": "ALPHABETICAL",
"start": 987,
"tags": ["eWVhaCByaWdodCBpdCdzIGI2NA=="],
"text": "abc123"
}
DirectorySearchResponse
Description
Type representing the response from a directory search.
Fields
Field Name | Description |
---|---|
facets - [FacetResult!]!
|
Facet results from the search. |
hashtags - [HashtagResult!]!
|
Hashtag matching results from the search. |
searchHashtags - [HashtagResult!]
|
Search for hashtags matching the given query string. |
Arguments
|
|
searchTags - [TagResult!]
|
Search for tags within a specific facet matching the given query string. |
spaceGroups - [SpaceGroupResult!]!
|
Results for space groups from the search. not possible anymore |
spaces - [SpaceResult!]!
|
Results for spaces from the search. not possible anymore |
suggestedText - String
|
Suggested text based on the search query. used for query correction - "did you mean?" |
totalCount - Int!
|
Total count of search results. |
users - [DirectorySearchResult!]!
|
Users matching the search criteria. |
Example
{
"facets": [FacetResult],
"hashtags": [HashtagResult],
"searchHashtags": [HashtagResult],
"searchTags": [TagResult],
"spaceGroups": [SpaceGroupResult],
"spaces": [SpaceResult],
"suggestedText": "xyz789",
"totalCount": 123,
"users": [DirectorySearchResult]
}
DirectorySearchResult
Description
Type representing a single search result in the directory.
Example
{
"highlightedFullName": "<html>Hello <h1>world</h1></html>",
"user": User
}
DirectorySearchSort
Description
Defines the sorting options for directory searches.
Values
Enum Value | Description |
---|---|
|
Sort results alphabetically. |
|
Sort results by newest first. |
|
Sort results by oldest first. |
|
Sort results by relevance score. (mix of popularity and recency, accross multiple fields) |
Example
"ALPHABETICAL"
DisableStandardContentErrors
Description
Error Type of the disableStandardContent
Mutation
Types
Union Types |
---|
Example
PermissionError
DisableStandardContentInput
Description
Input type for Mutation disableStandardContent
Fields
Input Field | Description |
---|---|
disabledStandardContent - [String!]!
|
List of standard content to disable story, link, file, event |
Example
{"disabledStandardContent": ["xyz789"]}
DisableStandardContentPayload
Description
Return Type of Mutation disableStandardContent
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
instance - Instance
|
The updated current instance |
errors - [DisableStandardContentErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "abc123",
"instance": Instance,
"errors": [PermissionError]
}
DraftsFilter
Description
Defines the filter options for drafts.
Values
Enum Value | Description |
---|---|
|
Include all drafts in the filter. |
|
Include only collaborative drafts in the filter. draft that are stored in a space, thus accessible to contributors of the space |
|
Include only drafts created by the current user in his private space |
Example
"ALL"
DrawingAsset
Description
Asset representing a drawing
Fields
Field Name | Description |
---|---|
elements - [JSON!]!
|
All the forms in the drawings (lines, circles, rects, texts,...) |
backgroundColor - Color
|
Background color of the drawing (needed for Excalidraw) |
embed - JSON
|
Text representation of the drawing as Excalidraw state |
slug - OpaqueID!
|
Identifier of the asset, you probably don't need it |
uuid - UUID!
|
UUID of the asset as referenced in slate body |
lang - Lang
|
The language of the asset. currently unused unused |
created - IsoDateTime!
|
Creation date of the current asset |
metadata - [AssetMetadata!]
|
The metadatas associated with the asset. |
Example
{
"elements": [{}],
"backgroundColor": "#CCCCCC",
"embed": {},
"slug": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"uuid": "7aac93c5-a56c-4528-b43e-457834a796c9",
"lang": "fr",
"created": "2016-10-07T01:08:03.420Z",
"metadata": [AssetMetadata]
}
DrawingPublicAsset
Description
A drawing asset for a public story
Fields
Field Name | Description |
---|---|
elements - [JSON!]!
|
All the forms in the drawings (lines, circles, rects, texts,...) |
backgroundColor - Color
|
Background color of the drawing (needed for Excalidraw) |
embed - JSON
|
Image representation of the drawing |
uuid - UUID!
|
UUID of the asset as referenced in slate body |
lang - Lang
|
The language of the asset. currently unused unused |
created - IsoDateTime!
|
Creation date of the current asset |
metadata - [AssetMetadata!]
|
The metadatas associated with the asset. |
Example
{
"elements": [{}],
"backgroundColor": "#CCCCCC",
"embed": {},
"uuid": "7aac93c5-a56c-4528-b43e-457834a796c9",
"lang": "fr",
"created": "2016-10-07T01:08:03.420Z",
"metadata": [AssetMetadata]
}
DuplicatedAsset
Description
A duplicated Asset item
Fields
Field Name | Description |
---|---|
asset - Asset!
|
An asset that is duplicated. This represents an asset in one of the stories below (only FileAsset , excluding images for the moment) |
stories - [Story!]!
|
List of visible stories where this asset is present |
duplicateCount - Int!
|
Number of time this asset was found |
Example
{
"asset": Asset,
"stories": [Story],
"duplicateCount": 987
}
DuplicatedAssetConnection
Description
List of duplicated assets
Fields
Field Name | Description |
---|---|
edges - [DuplicatedAssetEdge!]
|
A list of edges. |
pageInfo - PageInfo!
|
Information to aid in pagination. |
totalCount - Int
|
Total number of duplicated Assets |
Example
{
"edges": [DuplicatedAssetEdge],
"pageInfo": PageInfo,
"totalCount": 123
}
DuplicatedAssetEdge
Description
An edge in a connection.
Fields
Field Name | Description |
---|---|
cursor - String!
|
A cursor for use in pagination. |
node - DuplicatedAsset!
|
The item at the end of the edge. |
Example
{
"cursor": "abc123",
"node": DuplicatedAsset
}
EmailAddress
Description
A scalar type representing a well-formed email address. note: email addresses validation might be slightly different from the RFC 5322
Example
"test@test.com"
EmailAlreadyExistsError
EmailAsset
Description
Type representing an email content asset in a Story.
Fields
Field Name | Description |
---|---|
content - URL
|
URL pointing to the content of the email asset. |
contentType - EmailAssetContentType
|
Content type of the email asset, either HTML or plain text. |
created - IsoDateTime!
|
Creation date of the current asset. |
date - IsoDateTime
|
Date associated with the email asset. |
digest - String
|
Digest of the email content. |
embed - JSON
|
Embeds the email asset, optionally including public links. |
Arguments
|
|
fromAddress - String
|
Email address from which the email was sent. |
lang - Lang
|
The language of the asset. Currently unused. unused |
slug - OpaqueID!
|
Identifier of the asset, typically used for referencing. |
metadata - [AssetMetadata!]
|
Metadata associated with the asset, providing additional information. |
subject - String
|
Subject line of the email. |
uuid - UUID!
|
UUID of the asset as referenced in slate body, ensuring uniqueness. |
Example
{
"content": "http://www.test.com/",
"contentType": "HTML",
"created": "2016-10-07T01:08:03.420Z",
"date": "2016-10-07T01:08:03.420Z",
"digest": "xyz789",
"embed": {},
"fromAddress": "abc123",
"lang": "fr",
"slug": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"metadata": [AssetMetadata],
"subject": "abc123",
"uuid": "7aac93c5-a56c-4528-b43e-457834a796c9"
}
EmailAssetContentType
Description
Defines the content type of an email asset.
Values
Enum Value | Description |
---|---|
|
Indicates the email content is in HTML format. |
|
Indicates the email content is in plain text format. |
Example
"HTML"
EmailNotificationPreferences
Description
Preferences for the Email notifications for a user
Fields
Field Name | Description |
---|---|
additionalViews - Boolean!
|
Send an Email when an StoryGrant is added for you on a given content |
annotations - Boolean!
|
Send an Email when an Annotation is marked as Resolved, post or commented |
comments - Boolean!
|
Send an Email when a new comment is added |
mentions - Boolean!
|
Send an Email when the user has been mentioned (in comments or contents) |
inviteToContribute - Boolean!
|
Send an Email when the user has been invited to contribute to a content |
pings - Boolean!
|
Send an Email when a user send you a ping on a content. |
storyPosts - Boolean!
|
Send an Email when a new content is posted |
storyUpdates - Boolean!
|
Send an Email when a content is updated |
expiringContent - Boolean!
|
Send a weekly Email with the weekly expiring content |
approvalProcess - Boolean!
|
Send Email about approval process (assigned, approved, ...) |
Example
{
"additionalViews": true,
"annotations": false,
"comments": false,
"mentions": true,
"inviteToContribute": false,
"pings": false,
"storyPosts": true,
"storyUpdates": true,
"expiringContent": false,
"approvalProcess": true
}
EmailNotificationPreferencesInput
Description
Input type for Mutation emailNotificationPreferences
Fields
Input Field | Description |
---|---|
additionalViews - Boolean
|
Enable or disable Sending an Email message when an StoryGrant is added for you on a given content (if not provided then left untouched) |
annotations - Boolean
|
Enable or disable Sending an Email when an Annotation is marked as Resolved, post or commented (if not provided then left untouched) |
comments - Boolean
|
Enable or disable Sending an Email when a comment is made on a content you follow |
mentions - Boolean
|
Enable or disable Sending an Email when someone mention you |
inviteToContribute - Boolean
|
Enable or disable sending an Email when the user has been invited to contribute to a content |
pings - Boolean
|
Enable or disable sending an Email when you are invited to read a content |
storyPosts - Boolean
|
Enable or disable sending about new contents in Spaced configured to send notifications |
storyUpdates - Boolean
|
Enable or disable sending about update of followed content |
expiringContent - Boolean
|
Enable or disable sending weekly Email message with the expiring content for the week of each user |
approvalProcess - Boolean
|
Enable or disable sending Email about approval process (assigned, approved, ...) |
Example
{
"additionalViews": false,
"annotations": true,
"comments": true,
"mentions": false,
"inviteToContribute": true,
"pings": true,
"storyPosts": true,
"storyUpdates": false,
"expiringContent": false,
"approvalProcess": false
}
EmailPipeline
Description
Email Pipeline ingest emails and create related Story
.
Fields
Field Name | Description |
---|---|
id - ID!
|
ID of the object. |
extension - String!
|
Email extension part to send to. (ex myplatform.elium.com+extension@in.elium.com) Extension should :
|
description - String
|
Description of the Pipeline usage |
email - EmailAddress!
|
Email address where you need to send the message to be ingested |
ingestType - EmailPipelineIgestType!
|
Determine the way the content will be created once recieved |
createWithOwner - User
|
When ingesting content, create it with specific owner or with the user sending the email (sender email if empty) |
createInSpace - Space
|
When ingesting content, create it in the given space (sender's personal space if empty) |
createWithTags - [Tag!]!
|
When ingesting content, create it with those tags |
createWithHashtags - [Hashtag!]!
|
When ingesting content, create it with those Hashtags |
createPublish - Boolean!
|
When ingesting content, automatically publish it |
verifyPermissions - Boolean!
|
When ingesting content, create it in the space and respect create permission for the sender |
notifySender - Boolean!
|
Notify the user sending the pipeline about the result of the operation |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"extension": "xyz789",
"description": "xyz789",
"email": "test@test.com",
"ingestType": "BODY_FILES",
"createWithOwner": User,
"createInSpace": Space,
"createWithTags": [Tag],
"createWithHashtags": [Hashtag],
"createPublish": true,
"verifyPermissions": true,
"notifySender": true
}
EmailPipelineConnection
Description
List of results of EmailPipeline
Fields
Field Name | Description |
---|---|
edges - [EmailPipelineEdge!]
|
A list of edges. |
pageInfo - PageInfo!
|
Information to aid in pagination. |
totalCount - Int!
|
Identifies the total count of items in the connection. |
Example
{
"edges": [EmailPipelineEdge],
"pageInfo": PageInfo,
"totalCount": 987
}
EmailPipelineCreateErrors
Description
Error Type of the emailPipelineCreate Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
EmailPipelineCreateInput
Description
Input type for Mutation emailPipelineCreate
Fields
Input Field | Description |
---|---|
extension - String!
|
Email extension part to send to. Extension should :
|
description - String!
|
Description of the Pipeline usage |
ingestType - EmailPipelineIgestType!
|
Determine the way the content will be created once recieved |
createWithOwner - ID
|
When ingesting content, create it with specific owner or with the user sending the email (sender email if empty) Global ID of User |
createInSpace - ID
|
When ingesting content, create it in the given space (sender's personal space if empty) Global ID of User |
createWithTags - [ID!]
|
When ingesting content, create it with those tags Global ID of Tag |
createWithHashtags - [ID!]
|
When ingesting content, create it with those Hashtags Global ID of Hashtag |
createPublish - Boolean!
|
When ingesting content, automatically publish it |
verifyPermissions - Boolean!
|
When ingesting content, create it in the space and respect create permission for the sender |
notifySender - Boolean!
|
Notify the user sending the pipeline about the result of the operation |
Example
{
"extension": "abc123",
"description": "xyz789",
"ingestType": "BODY_FILES",
"createWithOwner": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"createInSpace": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"createWithTags": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"createWithHashtags": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"createPublish": true,
"verifyPermissions": false,
"notifySender": false
}
EmailPipelineCreatePayload
Description
Return Type of Mutation emailPipelineCreate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
pipeline - EmailPipeline
|
The Created EmailPipeline |
instance - Instance
|
The currrent Instance |
errors - [EmailPipelineCreateErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "abc123",
"pipeline": EmailPipeline,
"instance": Instance,
"errors": [ObjectNotFoundError]
}
EmailPipelineDeleteErrors
Description
Error Type of the EmailPipelineDelete
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
EmailPipelineDeleteInput
Description
Input type for Mutation emailPipelineDelete
Fields
Input Field | Description |
---|---|
id - ID!
|
The global ID of the EmailPipeline to delete |
Example
{"id": "eWVhaCByaWdodCBpdCdzIGI2NA=="}
EmailPipelineDeletePayload
Description
Return Type of Mutation emailPipelineDelete
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
deletedId - ID
|
The deleted EmailPipeline global ID |
instance - Instance
|
The currrent Instance |
errors - [EmailPipelineDeleteErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"deletedId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"instance": Instance,
"errors": [ObjectNotFoundError]
}
EmailPipelineEdge
Description
An edge in a connection.
Fields
Field Name | Description |
---|---|
cursor - String!
|
A cursor for use in pagination. |
node - EmailPipeline!
|
The item at the end of the edge. |
Example
{
"cursor": "abc123",
"node": EmailPipeline
}
EmailPipelineEditErrors
Description
Error Type of the0 EmailPipelineEdit
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
EmailPipelineEditInput
Description
Input type for Mutation emailPipelineEdit
Fields
Input Field | Description |
---|---|
id - ID!
|
The global ID of the EmailPipeline to edit |
extension - String
|
Email extension part to send to. Extension should :
|
description - String
|
Description of the Pipeline usage |
ingestType - EmailPipelineIgestType
|
Determine the way the content will be created once recieved |
createWithOwner - ID
|
When ingesting content, create it with specific owner or with the user sending the email (sender email if empty) Global ID of User |
removeCreateWithOwner - Boolean
|
To remove the createWithOwner field value |
createInSpace - ID
|
When ingesting content, create it in the given space (sender's personal space if empty) Global ID of Space |
removeCreateInSpace - Boolean
|
To remove the createInSpace field value |
createWithTags - [ID!]
|
When ingesting content, create it with those tags Global ID of Tag |
createWithHashtags - [ID!]
|
When ingesting content, create it with those Hashtags Global ID of Hashtag |
createPublish - Boolean
|
When ingesting content, automatically publish it |
verifyPermissions - Boolean
|
When ingesting content, create it in the space and respect create permission for the sender |
notifySender - Boolean
|
Notify the user sending the pipeline about the result of the operation |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"extension": "xyz789",
"description": "xyz789",
"ingestType": "BODY_FILES",
"createWithOwner": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"removeCreateWithOwner": true,
"createInSpace": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"removeCreateInSpace": false,
"createWithTags": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"createWithHashtags": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"createPublish": false,
"verifyPermissions": false,
"notifySender": false
}
EmailPipelineEditPayload
Description
Return Type of Mutation emailPipelineEdit
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
pipeline - EmailPipeline
|
The edited EmailPipeline |
instance - Instance
|
The currrent Instance |
errors - [EmailPipelineEditErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "abc123",
"pipeline": EmailPipeline,
"instance": Instance,
"errors": [ObjectNotFoundError]
}
EmailPipelineIgestType
Description
When receiveing an email via Pipeline determine the way story will be created
Values
Enum Value | Description |
---|---|
|
Body of mail is in highlight, and each attachement is a new story with file in highlight |
|
Body of mail is in highlight, attachements are ignored |
|
Body is ignored, each attachement creates a new content with file in highlight |
|
body is ignored, each links in the body is a new content with link in highlight |
|
Mail body is Story content and attachements are in a gallery at the bottom |
Example
"BODY_FILES"
EmailPipelineOrderBy
Description
Ordering options for EmailPipelineConnection.
Values
Enum Value | Description |
---|---|
|
Order by the email extension |
|
Order by the description |
|
Order by the EmailPipelineIgestType |
Example
"EXTENSION"
EmptyTab
Description
A SpaceTab is a sub-level navigation for a space. This provides a filtered / formated view of the contents in the space.
Fields
Field Name | Description |
---|---|
icon - OpaqueID
|
Icon representing the tab |
id - ID!
|
ID of the object. |
label - String!
|
The label of the tab for the current user's lang. |
labels - TranslatedString!
|
Translated names of the tab. |
slug - String!
|
Short human representation of the tab. |
subTabs - [SpaceTab!]!
|
List of Tabs that should be place as children of this tab |
Example
{
"icon": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"label": "xyz789",
"labels": {"en": "a Name", "fr": "Un Nom"},
"slug": "xyz789",
"subTabs": [SpaceTab]
}
Event
Description
An event attached to a Story
. This can be used to schedule meetings, deadlines, etc. users can be invited and RSVP to the event.
Fields
Field Name | Description |
---|---|
end - IsoDateTime!
|
End datetime of the event |
invitation - Invitation!
|
Invitation for linked of the event |
start - IsoDateTime!
|
Start datetime of the event |
timezone - LegacyTimezone
|
Timezone for this event. Legacy format. Use timezoneKey instead |
timezoneKey - Timezone
|
Timezone for this event |
Example
{
"end": "2016-10-07T01:08:03.420Z",
"invitation": Invitation,
"start": "2016-10-07T01:08:03.420Z",
"timezone": LegacyTimezone,
"timezoneKey": Timezone
}
EventAttributeInput
Description
Input to create an event
Fields
Input Field | Description |
---|---|
end - IsoDateTime!
|
End datetime of the event |
start - IsoDateTime!
|
Start datetime of the event |
timezone - Timezone!
|
Timezone on which the event is happening |
Example
{
"end": "2016-10-07T01:08:03.420Z",
"start": "2016-10-07T01:08:03.420Z",
"timezone": Timezone
}
EventFilter
Description
Filter to select the Events based on their status
Values
Enum Value | Description |
---|---|
|
does not filter events by status |
|
select only events that are declined |
|
select only events that are ongoing |
|
select only events that are in the past |
|
select only events that are pending a response |
|
select only events that are in the future |
|
Select event as an ICS file |
Example
"ALL"
EventInviteErrors
Description
Error Type of the eventInvite
Mutation
Types
Union Types |
---|
Example
PermissionError
EventInviteInput
Description
Input type for Mutation eventInvite
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"invite": false,
"participants": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
]
}
EventInvitePayload
Description
Return Type of Mutation eventInvite
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
story - Story
|
The Story on which the event is happening |
errors - [EventInviteErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"story": Story,
"errors": [PermissionError]
}
EventParticipant
EventRespondErrors
Description
Error Type of the eventRespond
Mutation
Types
Union Types |
---|
Example
PermissionError
EventRespondInput
EventRespondPayload
Description
Return Type of Mutation eventRespond
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
story - Story
|
The Story on which the event is happening |
errors - [EventRespondErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"story": Story,
"errors": [PermissionError]
}
EventSource
Description
Event source
Values
Enum Value | Description |
---|---|
|
Elium Mobile App |
|
Elium Web App |
|
Incoming email |
|
Microsoft Office Sharepoint Integration |
|
Slack Integration |
|
Microsoft Teams Integration |
|
Microsoft Office WOPI edition |
|
Facebook Workplace Integration |
|
Elium Browser Extension |
Example
"MOBILE"
EventValue
Description
Value of an Event in an Attribute
Fields
Field Name | Description |
---|---|
end - IsoDateTime!
|
End datetime of the event |
start - IsoDateTime!
|
Start datetime of the event |
timezone - LegacyTimezone
|
Timezone for this event. Legacy format. Use timezoneKey instead |
timezoneKey - Timezone
|
Timezone for this event |
Example
{
"end": "2016-10-07T01:08:03.420Z",
"start": "2016-10-07T01:08:03.420Z",
"timezone": LegacyTimezone,
"timezoneKey": Timezone
}
ExpireFilter
Description
Filter to select the Contents based on their expiration date
Values
Enum Value | Description |
---|---|
|
does not filter content by expiration |
|
select only content where expired date is before now |
|
select noth content where expired date is coming soon (in 30 days) or before now |
|
select only content where expired date is coming soon (in 30 days) |
|
select only content where no expiration date is set |
|
select content with no expiration, but seems to be good candidate for one |
|
select only content where the expiration date is in the future |
Example
"ALL"
Facet
Description
Category of tags
Fields
Field Name | Description |
---|---|
id - ID!
|
ID of the object. |
isGlobal - Boolean!
|
If isGlobal, the facet is available for all the spaces |
name - String!
|
Name of the facet in the user's prefered lang |
names - TranslatedString
|
List of names in the different langs defined |
restricted - Boolean!
|
If restricted, the list of tags of this facet is predefined by the administrator and cannot be enriched by contributors |
searchTags - [TagResult!]
|
Search tags that are used on contents Use tags instead |
Arguments
|
|
tags - TagConnection
|
Return a list of all tags contained in the facet |
slug - String!
|
Short human representation of the Facet . |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"isGlobal": false,
"name": "abc123",
"names": {"en": "a Name", "fr": "Un Nom"},
"restricted": true,
"searchTags": [TagResult],
"tags": TagConnection,
"slug": "xyz789"
}
FacetCreateErrors
Description
Error Type of the facetCreate
Mutation
Types
Union Types |
---|
Example
PermissionError
FacetCreateInput
Description
Input type for Mutation facetCreate
Fields
Input Field | Description |
---|---|
mandatory - Boolean!
|
If true, all new content in spaces will be required to have a tag using this facet. Default = false |
names - TranslatedString!
|
Translated array of names of the facet |
restricted - Boolean!
|
If true, only admins can add attach new tags onto the facet. Default = false |
spaces - [ID!]
|
List of spaces where the tag is available or mandatory |
Example
{
"mandatory": true,
"names": {"en": "a Name", "fr": "Un Nom"},
"restricted": true,
"spaces": ["eWVhaCByaWdodCBpdCdzIGI2NA=="]
}
FacetCreatePayload
Description
Return Type of Mutation facetCreate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
facet - Facet
|
The created Facet object |
errors - [FacetCreateErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"facet": Facet,
"errors": [PermissionError]
}
FacetFilter
Description
Filter to select the Facets based on their mandatory status
Values
Enum Value | Description |
---|---|
|
does not filter facet by mandatory status |
|
select only Optional facets |
|
select only Mandatory facets |
Example
"ALL"
FacetResult
Description
Result of a Facet facet
Fields
Field Name | Description |
---|---|
facet - Facet!
|
The facet |
partial - Boolean!
|
Is the facet's tag fully returned in tags |
tags - [TagResult!]!
|
Tags matching the query in the facet |
Example
{
"facet": Facet,
"partial": false,
"tags": [TagResult]
}
File
Description
Type to send file to the server File must be uploaded using another enpoint (/api/upload/file) and the result token should be send as a File
scalar in the form of a token ".eJw...xMWA"
Example
"5ee411f1-6632-4388-b994-9fda4caf5c43"
FileAsset
Description
Represents a uploaded File asset embeded in a Story
(pdf, image, ...)
Fields
Field Name | Description |
---|---|
antiVirusStatus - AssetAntiVirusStatus
|
Gives the status of the file regarding the anti-virus. |
cloudDetails - CloudDetails
|
Contains cloud-specific details from the file if imported from a cloud. |
created - IsoDateTime!
|
The creation date of the current asset. |
digest - String
|
The hash digest of the file asset. |
downloadUrl - URL
|
The download URL of the file asset. This will be empty if the file is not downloadable (e.g. a protected content) |
embed - JSON
|
Embeded extended information about the file Preview links, thumbnail_url , mimetype , ... |
Arguments
|
|
filename - String
|
The filename of the file asset as uploaded |
fileId - OpaqueID!
|
The unique identifier of the file asset. |
filesize - Int
|
The size of the file asset in bytes. |
lang - Lang
|
The language of the asset. (deprecated) unused |
slug - OpaqueID!
|
The slug identifier of the asset you probably don't need it |
metadata - [AssetMetadata!]
|
The metadata associated with the asset. |
mimetype - MimeType
|
The MIME type of the file asset. |
sharepointEditUrl - URL
|
Deprecated edit in office URL |
title - String
|
The title of the file asset (might be different than filename). |
uuid - UUID!
|
The UUID of the asset as referenced in the slate body. |
wopiEmbed - WOPIEmbed
|
WOPI integration configuration for this Asset . Empty if not available (because of type, mode, or flag). |
Arguments
|
Example
{
"antiVirusStatus": "DISABLED",
"cloudDetails": GoogleCloudDetails,
"created": "2016-10-07T01:08:03.420Z",
"digest": "xyz789",
"downloadUrl": "http://www.test.com/",
"embed": {},
"filename": "abc123",
"fileId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"filesize": 123,
"lang": "fr",
"slug": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"metadata": [AssetMetadata],
"mimetype": "image/png",
"sharepointEditUrl": "http://www.test.com/",
"title": "abc123",
"uuid": "7aac93c5-a56c-4528-b43e-457834a796c9",
"wopiEmbed": WOPIEmbed
}
FilePublicAsset
Description
A File
asset for a public story
Fields
Field Name | Description |
---|---|
created - IsoDateTime!
|
Creation date of the current asset |
digest - String
|
The hash digest of the file asset. |
downloadUrl - URL
|
Url for the download of the file |
embed - JSON
|
Details of the file asset. |
filename - String
|
File name of the asset. |
filesize - Int
|
File size of the file in bytes. |
lang - Lang
|
The language of the asset. currently unused unused |
title - String
|
Manually set title of the asset |
metadata - [AssetMetadata!]
|
The metadatas associated with the asset. |
mimetype - MimeType
|
Mime type of the file asset. |
uuid - UUID!
|
UUID of the asset as referenced in slate body |
Example
{
"created": "2016-10-07T01:08:03.420Z",
"digest": "xyz789",
"downloadUrl": "http://www.test.com/",
"embed": {},
"filename": "abc123",
"filesize": 123,
"lang": "fr",
"title": "xyz789",
"metadata": [AssetMetadata],
"mimetype": "image/png",
"uuid": "7aac93c5-a56c-4528-b43e-457834a796c9"
}
Folder
Description
An organized collection of content. Probably generated by an import of contents
Fields
Field Name | Description |
---|---|
created - IsoDateTime
|
Creation date of the current folder |
folders - [Folder!]
|
Children folders of the current folder |
id - ID!
|
ID of the object. |
name - String
|
Human readable name of the folder |
path - [Folder!]
|
Parent folder of the current folder |
slug - Int!
|
Human readable representation of folder |
space - Space
|
Space where the folder is located |
stories - [ImportedStory!]
|
Get Stories in the folder |
Example
{
"created": "2016-10-07T01:08:03.420Z",
"folders": [Folder],
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"name": "xyz789",
"path": [Folder],
"slug": 123,
"space": Space,
"stories": [ImportedStory]
}
FolderAddTagErrors
Description
Error Type of the folderAddTag
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
FolderAddTagInput
FolderAddTagPayload
Description
Return Type of Mutation folderAddTag
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [FolderAddTagErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError]
}
FolderDeleteErrors
Description
Error Type of the folderDelete
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
FolderDeleteInput
Description
Input type for Mutation folderDelete
Fields
Input Field | Description |
---|---|
id - ID!
|
Node ID of the Folder to remove |
Example
{"id": "eWVhaCByaWdodCBpdCdzIGI2NA=="}
FolderDeletePayload
Description
Return Type of Mutation folderDelete
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [FolderDeleteErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError]
}
FolderMoveErrors
Description
Error Type of the folderMove
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
FolderMoveInput
Description
Input type for Mutation folderMove
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"ownerId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"spaceId": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}
FolderMovePayload
Description
Return Type of Mutation folderMove
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [FolderMoveErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError]
}
FullNameAttributeInput
FullNameValue
GoogleCloudDetails
Description
Details related to Google Cloud files.
Example
{
"fileId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"revision": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"url": "http://www.test.com/"
}
GoogleMeService
Description
Service details for Google integration.
Fields
Field Name | Description |
---|---|
appKey - String
|
Application key for the Google app. |
clientId - String
|
Client ID for the Google app. |
connected - Boolean!
|
Indicates if the Google app is connected. |
email - EmailAddress
|
Email address conntected with the Google app. |
name - String
|
Name of the user conntected with the Google app. |
setupUrl - URL
|
URL for setting up the Google app authentication. |
type - MeServiceType!
|
Type of the Google app. |
Example
{
"appKey": "abc123",
"clientId": "xyz789",
"connected": false,
"email": "test@test.com",
"name": "xyz789",
"setupUrl": "http://www.test.com/",
"type": "GOOGLE"
}
HTML
Description
A Stringify version of an HTML content
Example
"<html>Hello <h1>world</h1></html>"
HTMLRichContent
Description
A Formatted content. This can have different format.
Fields
Field Name | Description |
---|---|
format - RichFormat
|
Format of the content (HTML) |
html - HTML
|
Unused @deprecated Use previewHtml instead |
previewHtml - HTML
|
Returns a preview version of the content in HTML. |
text - String
|
Returns the content as text. |
Example
{
"format": "CREOLE",
"html": "<html>Hello <h1>world</h1></html>",
"previewHtml": "<html>Hello <h1>world</h1></html>",
"text": "abc123"
}
Hashtag
Description
A Tag without Facet
Fields
Field Name | Description |
---|---|
id - ID!
|
ID of the object. |
name - String!
|
Name of the hashtag. |
names - TranslatedString
|
Translated names of the hashtag. |
slug - Int!
|
Slug representing the hashtag, typically used in URLs. |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"name": "abc123",
"names": {"en": "a Name", "fr": "Un Nom"},
"slug": 987
}
HashtagConnection
Description
List of results of Hashtag
Fields
Field Name | Description |
---|---|
edges - [HashtagEdge!]
|
A list of edges. |
pageInfo - PageInfo!
|
Information to aid in pagination. |
totalCount - Int!
|
Identifies the total count of items in the connection. |
Example
{
"edges": [HashtagEdge],
"pageInfo": PageInfo,
"totalCount": 987
}
HashtagCreateErrors
Description
Error Type of the hashTagCreate
Mutation
Types
Union Types |
---|
Example
PermissionError
HashtagCreateInput
Description
Input type for Mutation hashtagCreate
Fields
Input Field | Description |
---|---|
name - String
|
Name of the tag in the Lang of the user (if names are not passed) |
names - TranslatedString
|
Translated array of names |
Example
{
"name": "xyz789",
"names": {"en": "a Name", "fr": "Un Nom"}
}
HashtagCreatePayload
Description
Return Type of Mutation hashtagCreate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
hashtag - Hashtag
|
The created Hashtag |
me - Me
|
The current user |
errors - [HashtagCreateErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"hashtag": Hashtag,
"me": Me,
"errors": [PermissionError]
}
HashtagEdge
HashtagResult
ID
Description
The ID
scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as "4"
) or integer (such as 4
) input value will be accepted as an ID.
Example
"eWVhaCByaWdodCBpdCdzIGI2NA=="
ImportedStory
Description
Simplified Imported Object linked to a Story
Fields
Field Name | Description |
---|---|
added - IsoDateTime
|
Time of creation of the object in the external system |
owner - User
|
Owner of the object in the Instance owner of the Import or someone else if it was resassigned |
slug - OpaqueID!
|
Slug of the Story resulting of the import |
storyId - ID!
|
Node id of the Story resulting of the import |
title - String
|
Title of the Story resulting of the import |
Example
{
"added": "2016-10-07T01:08:03.420Z",
"owner": User,
"slug": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"storyId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"title": "xyz789"
}
InAppNotificationPreferences
Description
Preferences for the In-App notifications displayed on the web app and mobile for a user
Fields
Field Name | Description |
---|---|
additionalViews - Boolean!
|
Send an InApp message when a StoryGrant is added for you on a given content |
annotations - Boolean!
|
Send an InApp message when an Annotation is marked as Resolved, post or commented |
comments - Boolean!
|
Send an InApp message when a new comment is added |
likes - Boolean!
|
Send an InApp message when a new like is added on the user's content or comment |
mentions - Boolean!
|
Send an InApp message when the user has been mentioned (in comment or content) |
inviteToContribute - Boolean!
|
Send an InApp message when the user has been invited to contribute to a content |
pings - Boolean!
|
Send an InApp message when a user send you a ping on a content. |
storyPosts - Boolean!
|
Send an InApp message when a new post has been posted |
storyUpdates - Boolean!
|
Send an InApp message when a new comment is added |
approvalProcess - Boolean!
|
Send an InApp message for approval process changed (assigned, approved, ...) |
Example
{
"additionalViews": true,
"annotations": false,
"comments": true,
"likes": false,
"mentions": false,
"inviteToContribute": true,
"pings": false,
"storyPosts": true,
"storyUpdates": true,
"approvalProcess": true
}
InAppNotificationPreferencesInput
Description
Input type for Mutation inAppNotificationPreferencesEdit
Fields
Input Field | Description |
---|---|
additionalViews - Boolean
|
Enable or disable Sending an InApp message when an StoryGrant is added for you on a given content (if not provided then left untouched) |
annotations - Boolean
|
Enable or disable Sending an InApp message when an Annotation is marked as Resolved, post or commented (if not provided then left untouched) |
comments - Boolean
|
Enable or disable sending Notif about new comments on content you follow |
likes - Boolean
|
Enable or disable sending Notif about likes on content you follow |
inviteToContribute - Boolean
|
Enable or disable sending an Notif when the user has been invited to contribute to a content |
mentions - Boolean
|
Enable or disable sending Notif about mentions |
pings - Boolean
|
Enable or disable sending Notif about Invite to read |
storyPosts - Boolean
|
Enable or disable sending Notif about new content on spaces configured to notify. |
storyUpdates - Boolean
|
Enable or disable sending Notif about content beeing updated that you follows |
approvalProcess - Boolean
|
Enable or disable sending Notif about approval process (assigned, approved, ...) |
Example
{
"additionalViews": true,
"annotations": true,
"comments": false,
"likes": false,
"inviteToContribute": false,
"mentions": false,
"pings": false,
"storyPosts": true,
"storyUpdates": false,
"approvalProcess": false
}
InUseTagMutationError
Description
Represent the error when trying do an action on an object that is still used by other objects (of used for deletion)
Fields
Field Name | Description |
---|---|
path - String!
|
Path of the field leading to the error |
stories - Int!
|
Number of Story still using the object |
tagRelations - Int!
|
Number of Relations bewteen Tag still using the object |
savedSearches - Int!
|
Number of Alert / saved search still using the object |
spaceTabs - Int!
|
Number of Spacetab still using the object |
emailPipeline - Int!
|
Number of EmailPipeline still using the object |
smartFeeds - Int!
|
Number of SmartFeed still using the object |
smartAssistants - Int!
|
Number of SmartAssistant still using the object |
Example
{
"path": "xyz789",
"stories": 123,
"tagRelations": 987,
"savedSearches": 123,
"spaceTabs": 123,
"emailPipeline": 123,
"smartFeeds": 123,
"smartAssistants": 123
}
Instance
Description
Informations about the Instance and instance configuration
Fields
Field Name | Description |
---|---|
actions - InstanceActions
|
Indicate the list of actions available to the current user on this Object |
availablePlans - [InstancePlan!]
|
List of Billing plans available for selection |
baseUrl - URL
|
Canonical Base URL of the instance |
chargebee - InstanceChargebee
|
Chargebee integration settings For billing usage use InstanceSubscription |
configuration - InstanceConfiguration
|
Various configurations settings of the current instance |
contacts - InstanceContacts
|
Instance's contacts for related issues (GDPR, ...) |
contentLanguages - [JSON!]!
|
List of Languages availables for all contents provided by users return a list JSON like {"lang": "fr", "name": "Français"} Use contentLangs instead |
contentLangs - [Language!]!
|
List of Languages availables for all contents provided by users |
disabledStandardContent - [String!]
|
Return the disabled standard content within ['story file link event'] |
disabledUsersForSuccession - UserConnection
|
List of disabled users ordered by amount of content they own |
usersWithSuccession - UserConnection
|
List users that have succession defined (source users) and at least one content to transfer |
Arguments
|
|
duplicatedAssets - DuplicatedAssetConnection
|
Get a list of duplicated assets. (They can be duplicated in different stories or in the same story). |
disclaimer - Boolean!
|
Does the current has a "disclaimer" at sign-in enabled. also known as Use policy |
domain - String
|
Main domain name of the current instance |
downloadLimits - InstanceDownloadLimits
|
Download warning and limits configured by the platform admin Requires the downloadLimit limit |
emailPipelines - EmailPipelineConnection
|
List of EmailPipeline you can send content to see EmailPipeline |
Arguments
|
|
features - InstanceFeatures
|
Fetch feature flag for the given instance |
exportCSVRole - UserSystemRole
|
User Role capable of doing an automated csv export of a search see StorySearchResponse.exportCsv |
activityDigestFrequency - DigestFrequency!
|
Frequency at which the ActivityDigest (summary of the activities of the instance) will be sent to all users note: users can customise it in the profile |
fullstory - InstanceFullstory
|
If fullstory is active, it returns its configuration. unused service |
googleAnalytics - InstanceGoogleAnalytics
|
Configuration of Google Ananlytics Integration |
graphqlSubscriptionsUrl - URL
|
URL of the ServerSent Event endpoin for Graphql subscription |
graphqlVersion - String
|
Version of the Graphql Server (for internal use) |
id - ID!
|
ID of the object. |
intercom - InstanceIntercom
|
Configuration of the Intercom Integration (internal) unused service |
labFeatures - [LabFeature!]
|
Lab features are features that can be activated or deactivated by platform admins (opt-in beta features) |
limits - InstanceLimits
|
Returns the current Instance limits, which may be different from the plan limits (InstancePlanLimits) due to manual changes or historical reasons see also: InstanceUsage, InstancePlanLimits |
mailto - EmailAddress
|
Generic EmailPipeline address to send content to. see EmailPipeline |
microsoftTeams - InstanceMicrosoftTeams
|
Entry point for MS Teams integration |
mixpanel - InstanceMixpanel
|
Configuration of the Mixpanel Integration (internal) |
name - String
|
Name of Instance as displayed in the menu, ... |
onboardingCompleted - Boolean!
|
Return True if the onboarding have been completed |
onboardingCompletedSteps - [String!]
|
Return the current steps that have been done/skipped |
realtimeUrl - URL
|
Deprecated No longer available |
refiner - InstanceRefiner
|
If Refiner.io is activated, it returns its configuration. |
release - String
|
Backend named release version for reporting prupose see Instance.graphqlVersion |
passwordSettings - InstancePasswordSettings
|
Configuration of the Instance Passwords Settings Requires the passwordSettings limit |
sandboxGapiUrl - URL
|
URL of the sandboxed Google GAPI endpoint for the SDK |
sandboxOneDrivePickerUrl - URL
|
URL of the sandboxed Microsoft Onedrive API endpoint for SDK integration |
sandboxUrl - URL
|
URL of the Frontend SANDOX endpoint To include video, scripts and other dubious contents |
sharePoint - InstanceSharePoint
|
Entry point for the Sharepoint integration in elium |
officeOnline - Boolean
|
If the Edit in Office356 available for end users need InstanceLimits.officeOnline enabled to be able to flip. modifications via mutation.instanceOfficeOnlineUpdate |
slack - InstanceSlack
|
Entry point for the Slack integration in elium |
spaceGroups - SpaceGroupConnection
|
List space groups (SpaceGroup ) of the current instance |
Arguments
|
|
ssoConfig - InstanceSsoConfig
|
The configuration parameters of the SSO |
scimConfig - InstanceScimConfig
|
The configuration parameters for SCIM integration |
connectedApps - ConnectedAppConnection
|
The list of OAuth connected applications |
approvals - StoryApprovalConnection
|
List StoryApprovals . |
Arguments
|
|
publicSharedStories - StoryConnection
|
Get a list of All publicly shared content. |
spaces - SpaceConnection
|
Returns all existing spaces matching the query . It is only available for platform admins & space admins. |
Arguments
|
|
statistics - InstanceStatistics
|
Get statistics about the instances |
subscription - InstanceSubscription
|
Billing Subscription of the instance |
answerFeedbacks - AnswerConnection
|
Fetch the feedbacks made by users using Answer |
Arguments
|
|
answerFeedbacksExport - URL
|
Get the URL of the CSV export of the feedbacks made by users using Answer |
Arguments
|
|
searchFeedbacks - SearchFeedbackConnection
|
Fetch the feedbacks made by users using the regular Search |
Arguments
|
|
sharedAlerts - AlertConnection
|
List of Alert that are managed at Instance Level |
Arguments
|
|
sharedAlertsSubscribers - [AlertSubscriberMember!]!
|
List possible subscribers for a shared Alert (optionally filtering out existing subscribers) |
summaryStats - JSON
|
Yearly overview stats for End Of Year over the given year "searchCount": Number of searchs "publicationsCount": number of publication "sessionsCount": number of user sessions |
Arguments
|
|
successorsWithContent - UserConnection
|
List of users assigned to inherit content ordered by amount still to process |
timezones - [Timezone!]!
|
List of supported timezones |
teams - TeamConnection
|
Returns all existing teams matching the query . It is only available for platform admins. |
Arguments
|
|
teamsCSV - URL
|
URL of the endpoint to download CSV export of all the teams require InstanceActions.teamEdit |
spaceListCSV - URL
|
URL of the endpoint to download CSV export of all the spaces |
spaceMembershipCSV - URL
|
URL of the endpoint to download CSV export of all the space memberships |
theme - InstanceTheme
|
Theme: color, display, ... configuration of the instance some of the features need a specific InstanceLimit to be enabled |
uiLanguage - Lang
|
Get user's user interface language as "configured" in profile or "auto discovered" via browser This will determine the different messages, buttons, ui-elements the user see |
uiLanguages - [JSON!]!
|
List of different supported UI language of this instance ex:
Use uiLangs instead
|
uiLangs - [Language!]!
|
List of different supported UI language of this instance |
usage - InstanceUsage
|
Return the current usage of the platform against the limits (i.e. usage: 2 admins, limit for this plan is 3) Usage might sometimes be above the limit for some reason. see also: InstanceLimits, InstancePlanLimits |
users - UserConnection
|
List of User that are part of the instance |
Arguments
|
|
uuid - String
|
Unique uuid of the instance. mostly for internal use |
workplace - InstanceWorkplace
|
Integration details for Facebook Workplace |
exports - InstanceExportConnection
|
List instance exports require InstanceActions.downloadExport |
appLaunchers - AppLauncherConnection
|
List all the available AppLaunchers require InstanceActions.appLauncherEdit |
smartFeeds - SmartFeedConnection
|
List all the available SmartFeed require MeActions.smartFeedsManage |
smartAssistants - SmartAssistantConnection
|
List all the available SmartAssistant require MeActions.smartAssistantsManage |
storyAlerts - StoryAlertConnection
|
Get all the alerts on contents |
organizations - [Organization!]!
|
List all the available Organization |
auditLogExportURL - URL
|
Get the URL of the CSV export of audit log |
Arguments
|
Example
{
"actions": InstanceActions,
"availablePlans": [InstancePlan],
"baseUrl": "http://www.test.com/",
"chargebee": InstanceChargebee,
"configuration": InstanceConfiguration,
"contacts": InstanceContacts,
"contentLanguages": [{}],
"contentLangs": [Language],
"disabledStandardContent": ["abc123"],
"disabledUsersForSuccession": UserConnection,
"usersWithSuccession": UserConnection,
"duplicatedAssets": DuplicatedAssetConnection,
"disclaimer": true,
"domain": "xyz789",
"downloadLimits": InstanceDownloadLimits,
"emailPipelines": EmailPipelineConnection,
"features": InstanceFeatures,
"exportCSVRole": "ADMINISTRATOR",
"activityDigestFrequency": "DEFAULT",
"fullstory": InstanceFullstory,
"googleAnalytics": InstanceGoogleAnalytics,
"graphqlSubscriptionsUrl": "http://www.test.com/",
"graphqlVersion": "abc123",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"intercom": InstanceIntercom,
"labFeatures": [LabFeature],
"limits": InstanceLimits,
"mailto": "test@test.com",
"microsoftTeams": InstanceMicrosoftTeams,
"mixpanel": InstanceMixpanel,
"name": "xyz789",
"onboardingCompleted": true,
"onboardingCompletedSteps": ["abc123"],
"realtimeUrl": "http://www.test.com/",
"refiner": InstanceRefiner,
"release": "xyz789",
"passwordSettings": InstancePasswordSettings,
"sandboxGapiUrl": "http://www.test.com/",
"sandboxOneDrivePickerUrl": "http://www.test.com/",
"sandboxUrl": "http://www.test.com/",
"sharePoint": InstanceSharePoint,
"officeOnline": true,
"slack": InstanceSlack,
"spaceGroups": SpaceGroupConnection,
"ssoConfig": InstanceSsoConfig,
"scimConfig": InstanceScimConfig,
"connectedApps": ConnectedAppConnection,
"approvals": StoryApprovalConnection,
"publicSharedStories": StoryConnection,
"spaces": SpaceConnection,
"statistics": InstanceStatistics,
"subscription": InstanceSubscription,
"answerFeedbacks": AnswerConnection,
"answerFeedbacksExport": "http://www.test.com/",
"searchFeedbacks": SearchFeedbackConnection,
"sharedAlerts": AlertConnection,
"sharedAlertsSubscribers": [User],
"summaryStats": {},
"successorsWithContent": UserConnection,
"timezones": [Timezone],
"teams": TeamConnection,
"teamsCSV": "http://www.test.com/",
"spaceListCSV": "http://www.test.com/",
"spaceMembershipCSV": "http://www.test.com/",
"theme": InstanceTheme,
"uiLanguage": "fr",
"uiLanguages": [{}],
"uiLangs": [Language],
"usage": InstanceUsage,
"users": UserConnection,
"uuid": "abc123",
"workplace": InstanceWorkplace,
"exports": InstanceExportConnection,
"appLaunchers": AppLauncherConnection,
"smartFeeds": SmartFeedConnection,
"smartAssistants": SmartAssistantConnection,
"storyAlerts": StoryAlertConnection,
"organizations": [Organization],
"auditLogExportURL": "http://www.test.com/"
}
InstanceActions
Description
Actions the user is allowed to do on the related Instance
Fields
Field Name | Description |
---|---|
contacts - Boolean
|
Can change the Instance contacts |
downloadExport - Boolean!
|
Can Access the exports of the whole instances |
appLauncherEdit - Boolean!
|
Can edit the app launchers for users of the instances |
emailPipelineEdit - Boolean!
|
Can edit the EmailPipeline. You probably want ot check InstanceLimits.emailPipelines too. |
teamEdit - Boolean!
|
Can edit / create teams You probably want ot check InstanceLimits.teams too. |
spaceGroupEdit - Boolean!
|
Can edit / create SpaceGroups You probably want ot check InstanceLimits.spaceGroup too. |
sharedAlertEdit - Boolean!
|
Can edit/create/delete the Alert that are shared at the instance level |
spaceManage - Boolean!
|
Have the ability to display spaces, maybe edit some attributes. please check further space action |
analytics - Boolean!
|
You can access instance Analytics |
Example
{
"contacts": true,
"downloadExport": false,
"appLauncherEdit": false,
"emailPipelineEdit": false,
"teamEdit": false,
"spaceGroupEdit": false,
"sharedAlertEdit": false,
"spaceManage": true,
"analytics": false
}
InstanceActivateError
Description
Error type for the InstanceActivate
token verification
Values
Enum Value | Description |
---|---|
|
A user already exists with the same email |
|
The given Password is invalid |
|
The given Plan is invalid |
|
The given Token is invalid or expired |
Example
"EXISTING_USER"
InstanceActivateErrors
Description
Possile errors of the InstanceActivate
mutation
Types
Union Types |
---|
Example
InvalidInputError
InstanceActivateInput
Description
Input type for Mutation instanceActivate
Example
{
"company": "xyz789",
"password": "abc123",
"token": "7aac93c5-a56c-4528-b43e-457834a796c9",
"workPhone": "abc123"
}
InstanceActivatePayload
Description
Return Type of Mutation instanceActivate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [InstanceActivateErrors!]
|
Errors of the mutation. |
instance - Instance
|
The updated current instance |
user - User
|
The current logged-in user |
Example
{
"clientMutationId": "abc123",
"errors": [InvalidInputError],
"instance": Instance,
"user": User
}
InstanceActivationToken
Description
Data associated with an Activation Token
Fields
Field Name | Description |
---|---|
email - EmailAddress
|
Email address of the user requesting an activation |
errorCode - InstanceActivateError
|
Error code if any, associated with the token recovery |
lang - String
|
Lang associated with the token ie lang in wich the user have completed the flow |
mixpanelToken - String
|
Deprecated use InstanceAuth instead |
mixpanelHost - String
|
Deprecated use InstanceAuth instead |
Example
{
"email": "test@test.com",
"errorCode": "EXISTING_USER",
"lang": "abc123",
"mixpanelToken": "abc123",
"mixpanelHost": "abc123"
}
InstanceAuthentication
Description
Authentication methods for the instance
Fields
Field Name | Description |
---|---|
basic - InstanceAuthenticationMethod
|
Details for the Basic auth Method |
disclaimers - [TranslatedRichContent!]
|
List all disclaimer translations of the platform |
hasDisclaimer - Boolean!
|
The instance has a disclaimer activated |
instanceName - String
|
Name of the instance |
uuid - String
|
UUID identifiying the instance |
accentColor - Color
|
Main color of the instance |
headerColor - Color
|
Header color |
headerTextLightness - ColorLightness
|
Color shade of the text on the header |
logoImageUrl - URL
|
Logo Image URL |
introText - HTML
|
Introduction text to display to users at login |
isCustomDisclaimer - Boolean!
|
The setup disclaimer is a custom disclaimer there is no custom disclaimer anymore |
mobileEnabled - Boolean!
|
Is the mobile app available on this instance |
mixpanel - PublicInstanceMixpanel
|
Instance of mixpanel info to use while niot yet logged-in |
saml2 - InstanceAuthenticationMethod
|
Configuration of the SAML2 Authentifcation for login purpose |
sso - InstanceAuthenticationMethod
|
Configuration of the Single-Sign-On Authentifcation for login purpose |
Example
{
"basic": InstanceAuthenticationMethod,
"disclaimers": [TranslatedRichContent],
"hasDisclaimer": false,
"instanceName": "xyz789",
"uuid": "abc123",
"accentColor": "#CCCCCC",
"headerColor": "#CCCCCC",
"headerTextLightness": "DARK",
"logoImageUrl": "http://www.test.com/",
"introText": "<html>Hello <h1>world</h1></html>",
"isCustomDisclaimer": false,
"mobileEnabled": true,
"mixpanel": PublicInstanceMixpanel,
"saml2": InstanceAuthenticationMethod,
"sso": InstanceAuthenticationMethod
}
InstanceAuthenticationMethod
Description
Login Method parameters
Fields
Field Name | Description |
---|---|
description - String
|
Description text of the Login method for end users For example: employee only |
label - String
|
Label of the Login method for end users for example: "Internal" |
mobileUrl - URL
|
Connection URL for the mobile Application |
url - URL
|
Connection URL for a desktop Application |
Example
{
"description": "abc123",
"label": "xyz789",
"mobileUrl": "http://www.test.com/",
"url": "http://www.test.com/"
}
InstanceCancelSubscriptionErrors
Description
Error Type of the instanceCancelSubscription
Mutation
Types
Union Types |
---|
Example
PermissionError
InstanceCancelSubscriptionInput
Description
Input type for Mutation instanceCancelSubscription
Fields
Input Field | Description |
---|---|
endOfTerm - Boolean!
|
Cancel the subscription at the end of the current term or immediately default to false (immediate cancelation). Default = false |
Example
{"endOfTerm": false}
InstanceCancelSubscriptionPayload
Description
Return Type of Mutation instanceCancelSubscription
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
instance - Instance
|
The updated current instance |
errors - [InstanceCancelSubscriptionErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "abc123",
"instance": Instance,
"errors": [PermissionError]
}
InstanceChargebee
Description
Configuration of Chargebee Billing of the current Instance see InstanceSubscription
Fields
Field Name | Description |
---|---|
site - String
|
Current Chargbee Site |
Example
{"site": "xyz789"}
InstanceCompleteOnboadingStepErrors
Description
Error Type of the instanceCompleteOnboardingStep
Mutation
Types
Union Types |
---|
Example
PermissionError
InstanceCompleteOnboadingStepInput
Description
Input type for Mutation instanceCompleteOnboadingStep
Fields
Input Field | Description |
---|---|
step - String!
|
The name of the onboarding step completed |
Example
{"step": "xyz789"}
InstanceCompleteOnboadingStepPayload
Description
Return Type of Mutation instanceCompleteOnboadingStep
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
instance - Instance
|
The updated current instance |
errors - [InstanceCompleteOnboadingStepErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"instance": Instance,
"errors": [PermissionError]
}
InstanceConfiguration
Description
Settings about the instance's configuration
Fields
Field Name | Description |
---|---|
emailSenderName - String
|
Sender email address for emails sent by the platform |
homepage - MePreferencesHomepage
|
Display preference for the homepage |
overview - MePreferencesOverview
|
Deprecated removed old homepage |
showAgendaBox - Boolean
|
Deprecated removed old homepage |
showFavoriteContentBox - Boolean
|
Deprecated removed old homepage |
showPopularUserBox - Boolean
|
Deprecated removed old homepage |
showRecentUserBox - Boolean
|
Deprecated removed old homepage |
showRecommendedUserBox - Boolean
|
Deprecated removed old homepage |
showTrendingContentBox - Boolean
|
Deprecated removed old homepage |
sidebar - Boolean
|
Deprecated removed old homepage |
welcomeMessage - RichContent
|
Get the welcome message in the content lang of the current user |
welcomeMessages - [TranslatedRichContent!]!
|
Get the list of all welcome messages (in all languages) configured by platform administrators. |
mobileAppDescription - RichContent
|
Get the mobile app description in the content lang of the current user |
mobileAppDescriptions - [TranslatedRichContent!]!
|
Get the list of all mobile app descriptions (in all languages) configured by platform administrators. |
aiFeatureMembers - [SpaceMemberMember!]!
|
List of allowed members of the Ai feature |
Example
{
"emailSenderName": "abc123",
"homepage": "DEFAULT",
"overview": "SPACES",
"showAgendaBox": false,
"showFavoriteContentBox": false,
"showPopularUserBox": false,
"showRecentUserBox": true,
"showRecommendedUserBox": false,
"showTrendingContentBox": false,
"sidebar": false,
"welcomeMessage": RichContent,
"welcomeMessages": [TranslatedRichContent],
"mobileAppDescription": RichContent,
"mobileAppDescriptions": [TranslatedRichContent],
"aiFeatureMembers": [User]
}
InstanceContacts
InstanceContactsUpdateErrors
Description
Error Type of the instanceContactsUpdate
Mutation
Types
Union Types |
---|
Example
PermissionError
InstanceContactsUpdateInput
InstanceContactsUpdatePayload
Description
Return Type of Mutation instanceContactsUpdate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
contacts - InstanceContacts
|
The updated Instance Contacts |
errors - [InstanceContactsUpdateErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"contacts": InstanceContacts,
"errors": [PermissionError]
}
InstanceDeleteErrors
Description
Error Type of the instanceDelete
Mutation
Types
Union Types |
---|
Example
PermissionError
InstanceDeleteInput
Description
Input type for Mutation instanceDelete
Fields
Input Field | Description |
---|---|
dryRun - Boolean!
|
Skip instance deletetion if true. Default = false |
Example
{"dryRun": true}
InstanceDeletePayload
Description
Return Type of Mutation instanceDelete
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [InstanceDeleteErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"errors": [PermissionError]
}
InstanceDisclaimerSetupErrors
Description
Error Type of the instanceDisclaimerSetup
Mutation
Types
Union Types |
---|
Example
PermissionError
InstanceDisclaimerSetupInput
Description
Input type for Mutation instanceDisclaimerSetup
Fields
Input Field | Description |
---|---|
clearAccepted - Boolean
|
clear all already accepted disclaimer signature |
isEnabled - Boolean
|
True if the instance's users should validate the disclaimer before connecting |
texts - [TranslatedRichContentInput!]
|
Slate Rich text of the Disclaimers translations to send to Users. |
Example
{
"clearAccepted": false,
"isEnabled": true,
"texts": [TranslatedRichContentInput]
}
InstanceDisclaimerSetupPayload
Description
Return Type of Mutation instanceDisclaimerSetup
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
instance - Instance
|
The updated current instance |
instanceAuth - InstanceAuthentication
|
The refreshed Instance Authentication settings |
errors - [InstanceDisclaimerSetupErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"instance": Instance,
"instanceAuth": InstanceAuthentication,
"errors": [PermissionError]
}
InstanceDownloadLimits
Description
Download warning and limits configured by the platform admin
Fields
Field Name | Description |
---|---|
enabled - Boolean
|
Flag used to enable or disable download limits and warnings |
warnCount - Int
|
Number of downloads after which a warning email will be sent to the user and the platform administrators. 0 to disable. |
blockedCount - Int
|
Number of downloads after which the user will be disabled, and a warning email will be sent to the user and the platform administrators. 0 to disable. |
resetEveryDays - Int
|
Period (in days) after which the count is reset. 0 disables all limits. |
maxRole - UserSystemRole
|
User role that is impacted. All inferior roles are also impacted. Administrators will never be disabled, but the warning email will be sent. |
disabledUsers - [User!]
|
Users disabled due to download limits reached |
Example
{
"enabled": false,
"warnCount": 123,
"blockedCount": 987,
"resetEveryDays": 987,
"maxRole": "ADMINISTRATOR",
"disabledUsers": [User]
}
InstanceExport
Description
An export of contents/metadata of the current instance
Fields
Field Name | Description |
---|---|
id - ID!
|
ID of the object. |
created - IsoDateTime
|
Creation date of the inital object |
password - String
|
Password use to descrypt the file |
fileURL - URL
|
URL of the files export |
description - String
|
Description of the export |
status - InstanceExportStatus!
|
Status of the current export |
expiresAt - IsoDateTime
|
Expiration date of the export the export will not be downloadable after this date |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"created": "2016-10-07T01:08:03.420Z",
"password": "abc123",
"fileURL": "http://www.test.com/",
"description": "abc123",
"status": "STARTED",
"expiresAt": "2016-10-07T01:08:03.420Z"
}
InstanceExportConnection
Description
List of results of InstanceExport
Fields
Field Name | Description |
---|---|
edges - [InstanceExportEdge!]
|
A list of edges. |
pageInfo - PageInfo!
|
Information to aid in pagination. |
totalCount - Int!
|
Identifies the total count of items in the connection. |
Example
{
"edges": [InstanceExportEdge],
"pageInfo": PageInfo,
"totalCount": 987
}
InstanceExportEdge
Description
An edge in a connection.
Fields
Field Name | Description |
---|---|
cursor - String!
|
A cursor for use in pagination. |
node - InstanceExport!
|
The item at the end of the edge. |
Example
{
"cursor": "xyz789",
"node": InstanceExport
}
InstanceExportErrors
Description
Error Type of the instanceExport
Mutation
Types
Union Types |
---|
Example
PermissionError
InstanceExportInput
Description
Input type for Mutation instanceExport
Fields
Input Field | Description |
---|---|
title - String!
|
Name of the export |
type - InstanceExportType!
|
Select the type of export to produce. Default = ALL |
spaces - [Int!]
|
List of Space slug to export if not provided, all spaces are included |
exportFiles - Boolean!
|
Include files in the exports. Default = false |
Example
{
"title": "abc123",
"type": "ALL",
"spaces": [987],
"exportFiles": true
}
InstanceExportPayload
Description
Return Type of Mutation instanceExport
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [InstanceExportErrors!]
|
Errors of the mutation. |
instance - Instance
|
The updated current instance |
Example
{
"clientMutationId": "abc123",
"errors": [PermissionError],
"instance": Instance
}
InstanceExportStatus
Description
Status of an Export job
Values
Enum Value | Description |
---|---|
|
The export is in progress internal state not broadly available for users |
|
The export is ready to be downloaded |
|
Export has passed the due date and is not available for users anymore internal state not broadly available for users |
Example
"STARTED"
InstanceExportType
Description
Type of Instance Export result to produce
Values
Enum Value | Description |
---|---|
|
Export all data, including history of versions, comments, ... |
|
Export only Files |
Example
"ALL"
InstanceFeatures
Description
List of Configuration or settings of the instance
Fields
Field Name | Description |
---|---|
activityFeedTags - Boolean
|
Enable tags display in activity feed in kp4 unused flag |
adminImports - Boolean
|
Enable the admin to import contents in bulk |
aiEditor - Boolean
|
Enable AI in editor |
aiForAll - Boolean
|
Enable Ai for All users & Spaces |
antiVirus - Boolean
|
The antivirus scan of files is enabled for this instance |
advancedMobileSecurity - Boolean
|
True if Advanced mobile security verifications are enabled for users |
easterEgg - Boolean
|
Fun stuff might occur |
decisionTree - Boolean
|
Enable the decision tree for the current user |
storySummary - Boolean
|
Enable the story summary feature |
storyAlert - Boolean
|
Enable the story Alert feature unused flag, streamlined |
enableKP3Chat - Boolean
|
Deprecated No longer available |
googleDrive - Boolean
|
Enable the Google drive integration for users |
hideBillingPage - Boolean
|
Hide the billing page in the settings |
hideEvents - Boolean
|
Hide events (menu, template, ical integration,...) |
hideMainAsset - Boolean
|
Hide main Asset from stories |
hidePublicationFields - Boolean
|
Hide publications fields from stories |
hidePublicPersonal - Boolean
|
Deprecated No longer available |
publicPages - Boolean
|
Is the instance allows sharing pages to public |
ie11Upgrade - String
|
Display a warning about outdated browser @deprecated |
kmScore - Boolean
|
Access/Display an agregated KM score in the statistics |
autoTranslate - Boolean
|
True if the autoTranslate is enabled for this instance (if plan does not allow it, it's always false) |
kp3 - Boolean
|
Deprecated No longer available |
feature - Boolean!
|
Get the Status of an Instance Feature true means Activated |
Arguments
|
|
mandatoryTwoFactor - Boolean
|
True if the 2fa is mandatory for this instance (only for method using login and password) |
mobileReadingList - Boolean
|
Send weekly notification about new contents on the instance |
newMobileEditor - Boolean
|
Unused @deprecated unused flag, streamlined |
showNewAnalytics - Boolean
|
Unused @deprecated unused flag, streamlined |
newDigestDesign - Boolean
|
Use the new design of email Digest notification |
newHomepage - Boolean
|
Display the new homepage, deprecated |
mobileApp - Boolean
|
Enable the mobile App for users |
officePreviewer - Boolean
|
New office previewer using External tool (MS or google) (not the WOPI) |
onedrive - Boolean
|
Enable download from OneDrive integration |
schemaBuilder - Boolean
|
Deprecated unused flag, streamlined |
searchFeedback - Boolean
|
Display a button for user to give feedback about search & QS |
sharebox - Boolean
|
Deprecated unused flag |
smartFeed - Boolean
|
Is smartFeed feature enabled on the instance for the current user unused flag |
storyAttribution - Boolean
|
Show tile attribution in search results |
storyMetadata - Boolean
|
Display metadata (author, publication date, ...) at the bottom of story linked with storyAttribution |
storyDuplicates - Boolean
|
Detect and warn about duplicate main assets in story creation form deprecated |
supportLink - Boolean
|
Display to "ask for support" link in the help menu |
offboarding - Boolean
|
True if the client can display the UI for the offboarding Streamlined; no opt-out |
sharePointSearch - Boolean
|
Feature flag to enable Multi source search (like Sharepoint) probably user based (after it's toggleable in instance.sharepoint.active) |
urlAssetManualEdit - Boolean
|
Feature flag about the Ability to edit Url Asset details |
modernEditor - Boolean
|
True if the new editor is enabled by default unused flag |
answer - Boolean
|
True if the AI-powered question answering is enabled for this instance AND for the current user |
smartAssistant - Boolean
|
True if smart assistants are enabled |
auditLog - Boolean
|
True if audit logging is enabled |
wopi - Boolean
|
Enable the WOPI integration (Office Online edition of documents) |
storyEmbedBlock - Boolean
|
Enable the Embed block in story editor |
disableLazyTables - Boolean
|
Disable Lazy load of Tables in diff |
extensionProactiveSupport - Boolean
|
Enable proactive support in the browser extension |
Example
{
"activityFeedTags": true,
"adminImports": true,
"aiEditor": false,
"aiForAll": false,
"antiVirus": false,
"advancedMobileSecurity": true,
"easterEgg": false,
"decisionTree": false,
"storySummary": true,
"storyAlert": false,
"enableKP3Chat": false,
"googleDrive": false,
"hideBillingPage": false,
"hideEvents": false,
"hideMainAsset": true,
"hidePublicationFields": false,
"hidePublicPersonal": true,
"publicPages": false,
"ie11Upgrade": "xyz789",
"kmScore": false,
"autoTranslate": false,
"kp3": true,
"feature": true,
"mandatoryTwoFactor": false,
"mobileReadingList": false,
"newMobileEditor": false,
"showNewAnalytics": false,
"newDigestDesign": false,
"newHomepage": false,
"mobileApp": false,
"officePreviewer": true,
"onedrive": true,
"schemaBuilder": false,
"searchFeedback": true,
"sharebox": false,
"smartFeed": false,
"storyAttribution": true,
"storyMetadata": true,
"storyDuplicates": false,
"supportLink": false,
"offboarding": false,
"sharePointSearch": true,
"urlAssetManualEdit": false,
"modernEditor": true,
"answer": true,
"smartAssistant": true,
"auditLog": false,
"wopi": true,
"storyEmbedBlock": false,
"disableLazyTables": true,
"extensionProactiveSupport": true
}
InstanceFinishProvisionningErrors
Description
Error Type of the instanceFinishProvisionning
Mutation
Types
Union Types |
---|
Example
PermissionError
InstanceFinishProvisionningInput
Description
Input type for Mutation instanceFinishProvisionning
Fields
Input Field | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. DUMMY FIELD FOR HAVING A FIELD |
Example
{"clientMutationId": "abc123"}
InstanceFinishProvisionningPayload
Description
Return Type of Mutation instanceFinishProvisionning
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
instance - Instance
|
The updated current instance |
errors - [InstanceFinishProvisionningErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"instance": Instance,
"errors": [PermissionError]
}
InstanceFullstory
Description
Deprecated
Example
{
"engagePayload": {},
"orgId": "abc123",
"userId": "xyz789"
}
InstanceGoogleAnalytics
InstanceGoogleAnalyticsUpdateErrors
Description
Error Type of the instanceGoogleAnalyticsUpdate
Mutation
Types
Union Types |
---|
Example
PermissionError
InstanceGoogleAnalyticsUpdateInput
InstanceGoogleAnalyticsUpdatePayload
Description
Return Type of Mutation instanceGoogleAnalyticsUpdate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
instance - Instance
|
The updated current instance |
errors - [InstanceGoogleAnalyticsUpdateErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "abc123",
"instance": Instance,
"errors": [PermissionError]
}
InstanceGoogleDriveUpdateErrors
Description
Error Type of the instanceGoogleDriveUpdate
Mutation
Types
Union Types |
---|
Example
PermissionError
InstanceGoogleDriveUpdateInput
Description
Input type for Mutation instanceGoogleDriveUpdate
Fields
Input Field | Description |
---|---|
activate - Boolean
|
Should the integration be activated or deactivated |
Example
{"activate": false}
InstanceGoogleDriveUpdatePayload
Description
Return Type of Mutation instanceGoogleDriveUpdate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [InstanceGoogleDriveUpdateErrors!]
|
Errors of the mutation. |
instance - Instance
|
The updated current instance |
Example
{
"clientMutationId": "abc123",
"errors": [PermissionError],
"instance": Instance
}
InstanceIntercom
InstanceInvoice
Description
An invoice for the current instance's billing
Fields
Field Name | Description |
---|---|
date - IsoDateTime
|
Date of the invoice |
downloadUrl - URL
|
Returns a temporary link to the PDF of this invoice. This link lives for 1 hour. Attention: This resolver is really slow. We suggest to use it only when necessary. |
id - ID
|
Invoice ID: deprecated Use invoice_id instead
|
reference - String
|
Po number of the invoice |
invoiceId - OpaqueID
|
Invoice ID from Chargebee |
status - InvoiceStatus
|
Payment status of the invoice |
total - Int
|
Total amount of the invoice |
Example
{
"date": "2016-10-07T01:08:03.420Z",
"downloadUrl": "http://www.test.com/",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"reference": "abc123",
"invoiceId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"status": "NOT_PAID",
"total": 123
}
InstanceInvoiceResult
Description
Result listing of invoices
Fields
Field Name | Description |
---|---|
endCursor - String
|
When paginating forwards, the cursor to continue. |
hasNextPage - Boolean
|
When paginating forwards, are there more items? |
nodes - [InstanceInvoice!]
|
A list of nodes. |
Example
{
"endCursor": "xyz789",
"hasNextPage": false,
"nodes": [InstanceInvoice]
}
InstanceInvoiceUpdateErrors
Description
Error Type of the instanceInvoiceUpdate
Mutation
Types
Union Types |
---|
Example
PermissionError
InstanceInvoiceUpdateInput
InstanceInvoiceUpdatePayload
Description
Return Type of Mutation instanceInvoiceUpdate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
invoice - InstanceInvoice
|
The updated Invoice |
errors - [InstanceInvoiceUpdateErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"invoice": InstanceInvoice,
"errors": [PermissionError]
}
InstanceLabFlagUpdateErrors
Description
Error Type of the instanceLabFlagUpdate
Mutation
Types
Union Types |
---|
Example
PermissionError
InstanceLabFlagUpdateInput
InstanceLabFlagUpdatePayload
Description
Return Type of Mutation instanceLabFlagUpdate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
instance - Instance
|
The updated current instance |
errors - [InstanceLabFlagUpdateErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"instance": Instance,
"errors": [PermissionError]
}
InstanceLimits
Description
Limits of the instance linked to the current plan
Fields
Field Name | Description |
---|---|
spaceGroup - Boolean
|
Is the current instance allowed to use or create SpaceGroup |
adminsCount - Int
|
Maximum number of admins allowed for this instance |
api - Boolean
|
Is the current instance allowed to use the API |
analytics - Boolean
|
Is the current instance allowed to use the analytics |
emailPipelines - Boolean
|
Is the current instance allowed to use the EmailPipeline |
googleAnalytics - Boolean
|
Is the current instance allowed to use the Google Analytics integration |
hasOverLimit - Boolean
|
Is the current instance over the seats limit |
minSeats - Int
|
Minumum number of seats for this instance |
passwordSettings - Boolean
|
Is the current instance allowed to customize the password settings |
scim - Boolean
|
Is the current instance allowed to use the SCIM user provisioning |
sharedAlerts - Boolean
|
Is the current instance allowed to use the ShareAlerts |
sso - Boolean
|
Is the current instance allowed to use the SSO |
teams - Boolean
|
Is the current instance allowed to use the Teams feature |
whiteLabel - Boolean
|
Can the instance be customized with a custom domain |
workplace - Boolean
|
Can Workspace be activated |
disablePublicPages - Boolean
|
Have the ability to disable public sharing |
autoTranslate - Boolean
|
Have the ability to automatically translate content |
confidentialContent - Boolean
|
Have the ability to protect content agaisnt copy, download, ... |
downloadLimit - Boolean
|
Allow the admins to set soft and hard limits to the number of files that users can download over specific periods of time. See instance.downloadLimits for configuration |
officeOnline - Boolean
|
Have the ability to view/edit content with Online office (ie o365) |
mandatoryApproval - Boolean
|
Have the ability to setup mandatory approval for spaces |
approval - Boolean
|
Have the ability to use the appoval process |
contentTransfer - Boolean
|
Have the ability to use the content transfer feature |
smartAssistant - Boolean
|
Have the ability to use smart assistants |
Example
{
"spaceGroup": false,
"adminsCount": 987,
"api": true,
"analytics": true,
"emailPipelines": true,
"googleAnalytics": true,
"hasOverLimit": false,
"minSeats": 987,
"passwordSettings": true,
"scim": false,
"sharedAlerts": true,
"sso": true,
"teams": true,
"whiteLabel": true,
"workplace": false,
"disablePublicPages": true,
"autoTranslate": false,
"confidentialContent": false,
"downloadLimit": false,
"officeOnline": false,
"mandatoryApproval": true,
"approval": false,
"contentTransfer": false,
"smartAssistant": true
}
InstanceMicrosoftTeams
Description
Details about Microsoft Teams Integration for the instance
Fields
Field Name | Description |
---|---|
active - Boolean
|
True if a platform admin activated the feature |
activitiesConfig - MicrosoftTeamsActivitiesConfig
|
Configuration of the activities you want to be published on Ms Teams |
installed - Boolean
|
True if a teams access token is stored |
setupUrl - URL
|
Url of the Sign-in process to setup the integration |
tokenOwner - String
|
Information about the owner of the token if available |
spacesToChannel - [MicrosoftTeamsSpacesToChannelItem!]
|
A list of Elium space to Microsoft Teams channel mappings. For each of those mappings, a message will be sent to the Microsoft teams channel when one of the following activities occurs in the Elium space: - New story published - New version published - New comment on a story |
validToken - Boolean
|
True if a teams access token is stored and it has not been revoked from the Teams workspace |
Example
{
"active": true,
"activitiesConfig": MicrosoftTeamsActivitiesConfig,
"installed": true,
"setupUrl": "http://www.test.com/",
"tokenOwner": "abc123",
"spacesToChannel": [MicrosoftTeamsSpacesToChannelItem],
"validToken": false
}
InstanceMicrosoftTeamsUpdateErrors
Description
Error Type of the instanceMicrosoftTeamsUpdate
Mutation
Types
Union Types |
---|
Example
PermissionError
InstanceMicrosoftTeamsUpdateInput
InstanceMicrosoftTeamsUpdatePayload
Description
Return Type of Mutation instanceMicrosoftTeamsUpdate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [InstanceMicrosoftTeamsUpdateErrors!]
|
Errors of the mutation. |
instance - Instance
|
The updated current instance |
Example
{
"clientMutationId": "abc123",
"errors": [PermissionError],
"instance": Instance
}
InstanceMixpanel
Description
Configuration of the Mixpanel Integration for the instance
Fields
Field Name | Description |
---|---|
companyType - String
|
Company usecase type description |
engagePayload - JSON
|
Payload to send to mixpanel as engage data |
host - String
|
Host name of the mixpanel endpoint |
token - String
|
Tenant token to use to send data to mixpanel |
userId - String
|
Unique identifier for the user in mixpanel |
Example
{
"companyType": "xyz789",
"engagePayload": {},
"host": "abc123",
"token": "abc123",
"userId": "xyz789"
}
InstanceMobileAppDescriptionsUpdateErrors
Description
Error Type of the instanceMobileAppDescriptionsUpdate
Mutation
Types
Union Types |
---|
Example
PermissionError
InstanceMobileAppDescriptionsUpdateInput
Description
Input Type of the instanceMobileAppDescriptionsUpdate
mutation
Fields
Input Field | Description |
---|---|
mobileAppDescriptions - [TranslatedRichContentInput!]!
|
Slate Rich text of the Mobile app description translations. |
Example
{"mobileAppDescriptions": [TranslatedRichContentInput]}
InstanceMobileAppDescriptionsUpdatePayload
Description
Return Type of Mutation disableStandardContent
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
instance - Instance
|
The updated current instance |
errors - [InstanceMobileAppDescriptionsUpdateErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"instance": Instance,
"errors": [PermissionError]
}
InstanceOfficeOnlineUpdateErrors
Description
Error Type of the instanceOfficeOnlineUpdate
Mutation
Types
Union Types |
---|
Example
PermissionError
InstanceOfficeOnlineUpdateInput
Description
Input type for Mutation instanceOfficeOnlineUpdate
Fields
Input Field | Description |
---|---|
activate - Boolean
|
Should the Office Online integration be enabled |
Example
{"activate": false}
InstanceOfficeOnlineUpdatePayload
Description
Return Type of Mutation instanceOfficeOnlineUpdate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [InstanceOfficeOnlineUpdateErrors!]
|
Errors of the mutation. |
instance - Instance
|
The updated current instance check instance.officeOnline |
Example
{
"clientMutationId": "xyz789",
"errors": [PermissionError],
"instance": Instance
}
InstanceOneDriveUpdateErrors
Description
Error Type of the instanceOneDriveUpdate
Mutation
Types
Union Types |
---|
Example
PermissionError
InstanceOneDriveUpdateInput
Description
Input type for Mutation instanceOneDriveUpdate
Fields
Input Field | Description |
---|---|
activate - Boolean
|
Should the Onedrive integration be enbled for en users |
Example
{"activate": true}
InstanceOneDriveUpdatePayload
Description
Return Type of Mutation instanceOneDriveUpdate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [InstanceOneDriveUpdateErrors!]
|
Errors of the mutation. |
instance - Instance
|
The updated current instance |
Example
{
"clientMutationId": "xyz789",
"errors": [PermissionError],
"instance": Instance
}
InstancePasswordSettings
Description
Instance security settings defined by platform administrators. Requires the passwordSettings
limit
Fields
Field Name | Description |
---|---|
forceTwoFactor - Boolean
|
When set to true, all users that use a login and password to connect must use a second authentification factor |
passwordSecurityLevel - PasswordSecurityLevel
|
Required security level of users passwords. See PasswordSecurityLevel |
maxLoginAttempts - Int
|
The number of failed login attempts after which an account is suspended (default: 5). |
loginSuspendPeriod - Int
|
The number of seconds after which a suspended account is reactivated (default: 600). |
Example
{
"forceTwoFactor": true,
"passwordSecurityLevel": "LOW",
"maxLoginAttempts": 123,
"loginSuspendPeriod": 123
}
InstancePlan
Description
A Definition of a Billing Plan
Fields
Field Name | Description |
---|---|
active - Boolean
|
Is the plan actively choosable. |
id - ID!
|
ID of the object. |
limits - InstancePlanLimits
|
Return the limits as they are defined in the plan, and as they will be applied during a changePlan. see also: InstanceUsage, InstanceLimits |
perUserPrice - Int
|
Get the price of the given plan in Cents |
periodicity - PlanPeriodicity
|
Rate at which the plan is renewed |
Example
{
"active": true,
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"limits": InstancePlanLimits,
"perUserPrice": 987,
"periodicity": "MONTHLY"
}
InstancePlanLimits
Description
Limits of what you can do/have in a given plan
Fields
Field Name | Description |
---|---|
api - Boolean
|
Have the ability to use the API |
adminsCount - Int
|
Allowed number of users with the ADMINISTRATOR Role |
allowChangeTo - Boolean
|
Is the current instance allowed to change plan to this plan |
passwordSettings - Boolean
|
Allow customisation of the passwords security setttings |
pipelines - Boolean
|
Allow usage of EmailPipelines (incoming email-to-story) |
seatsCount - Int
|
Allowed number of seats (Active users) |
sharedAlerts - Boolean
|
Allow usage of shared alert (see Alert ) |
spaceGroups - Boolean
|
Allow usage of Groups of Spaces (SpaceGroups ) |
whiteLabel - Boolean
|
Does the plan have the ability to customise appearance |
disablePublicPages - Boolean
|
Does the plan have the ability to disable public sharing |
autoTranslate - Boolean
|
Have the ability to automatically translate content |
confidentialContent - Boolean
|
Have the ability to protect content against copy, download, ... |
officeOnline - Boolean
|
Have the ability to view/edit content with Online office (ie o365) |
mandatoryApproval - Boolean
|
Have the ability to set a space to mandatory approval |
Example
{
"api": true,
"adminsCount": 987,
"allowChangeTo": false,
"passwordSettings": false,
"pipelines": true,
"seatsCount": 123,
"sharedAlerts": true,
"spaceGroups": true,
"whiteLabel": false,
"disablePublicPages": false,
"autoTranslate": false,
"confidentialContent": false,
"officeOnline": true,
"mandatoryApproval": false
}
InstanceRefiner
InstanceScimConfig
InstanceScimConfigUpdateErrors
Description
Error Type of the instanceScimConfigUpdate
Mutation
Types
Union Types |
---|
Example
PermissionError
InstanceScimConfigUpdateInput
InstanceScimConfigUpdatePayload
Description
Return Type of Mutation instanceScimConfigUpdate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [InstanceScimConfigUpdateErrors!]
|
Errors of the mutation. |
instance - Instance
|
Current instance with updated settings |
Example
{
"clientMutationId": "xyz789",
"errors": [PermissionError],
"instance": Instance
}
InstanceSettingsUpdateErrors
Description
Error Type of the instanceSettingsUpdate
Mutation
Types
Union Types |
---|
Example
PermissionError
InstanceSettingsUpdateInput
Description
Input type for Mutation instanceSettingsUpdate
Fields
Input Field | Description |
---|---|
publicSharing - Boolean
|
Enable public sharing: true activate it, false: disable it, null: do not touch the value |
autoTranslate - Boolean
|
Enable auto translate of content: (can only be used if planLimits.autoTranslate is also enabled) |
advancedMobileSecurity - Boolean
|
Enable advanced mobile security verifications (biometric, pin,...) |
exportCSVRole - UserSystemRole
|
Configure the role able to do automated export of CSV |
activityDigestFrequency - DigestFrequency
|
Setup the activity DigestFrequency for all the users (DEFAULT is Invalid in this context and will be assigned to never) |
sharePointSearch - Boolean
|
Enable search in SharePoint sites, toggle the InstanceSharePoint.active field |
downloadLimitEnable - Boolean
|
Enable or disable download limits |
downloadLimitWarn - Int
|
Number of downloads after which a warning email will be sent to the user and the platform administrators. 0 to disable. |
downloadLimitLimit - Int
|
Number of downloads after which the user will be disabled, and a warning email will be sent to the user and the platform administrators. 0 to disable. |
downloadLimitReset - Int
|
Period (in days) after which the count is reset. 0 disables all limits. |
downloadLimitRole - UserSystemRole
|
User role that is impacted. All inferior roles are also impacted. Administrators will never be disabled, but the warning email will be sent. |
forceTwoFactor - Boolean
|
When set to true, all users that use a login and password to connect must use a second authentification factor |
passwordSecurityLevel - PasswordSecurityLevel
|
Required security level of users passwords. See PasswordSecurityLevel |
maxLoginAttempts - Int
|
The number of failed login attempts after which an account is suspended (default: 5). |
loginSuspendPeriod - Int
|
The number of seconds after which a suspended account is reactivated (default: 600). |
addAiFeatureMembers - [ID!]
|
Enable the use of the AI feature for a Team or User |
removeAiFeatureMembers - [ID!]
|
Disable the use of the AI feature for a Team or User (that was previously enabled) |
Example
{
"publicSharing": true,
"autoTranslate": false,
"advancedMobileSecurity": true,
"exportCSVRole": "ADMINISTRATOR",
"activityDigestFrequency": "DEFAULT",
"sharePointSearch": false,
"downloadLimitEnable": true,
"downloadLimitWarn": 987,
"downloadLimitLimit": 123,
"downloadLimitReset": 987,
"downloadLimitRole": "ADMINISTRATOR",
"forceTwoFactor": false,
"passwordSecurityLevel": "LOW",
"maxLoginAttempts": 123,
"loginSuspendPeriod": 123,
"addAiFeatureMembers": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"removeAiFeatureMembers": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
]
}
InstanceSettingsUpdatePayload
Description
Return Type of Mutation instanceSettingsUpdate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [InstanceSettingsUpdateErrors!]
|
Errors of the mutation. |
instance - Instance
|
Current instance with updated settings |
Example
{
"clientMutationId": "xyz789",
"errors": [PermissionError],
"instance": Instance
}
InstanceSlack
Description
Details about the Slack integration
Fields
Field Name | Description |
---|---|
active - Boolean
|
True if a platform admin activated the feature |
activitiesConfig - SlackActivitiesConfig
|
Configuration of the activities you want to be published on Slack |
installed - Boolean
|
True if a slack access token is stored |
setupUrl - URL
|
Url of the Sign-in process to setup the integration |
tokenOwner - String
|
Information about the owner of the token if available |
spacesToChannel - [SpacesToChannelItem!]
|
A list of Elium space to Slack channel mappings. For each of those mappings, a message will be sent to the slack channel when one of the following activities occurs in the Elium space: - New story published - New version published - New comment on a story |
validToken - Boolean
|
True if a slack access token is stored and it has not been revoked from the Slack workspace |
Example
{
"active": false,
"activitiesConfig": SlackActivitiesConfig,
"installed": false,
"setupUrl": "http://www.test.com/",
"tokenOwner": "xyz789",
"spacesToChannel": [SpacesToChannelItem],
"validToken": false
}
InstanceSlackUpdateErrors
Description
Error Type of the instanceSlackUpdate
Mutation
Types
Union Types |
---|
Example
PermissionError
InstanceSlackUpdateInput
InstanceSlackUpdatePayload
Description
Return Type of Mutation instanceSlackUpdate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [InstanceSlackUpdateErrors!]
|
Errors of the mutation. |
instance - Instance
|
The updated current instance |
Example
{
"clientMutationId": "xyz789",
"errors": [PermissionError],
"instance": Instance
}
InstanceSpaceOrderBy
Description
Ordering options for SpaceConnection admin
Values
Enum Value | Description |
---|---|
|
Order by Space name |
|
Order by status space (enabled, closed, pending) |
|
Order by the SpaceGroup name |
|
Order by SpaceType
|
|
Order by default spaces first |
|
Order by the number of members in the space (members in team are counted and deleted or pending users too) |
Example
"NAME"
InstanceSsoConfig
Description
Configuration of the Instance's SingleSignOn
Fields
Field Name | Description |
---|---|
allowCreate - Boolean
|
Enable automatic creation of accounts for new users upon first connection. |
assertionsSigned - Boolean
|
Are saml2 assertions signed |
digestAlgorithm - Saml2DigestAlgo
|
The digest algorithm for saml2 |
metadata - String
|
XML metadata of your SAML Identity Provider. |
metadataUrl - URL
|
URL of the SAML metadata |
regularLogin - URL
|
Regular login url to connect with login and password |
responseSigned - Boolean
|
Are saml2 responses signed |
saml2Enabled - Boolean
|
Is saml2 enabled (platform wide) |
saml2Validity - Saml2Validity
|
Information about the current SAML certificate validity |
saml2Login - URL
|
Saml2 login URL |
signatureAlgorithm - Saml2SignatureAlgo
|
The signature algorithm for saml2 |
transparentAuth - Boolean
|
Automatically initiate the SSO transaction. If disabled the user will be asked which login method to use (password or SSO). |
Example
{
"allowCreate": true,
"assertionsSigned": false,
"digestAlgorithm": "SHA1",
"metadata": "xyz789",
"metadataUrl": "http://www.test.com/",
"regularLogin": "http://www.test.com/",
"responseSigned": true,
"saml2Enabled": true,
"saml2Validity": Saml2Validity,
"saml2Login": "http://www.test.com/",
"signatureAlgorithm": "RSA_SHA1",
"transparentAuth": true
}
InstanceSsoConfigUpdateErrors
Description
Error Type of the instanceSsoConfigUpdate
Mutation
Types
Union Types |
---|
Example
PermissionError
InstanceSsoConfigUpdateInput
Description
Input type for Mutation instanceSsoConfigUpdate
Fields
Input Field | Description |
---|---|
allowCreate - Boolean
|
Enable automatic creation of accounts for new users upon first connection. |
assertionsSigned - Boolean
|
Are saml2 assertions signed |
digestAlgorithm - Saml2DigestAlgo
|
The digest algorithm for saml2 |
metadata - String
|
XML metadata of your SAML Identity Provider. |
metadataUrl - URLInput
|
URL to fetch Metadata From it will fill metadata field |
responseSigned - Boolean
|
Are saml2 responses signed |
saml2Enabled - Boolean
|
Enable SMAL2 federation for everyone |
signatureAlgorithm - Saml2SignatureAlgo
|
The signature algorithm for saml2 |
transparentAuth - Boolean
|
Automatically initiate the SSO transaction. If disabled the user will be asked which login method to use (password or SSO). |
Example
{
"allowCreate": false,
"assertionsSigned": false,
"digestAlgorithm": "SHA1",
"metadata": "xyz789",
"metadataUrl": URLInput,
"responseSigned": true,
"saml2Enabled": false,
"signatureAlgorithm": "RSA_SHA1",
"transparentAuth": false
}
InstanceSsoConfigUpdatePayload
Description
Return Type of Mutation instanceSsoConfigUpdate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [InstanceSsoConfigUpdateErrors!]
|
Errors of the mutation. |
instance - Instance
|
Current instance with updated settings |
Example
{
"clientMutationId": "abc123",
"errors": [PermissionError],
"instance": Instance
}
InstanceStatistics
Description
All Stats about the current instance
Fields
Field Name | Description |
---|---|
id - ID!
|
ID of the object. |
activeUsersCount - Int!
|
Total number of active users over the period |
Arguments
|
|
activityDigestDelivered - ActivityDigestOpenResult
|
Get Statistics about the number of Delivered Emails from Activity digest or Shared alert. if no Alert is given, then it's the Activity digest |
Arguments
|
|
activityDigestOpen - ActivityDigestOpenResult
|
Get Statistics about the number of Open Emails from Activity digest or Shared alert. if no Alert is given, then it's the Activity digest |
Arguments
|
|
commentsTrends - TimeSeries
|
Trend of the comments post over the requested period |
Arguments
|
|
resharesTrends - TimeSeries
|
Trend of the reshares posted over the requested period |
Arguments
|
|
contentCount - Int!
|
Total number of content on the platform (archived, draft and personal included) |
draftCount - Int!
|
Total number of unpublished stories in shared spaces (not personnal) |
draftSpaces - ActiveSpaceTableResult
|
Show spaces with most drafts |
inactiveSpaceTable - ActiveSpaceTableResult
|
Get a list of Space with no activity on the platform during the selected period If team is provided, filter to activities of members of the team |
Arguments
|
|
inactiveUsers - UserConnection
|
List of inactive users since at least 30 days. Optionally filter by a team. |
Arguments
|
|
likesTrends - TimeSeries
|
Trend of the likes of the stories and story comments over the requested period |
Arguments
|
|
mostActiveContentTable - ActiveContentTableResult
|
Get a list of Content with most activity on the platform during the selected period return a list of stories and stats (likes, comments, views, unique_views) |
Arguments
|
|
mostActiveSpaceTable - ActiveSpaceTableResult
|
Get a list of Space with most activity on the platform during the selected period return a list of spaces and stats (likes, comments, views, unique_views) If team is provided, filter to activities of members of the team |
Arguments
|
|
mostActiveUsers - MostActiveUsersList
|
Get a list of users with most activity on the platform during the selected period return a list of object with view, like, comment, publications, updates + users if team is provided, only (current) members of this team will be returned |
Arguments
|
|
pendingUserCount - Int!
|
Total number of users that didn't finish the registration process |
Arguments
|
|
publicationsTrends - TimeSeries
|
Evolution of the number of publications over the requested period publications mean New content beeing created (STORY_PUBLISH) |
Arguments
|
|
updatesTrends - TimeSeries
|
Evolution of the new versions of contents over the requested period this will count update on contents (regular, silent) not draft |
Arguments
|
|
searchCount - Int!
|
Number of search perfomed durint the period |
Arguments
|
|
searchUsersCount - Int!
|
Number of distinct users who performed a search during the period |
Arguments
|
|
spaceApprovalsStats - ActiveSpaceTableResult
|
List number of approval per spaces and their statuses possible keys are: |
topSearches - TopSearchesTableResult
|
Get the Top search phrases for a given period |
Arguments
|
|
totalUniqueDeliveredDigest - Int!
|
Number of unique people who have received a digest or a shared Alert also see activityDigestDelivered |
Arguments
|
|
totalUniqueOpenDigest - Int!
|
Number of unique people who have opened a digest or a shared Alert also see activityDigestOpen |
Arguments
|
|
totalUniqueMailOpenDigest - Int!
|
Number of unique email of Activity Digest or Alert that has been opened on the period |
Arguments
|
|
totalUniqueMailDeliveredDigest - Int!
|
Number of unique email of Activity Digest or Alert that has been delivered on the period |
Arguments
|
|
totalUserCount - Int!
|
Total number of users |
Arguments
|
|
usersActivity - TimeSeries
|
Get distinct count of active users on a product (null means all products). Optionally limited to the members of a team. |
Arguments
|
|
viewsTrends - TimeSeries
|
Trend of the unique views of the stories over the requested period |
Arguments
|
|
answerAsk - TimeSeries
|
Get number of question asked to answer |
Arguments
|
|
answerFeedbackPositive - TimeSeries
|
Get number of positive feedback on question asked to answer |
Arguments
|
|
answerFeedbackNegative - TimeSeries
|
Get number of negative feedback on question asked to answer |
Arguments
|
|
kmScore - KMScore
|
Get Evaluation score about Your Instance contents |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"activeUsersCount": 123,
"activityDigestDelivered": ActivityDigestOpenResult,
"activityDigestOpen": ActivityDigestOpenResult,
"commentsTrends": [
["2020-08-01T00:00:00Z", 12],
["2020-08-02T00:00:00Z", 13]
],
"resharesTrends": [
["2020-08-01T00:00:00Z", 12],
["2020-08-02T00:00:00Z", 13]
],
"contentCount": 123,
"draftCount": 987,
"draftSpaces": ActiveSpaceTableResult,
"inactiveSpaceTable": ActiveSpaceTableResult,
"inactiveUsers": UserConnection,
"likesTrends": [["2020-08-01T00:00:00Z", 12], ["2020-08-02T00:00:00Z", 13]],
"mostActiveContentTable": ActiveContentTableResult,
"mostActiveSpaceTable": ActiveSpaceTableResult,
"mostActiveUsers": MostActiveUsersList,
"pendingUserCount": 987,
"publicationsTrends": [
["2020-08-01T00:00:00Z", 12],
["2020-08-02T00:00:00Z", 13]
],
"updatesTrends": [["2020-08-01T00:00:00Z", 12], ["2020-08-02T00:00:00Z", 13]],
"searchCount": 123,
"searchUsersCount": 123,
"spaceApprovalsStats": ActiveSpaceTableResult,
"topSearches": TopSearchesTableResult,
"totalUniqueDeliveredDigest": 987,
"totalUniqueOpenDigest": 987,
"totalUniqueMailOpenDigest": 987,
"totalUniqueMailDeliveredDigest": 987,
"totalUserCount": 123,
"usersActivity": [["2020-08-01T00:00:00Z", 12], ["2020-08-02T00:00:00Z", 13]],
"viewsTrends": [["2020-08-01T00:00:00Z", 12], ["2020-08-02T00:00:00Z", 13]],
"answerAsk": [["2020-08-01T00:00:00Z", 12], ["2020-08-02T00:00:00Z", 13]],
"answerFeedbackPositive": [
["2020-08-01T00:00:00Z", 12],
["2020-08-02T00:00:00Z", 13]
],
"answerFeedbackNegative": [
["2020-08-01T00:00:00Z", 12],
["2020-08-02T00:00:00Z", 13]
],
"kmScore": KMScore
}
InstanceSubscription
Description
Billing Subscription for the current instance
Fields
Field Name | Description |
---|---|
id - ID!
|
ID of the object. |
customer - JSON
|
JSON representation of the subscription's customer |
estimate - JSON
|
Compute an estimate for a subscription change return an Estimate Object from chargebee |
finishedCheckout - IsoDateTime
|
Give the date for the first finished checkout |
inTrialNotCheckedOut - Boolean!
|
Has the customer already checked-out but is still in trial |
invoices - InstanceInvoiceResult
|
Returns the invoices for this subscription. Attention: This resolver is really slow. We suggest to use it only when necessary. |
nextBillingAt - IsoDateTime
|
Get the date of the next billing |
paymentIntent - JSON
|
Fetch an intent to pay for the subscription return an Intent Object from chargebee |
paymentSources - [JSON!]
|
List possible payement sources from the account payement sources from chargebee |
plan - InstancePlan
|
Get the description of the current plan |
portalSession - JSON
|
Portal Session for payement Return a JSON object from chargebee |
seats - Int
|
Number of regular seats available in the subscription |
readerSeats - Int
|
Number of reader seats available in the subscription |
status - InstanceSubscriptionStatus
|
Current status of the subscription |
subscriptionId - OpaqueID
|
Subscription ID for synchronisation with payment provider |
trialEnd - IsoDateTime
|
If the subscription is currently in IN_TRIAL status, when does the trial ends |
site - String
|
Current Chargebee Site |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"customer": {},
"estimate": {},
"finishedCheckout": "2016-10-07T01:08:03.420Z",
"inTrialNotCheckedOut": true,
"invoices": InstanceInvoiceResult,
"nextBillingAt": "2016-10-07T01:08:03.420Z",
"paymentIntent": {},
"paymentSources": [{}],
"plan": InstancePlan,
"portalSession": {},
"seats": 987,
"readerSeats": 987,
"status": "ACTIVE",
"subscriptionId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"trialEnd": "2016-10-07T01:08:03.420Z",
"site": "xyz789"
}
InstanceSubscriptionStatus
Description
Represents the status of an instance subscription.
Values
Enum Value | Description |
---|---|
|
The subscription is currently active. |
|
The subscription has been cancelled and the instance will shutdown after the grace period |
|
The subscription is scheduled for a future date. |
|
The subscription is in a trial period. |
|
The subscription does not renew automatically. |
|
The subscription is temporarily paused. |
Example
"ACTIVE"
InstanceTheme
Description
Configuration of the Instance's Look & Feel Customize colors or display of the instance
Fields
Field Name | Description |
---|---|
accentColor - Color
|
The primary accent color used throughout the application. This color is used for interactive elements and highlights. Note: Only available for white label instances. Requires InstanceLimits.whiteLabel |
activityLog - Boolean!
|
Indicates whether the Activity log is enabled for the homepage. The Activity log displays a stream of events related to the user. |
directory - Boolean!
|
Determines if the directory of users link is visible in the sidebar menu. |
personalContent - Boolean!
|
Deprecated unused, will be deleted |
desktopNotificationIcon - URL!
|
The URL for the desktop notification icon. This icon is used in desktop notifications made by the browser to represent the application. |
emailLogo - URL
|
The URL for the email logo. This logo is used in emails sent by the application to represent the brand. |
faviconUrl - URL
|
The URL for the favicon. The favicon is a small icon displayed in the browser tab and bookmarks. |
headerColor - Color
|
The color used for the header section of the application. This color sets the background of the header and can affect the readability of text. see headerTextLightness Requires InstanceLimits.whiteLabel |
headerTextLightness - ColorLightness
|
Specifies the lightness of the header text. This can be used to ensure the header text is readable against the header background color. see headerColor Requires InstanceLimits.whiteLabel |
logoImageUrl - URL
|
The URL for the logo image. Requires |
logoSize - LogoSize
|
Determines the size of the logo displayed on the application. Options include BIG, SMALL, or NO_LOGO. Requires InstanceLimits.whiteLabel |
mobileLogo - URL
|
The URL for the mobile logo. This logo is used in the mobile version of the application to represent the brand. |
presetColors - [Color!]
|
A preset of colors used throughout the application. These colors can be used to maintain a consistent look and feel across different parts of the UI. |
Example
{
"accentColor": "#CCCCCC",
"activityLog": false,
"directory": true,
"personalContent": false,
"desktopNotificationIcon": "http://www.test.com/",
"emailLogo": "http://www.test.com/",
"faviconUrl": "http://www.test.com/",
"headerColor": "#CCCCCC",
"headerTextLightness": "DARK",
"logoImageUrl": "http://www.test.com/",
"logoSize": "BIG",
"mobileLogo": "http://www.test.com/",
"presetColors": ["#CCCCCC"]
}
InstanceThemeUpdateErrors
Description
Error Type of the instanceThemeUpdate
Mutation
Types
Union Types |
---|
Example
PermissionError
InstanceThemeUpdateInput
Description
Input type for Mutation instanceThemeUpdate
Fields
Input Field | Description |
---|---|
accentColor - Color
|
The primary accent color to be updated for the application. This color is used for interactive elements and highlights. |
desktopNotificationIcon - File
|
The file to be used as the desktop notification icon. This icon is used in desktop notifications to represent the application. |
emailLogo - File
|
The file to be used as the email logo. This logo is used in emails sent by the application to represent the brand. |
emailSenderName - String
|
The name to be used as the email sender. This name appears as the sender in emails sent by the application. |
favicon - File
|
The file to be used as the favicon. The favicon is a small icon displayed in the browser tab and bookmarks. |
headerColor - Color
|
The color to be used for the header section of the application. This color sets the background of the header and can affect the readability of text. see headerTextLightness |
headerTextLightness - ColorLightness
|
Specifies the lightness of the header text. This can be used to ensure the header text is readable against the header background color. |
homepage - MePreferencesHomepage
|
Configuration for the homepage Layout preferences for other users |
instanceName - String
|
The name to be configured for the current instance. this could be used in email, in the interface or in tab name. This requires the InstanceLimits.whiteLabel permission. |
logoImage - File
|
The file to be used as the logo image. This image is used as the application's logo in various places within the UI. |
logoSize - LogoSize
|
Determines the size of the logo displayed on the application. Options include BIG, SMALL, or NO_LOGO. |
mobileLogo - File
|
The file to be used as the mobile logo. This logo is used in the mobile version of the application to represent the brand. |
presetColors - [Color!]
|
A preset of colors to be used throughout the application. These colors can be used to maintain a consistent look and feel across different parts of the UI. |
removeDesktopNotificationIcon - Boolean!
|
Indicates whether to remove the desktop notification icon. If set to true, the current desktop notification icon will be removed. Default = false |
removeEmailLogo - Boolean!
|
Indicates whether to remove the email logo. If set to true, the current email logo will be removed. Default = false |
removeFavicon - Boolean!
|
Indicates whether to remove the favicon. If set to true, the current favicon will be removed. Default = false |
removeLogoImage - Boolean!
|
Indicates whether to remove the logo image. If set to true, the current logo image will be removed. Default = false |
removeMobileLogo - Boolean!
|
Indicates whether to remove the mobile logo. If set to true, the current mobile logo will be removed. Default = false |
activityLog - Boolean
|
Toogle the activity log for every users on the homepage |
directory - Boolean
|
Toogle the directory link on the homepage for every users |
welcomeMessages - [TranslatedRichContentInput!]
|
List of welcome messages to be displayed on the homepage The list should contain ALL the defined messages (1 by language) If a language is not defined, the message will be removed |
Example
{
"accentColor": "#CCCCCC",
"desktopNotificationIcon": "5ee411f1-6632-4388-b994-9fda4caf5c43",
"emailLogo": "5ee411f1-6632-4388-b994-9fda4caf5c43",
"emailSenderName": "xyz789",
"favicon": "5ee411f1-6632-4388-b994-9fda4caf5c43",
"headerColor": "#CCCCCC",
"headerTextLightness": "DARK",
"homepage": "DEFAULT",
"instanceName": "abc123",
"logoImage": "5ee411f1-6632-4388-b994-9fda4caf5c43",
"logoSize": "BIG",
"mobileLogo": "5ee411f1-6632-4388-b994-9fda4caf5c43",
"presetColors": ["#CCCCCC"],
"removeDesktopNotificationIcon": true,
"removeEmailLogo": true,
"removeFavicon": true,
"removeLogoImage": false,
"removeMobileLogo": true,
"activityLog": false,
"directory": true,
"welcomeMessages": [TranslatedRichContentInput]
}
InstanceThemeUpdatePayload
Description
Return Type of Mutation instanceThemeUpdate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [InstanceThemeUpdateErrors!]
|
Errors of the mutation. |
instance - Instance
|
The updated current instance |
Example
{
"clientMutationId": "xyz789",
"errors": [PermissionError],
"instance": Instance
}
InstanceUpdateSubscriptionErrors
Description
Possible Errors of the instanceUpdateSubscription
Mutation
Example
PermissionError
InstanceUpdateSubscriptionInput
Description
Input type for Mutation instanceUpdateSubscription
Example
{
"paymentIntentId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"planId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"seats": 987
}
InstanceUpdateSubscriptionPayload
Description
Return Type of Mutation instanceUpdateSubscription
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
instance - Instance
|
The updated current instance |
errors - [InstanceUpdateSubscriptionErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"instance": Instance,
"errors": [PermissionError]
}
InstanceUsage
Description
Describe the current usage of limits of the instance
Example
{
"adminsCount": 123,
"pipelinesCount": 123,
"seatsCount": 987,
"sharedAlertsCount": 123,
"spaceGroupsCount": 123
}
InstanceWorkplace
Description
Details about the Facebook Workplace integration of the instance
Example
{
"active": false,
"installed": false,
"setupUrl": "http://www.test.com/"
}
InstanceWorkplaceUpdateErrors
Description
Error Type of the instanceWorkplaceUpdate
Mutation
Types
Union Types |
---|
Example
PermissionError
InstanceWorkplaceUpdateInput
InstanceWorkplaceUpdatePayload
Description
Return Type of Mutation instanceWorkplaceUpdate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [InstanceWorkplaceUpdateErrors!]
|
Errors of the mutation. |
instance - Instance
|
The updated current instance |
Example
{
"clientMutationId": "abc123",
"errors": [PermissionError],
"instance": Instance
}
Int
Description
The Int
scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.
Example
987
IntListWrapper
Description
Container type for values with a list of Int
Fields
Field Name | Description |
---|---|
valueIntList - [Int!]!
|
List of values |
Example
{"valueIntList": [123]}
IntWrapper
Description
Container type for values with a single Int
Fields
Field Name | Description |
---|---|
valueInt - Int!
|
The Integer value |
Example
{"valueInt": 987}
IntegrationError
Description
Represent the error when an external integration service returned an error
Fields
Field Name | Description |
---|---|
path - String!
|
Path of the field leading to the error |
Example
{"path": "xyz789"}
Integrations
Description
External data sources that can be queried from this graph, typically to help setting up integrations
Fields
Field Name | Description |
---|---|
microsoftTeams - MicrosoftTeamsIntegration
|
Get informations about connected Microsoft Teams instance |
slack - SlackIntegration
|
Get informations about connected Slack instance |
sharePoint - SharePointIntegration
|
Get informations about connected Sharepoints |
Example
{
"microsoftTeams": MicrosoftTeamsIntegration,
"slack": SlackIntegration,
"sharePoint": SharePointIntegration
}
InvalidFormatError
InvalidInputError
Description
Represent the error when a supplied value is invalid
Fields
Field Name | Description |
---|---|
path - String!
|
Path of the field leading to the error |
Example
{"path": "abc123"}
InvalidPasswordError
InvalidPlanError
Description
Represent the error when doing operations with an invalid Plan.
Fields
Field Name | Description |
---|---|
path - String!
|
Path of the field leading to the error |
Example
{"path": "xyz789"}
InvalidPlanLimitsError
Description
Represent the error when an operation violate the limits of the future plan
Fields
Field Name | Description |
---|---|
path - String!
|
Path of the field leading to the error |
errorLimits - InstancePlanLimits
|
Limits of the future plan |
Example
{
"path": "xyz789",
"errorLimits": InstancePlanLimits
}
InvitableConnection
Description
List of results of Invitable
Fields
Field Name | Description |
---|---|
edges - [InvitableEdge!]
|
A list of edges. |
pageInfo - PageInfo!
|
Information to aid in pagination. |
totalCount - Int!
|
Identifies the total count of items in the connection. |
Example
{
"edges": [InvitableEdge],
"pageInfo": PageInfo,
"totalCount": 123
}
InvitableEdge
Description
An edge in a connection.
Fields
Field Name | Description |
---|---|
cursor - String!
|
A cursor for use in pagination. |
node - InvitableResult!
|
The item at the end of the edge. |
Example
{
"cursor": "abc123",
"node": InvitableResult
}
InvitableResult
Description
An Invitation respond result
Fields
Field Name | Description |
---|---|
invitable - EventParticipant!
|
The participant that was invited |
rsvp - Rsvp
|
The response to the invitation |
Example
{"invitable": User, "rsvp": "INVITED"}
Invitation
Description
Invitation to an event
Fields
Field Name | Description |
---|---|
id - ID!
|
ID of the object. |
invitedAt - IsoDateTime
|
Date when the invitation was sent |
inviter - User
|
User who sent the invitation |
participant - EventParticipant
|
The invited participant |
rsvp - Rsvp!
|
The response the invited participant gave |
rsvpAt - IsoDateTime
|
Date when the invited participant responded |
rsvpUpdated - IsoDateTime
|
The date when the invitation was last updated |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"invitedAt": "2016-10-07T01:08:03.420Z",
"inviter": User,
"participant": User,
"rsvp": "INVITED",
"rsvpAt": "2016-10-07T01:08:03.420Z",
"rsvpUpdated": "2016-10-07T01:08:03.420Z"
}
InvitationConnection
Description
List of results of Invitation
Fields
Field Name | Description |
---|---|
edges - [InvitationEdge!]
|
A list of edges. |
pageInfo - PageInfo!
|
Information to aid in pagination. |
totalCount - Int!
|
Identifies the total count of items in the connection. |
Example
{
"edges": [InvitationEdge],
"pageInfo": PageInfo,
"totalCount": 987
}
InvitationEdge
Description
An edge in a connection.
Fields
Field Name | Description |
---|---|
cursor - String!
|
A cursor for use in pagination. |
node - Invitation!
|
The item at the end of the edge. |
Example
{
"cursor": "xyz789",
"node": Invitation
}
InvoiceStatus
Description
Status of an invoice
Values
Enum Value | Description |
---|---|
|
An invoice is marked as Not Paid when the payment has not been received. No further attempts will be made on this invoice. An invoice is also marked as Not Paid if a direct debit transaction fails. |
|
Indicates a paid invoice. |
|
Indicates the payment is not yet collected and is being retried as per retry settings. |
|
The invoice is yet to be closed (sent for payment collection). |
|
Indicates the payment is not yet collected and will be in this state till the due date to indicate the due period |
|
Indicates a voided invoice. |
Example
"NOT_PAID"
IsoDateTime
Description
Represent a Date and Time in the ISO 8601 format with attached timezone
Example
"2016-10-07T01:08:03.420Z"
JSON
Description
A JSON object. In inputs it can be either a stringify version of a JSON object or a JSON object itself in query, it's a regular JSON object
Example
{}
JsonWrapper
Description
Container type for values organized in a JSON object
Fields
Field Name | Description |
---|---|
valueJson - JSON!
|
The value as a JSON object |
Example
{"valueJson": {}}
KMScore
Description
A Score about instance's management and content.
Fields
Field Name | Description |
---|---|
globalScore - Int
|
Weighted combination of the other scores, summary of the state of the instance. 0 (worst) to 100 (best) |
activeUserScore - Int
|
Active user score (% active on registered). 0 to 100 |
outdatedProportionScore - Int
|
Proportion of outdated contents (outdated on verified), 0 to 100 |
lastContentsReachScore - Int
|
Reach of your 90Days latest contents |
Example
{
"globalScore": 123,
"activeUserScore": 987,
"outdatedProportionScore": 987,
"lastContentsReachScore": 123
}
LabFeature
Lang
Description
The ISO-639 ALPHA-2 version of a language.
Example
"fr"
LangResult
Description
Language Facetted Result of a search listing the number of content of the given Lang
Example
{
"label": "xyz789",
"lang": "fr",
"totalCount": 123
}
Language
LegacyTimezone
Description
Legacy time zone identifier such as 'EUROPE_BRUSSELS'
Fields using this type of value are deprecated and should no longer be used
The identifier is obtained by taking the IANA identifier and replacing "/" and "-" by "_" and making it uppercase
Example
LegacyTimezone
LibraryTab
Description
A SpaceTab is a sub-level navigation for a space. This provides a filtered / formated view of the contents in the space.
Fields
Field Name | Description |
---|---|
icon - OpaqueID
|
Icon representing the tab |
id - ID!
|
ID of the object. |
label - String!
|
The label of the tab for the current user's lang. |
labels - TranslatedString!
|
Translated names of the tab. |
slug - String!
|
Short human representation of the tab. |
Example
{
"icon": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"label": "abc123",
"labels": {"en": "a Name", "fr": "Un Nom"},
"slug": "xyz789"
}
Likeable
Description
Interface for objects that can be liked finding the likers and if the current user liked it
Fields
Field Name | Description |
---|---|
likers - UserConnection
|
List of users who liked this object |
liked - Boolean!
|
Is the current user liking this object |
Example
{"likers": UserConnection, "liked": true}
LimitsViolationError
Description
Represent the error when an operation will result in violating the current limits of the plan
Fields
Field Name | Description |
---|---|
path - String!
|
Path of the field leading to the error |
limits - InstanceLimits
|
Limits of the current instance |
Example
{
"path": "xyz789",
"limits": InstanceLimits
}
LinkTab
Description
A SpaceTab is a sub-level navigation for a space. This provides a filtered / formated view of the contents in the space.
Fields
Field Name | Description |
---|---|
display - LinkTabDisplay!
|
Kind of Tab to display (embeded in the app or open an external link) |
icon - OpaqueID
|
Icon representing the tab |
id - ID!
|
ID of the object. |
label - String!
|
The label of the tab for the current user's lang. |
labels - TranslatedString!
|
Translated names of the tab. |
slug - String!
|
Short human representation of the tab. |
src - URL
|
URL of the link to open when using the tab |
Example
{
"display": "EMBEDDED",
"icon": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"label": "abc123",
"labels": {"en": "a Name", "fr": "Un Nom"},
"slug": "xyz789",
"src": "http://www.test.com/"
}
LinkTabDisplay
Description
Kind of display for a LinkTab
Values
Enum Value | Description |
---|---|
|
The link is embeded in the tab as an" iframe" |
|
The link is opened if the user click on the tab |
Example
"EMBEDDED"
LinksBox
LockedContentError
Description
Error when a content is currently locked for edition
Fields
Field Name | Description |
---|---|
path - String!
|
Path of the field leading to the error |
Example
{"path": "abc123"}
LogoSize
Description
Size of the logo to display
Values
Enum Value | Description |
---|---|
|
The logo is displayed in a "big" size arround 400x400 |
|
No logo is displayed |
|
The logo is displayed in a "small" size arround 40x40 along with the name |
Example
"BIG"
Me
Description
Entry point for the the currently authenticated user. From there you can browse objects the user has access to.
Fields
Field Name | Description |
---|---|
actions - MeActions!
|
Indicate the list of actions available to the current user on this Object |
activities - ActivityConnection
|
Activity logs (stream of events) from the spaces where the current user is a member. this goes max to 30 days |
aiCompletion - String
|
AI editor integration requires features.aiEditor |
Arguments |
|
annotations - AnnotationConnection
|
Return a list of opened annotations on the content you owned |
smartConversations - SmartConversationConnection
|
List active smartConversation for the current user |
alerts - [Alert!]!
|
List of Alert saved by the current user. Use myAlerts or sharedAlerts instead
|
sharedAlerts - AlertConnection
|
List of shared Alert the user is subscribed to |
Arguments
|
|
myAlerts - AlertConnection
|
List of Alert created and owned by Me |
Arguments
|
|
analytics - MeAnalytics!
|
Get Personal Analytics |
answer - MeAnswer!
|
AI-powered question answering and more |
appLaunchers - [AppLauncher!]!
|
List of Shortcut of "Apps" installed for the current user. |
bookmarks - StoryConnection
|
Return current user's bookmarks |
boxes - [Box!]!
|
Deprecated part of old homepage |
completeStories - [Story!]!
|
Auto Complete search a content in a given space (or not) excluding content via exclude |
contentFeed - StoryConnection
|
Returns the content feed with given connection params ordered by added datetime and only the content added after afterDate when provided. |
Arguments
|
|
contentFromSuccessions - StoryConnection
|
List of the content you have inherit from successions to process |
deviceTokens - [MeDeviceToken!]
|
List of Mobile devices (token) of the current user |
directory - DirectorySearchResponse!
|
Search the directory for Users |
Arguments
|
|
drafts - StoryConnection
|
List all the draft the current user is working on (as owner or contributor) |
Arguments
|
|
events - StoryConnection
|
List events the current user is invited to the feature is deprecated |
Arguments
|
|
facets - [Facet!]!
|
Fetch list of available Facet for the current user |
Arguments
|
|
feed - ActivityFeedItemConnection
|
Old Activity feed on the homepage |
Arguments
|
|
globalPinnedStories - [Story!]!
|
Fetch stories pinned for the whole platform. |
globalSchemaAttributes - [SchemaAttribute!]!
|
List of Attributes that are global to the platform and must be filled in for all content (mostly deprecated) |
id - ID!
|
ID of the object. |
mention - [MentionResult!]!
|
Look for mention can also be used to invite users to an event, contributors, ... |
Arguments
|
|
ownedContentWithAnnotations - StoryConnection
|
Returns a connection of contents that you are responsible for, that contains "open" annotations. |
myContent - StoryConnection
|
Returns a connection of contents where you are owner or contributor. |
Arguments
|
|
notifications - NotificationConnection
|
List the user"s notifications |
Arguments
|
|
notificationsPreferences - MeNotificationsPreferences!
|
User's notifications preferences |
personalContent - StoryConnection
|
Returns all the contents in the Personal Content space. |
preferences - MePreferences!
|
Current User's preferences like emails, notifications,... |
presenceToken - OpaqueID!
|
Deprecated No longer available |
quickSearch - QuickSearchResponse
|
Quick autocomplete type search of users/contents/spaces |
Arguments
|
|
recents - [Story!]!
|
List of at most 10 Recent content for the current user those are flagged via the analytics mutation system. but less than 10 will be returned if some were deleted or not available anymore |
Arguments
|
|
schemas - [StorySchema!]!
|
Returns a list of schemas for the current user |
search - StorySearchResponse
|
Search content using a variety of criteria used for "Advanced search" |
Arguments
|
|
searchGlobalTags - [TagResult!]
|
Search Tags that are not scoped to a given space |
Arguments
|
|
searchTags - [TagResult!]
|
Search Tags that are scoped to any one of the given spaces |
searchHashtags - [HashtagResult!]
|
Search Hashtags |
Arguments
|
|
hashtags - HashtagConnection
|
Return a list of all available Hashtag |
smartFeeds - SmartFeedConnection
|
List all the available SmartFeed for a the current user |
smartAssistants - SmartAssistantConnection
|
List all the available SmartAssistant for a the current user |
spaceGroups - SpaceGroupConnection
|
List the space groups where there are spaces that the user is member of |
Arguments
|
|
spaces - SpaceConnection
|
List the spaces where the user is member has access to or is member (following the filter criteria) |
Arguments
|
|
storiesByAsset - [Story!]!
|
Deprecated No longer available |
Arguments
|
|
storyAlerts - StoryAlertConnection
|
Get all the active alerts on contents |
subscriptionToken - OpaqueID
|
Deprecated No longer available |
unreadDiscussionsCount - Int!
|
Get the Number of unread discussions for the current user No longer available |
user - User!
|
Currently authenticated user |
Example
{
"actions": MeActions,
"activities": ActivityConnection,
"aiCompletion": "xyz789",
"annotations": AnnotationConnection,
"smartConversations": SmartConversationConnection,
"alerts": [Alert],
"sharedAlerts": AlertConnection,
"myAlerts": AlertConnection,
"analytics": MeAnalytics,
"answer": MeAnswer,
"appLaunchers": [AppLauncher],
"bookmarks": StoryConnection,
"boxes": [Box],
"completeStories": [Story],
"contentFeed": StoryConnection,
"contentFromSuccessions": StoryConnection,
"deviceTokens": [MeDeviceToken],
"directory": DirectorySearchResponse,
"drafts": StoryConnection,
"events": StoryConnection,
"facets": [Facet],
"feed": ActivityFeedItemConnection,
"globalPinnedStories": [Story],
"globalSchemaAttributes": [SchemaAttribute],
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"mention": [User],
"ownedContentWithAnnotations": StoryConnection,
"myContent": StoryConnection,
"notifications": NotificationConnection,
"notificationsPreferences": MeNotificationsPreferences,
"personalContent": StoryConnection,
"preferences": MePreferences,
"presenceToken": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"quickSearch": QuickSearchResponse,
"recents": [Story],
"schemas": [StorySchema],
"search": StorySearchResponse,
"searchGlobalTags": [TagResult],
"searchTags": [TagResult],
"searchHashtags": [HashtagResult],
"hashtags": HashtagConnection,
"smartFeeds": SmartFeedConnection,
"smartAssistants": SmartAssistantConnection,
"spaceGroups": SpaceGroupConnection,
"spaces": SpaceConnection,
"storiesByAsset": [Story],
"storyAlerts": StoryAlertConnection,
"subscriptionToken": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"unreadDiscussionsCount": 123,
"user": User
}
MeActions
Description
Actions the current user is allowed to do
Fields
Field Name | Description |
---|---|
admin - Boolean!
|
The current has admin rights on the plateform |
adminPanel - Boolean!
|
The current user can access the Admin panel, at least partially. |
billing - Boolean!
|
The current user can access and modify billing informations this might be off also because the instance isn't activated on payement platform |
emailEdit - Boolean!
|
The user can edit his email addresses |
hashtagCreate - Boolean!
|
You have the ability to create Hashtag |
inviteUser - Boolean!
|
You can Invite a user to the platform |
lookAndFeel - Boolean!
|
You can modify the instance look & feel |
passwordChange - Boolean!
|
You can change password (usally unavailable if you are using SSO or other authentification method) |
postPersonalStory - Boolean!
|
The current user can post a new content in his personal space |
postStory - Boolean!
|
The current user can post a new content in at least one Space |
smartFeedsManage - Boolean!
|
Can create/edit/delete smart feeds in homepage |
smartAssistantsManage - Boolean!
|
Can create/edit/delete smart assistants in homepage |
spaceAdd - Boolean!
|
You can create new Space see spaceAdd mutation |
spaceAddRequest - Boolean!
|
You can request the creation of a space see spaceAddRequest mutation |
spaceGroupAdd - Boolean!
|
You can create a SpaceGroup and add spaces to it see spaceGroupAdd mutation |
storySchemaBuilder - Boolean!
|
You can access the StorySchema editor |
Example
{
"admin": false,
"adminPanel": false,
"billing": false,
"emailEdit": true,
"hashtagCreate": false,
"inviteUser": false,
"lookAndFeel": true,
"passwordChange": true,
"postPersonalStory": false,
"postStory": true,
"smartFeedsManage": true,
"smartAssistantsManage": true,
"spaceAdd": false,
"spaceAddRequest": false,
"spaceGroupAdd": true,
"storySchemaBuilder": false
}
MeActivateTwoFactorErrors
Description
Error Type of the meActivateTwoFactor
Mutation
Types
Union Types |
---|
Example
InvalidPasswordError
MeActivateTwoFactorInput
Description
Input type for Mutation meActivateTwoFactor
Example
{
"currentPassword": "abc123",
"verificationCode": "xyz789"
}
MeActivateTwoFactorPayload
Description
Return Type of Mutation meActivateTwoFactor
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [MeActivateTwoFactorErrors!]
|
Errors of the mutation. |
me - Me!
|
Currently authenticated user. |
Example
{
"clientMutationId": "xyz789",
"errors": [InvalidPasswordError],
"me": Me
}
MeAnalytics
Description
Get information about your personal achievements on the platform
Fields
Field Name | Description |
---|---|
contentActivity - ActiveContentTableResult
|
Get a list of Content with most activity on the platform during the selected period return a list of stories and stats (likes, comments, views, unique_views) |
preferedPublicationHour - Int
|
Preferred hour of publication (0 is midnight UTC) if a any, else null |
Arguments
|
|
engagementSummary - MeEngagementSummary!
|
Fetch a summary of the activity You generated over the period |
Arguments
|
|
ownedContentsSummary - MeAnalyticsSummary!
|
Fetch a summary of the activity generated by the content you owned |
Arguments
|
|
publishedContentsSummary - MeAnalyticsSummary!
|
Fetch a summary of the activity generated by the content you've published during the period |
Arguments
|
|
summary - MeAnalyticsSummary!
|
Fetch a summary of the activity generated by the content you owned use ownedContentsSummary
|
Example
{
"contentActivity": ActiveContentTableResult,
"preferedPublicationHour": 987,
"engagementSummary": MeEngagementSummary,
"ownedContentsSummary": MeAnalyticsSummary,
"publishedContentsSummary": MeAnalyticsSummary,
"summary": MeAnalyticsSummary
}
MeAnalyticsSummary
Description
Analytics summary for the current user
Fields
Field Name | Description |
---|---|
comments - Int
|
Number of comment on the selected contents over the period |
likes - Int
|
Number of like collected on the selected content over the period |
stories - Int
|
Number of content matching the criterias over the period |
uniqueViews - Int
|
Number of Unique views (users) on selected contents over the period |
views - Int
|
Total number of views (including yours) on selected contents over the period |
Example
{
"comments": 123,
"likes": 123,
"stories": 123,
"uniqueViews": 123,
"views": 123
}
MeAnswer
Description
User specific answer related fields
Fields
Field Name | Description |
---|---|
semanticSearch - SemanticSearchResponse
|
AI-powered semantic search |
Arguments
|
|
answer - Answer
|
AI-powered question answering |
Arguments
|
|
spaces - [Space!]!
|
List of spaces that are configured to be indexed for AI-powered question answering and that the user has access to |
Example
{
"semanticSearch": SemanticSearchResponse,
"answer": Answer,
"spaces": [Space]
}
MeBookmarksClearInput
Description
Input type for Mutation meBookmarksClear
Fields
Input Field | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. DUMMY FIELD FOR HAVING A FIELD |
Example
{"clientMutationId": "xyz789"}
MeBookmarksClearPayload
MeDeviceToken
Description
A Mobile device Link After registering a device with Firebase, you can use the token to send notifications to the device
Fields
Field Name | Description |
---|---|
created - IsoDateTime!
|
The date and time when the token was created, represented as an ISO 8601 formatted string. |
deviceId - OpaqueID!
|
A unique identifier for the device. |
model - String
|
The model of the device. |
name - String
|
The name of the device. |
os - MeDeviceTokenOS
|
The operating system of the device, represented as an enum MeDeviceTokenOS . |
secret - String!
|
A secret string associated with the token this is needed to decrypt the notifications |
updated - IsoDateTime
|
The date and time when the token was last updated, represented as an ISO 8601 formatted string. |
Example
{
"created": "2016-10-07T01:08:03.420Z",
"deviceId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"model": "xyz789",
"name": "xyz789",
"os": "ANDROID",
"secret": "xyz789",
"updated": "2016-10-07T01:08:03.420Z"
}
MeDeviceTokenOS
Description
Type of Notification Device OS
Values
Enum Value | Description |
---|---|
|
Google Android OS https://www.android.com |
|
Apple iOS https://www.apple.com/ios |
Example
"ANDROID"
MeDeviceTokenPublishErrors
Description
Error Type of the meDeviceTokenPublish
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
MeDeviceTokenPublishInput
Description
Input type for Mutation meDeviceTokenPublish
Fields
Input Field | Description |
---|---|
body - String
|
Body text of the notification |
deviceId - OpaqueID!
|
Device ID to send the notification to. Previously registered with meDeviceTokenRegister |
extraData - JSON
|
Extra data to send with the notification like "Screen" or "storyId", ... |
title - String
|
Title for the notification |
badge - Int
|
Badge for the notifications |
Example
{
"body": "abc123",
"deviceId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"extraData": {},
"title": "xyz789",
"badge": 987
}
MeDeviceTokenPublishPayload
Description
Return Type of Mutation meDeviceTokenPublish
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
deviceToken - MeDeviceToken
|
The registered device token where the notification was sent |
sent - Boolean
|
Was the notification effectively sent |
errors - [MeDeviceTokenPublishErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "abc123",
"deviceToken": MeDeviceToken,
"sent": false,
"errors": [ObjectNotFoundError]
}
MeDeviceTokenRegisterInput
Description
Input type for Mutation meDeviceTokenRegister
Fields
Input Field | Description |
---|---|
deviceId - OpaqueID!
|
A unique identifier for the device will be used as reference for accessing the device |
model - String
|
Model name of the device used for identification |
name - String
|
Friendly name of the device used for display |
os - MeDeviceTokenOS!
|
OS of the device |
token - OpaqueID!
|
Firebase (push notification) Token for the device obtain after registering the device with Firebase |
Example
{
"deviceId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"model": "abc123",
"name": "abc123",
"os": "ANDROID",
"token": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}
MeDeviceTokenRegisterPayload
Description
Return Type of Mutation meDeviceTokenRegister
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
deviceToken - MeDeviceToken
|
Newly registered device token |
Example
{
"clientMutationId": "abc123",
"deviceToken": MeDeviceToken
}
MeDeviceTokenUnregisterErrors
Description
Error Type of the meDeviceTokenUnregister
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
MeDeviceTokenUnregisterInput
Description
Input type for Mutation meDeviceTokenUnregister
Fields
Input Field | Description |
---|---|
deviceId - OpaqueID!
|
Device ID to unregister |
Example
{"deviceId": "eWVhaCByaWdodCBpdCdzIGI2NA=="}
MeDeviceTokenUnregisterPayload
Description
Return Type of Mutation meDeviceTokenUnregister
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [MeDeviceTokenUnregisterErrors!]
|
Errors of the mutation. |
me - Me!
|
Currently authenticated user. |
Example
{
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError],
"me": Me
}
MeDisclaimerAcceptInput
Description
Input type for Mutation meDisclaimerAccept
Fields
Input Field | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. DUMMY FIELD FOR HAVING A FIELD |
Example
{"clientMutationId": "abc123"}
MeDisclaimerAcceptPayload
MeEngagementSummary
Description
Engagement statistics for on the current user's content
Fields
Field Name | Description |
---|---|
comments - Int
|
Number of comment on the selected contents over the period |
likes - Int
|
Number of like collected on the selected content over the period |
viewedStories - Int
|
Number of content viewed over the period (unique count) |
views - Int
|
Total number of views over the period |
createdStories - Int
|
Number of published stories created over the period |
presenceDayCount - Int
|
Number of days the app was used over the period |
Example
{
"comments": 123,
"likes": 987,
"viewedStories": 123,
"views": 987,
"createdStories": 987,
"presenceDayCount": 987
}
MeFacetFilter
Description
Filter the facets to return
Values
Enum Value | Description |
---|---|
|
All available facets |
|
Only the global facets (not linked to a space) |
Example
"ALL"
MeNotificationsPreferences
Description
Notification preferences of the current user
Fields
Field Name | Description |
---|---|
email - EmailNotificationPreferences!
|
Preferences for the Email notifications |
inApp - InAppNotificationPreferences!
|
Preferences for the In-App notifications displayed on the web app and mobile |
mobilePush - MobilePushNotificationPreferences!
|
Preferences for the Mobile Push notification |
Example
{
"email": EmailNotificationPreferences,
"inApp": InAppNotificationPreferences,
"mobilePush": MobilePushNotificationPreferences
}
MeNotificationsPreferencesInput
Description
Input type for Mutation meNotificationsPreferences
Fields
Input Field | Description |
---|---|
email - EmailNotificationPreferencesInput
|
Configuration for email notifications see EmailNotificationPreferences (if null, then not touched) |
inApp - InAppNotificationPreferencesInput
|
Set configuration for in App notifications see InAppNotificationPreferences (if null, then not touched) |
mobilePush - MobilePushNotificationPreferencesInput
|
for Mobile push notifications see MobilePushNotificationPreferences (if null, then not touched) |
Example
{
"email": EmailNotificationPreferencesInput,
"inApp": InAppNotificationPreferencesInput,
"mobilePush": MobilePushNotificationPreferencesInput
}
MeNotificationsPreferencesPayload
MePasswordChangeErrors
Description
Error Type of the mePasswordChange
Mutation
Types
Union Types |
---|
Example
PermissionError
MePasswordChangeInput
Description
Input type for Mutation mePasswordChange
Fields
Input Field | Description |
---|---|
currentPassword - String!
|
The current password of the user. This is required to authenticate the user before allowing them to change their password. |
newPassword - String!
|
The new password that the user wishes to set. This is the password that will replace the current password. |
verificationCode - String
|
AVerification code provided by the 2FA system, if enabled. |
Example
{
"currentPassword": "xyz789",
"newPassword": "xyz789",
"verificationCode": "abc123"
}
MePasswordChangePayload
Description
Return Type of Mutation mePasswordChange
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
me - Me!
|
Currently authenticated user. |
errors - [MePasswordChangeErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "abc123",
"me": Me,
"errors": [PermissionError]
}
MePreferences
Description
Current User's preferences
Fields
Field Name | Description |
---|---|
authQRCodeUrl - URL
|
Authentication QR Code for the mobile APP. Can be null if the mobile app is disabled or is a custom APP. |
authQRCodeValidity - Int
|
Number of seconds after which the authQRCodeUrl will be invalidated. |
contentLang - Lang!
|
Preferred language of the user-generated items (Story , Space titles, Tags ....). See uiLang . Use contentLangs instead
|
contentLangs - [Lang!]!
|
Preferred languages of the user-generated items (Story , Space titles, Tags ....). See uiLang . |
digestFrequencyActivity - DigestFrequency!
|
Frequency at which the Activity Digest (summary of the activities of the instance) will be sent to the current user. |
nextActivityDigest - IsoDateTime
|
Defines the next compute of activity digest if digestFrequencyActivity is different than NONE (or not configured as NONE). unused, will be deleted
|
disclaimerAccepted - IsoDateTime
|
Date and time when the user accepted the disclaimer. (if null, the user has not accepted the disclaimer yet) |
emails - [EmailAddress!]!
|
Email addresses associated with the current user. those might be used to validate incoming emails |
homepage - MePreferencesHomepage!
|
Homepage preferences of the current user. |
Arguments
|
|
icsFeed - URL!
|
URL for the ICS feed associated with the current user. |
overview - MePreferencesOverview!
|
Deprecated overview settings for the user's homepage. removed old homepage |
profileSetupCompleted - Boolean
|
Indicates whether the profile setup is completed. (filled the profile, etc.) |
service - MeService
|
Service details for a specified type of service. If refresh is true, the service information will be refreshed. |
Arguments
|
|
timezone - LegacyTimezone!
|
Preferred timezone for this user. Legacy format. Use timezoneKey instead |
timezoneKey - Timezone!
|
Preferred timezone for this user. |
twoFactorCodeUrl - URL
|
URL for the two-factor authentication QRCode. |
uiLang - Lang!
|
Preferred language for the user interface. |
Example
{
"authQRCodeUrl": "http://www.test.com/",
"authQRCodeValidity": 123,
"contentLang": "fr",
"contentLangs": ["fr"],
"digestFrequencyActivity": "DEFAULT",
"nextActivityDigest": "2016-10-07T01:08:03.420Z",
"disclaimerAccepted": "2016-10-07T01:08:03.420Z",
"emails": ["test@test.com"],
"homepage": "DEFAULT",
"icsFeed": "http://www.test.com/",
"overview": "SPACES",
"profileSetupCompleted": true,
"service": GoogleMeService,
"timezone": LegacyTimezone,
"timezoneKey": Timezone,
"twoFactorCodeUrl": "http://www.test.com/",
"uiLang": "fr"
}
MePreferencesHomepage
Description
Homepage preferences for the current user.
Values
Enum Value | Description |
---|---|
|
Default homepage setting. |
|
Feed homepage setting. (feed of latest contents) |
|
Overview homepage setting. (overview of spaces and space groups) |
Example
"DEFAULT"
MePreferencesOverview
Description
Overview preferences for the user's homepage.
Values
Enum Value | Description |
---|---|
|
Overview showing spaces. |
|
Overview showing space groups. |
Example
"SPACES"
MePreferencesUpdateErrors
Description
Error Type of the mePreferencesUpdate
Mutation
Types
Union Types |
---|
Example
EmailAlreadyExistsError
MePreferencesUpdateInput
Description
Input type for Mutation mePreferencesUpdate
Fields
Input Field | Description |
---|---|
contentLangs - [Lang!]
|
A Ordered list of preferred content languages. Then content will be preferably displayed in the first language of the list. |
digestFrequencyActivity - DigestFrequency
|
The frequency of which to send activity digests. |
emails - [EmailAddress!]
|
A list of email addresses associated with the user. |
homepage - MePreferencesHomepage
|
The user's preferred homepage settings. |
timezone - Timezone
|
The user's preferred timezone. |
uiLang - Lang
|
The user's preferred UI language. |
Example
{
"contentLangs": ["fr"],
"digestFrequencyActivity": "DEFAULT",
"emails": ["test@test.com"],
"homepage": "DEFAULT",
"timezone": Timezone,
"uiLang": "fr"
}
MePreferencesUpdatePayload
Description
Return Type of Mutation mePreferencesUpdate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
me - Me
|
The current user |
errors - [MePreferencesUpdateErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"me": Me,
"errors": [EmailAlreadyExistsError]
}
MePresenceUpdateInput
Description
Input type for Mutation mePresenceUpdate
Fields
Input Field | Description |
---|---|
device - UserDevice
|
The concerned device. This will override the autodetection made. |
status - UserPresenceStatus!
|
Reported Status of the user on the device |
token - UUID
|
Token Of the Openend Subscription Channel. See Instance.graphqlSubscriptionsUrl |
Example
{
"device": "MOBILE",
"status": "AVAILABLE",
"token": "7aac93c5-a56c-4528-b43e-457834a796c9"
}
MePresenceUpdatePayload
MeProfileSetupCompleteInput
Description
Input type for Mutation meProfileSetupComplete
Fields
Input Field | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. DUMMY FIELD FOR HAVING A FIELD |
Example
{"clientMutationId": "xyz789"}
MeProfileSetupCompletePayload
MeRemoveTwoFactorErrors
Description
Error Type of the meRemoveTwoFactor
Mutation
Types
Union Types |
---|
Example
PermissionError
MeRemoveTwoFactorInput
Description
Input type for Mutation meRemoveTwoFactor
Example
{
"currentPassword": "abc123",
"verificationCode": "abc123"
}
MeRemoveTwoFactorPayload
Description
Return Type of Mutation meRemoveTwoFactor
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [MeRemoveTwoFactorErrors!]
|
Errors of the mutation. |
me - Me!
|
Currently authenticated user. |
Example
{
"clientMutationId": "xyz789",
"errors": [PermissionError],
"me": Me
}
MeService
Description
Possible Service Object
Types
Union Types |
---|
Example
GoogleMeService
MeServiceResetInput
Description
Input type for Mutation meServiceReset
Fields
Input Field | Description |
---|---|
type - MeServiceType!
|
Type of Service to reset |
Example
{"type": "GOOGLE"}
MeServiceResetPayload
MeServiceTokenErrors
Description
Error Type of the meServiceToken
Mutation
Types
Union Types |
---|
Example
InvalidInputError
MeServiceTokenInput
Description
Input type for Mutation meServiceToken
Fields
Input Field | Description |
---|---|
type - MeServiceType!
|
Type of the service you want to obtain a token from |
Example
{"type": "GOOGLE"}
MeServiceTokenPayload
Description
Return Type of Mutation meServiceToken
Fields
Field Name | Description |
---|---|
accessToken - String
|
Access token of the service |
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
expiresIn - Int
|
Expiration time in seconds of the current accessToken |
errors - [MeServiceTokenErrors!]
|
Errors of the mutation. |
Example
{
"accessToken": "abc123",
"clientMutationId": "xyz789",
"expiresIn": 123,
"errors": [InvalidInputError]
}
MeServiceType
Description
The type of service available for the current user.
Values
Enum Value | Description |
---|---|
|
Google / Google Drive |
|
Microsoft Teams |
|
Microsoft OneDrive |
|
Slack |
Example
"GOOGLE"
MeTokenResetInput
Description
Input type for Mutation meTokenReset
Fields
Input Field | Description |
---|---|
token - MeTokenType!
|
The type of token you want to reset. note: Reseting the MOBILE_APPS will also remove DeviceToken associated with the account |
Example
{"token": "API"}
MeTokenResetPayload
MeTokenType
Description
Type of Token for the meTokenReset
mutation
Values
Enum Value | Description |
---|---|
|
Deprecated. Use MOBILE_APPS
|
|
Token for the RSS feed of search results |
|
Token for ical integration |
|
Token for the mobile Apps |
Example
"API"
MediaTypeResult
MentionResult
MicrosoftTeamsActivitiesConfig
Description
Configuration About Activities that should be sent as MsTeams Notifications
Fields
Field Name | Description |
---|---|
comments - Boolean
|
Comments should trigger a msTeam notification on the given channels |
storyPublish - Boolean
|
Story Publish should trigger a msTeam notification on the given channels |
versionPublish - Boolean
|
Version Publish should trigger a msTeam notification on the given channels |
Example
{"comments": true, "storyPublish": false, "versionPublish": true}
MicrosoftTeamsActivitiesConfigUpdateErrors
Description
Error Type of the microsoftTeamsActivitiesConfigUpdate
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
MicrosoftTeamsActivitiesConfigUpdateInput
Description
Input type for Mutation microsoftTeamsActivitiesConfigUpdate
Fields
Input Field | Description |
---|---|
comments - Boolean!
|
New comments should trigger a notification in the linked MS Teams channel |
storyPublish - Boolean!
|
New stories should trigger a notification in the linked MS Teams channel |
versionPublish - Boolean!
|
New versions of stories should trigger a notification in the linked MS Teams channel |
Example
{"comments": false, "storyPublish": true, "versionPublish": false}
MicrosoftTeamsActivitiesConfigUpdatePayload
Description
Return Type of Mutation microsoftTeamsActivitiesConfigUpdate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
instance - Instance
|
The updated current instance |
errors - [MicrosoftTeamsActivitiesConfigUpdateErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "abc123",
"instance": Instance,
"errors": [ObjectNotFoundError]
}
MicrosoftTeamsChannel
MicrosoftTeamsChannelsResult
Description
List of channels of a Microsoft Teams
Fields
Field Name | Description |
---|---|
nodes - [MicrosoftTeamsChannel!]
|
A list of nodes. |
Example
{"nodes": [MicrosoftTeamsChannel]}
MicrosoftTeamsIntegration
Description
Details about the Microsoft Teams integration
Fields
Field Name | Description |
---|---|
channels - MicrosoftTeamsChannelsResult
|
If the MS Teams integration is configured, returns the list of channels of the linked Team. |
teams - MicrosoftTeamsTeamsResult
|
If the MS Teams integration is configured, returns the list of Teams. |
Example
{
"channels": MicrosoftTeamsChannelsResult,
"teams": MicrosoftTeamsTeamsResult
}
MicrosoftTeamsMeService
Description
Service details for the Microsoft Teams service
Fields
Field Name | Description |
---|---|
type - MeServiceType!
|
Type of the service |
Example
{"type": "GOOGLE"}
MicrosoftTeamsSpacesToChannelItem
Description
An item linking a MS Teams channel to a Space for notifications
Fields
Field Name | Description |
---|---|
channel - MicrosoftTeamsChannel!
|
The MS Teams channel linked to the Space |
space - Space!
|
The Space linked to the MS Teams channel |
team - MicrosoftTeamsTeam!
|
The Ms Teams team linked to the Space |
Example
{
"channel": MicrosoftTeamsChannel,
"space": Space,
"team": MicrosoftTeamsTeam
}
MicrosoftTeamsSpacesToChannelRemoveErrors
Description
Error Type of the microsoftTeamsSpacesToChannelRemove
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
MicrosoftTeamsSpacesToChannelRemoveInput
MicrosoftTeamsSpacesToChannelRemovePayload
Description
Return Type of Mutation microsoftTeamsSpacesToChannelRemove
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
instance - Instance
|
The updated current instance |
errors - [MicrosoftTeamsSpacesToChannelRemoveErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "abc123",
"instance": Instance,
"errors": [ObjectNotFoundError]
}
MicrosoftTeamsSpacesToChannelUpdateErrors
Description
Error Type of the microsoftTeamsSpacesToChannelUpdate
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
MicrosoftTeamsSpacesToChannelUpdateInput
Description
Input type for Mutation microsoftTeamsSpacesToChannelUpdate
Example
{
"channelId": "xyz789",
"channelName": "abc123",
"spaceId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"teamId": "xyz789",
"teamName": "xyz789"
}
MicrosoftTeamsSpacesToChannelUpdatePayload
Description
Return Type of Mutation microsoftTeamsSpacesToChannelUpdate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
instance - Instance
|
The updated current instance |
errors - [MicrosoftTeamsSpacesToChannelUpdateErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"instance": Instance,
"errors": [ObjectNotFoundError]
}
MicrosoftTeamsTabEmbedErrors
Description
Error Type of the microsoftTeamsTabEmbed
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
MicrosoftTeamsTabEmbedInput
Description
Input type for Mutation microsoftTeamsTabEmbed
Example
{
"channelId": "xyz789",
"tabId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"teamId": "abc123"
}
MicrosoftTeamsTabEmbedPayload
Description
Return Type of Mutation microsoftTeamsTabEmbed
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [MicrosoftTeamsTabEmbedErrors!]
|
Errors of the mutation. |
instance - Instance
|
The updated current instance |
Example
{
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError],
"instance": Instance
}
MicrosoftTeamsTeam
MicrosoftTeamsTeamsResult
Description
Result of the list of Teams in the Microsoft Teams integration
Fields
Field Name | Description |
---|---|
nodes - [MicrosoftTeamsTeam!]
|
A list of nodes. |
Example
{"nodes": [MicrosoftTeamsTeam]}
MimeType
Description
A mime type as defined in the IANA registry
Example
"image/png"
MissingTypeInputError
Description
Represent the error when creating a SpaceTab without giving a proper type
Fields
Field Name | Description |
---|---|
path - String!
|
Path of the field leading to the error |
Example
{"path": "xyz789"}
MobilePushNotificationPreferences
Description
Preferences for the Mobile Push notification for a user
Fields
Field Name | Description |
---|---|
additionalViews - Boolean!
|
Send a push Notification when a StoryGrant is added for you on a given content |
annotations - Boolean!
|
Send a push Notification when an Annotation is marked as Resolved, post or commented (if not provided then left untouched) |
comments - Boolean!
|
Send a push Notification when a new comment is added |
groupMentions - Boolean!
|
Send a Push Notification to mobile when you are mentioned via a space or a team |
expiringContent - Boolean!
|
Send a Push Notification to mobile when there's a content you maintain that is expiring |
inviteToContribute - Boolean!
|
Send a push notification to mobile when the user has been invited to contribute to a content |
isEnabled - Boolean!
|
Are push notification globally enabled Note: this override all other configurations about mobile push |
personalMentions - Boolean!
|
Send a Push Notification to mobile when you are personaly mentioned |
pings - Boolean!
|
Send a Push Notification to mobile when you have been invited to read a content |
readingList - Boolean!
|
Send a Push Notification to mobile when there are new content you've missed |
approvalProcess - Boolean!
|
Send a Push Notification to mobile when there is a change in the approval process |
Example
{
"additionalViews": true,
"annotations": false,
"comments": false,
"groupMentions": false,
"expiringContent": false,
"inviteToContribute": false,
"isEnabled": false,
"personalMentions": true,
"pings": true,
"readingList": false,
"approvalProcess": false
}
MobilePushNotificationPreferencesInput
Description
Input type for Mutation mobilePushNotificationPreferences
Fields
Input Field | Description |
---|---|
additionalViews - Boolean
|
Toggle the mobilePushNotificationPreferences.additionalViews setting (if not provided then left untouched) |
annotations - Boolean
|
Toggle the mobilePushNotificationPreferences.annotations setting (if not provided then left untouched) |
comments - Boolean
|
Toggle the mobilePushNotificationPreferences.comments setting |
groupMentions - Boolean
|
Toggle the mobilePushNotificationPreferences.groupMentions setting |
inviteToContribute - Boolean
|
Toggle the mobilePushNotificationPreferences.inviteToContribute setting |
isEnabled - Boolean
|
Toggle the mobilePushNotificationPreferences.isEnabled setting |
personalMentions - Boolean
|
Toggle the mobilePushNotificationPreferences.personalMentions setting |
pings - Boolean
|
Toggle the mobilePushNotificationPreferences.pings setting |
readingList - Boolean
|
Toggle the mobilePushNotificationPreferences.readingList setting |
expiringContent - Boolean
|
Enable or disable Sending a push message when one or more content are expiring |
approvalProcess - Boolean
|
Enable or disable Sending a push message when a change occurs in the Story approval process |
Example
{
"additionalViews": true,
"annotations": true,
"comments": true,
"groupMentions": false,
"inviteToContribute": true,
"isEnabled": true,
"personalMentions": true,
"pings": true,
"readingList": true,
"expiringContent": false,
"approvalProcess": false
}
MostActiveUsersList
Description
List of the most active users
Fields
Field Name | Description |
---|---|
endCursor - String
|
When paginating forwards, the cursor to continue. |
hasNextPage - Boolean
|
When paginating forwards, are there more items? |
pageInfo - PageInfo!
|
Information to aid in pagination. |
edges - [ActiveUserEdge!]!
|
A list of edges. |
nodes - [ActiveUserItem!]
|
A list of nodes. Use edges instead
|
Example
{
"endCursor": "abc123",
"hasNextPage": false,
"pageInfo": PageInfo,
"edges": [ActiveUserEdge],
"nodes": [ActiveUserItem]
}
MutationError
Description
Interface for all the mutation errors
Fields
Field Name | Description |
---|---|
path - String!
|
Path of the field leading to the error |
Possible Types
MutationError Types |
---|
Example
{"path": "xyz789"}
MyContentFilter
Description
Filter about my content
Values
Enum Value | Description |
---|---|
|
Return All the content visible |
|
select content where you are contributor |
|
let you select content where you are owner only |
|
Select All contents with an StoryApproval in progress requested by you. |
|
Select All contents that are Published (niether draft nor archived) |
|
Select All contents where there is a StoryApproval pending for your review (where you are assigned) |
Example
"ALL"
Node
Description
An object with an ID.
Fields
Field Name | Description |
---|---|
id - ID!
|
ID of the object. |
Possible Types
Node Types |
---|
Example
{"id": "eWVhaCByaWdodCBpdCdzIGI2NA=="}
Notification
Description
A notification about One or multiple similar events
Fields
Field Name | Description |
---|---|
actors - [User!]!
|
The actors involved in the notification. |
created - IsoDateTime!
|
The creation date and time of the notification in ISO 8601 format. |
id - ID!
|
ID of the notification. |
object - NotificationObject
|
The object details associated with the notification. |
pinned - Boolean!
|
Indicates whether the notification is pinned. (pinned notifications are also displayed in a special list) |
readAt - IsoDateTime
|
The date and time when the notification was marked as read. it can be marked automatically (via story read for example) |
seenAt - IsoDateTime
|
The date and time when the notification was seen by the user, if applicable. |
slug - Int!
|
@deprecated Slug of the notification. Slug is deprecated and should not be used. Use id instead. Slug is deprecated. use id
|
subscriptionToken - OpaqueID
|
@deprecated Token for the subscription associated with the notification. This field is deprecated and no longer available. No longer available |
updated - IsoDateTime!
|
The last update date and time of the notification in ISO 8601 format. |
verb - NotificationVerb
|
The verb associated with the notification, which describes the action that triggered the notification. |
Example
{
"actors": [User],
"created": "2016-10-07T01:08:03.420Z",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"object": NotificationObject,
"pinned": false,
"readAt": "2016-10-07T01:08:03.420Z",
"seenAt": "2016-10-07T01:08:03.420Z",
"slug": 987,
"subscriptionToken": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"updated": "2016-10-07T01:08:03.420Z",
"verb": "APPROVE"
}
NotificationAddedInput
Description
Input type for NotificationAdded Subscription
Example
{
"clientSubscriptionId": "xyz789",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}
NotificationAddedPayload
Description
Return Type of NotificationAdded Subscription
Fields
Field Name | Description |
---|---|
clientSubscriptionId - String
|
A unique identifier for the client performing the subscription. |
me - Me
|
The current user |
notificationEdge - NotificationEdge
|
The just added Notification in an Edge |
Example
{
"clientSubscriptionId": "xyz789",
"me": Me,
"notificationEdge": NotificationEdge
}
NotificationConnection
Description
List of results of Notification
Fields
Field Name | Description |
---|---|
edges - [NotificationEdge!]
|
A list of edges. |
pageInfo - PageInfo!
|
Information to aid in pagination. |
totalCount - Int!
|
Identifies the total count of items in the connection. |
Example
{
"edges": [NotificationEdge],
"pageInfo": PageInfo,
"totalCount": 123
}
NotificationCountInput
NotificationCountPayload
NotificationEdge
Description
An edge in a connection.
Fields
Field Name | Description |
---|---|
cursor - String!
|
A cursor for use in pagination. |
node - Notification!
|
The item at the end of the edge. |
Example
{
"cursor": "abc123",
"node": Notification
}
NotificationFilter
Description
Filter out Notifications base on criterions
Values
Enum Value | Description |
---|---|
|
Get all Notifications |
|
Select only "pinned" notifications |
|
Select only notifications that haven't been read yet |
|
Select only notifications that haven't been seen yet |
Example
"ALL"
NotificationObject
Description
Represent an object related to a given notification
Fields
Field Name | Description |
---|---|
excerpt - String
|
Excerpt text of the notification object |
objectId - ID!
|
Global NodeID of the related object |
relatedStorySlug - Int
|
Integer Slug of the related story |
slug - Int!
|
Integer slug of the related object (story, comment, ...) |
title - String
|
Title of the Notification Object (often story or Space....) |
type - NotificationObjectType
|
Type of the objectId object |
anchor - String
|
Anchor in the related object to wich the notification point to (used with type: ANNOTATION or ANNOTATION_COMMENT) |
lang - String
|
Lang of the related content if any (for example in case of annotations) |
Example
{
"excerpt": "xyz789",
"objectId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"relatedStorySlug": 123,
"slug": 987,
"title": "abc123",
"type": "ANNOTATION",
"anchor": "abc123",
"lang": "xyz789"
}
NotificationObjectType
Description
Different Type of objects related to the notification
Values
Enum Value | Description |
---|---|
|
Related Object is an Annotation
|
|
Related Object is a StoryApproval
|
|
Related Object is an AnnotationComment
|
|
Related Object is an Comment
|
|
Related Object is an Space
|
|
Deprecated Does not exists anymore |
|
Related object is of type Story
|
|
Related Object is an User
|
|
Related Object is a StoryBroadcast
|
Example
"ANNOTATION"
NotificationPinErrors
Description
Error Type of the notificationPin
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
NotificationPinInput
NotificationPinPayload
Description
Return Type of Mutation notificationPin
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
me - Me
|
The current user |
notification - Notification
|
The updated Notification object |
errors - [NotificationPinErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "abc123",
"me": Me,
"notification": Notification,
"errors": [ObjectNotFoundError]
}
NotificationUpdatedInput
Description
Input type for notificationUpdated Subscription
Example
{
"clientSubscriptionId": "xyz789",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}
NotificationUpdatedPayload
Description
Return Type of notificationUpdated Subscription
Fields
Field Name | Description |
---|---|
clientSubscriptionId - String
|
A unique identifier for the client performing the subscription. |
me - Me
|
The current user |
notification - Notification
|
The updated Notification object |
Example
{
"clientSubscriptionId": "xyz789",
"me": Me,
"notification": Notification
}
NotificationVerb
Description
Action made on the related object if any
Values
Enum Value | Description |
---|---|
|
The related object has been approved |
|
The related object has been assigned to the current user |
|
The related object has been assigned to another user |
|
User followed another user, deprecated unused |
|
User got contents from another user he need to reassign or classifiy |
|
User is invited to contribute to the related object |
|
User is invited to an Event |
|
User got new permissions on a given object (usually Story ) |
|
User Joined the related object (usally a Space ) |
|
A user liked the related object |
|
User has been mentionned on related object |
|
The user notified to read the related object |
|
A new related object has been created |
|
A correction was requested on related object |
|
The related object was marked as Resolved |
|
The related object was reshared |
|
A new draft has been saved |
|
A new version has been published |
Example
"APPROVE"
NotificationsReadAllInput
Description
Input type for Mutation notificationsReadAll
Fields
Input Field | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. DUMMY FIELD FOR HAVING A FIELD |
Example
{"clientMutationId": "xyz789"}
NotificationsReadAllPayload
NotificationsReadInput
Description
Input type for Mutation notificationsRead
Fields
Input Field | Description |
---|---|
ids - [ID!]!
|
Node IDs of the Notification objects to mark as read |
Example
{"ids": ["eWVhaCByaWdodCBpdCdzIGI2NA=="]}
NotificationsReadPayload
Description
Return Type of Mutation notificationsRead
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
me - Me
|
The current user |
notifications - [Notification!]!
|
The updated Notification objects |
Example
{
"clientMutationId": "abc123",
"me": Me,
"notifications": [Notification]
}
NotificationsSeenAllInput
Description
Input type for Mutation notificationsSeenAll
Fields
Input Field | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. DUMMY FIELD FOR HAVING A FIELD |
Example
{"clientMutationId": "xyz789"}
NotificationsSeenAllPayload
NotificationsUnreadInput
Description
Input type for Mutation notificationsUnread
Fields
Input Field | Description |
---|---|
ids - [ID!]!
|
Node IDs of the Notification objects to mark as unread |
Example
{"ids": ["eWVhaCByaWdodCBpdCdzIGI2NA=="]}
NotificationsUnreadPayload
Description
Return Type of Mutation notificationsUnread
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
me - Me
|
The current user |
notifications - [Notification!]
|
The updated Notification objects |
Example
{
"clientMutationId": "xyz789",
"me": Me,
"notifications": [Notification]
}
ObjectAlreadyExistsError
Description
Represent the error when an object you are trying to create or edit conflict whith an existing object
Fields
Field Name | Description |
---|---|
path - String!
|
Path of the field leading to the error |
Example
{"path": "abc123"}
ObjectNotFoundError
Description
Represent the error when an object touched by a mutation was not found
Fields
Field Name | Description |
---|---|
path - String!
|
Path of the field leading to the error |
Example
{"path": "xyz789"}
OnboardingStepCompletedInput
Description
Input type for onboardingStepCompleted Subscription
Example
{
"clientSubscriptionId": "abc123",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}
OnboardingStepCompletedPayload
Description
Return Type of onboardingStepCompleted Subscription
Example
{
"clientSubscriptionId": "xyz789",
"instance": Instance
}
OnedriveMeService
Description
Integration setup service for Onedrive and Sharepoint
Fields
Field Name | Description |
---|---|
clientId - String
|
Client ID of the oauth integration |
connected - Boolean!
|
Is the current user connected to Onedrive |
email - EmailAddress
|
Email of the user connected to Onedrive/sharepoint (if any) |
name - String
|
Display name of the user connected to Onedrive/sharepoint (if any) |
setupUrl - URL
|
URL the user need to hit to make the Auth flow to connect Onedrive (check sharePointSearchSetupUrl for Sharepoint) |
type - MeServiceType!
|
Type of the service |
sharePointSearchConnected - Boolean!
|
Is the current connected to Sharepoint (can be connected to Onedrive without this) |
sharePointSearchSetupUrl - String
|
URL the user need to hit to make the Auth flow to connect Onedrive (check setupUrl for only Onedrive) |
Example
{
"clientId": "xyz789",
"connected": false,
"email": "test@test.com",
"name": "xyz789",
"setupUrl": "http://www.test.com/",
"type": "GOOGLE",
"sharePointSearchConnected": false,
"sharePointSearchSetupUrl": "abc123"
}
OpaqueID
Description
The OpaqueID scalar type represents a unique identifier. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable or modifiable.
Example
"eWVhaCByaWdodCBpdCdzIGI2NA=="
Organization
Description
Organization that has access to the instance Organization is a group of users that can be managed by the platform admin and might have specific SSO settings
Fields
Field Name | Description |
---|---|
id - ID!
|
The ID of the organization |
subdomain - String!
|
Organization subdomain used to access this organization, this is also a unique identifier |
name - String!
|
Organization name, to be used instead of the instance name |
created - IsoDateTime!
|
Creation timestamp for this organization |
saml2Enabled - Boolean!
|
Enable SMAL2 federation for everyone in this organization |
transparentAuth - Boolean!
|
Automatically initiate the SSO transaction. If disabled the user will be asked which login method to use (password or SSO). |
allowCreate - Boolean!
|
Enable automatic creation of accounts for new users upon first connection in this organization |
metadata - String!
|
XML metadata of your SAML Identity Provider. |
metadataUrl - URL
|
URL to fetch Metadata From it will fill metadata field |
assertionsSigned - Boolean!
|
Are saml2 assertions signed |
messagesSigned - Boolean!
|
Are saml2 messages signed |
signatureAlgorithm - Saml2SignatureAlgo!
|
The signature algorithm for saml2 |
digestAlgorithm - Saml2DigestAlgo!
|
The digest algorithm for saml2 |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"subdomain": "abc123",
"name": "abc123",
"created": "2016-10-07T01:08:03.420Z",
"saml2Enabled": true,
"transparentAuth": true,
"allowCreate": true,
"metadata": "xyz789",
"metadataUrl": "http://www.test.com/",
"assertionsSigned": false,
"messagesSigned": true,
"signatureAlgorithm": "RSA_SHA1",
"digestAlgorithm": "SHA1"
}
OrganizationCreateErrors
Description
Error Type of the organizationCreate
Mutation
Types
Union Types |
---|
Example
InvalidFormatError
OrganizationCreateInput
Description
Input type for Mutation organizationCreate
Fields
Input Field | Description |
---|---|
subdomain - String!
|
A unique subdomain used to access this organization, restrictions on the format apply. It must be a valid dns label (numbers and letters and dashes) and under 60 characters. |
name - String!
|
User-facing name of this organization, will be used instead of the instance name |
Example
{
"subdomain": "abc123",
"name": "abc123"
}
OrganizationCreatePayload
Description
Return Type of Mutation organizationCreate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
organization - Organization
|
The newly created Organization |
errors - [OrganizationCreateErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"organization": Organization,
"errors": [InvalidFormatError]
}
OrganizationDeleteErrors
Description
Error Type of the organizationDelete
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
OrganizationDeleteInput
Description
Input type for Mutation organizationDelete
Fields
Input Field | Description |
---|---|
id - ID!
|
The ID of the organization to be deleted |
Example
{"id": "eWVhaCByaWdodCBpdCdzIGI2NA=="}
OrganizationDeletePayload
Description
Return Type of Mutation organizationDelete
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
deletedId - ID
|
The deleted organization id |
errors - [OrganizationDeleteErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"deletedId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"errors": [ObjectNotFoundError]
}
OrganizationUpdateErrors
Description
Error Type of the organizationUpdate
Mutation
Types
Union Types |
---|
Example
InvalidFormatError
OrganizationUpdateInput
Description
Input type for Mutation organizationUpdate
Fields
Input Field | Description |
---|---|
id - ID!
|
The ID of the organization to be updated |
name - String
|
Organization name, to be used instead of the instance name |
allowCreate - Boolean
|
Enable automatic creation of accounts for new users upon first connection in this organization |
assertionsSigned - Boolean
|
Are saml2 assertions signed |
digestAlgorithm - Saml2DigestAlgo
|
The digest algorithm for saml2 |
metadata - String
|
XML metadata of your SAML Identity Provider. |
metadataUrl - URLInput
|
Url used to fetch the metadata of your SAML Identity Provider. |
messagesSigned - Boolean
|
Are saml2 messages signed |
saml2Enabled - Boolean
|
Enable SMAL2 federation for everyone in this organization |
signatureAlgorithm - Saml2SignatureAlgo
|
The signature algorithm for saml2 |
transparentAuth - Boolean
|
Automatically initiate the SSO transaction. If disabled the user will be asked which login method to use (password or SSO). |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"name": "xyz789",
"allowCreate": true,
"assertionsSigned": false,
"digestAlgorithm": "SHA1",
"metadata": "xyz789",
"metadataUrl": URLInput,
"messagesSigned": false,
"saml2Enabled": false,
"signatureAlgorithm": "RSA_SHA1",
"transparentAuth": true
}
OrganizationUpdatePayload
Description
Return Type of Mutation organizationUpdate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
organization - Organization
|
The updated Organization |
errors - [OrganizationUpdateErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"organization": Organization,
"errors": [InvalidFormatError]
}
PageInfo
Description
Information about pagination in a connection.
Fields
Field Name | Description |
---|---|
endCursor - String
|
When paginating forwards, the cursor to continue. |
hasNextPage - Boolean!
|
When paginating forwards, are there more items? |
hasPreviousPage - Boolean!
|
When paginating backwards, are there more items? |
startCursor - String
|
When paginating backwards, the cursor to continue. |
Example
{
"endCursor": "abc123",
"hasNextPage": true,
"hasPreviousPage": false,
"startCursor": "xyz789"
}
PasswordSecurityLevel
Description
Possible level of password verification levels
Values
Enum Value | Description |
---|---|
|
Ensures the password is different from the user name. |
|
Also requires the password to be minimum 8 characters long and to contain enough different characters. |
|
Additionally checks the password for simplistic patterns and resemblance to a dictionary word. |
Example
"LOW"
PermissionError
Description
Represent the error when trying do an action but there are permission issues
Fields
Field Name | Description |
---|---|
path - String!
|
Path of the field leading to the error |
Example
{"path": "abc123"}
PlanPeriodicity
Description
Periodicity of which a plan is Renewed
Values
Enum Value | Description |
---|---|
|
Renewed every month |
|
Renewed every 6 months |
|
Renewed every year |
Example
"MONTHLY"
PublicAsset
Description
Interface for all Assets in a public story
Fields
Field Name | Description |
---|---|
uuid - UUID!
|
UUID of the asset as referenced in slate body |
lang - Lang
|
The language of the asset. currently unused unused |
created - IsoDateTime!
|
Creation date of the current asset |
metadata - [AssetMetadata!]
|
The metadatas associated with the asset. |
Possible Types
PublicAsset Types |
---|
Example
{
"uuid": "7aac93c5-a56c-4528-b43e-457834a796c9",
"lang": "fr",
"created": "2016-10-07T01:08:03.420Z",
"metadata": [AssetMetadata]
}
PublicAttribute
Description
Attributes of a public story
Fields
Field Name | Description |
---|---|
key - String!
|
Identifier of the attribute |
type - ValueWrapperType
|
Type of value of the attribute |
value - ValueWrapper!
|
Value of the attribute |
label - String
|
The label of the Attribute for the current user's lang. |
hint - SchemaAttributeHint
|
Hint about how to use the value |
Example
{
"key": "xyz789",
"type": "ADDRESS",
"value": StringWrapper,
"label": "abc123",
"hint": "DATE_ONLY"
}
PublicInstance
Description
Configuration Informations about the instance
Fields
Field Name | Description |
---|---|
name - String
|
Name of the instance |
uuid - String
|
UUid identifiying the instance |
accentColor - Color
|
Main color of the instance |
headerColor - Color
|
Header color |
headerTextLightness - ColorLightness
|
Color shade of the text on the header |
logoImageUrl - URL
|
Logo Image URL |
googleAnalyticsTrackingId - String
|
Google Analytics code |
baseUrl - URL
|
Base url of the instance |
domain - String
|
Main domain name of the current instance |
release - String
|
Backend release version for reporting prupose |
mixpanel - PublicInstanceMixpanel
|
Mixpanel Configurations |
sandboxUrl - URL
|
Sandbox URL |
Example
{
"name": "xyz789",
"uuid": "xyz789",
"accentColor": "#CCCCCC",
"headerColor": "#CCCCCC",
"headerTextLightness": "DARK",
"logoImageUrl": "http://www.test.com/",
"googleAnalyticsTrackingId": "xyz789",
"baseUrl": "http://www.test.com/",
"domain": "xyz789",
"release": "xyz789",
"mixpanel": PublicInstanceMixpanel,
"sandboxUrl": "http://www.test.com/"
}
PublicInstanceMixpanel
PublicStory
Description
A publicly shared Content
Fields
Field Name | Description |
---|---|
lang - Lang
|
Lang of the requested story version |
availableLangs - [JSON!]!
|
Available translations |
assets - [PublicAsset!]!
|
Get the Content's assets |
Arguments
|
|
mainAsset - PublicAsset
|
The main asset of the story |
layoutMode - StoryLayoutMode!
|
Display Layout of the story |
hideReadTime - Boolean!
|
Contributors have hidden the estimated read time |
body - RichContent
|
The main content of the story |
created - IsoDateTime!
|
Date of the first publication of the story |
title - String
|
Title of the story |
attributes - [PublicAttribute!]
|
List of story's attributes |
builtins - [BuiltinAttribute!]!
|
Get the built-in attributes of the story, such as its title and publishing date. |
Example
{
"lang": "fr",
"availableLangs": [{}],
"assets": [PublicAsset],
"mainAsset": PublicAsset,
"layoutMode": "SMALL",
"hideReadTime": false,
"body": RichContent,
"created": "2016-10-07T01:08:03.420Z",
"title": "abc123",
"attributes": [PublicAttribute],
"builtins": [BuiltinAttribute]
}
QuickSearchContext
Description
Possible Type of Quick Search context. Describe the kind of results you want in the quick search
Values
Enum Value | Description |
---|---|
|
In a Space |
|
On a story or on the Homepage |
Example
"SPACE"
QuickSearchQuery
Description
Input type for QuickSearch Query QuickSearch is a way to search for multiple types of objects at once in a "autocomplete" fashion
Fields
Input Field | Description |
---|---|
nHashtags - Int
|
Number of Hashtag results to return |
nSchemas - Int
|
Number of StorySchema results to return |
nSpaceGroups - Int
|
Number of SpaceGroup results to return |
nSpaces - Int
|
Number of Space results to return |
nStories - Int
|
Number of Story results to return |
nTags - Int
|
Number of Tag results to return |
nUsers - Int
|
Number of User results to return |
text - String!
|
The search text |
context - QuickSearchContext!
|
Context from which you are performing the quick search. Default = GLOBAL |
contextId - ID
|
Global ID of the Reference Object of the context (Space.id when context is SPACE for example) |
Example
{
"nHashtags": 987,
"nSchemas": 123,
"nSpaceGroups": 123,
"nSpaces": 123,
"nStories": 123,
"nTags": 123,
"nUsers": 987,
"text": "abc123",
"context": "SPACE",
"contextId": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}
QuickSearchResponse
Description
Results of a quick search
Fields
Field Name | Description |
---|---|
hashtags - [Hashtag!]!
|
Top Hashtags matching the search query |
schemas - [StorySchema!]!
|
Top StorySchemas matching the search query |
spaceGroups - [SpaceGroup!]!
|
Top SpaceGroups matching the search query |
spaces - [Space!]!
|
Top Spaces matching the search query |
stories - [Story!]!
|
Top Stories matching the search query |
tags - [Tag!]!
|
Top Tags matching the search query |
users - [User!]!
|
Top Users matching the search query |
searchToken - String!
|
A token reprensenting the search criterias |
Example
{
"hashtags": [Hashtag],
"schemas": [StorySchema],
"spaceGroups": [SpaceGroup],
"spaces": [Space],
"stories": [Story],
"tags": [Tag],
"users": [User],
"searchToken": "abc123"
}
RichContent
Description
Represent A content with a rich text format Including bold,italic,underline, strikethrough, link, and more but also advanced blocs like file, user, story, ...
Fields
Field Name | Description |
---|---|
format - RichFormat
|
Returns the format of the content. |
text - String
|
Returns the content as text. |
previewHtml - HTML
|
Returns a preview version of the content in HTML. |
Possible Types
RichContent Types |
---|
Example
{
"format": "CREOLE",
"text": "xyz789",
"previewHtml": "<html>Hello <h1>world</h1></html>"
}
RichContentInput
Description
Input type to describe a Rich Content This is used to create or update a content with advanced formatting features
Fields
Input Field | Description |
---|---|
content - JSON
|
Object description of the content in the specified format |
format - RichFormat!
|
Format of the content. |
markup - String
|
Markup of the content in case of HTML format |
Example
{
"content": {},
"format": "CREOLE",
"markup": "xyz789"
}
RichFormat
Description
Format of the content.
Values
Enum Value | Description |
---|---|
|
Python Creole https://github.com/jedie/python-creole/ (Deprecated) Unused format except some old comments |
|
DraftJS encoded state https://draftjs.org/ (Deprecated) Unused format except some old comments |
|
Regular HTML as a string This can't support blocks like story, user, and other feature, but it's handy as a quick/easy way to ingest content |
|
SLATE as version 0.47 => https://docs.slatejs.org/ the format is the default format used by elium's Frontend thus it's the more powerfull and supported one. |
Example
"CREOLE"
RootFolderRemoveError
Description
Represent the error when trying to remove the root folder.
Fields
Field Name | Description |
---|---|
path - String!
|
Path of the field leading to the error |
Example
{"path": "xyz789"}
Rsvp
Description
Status of the Event's RSVP
Values
Enum Value | Description |
---|---|
|
The user is invited to the event |
|
The user has responded to the event with a maybe |
|
The user has declined the event |
|
The user has accepted the event |
Example
"INVITED"
RsvpResult
Saml2DigestAlgo
Description
Digest algorithms used in SAML2.
Values
Enum Value | Description |
---|---|
|
SHA-1 hashing algorithm. |
|
SHA-256 hashing algorithm. |
|
SHA-384 hashing algorithm. |
|
SHA-512 hashing algorithm. |
Example
"SHA1"
Saml2SignatureAlgo
Description
Signature algorithms used in SAML2.
Values
Enum Value | Description |
---|---|
|
RSA with SHA-1 hashing. |
|
DSA with SHA-1 hashing. |
|
RSA with SHA-256 hashing. |
|
RSA with SHA-384 hashing. |
|
RSA with SHA-512 hashing. |
Example
"RSA_SHA1"
Saml2Validity
Description
Information about a SAML certificate validity
Fields
Field Name | Description |
---|---|
subject - String!
|
Certificate issuer |
validFrom - IsoDateTime!
|
Certificate is valid from this date |
validTo - IsoDateTime!
|
Certificate is valid up to this date |
Example
{
"subject": "abc123",
"validFrom": "2016-10-07T01:08:03.420Z",
"validTo": "2016-10-07T01:08:03.420Z"
}
SchemaAttribute
Description
Definition of a StorySchema
Attribute
as required for display and StorySchema Edition.
Fields
Field Name | Description |
---|---|
builtinKey - BuiltinAttributeKey
|
Associated Builtin Attribute Key |
canCreateOption - Boolean!
|
Can the user create a new option for the attribute (for example create a tag in the tag list attribute) |
default - ValueWrapper
|
Default Value for the attribute Unused |
deprecated - Boolean
|
Field is marked as deprecated. If true, the field shouldn't be visible in the UI if the value is not defined |
facet - Facet
|
When the SchemaAttribute is a TAG or TAG_LIST, this field will be filled with the Facet in which the tag should be created |
hasOptions - Boolean!
|
Does the attribute need Addition option to configure (mostly for TAG , TAG_LIST , USER and USER_LIST attributes) |
hint - SchemaAttributeHint
|
Additional information about the attribute this allows to further specialize the attribute (text, email, phone, ...) |
hints - [SchemaAttributeHint!]!
|
Additional information about the attribute this allows to further specialize the attribute (text, email, phone, ...) Use hint instead
|
id - ID!
|
ID of the object. |
key - String!
|
Opaque identifier of the type of Attribute All attribute values will also have this key |
label - String
|
The display label of the SchemaAttribute for the current user's lang. |
labels - TranslatedString
|
Translated names of the SchemaAttribute. |
options - [SchemaAttributeOption!]!
|
Search For possible values of a given attribute this should be use with attribute type like TAG, TAG_LIST, USER, USER_LIST |
readonly - Boolean
|
Is current attribute marked as Read-Only (often use in User Schema) |
type - ValueWrapperType!
|
Type of the attribute's Value |
usage - SchemaAttributeUsage!
|
Usage of the attribute in the UI (placement, display, ...) |
Example
{
"builtinKey": "AUTHOR",
"canCreateOption": false,
"default": StringWrapper,
"deprecated": true,
"facet": Facet,
"hasOptions": false,
"hint": "DATE_ONLY",
"hints": ["DATE_ONLY"],
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"key": "abc123",
"label": "xyz789",
"labels": {"en": "a Name", "fr": "Un Nom"},
"options": [SchemaAttributeOption],
"readonly": false,
"type": "ADDRESS",
"usage": "IMPORTANT"
}
SchemaAttributeCreateErrors
Description
Error Type of the schemaAttributeCreate
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SchemaAttributeCreateInput
Description
Input type for Mutation schemaAttributeCreate
Fields
Input Field | Description |
---|---|
builtinKey - BuiltinAttributeKey
|
The key intentifier of the built-in attribute linked to this attribute (if any) |
facetId - ID
|
Global ID for the Facet in which the attribute should be created for the TAG and TAG_LIST attributes types only |
hint - SchemaAttributeHint
|
Additional information about the attribute this allows to further specialize the attribute (text, email, phone, ...) |
key - String
|
Key of the attribute |
labels - TranslatedString!
|
Translated display label of the SchemaAttribute |
storySchemaId - ID!
|
The Global ID of the StorySchema in which the attribute should be created |
type - ValueWrapperType
|
Type of the attribute's Value |
usage - SchemaAttributeUsage!
|
Usage of the attribute in the UI (required or not and placement) |
Example
{
"builtinKey": "AUTHOR",
"facetId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"hint": "DATE_ONLY",
"key": "abc123",
"labels": {"en": "a Name", "fr": "Un Nom"},
"storySchemaId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"type": "ADDRESS",
"usage": "IMPORTANT"
}
SchemaAttributeCreatePayload
Description
Return Type of Mutation schemaAttributeCreate
Fields
Field Name | Description |
---|---|
attribute - SchemaAttribute
|
The newly created SchemaAttribute |
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SchemaAttributeCreateErrors!]
|
Errors of the mutation. |
Example
{
"attribute": SchemaAttribute,
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError]
}
SchemaAttributeDeleteErrors
Description
Error Type of the schemaAttributeDelete
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SchemaAttributeDeleteInput
Description
Input type for Mutation schemaAttributeDelete
Fields
Input Field | Description |
---|---|
id - ID!
|
Node ID of the SchemaAttribute to delete |
Example
{"id": "eWVhaCByaWdodCBpdCdzIGI2NA=="}
SchemaAttributeDeletePayload
Description
Return Type of Mutation schemaAttributeDelete
Fields
Field Name | Description |
---|---|
attribute - SchemaAttributeUnion
|
The deleted SchemaAttribute |
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SchemaAttributeDeleteErrors!]
|
Errors of the mutation. |
Example
{
"attribute": SchemaSeparator,
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError]
}
SchemaAttributeHint
Description
Hint (specialization) of a SchemaAttribute
Values
Enum Value | Description |
---|---|
|
type: DATETIME, Hint datetime is truncated to Date only |
|
type: STRING, Hint string is a valid Email |
|
type: STRING, Hint string is a multiline text |
|
type: STRING, Hint string is a Phone number |
|
For separator, Hint the separator is a Level 1 Header |
|
For separator, Hint the separator is a Level 2 Header |
|
type: STRING, Hint string is a Skype address |
|
type: STRING, Hint string is an URL |
Example
"DATE_ONLY"
SchemaAttributeOption
Description
Result of a search of a possible value of a SchemaAttribute. For example a Tag value for a TAG attribute
Fields
Field Name | Description |
---|---|
label - String
|
Display label of the option, name of the tag for example |
value - ValueWrapper
|
Value of the element adapted to the type of the attribute will either be a Tag or a User |
Example
{
"label": "abc123",
"value": StringWrapper
}
SchemaAttributeOptionCreateErrors
Description
Error Type of the schemaAttributeOptionCreate
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SchemaAttributeOptionCreateInput
Description
Input type for Mutation schemaAttributeOptionCreate
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"value": "abc123"
}
SchemaAttributeOptionCreatePayload
Description
Return Type of Mutation schemaAttributeOptionCreate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
option - SchemaAttributeOption
|
The newly created option (ie Tag) |
errors - [SchemaAttributeOptionCreateErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "abc123",
"option": SchemaAttributeOption,
"errors": [ObjectNotFoundError]
}
SchemaAttributeUnion
Description
Union of the different types of SchemaAttribute
Types
Union Types |
---|
Example
SchemaSeparator
SchemaAttributeUpdateErrors
Description
Error Type of the schemaAttributeUpdate
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SchemaAttributeUpdateInput
Description
Input type for Mutation schemaAttributeUpdate
Fields
Input Field | Description |
---|---|
deprecated - Boolean
|
Set the deprecated status of the attribute (only if provided) |
hint - SchemaAttributeHint
|
Additional information about the attribute this allows to further specialize the attribute (text, email, phone, ...) only changed if provided |
id - ID!
|
Global ID of the SchemaAttribute to update |
labels - TranslatedString
|
Set the labels of the attribute in different languages (only if provided, but all langs needs to be sent) |
removeHint - Boolean!
|
Remove the hint of the attribute. Default = false |
usage - SchemaAttributeUsage
|
Change the Attribute Usage only if provided |
Example
{
"deprecated": false,
"hint": "DATE_ONLY",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"labels": {"en": "a Name", "fr": "Un Nom"},
"removeHint": false,
"usage": "IMPORTANT"
}
SchemaAttributeUpdatePayload
Description
Return Type of Mutation schemaAttributeUpdate
Fields
Field Name | Description |
---|---|
attribute - SchemaAttributeUnion
|
The Update SchemaAttribute |
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SchemaAttributeUpdateErrors!]
|
Errors of the mutation. |
Example
{
"attribute": SchemaSeparator,
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError]
}
SchemaAttributeUsage
Description
Usage and placement of a SchemaAttribute
in the UI
Values
Enum Value | Description |
---|---|
|
Attribute is used on the Top of the Story's body |
|
Attribute is mandatory for the Story |
|
Attribute is used in the Story's body |
Example
"IMPORTANT"
SchemaResult
Description
Result of a search of a possible value of a StorySchema count the number of Content Per StorySchema
Fields
Field Name | Description |
---|---|
schema - StorySchema!
|
The Given StorySchema |
totalCount - Int!
|
Total number of Content for the given StorySchema matching the criterias |
Example
{"schema": StorySchema, "totalCount": 987}
SchemaSeparator
Description
A Separator as field in a StorySchema
Fields
Field Name | Description |
---|---|
hint - SchemaAttributeHint
|
Additional information about the attribute this allows to further specialize the attribute (for example SEPARATOR_H1, SEPARATOR_H2) |
hints - [SchemaAttributeHint!]!
|
Deprecated Use hint instead
|
id - ID!
|
ID of the object. |
label - String
|
The display label of the SchemaSeparator for the current user's lang. |
labels - TranslatedString
|
Translated names of the SchemaSeparator. |
usage - SchemaAttributeUsage!
|
Usage of the attribute in the UI (placement, display, ...) |
Example
{
"hint": "DATE_ONLY",
"hints": ["DATE_ONLY"],
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"label": "abc123",
"labels": {"en": "a Name", "fr": "Un Nom"},
"usage": "IMPORTANT"
}
SchemaSeparatorCreateErrors
Description
Error Type of the schemaSeparatorCreate
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SchemaSeparatorCreateInput
Description
Input type for Mutation schemaSeparatorCreate
Fields
Input Field | Description |
---|---|
hint - SchemaAttributeHint
|
Additional information about the attribute this allows to further specialize the attribute (text, email, phone, ...) |
labels - TranslatedString!
|
Translated Names of the Label of the SchemaSeparator |
storySchemaId - ID!
|
Global ID of the storySchema in which the separator should be created |
usage - SchemaAttributeUsage!
|
Usage of the attribute in the UI (placement, display, ...) |
Example
{
"hint": "DATE_ONLY",
"labels": {"en": "a Name", "fr": "Un Nom"},
"storySchemaId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"usage": "IMPORTANT"
}
SchemaSeparatorCreatePayload
Description
Return Type of Mutation schemaSeparatorCreate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SchemaSeparatorCreateErrors!]
|
Errors of the mutation. |
separator - SchemaSeparator
|
Newly created SchemaSeparator |
Example
{
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError],
"separator": SchemaSeparator
}
SearchFeedback
Description
A feedback made by search results or missing contents
Fields
Field Name | Description |
---|---|
created - IsoDateTime!
|
Date at which the feedback was sent |
id - ID!
|
ID of the object. |
user - User
|
The user that did sent the feedback |
message - String
|
The message attached to the feedback |
queryText - String!
|
The text query of the search launched by the user |
Example
{
"created": "2016-10-07T01:08:03.420Z",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"user": User,
"message": "abc123",
"queryText": "xyz789"
}
SearchFeedbackConnection
Description
List of results of SearchFeedback
Fields
Field Name | Description |
---|---|
edges - [SearchFeedbackEdge!]
|
A list of edges. |
pageInfo - PageInfo!
|
Information to aid in pagination. |
totalCount - Int!
|
Identifies the total count of items in the connection. |
Example
{
"edges": [SearchFeedbackEdge],
"pageInfo": PageInfo,
"totalCount": 123
}
SearchFeedbackEdge
Description
An edge in a connection.
Fields
Field Name | Description |
---|---|
cursor - String!
|
A cursor for use in pagination. |
node - SearchFeedback!
|
The item at the end of the edge. |
Example
{
"cursor": "xyz789",
"node": SearchFeedback
}
SearchFeedbackInput
Description
Input type for Mutation searchFeedback
Example
{
"url": "abc123",
"message": "abc123",
"searchToken": "abc123"
}
SearchFeedbackPayload
SearchHistoryPostInput
Description
Input type for Mutation searchHistoryPost
Fields
Input Field | Description |
---|---|
query - String!
|
Query string used for the search |
Example
{"query": "abc123"}
SearchHistoryPostPayload
SemanticSearchQuery
Description
Query to perform a semantic search filtering of stories or assets with a text query
Fields
Input Field | Description |
---|---|
text - String!
|
Semantic query text |
limit - Int!
|
Number of top-scoring results to return. Default = 5 |
minScore - Int
|
Minimal score required to include a result. Higher scores are better matches (0-100) |
method - AnswerMethod
|
Select answer method to use |
Example
{
"text": "abc123",
"limit": 123,
"minScore": 123,
"method": "V1"
}
SemanticSearchResponse
Description
Response type for a semantic search.
Fields
Field Name | Description |
---|---|
stories - [StorySemanticSearchResult!]!
|
List of matching stories ordered by best score |
Example
{"stories": [StorySemanticSearchResult]}
SeparatorTab
Description
A SpaceTab is a sub-level navigation for a space. This provides a filtered / formated view of the contents in the space.
Fields
Field Name | Description |
---|---|
icon - OpaqueID
|
Icon representing the tab |
id - ID!
|
ID of the object. |
label - String!
|
The label of the tab for the current user's lang. |
labels - TranslatedString!
|
Translated names of the tab. |
slug - String!
|
Short human representation of the tab. |
Example
{
"icon": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"label": "abc123",
"labels": {"en": "a Name", "fr": "Un Nom"},
"slug": "xyz789"
}
SlackActivitiesConfig
Description
Configuration About Activities that should be sent as Slack Notifications
Fields
Field Name | Description |
---|---|
comments - Boolean
|
Comments should trigger a slack notification on the given channels |
storyPublish - Boolean
|
Story Publish should trigger a slack notification on the given channels |
versionPublish - Boolean
|
Version Publish should trigger a slack notification on the given channels |
Example
{"comments": false, "storyPublish": true, "versionPublish": false}
SlackActivitiesConfigUpdateErrors
Description
Error Type of the slackActivitiesConfigUpdate
Mutation
Types
Union Types |
---|
Example
PermissionError
SlackActivitiesConfigUpdateInput
Description
Input type for Mutation slackActivitiesConfigUpdate
Fields
Input Field | Description |
---|---|
comments - Boolean!
|
New Comments should trigger a slack notification on the given channels |
storyPublish - Boolean!
|
New Story Publish should trigger a slack notification on the given channels |
versionPublish - Boolean!
|
New Version Publish should trigger a slack notification on the given channels |
Example
{"comments": true, "storyPublish": false, "versionPublish": true}
SlackActivitiesConfigUpdatePayload
Description
Return Type of Mutation slackActivitiesConfigUpdate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
instance - Instance
|
The updated current instance |
errors - [SlackActivitiesConfigUpdateErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "abc123",
"instance": Instance,
"errors": [PermissionError]
}
SlackChannel
SlackChannelsResult
Description
Result of a search of Channel in a Slack Workspace
Fields
Field Name | Description |
---|---|
endCursor - String
|
When paginating forwards, the cursor to continue. |
hasNextPage - Boolean
|
When paginating forwards, are there more items? |
nodes - [SlackChannel!]
|
A list of nodes. |
Example
{
"endCursor": "xyz789",
"hasNextPage": true,
"nodes": [SlackChannel]
}
SlackIntegration
Description
Entry point to interact with the Slack integration
Fields
Field Name | Description |
---|---|
channels - SlackChannelsResult
|
If the Slack integration is configured, returns the list of public channels of the linked Slack workspace Otherwise, returns an empty list |
Example
{"channels": SlackChannelsResult}
SlackMeService
Description
Configuration Details for the Slack integration on the current instance
Fields
Field Name | Description |
---|---|
type - MeServiceType!
|
Type of the service |
slackUser - String
|
Slack user ID if connected to a slack account |
Example
{"type": "GOOGLE", "slackUser": "abc123"}
SlackSpacesToChannelRemoveErrors
Description
Error Type of the slackSpacesToChannelRemove
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SlackSpacesToChannelRemoveInput
SlackSpacesToChannelRemovePayload
Description
Return Type of Mutation slackSpacesToChannelRemove
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
instance - Instance
|
The updated current instance |
errors - [SlackSpacesToChannelRemoveErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"instance": Instance,
"errors": [ObjectNotFoundError]
}
SlackSpacesToChannelUpdateErrors
Description
Error Type of the slackSpacesToChannelUpdate
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SlackSpacesToChannelUpdateInput
Description
Input type for Mutation slackSpacesToChannelUpdate
Example
{
"channelId": "xyz789",
"channelName": "abc123",
"spaceId": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}
SlackSpacesToChannelUpdatePayload
Description
Return Type of Mutation slackSpacesToChannelUpdate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
instance - Instance
|
The updated current instance |
errors - [SlackSpacesToChannelUpdateErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"instance": Instance,
"errors": [ObjectNotFoundError]
}
SlateRichContent
Description
A Formatted content. This can have different format.
Fields
Field Name | Description |
---|---|
format - RichFormat
|
Returns the format of the content. |
previewHtml - HTML
|
Returns a preview version of the content in HTML. |
state - JSON
|
Returns the Slate value. |
text - String
|
Returns the content as text. |
Example
{
"format": "CREOLE",
"previewHtml": "<html>Hello <h1>world</h1></html>",
"state": {},
"text": "xyz789"
}
SmartAssistant
Description
A SmartAssistant is a content feed pre-filtered with specific criterion
Fields
Field Name | Description |
---|---|
id - ID!
|
ID of the object. |
created - IsoDateTime!
|
Creation date for the SmartAssistant |
enabled - Boolean!
|
Is the smart feed currently available on the homepage |
label - String!
|
The label of the SmartAssistant for the current user's lang. |
icon - URL
|
Url of the SmartAssistant icon |
labels - TranslatedString!
|
Translated names of the SmartAssistant . |
description - String
|
A description to help the user when using this agent for the current user's lang |
descriptions - TranslatedString!
|
Translated descriptions of the SmartAssistant . |
teams - [Team!]
|
List of teams where the SmartAssistant is defined (only defined if Only available when |
forEveryone - Boolean!
|
Is the applauncher available for everyone in the platform or only for given teams. |
semanticSearch - SemanticSearchResponse
|
AI-powered semantic search on all contents included in this SmartAssistant |
Arguments
|
|
answer - Answer
|
Answer a natural language question on the documents included in this SmartAssistant |
Arguments
|
|
prompt - String
|
The prompt text. |
tags - [Tag!]!
|
List of Tag to filter on |
hashtags - [Hashtag!]!
|
List of Hashtag to filter on |
space - Space
|
Space to filter on Use spaces instead
|
schema - StorySchema
|
StorySchema to filter on Use schemas instead
|
spaces - [Space!]!
|
Spaces to filter on |
schemas - [StorySchema!]!
|
StorySchemas to filter on |
smartConversations - SmartConversationConnection
|
List active smartConversation for the current user and assistant |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"created": "2016-10-07T01:08:03.420Z",
"enabled": true,
"label": "abc123",
"icon": "http://www.test.com/",
"labels": {"en": "a Name", "fr": "Un Nom"},
"description": "abc123",
"descriptions": {"en": "a Name", "fr": "Un Nom"},
"teams": [Team],
"forEveryone": true,
"semanticSearch": SemanticSearchResponse,
"answer": Answer,
"prompt": "abc123",
"tags": [Tag],
"hashtags": [Hashtag],
"space": Space,
"schema": StorySchema,
"spaces": [Space],
"schemas": [StorySchema],
"smartConversations": SmartConversationConnection
}
SmartAssistantConnection
Description
List of results of SmartAssistant
Fields
Field Name | Description |
---|---|
edges - [SmartAssistantEdge!]
|
A list of edges. |
pageInfo - PageInfo!
|
Information to aid in pagination. |
totalCount - Int!
|
Identifies the total count of items in the connection. |
Example
{
"edges": [SmartAssistantEdge],
"pageInfo": PageInfo,
"totalCount": 987
}
SmartAssistantCreateErrors
Description
Error Type of the smartAssistantCreate
Mutation
Types
Union Types |
---|
Example
InvalidInputError
SmartAssistantCreateInput
Description
Input type for Mutation smartAssistantCreate
Fields
Input Field | Description |
---|---|
labels - TranslatedString!
|
Translated labels |
descriptions - TranslatedString
|
Translated descriptions |
enabled - Boolean!
|
Enable the SmartAssistant on the homepage. Default = true |
forEveryone - Boolean!
|
True to make it available for all users |
teams - [ID!]
|
Set to restrain to specific team(s) |
tags - [ID!]
|
Filter by tag(s) If multiple tags, filtered for content with all tags (AND) |
hashtags - [ID!]
|
Filter by hashtag(s) If multiple hashtags, filtered for content with all hashtags (AND) |
schemas - [ID!]
|
Filter by schema (template) If multiple schemas, filtered for content with any schema (OR) |
spaces - [ID!]
|
Filter by space If multiple spaces, filtered for content within any space (OR) |
prompt - String
|
The prompt text. Only releveant of this smart feed is an agent |
icon - File
|
Icon file to display beside the Launcher |
Example
{
"labels": {"en": "a Name", "fr": "Un Nom"},
"descriptions": {"en": "a Name", "fr": "Un Nom"},
"enabled": false,
"forEveryone": true,
"teams": ["eWVhaCByaWdodCBpdCdzIGI2NA=="],
"tags": ["eWVhaCByaWdodCBpdCdzIGI2NA=="],
"hashtags": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"schemas": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"spaces": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"prompt": "xyz789",
"icon": "5ee411f1-6632-4388-b994-9fda4caf5c43"
}
SmartAssistantCreatePayload
Description
Return Type of Mutation smartAssistantCreate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SmartAssistantCreateErrors!]
|
Errors of the mutation. |
edge - SmartAssistantEdge
|
The created Smartassistant in an Edge |
smartAssistant - SmartAssistant
|
Created smart feed |
Example
{
"clientMutationId": "xyz789",
"errors": [InvalidInputError],
"edge": SmartAssistantEdge,
"smartAssistant": SmartAssistant
}
SmartAssistantDeleteErrors
Description
Error Type of the smartAssistantDelete
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SmartAssistantDeleteInput
Description
Input type for Mutation smartAssistantDelete
Fields
Input Field | Description |
---|---|
id - ID!
|
ID of the smart feed to delete |
Example
{"id": "eWVhaCByaWdodCBpdCdzIGI2NA=="}
SmartAssistantDeletePayload
Description
Return Type of Mutation smartAssistantDelete
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SmartAssistantDeleteErrors!]
|
Errors of the mutation. |
deletedId - ID
|
Global ID of the deleted smart feed |
instance - Instance
|
The currrent Instance |
Example
{
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError],
"deletedId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"instance": Instance
}
SmartAssistantEdge
Description
An edge in a connection.
Fields
Field Name | Description |
---|---|
cursor - String!
|
A cursor for use in pagination. |
node - SmartAssistant!
|
The item at the end of the edge. |
Example
{
"cursor": "xyz789",
"node": SmartAssistant
}
SmartAssistantOrderErrors
Description
Error Type of the smartAssistantOrder
Mutation
Types
Union Types |
---|
Example
PermissionError
SmartAssistantOrderInput
Description
Input type for Mutation smartAssistantOrder
Fields
Input Field | Description |
---|---|
ids - [ID!]!
|
Ordered list with smart feeds id |
Example
{"ids": ["eWVhaCByaWdodCBpdCdzIGI2NA=="]}
SmartAssistantOrderPayload
Description
Return Type of Mutation smartAssistantOrder
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SmartAssistantOrderErrors!]
|
Errors of the mutation. |
instance - Instance
|
The updated current instance |
Example
{
"clientMutationId": "xyz789",
"errors": [PermissionError],
"instance": Instance
}
SmartAssistantUpdateErrors
Description
Error Type of the smartAssistantUpdate
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SmartAssistantUpdateInput
Description
Input type for Mutation smartAssistantUpdate
Fields
Input Field | Description |
---|---|
id - ID!
|
Global ID of the SmartAssistant to update |
labels - TranslatedString
|
Translated labels |
descriptions - TranslatedString
|
A description to help the user when using this agent |
enabled - Boolean
|
Enable or disable the SmartAssistant on the homepage |
forEveryone - Boolean
|
True to make it available for all users |
teams - [ID!]
|
Set to restrain to specific team(s) |
prompt - String
|
The prompt text. |
tags - [ID!]
|
Filter by tag(s) (global ID of Tag ) If multiple tags, filtered for content with all tags (AND) |
hashtags - [ID!]
|
Filter by hashtag(s) (global ID of Hashtag ) If multiple hashtags, filtered for content with all hashtags (AND) |
schemas - [ID!]
|
Filter by schema (template) If multiple schemas, filtered for content with any schema (OR) |
spaces - [ID!]
|
Filter by space If multiple spaces, filtered for content within any space (OR) |
icon - File
|
New icon file to display |
removeIcon - Boolean!
|
Remove the icon file. Default = false |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"labels": {"en": "a Name", "fr": "Un Nom"},
"descriptions": {"en": "a Name", "fr": "Un Nom"},
"enabled": true,
"forEveryone": true,
"teams": ["eWVhaCByaWdodCBpdCdzIGI2NA=="],
"prompt": "xyz789",
"tags": ["eWVhaCByaWdodCBpdCdzIGI2NA=="],
"hashtags": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"schemas": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"spaces": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"icon": "5ee411f1-6632-4388-b994-9fda4caf5c43",
"removeIcon": true
}
SmartAssistantUpdatePayload
Description
Return Type of Mutation smartAssistantUpdate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SmartAssistantUpdateErrors!]
|
Errors of the mutation. |
smartAssistant - SmartAssistant
|
Updated smart feed |
Example
{
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError],
"smartAssistant": SmartAssistant
}
SmartConversation
Description
A SmartConversation is a discussion feed linked to a smartAssistant allowing to save and retrieve messages and discuss with a bot
Fields
Field Name | Description |
---|---|
id - ID!
|
ID of the object. |
created - IsoDateTime!
|
Creation date for the SmartConversation |
updated - IsoDateTime!
|
Update date for the SmartConversation |
archived - IsoDateTime
|
Archive date for the SmartConversation |
user - User
|
The user who created the SmartConversation |
smartAssistant - SmartAssistant
|
SmartAssistant related to the conversion |
messages - [SmartConversationMessage!]!
|
List of saved messages |
label - String!
|
Label representing the conversation, or a short summary of the conversation |
streamingResponseUrl - String
|
Connection URL to fetch streaming response |
streamingResponseToken - String
|
Connection Bearer token to fetch streaming response. Use as "Authorization: Bearer xxx" header |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"created": "2016-10-07T01:08:03.420Z",
"updated": "2016-10-07T01:08:03.420Z",
"archived": "2016-10-07T01:08:03.420Z",
"user": User,
"smartAssistant": SmartAssistant,
"messages": [SmartConversationMessage],
"label": "abc123",
"streamingResponseUrl": "abc123",
"streamingResponseToken": "abc123"
}
SmartConversationArchiveErrors
Description
Error Type of the smartConversationArchive
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SmartConversationArchiveInput
Description
Input type for Mutation smartConversationArchive
Fields
Input Field | Description |
---|---|
id - ID!
|
Global ID of the SmartConversation to update |
Example
{"id": "eWVhaCByaWdodCBpdCdzIGI2NA=="}
SmartConversationArchivePayload
Description
Return Type of Mutation smartConversationArchive
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SmartConversationArchiveErrors!]
|
Errors of the mutation. |
smartConversation - SmartConversation
|
Updated smart conversation |
Example
{
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError],
"smartConversation": SmartConversation
}
SmartConversationConnection
Description
List of results of SmartConversation
Fields
Field Name | Description |
---|---|
edges - [SmartConversationEdge!]
|
A list of edges. |
pageInfo - PageInfo!
|
Information to aid in pagination. |
totalCount - Int!
|
Identifies the total count of items in the connection. |
Example
{
"edges": [SmartConversationEdge],
"pageInfo": PageInfo,
"totalCount": 987
}
SmartConversationCreateErrors
Description
Error Type of the smartConversationCreate
Mutation
Types
Union Types |
---|
Example
InvalidInputError
SmartConversationCreateInput
Description
Input type for Mutation smartConversationCreate
Example
{
"smartAssistantId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"label": "abc123"
}
SmartConversationCreatePayload
Description
Return Type of Mutation smartConversationCreate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SmartConversationCreateErrors!]
|
Errors of the mutation. |
smartConversation - SmartConversation
|
Created smart conversation |
edge - SmartConversationEdge
|
The created SmartConversation in an Edge |
Example
{
"clientMutationId": "xyz789",
"errors": [InvalidInputError],
"smartConversation": SmartConversation,
"edge": SmartConversationEdge
}
SmartConversationDeleteErrors
Description
Error Type of the smartConversationDelete
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SmartConversationDeleteInput
Description
Input type for Mutation smartConversationDelete
Fields
Input Field | Description |
---|---|
id - ID!
|
ID of the smart conversation to delete |
Example
{"id": "eWVhaCByaWdodCBpdCdzIGI2NA=="}
SmartConversationDeletePayload
Description
Return Type of Mutation smartConversationDelete
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SmartConversationDeleteErrors!]
|
Errors of the mutation. |
deletedId - ID
|
Global ID of the deleted conversation |
instance - Instance
|
The currrent Instance |
Example
{
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError],
"deletedId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"instance": Instance
}
SmartConversationEdge
Description
An edge in a connection.
Fields
Field Name | Description |
---|---|
cursor - String!
|
A cursor for use in pagination. |
node - SmartConversation!
|
The item at the end of the edge. |
Example
{
"cursor": "abc123",
"node": SmartConversation
}
SmartConversationMessage
Description
AI message
Fields
Field Name | Description |
---|---|
uuid - UUID!
|
Unique identifier for this AI message |
content - String!
|
Content of the AI message |
sources - [SmartConversationMessageSource!]
|
Sources used to generate the message |
role - String!
|
Role of the party sending the message |
toolCalls - [JSON!]
|
Tools calls made by the AI to generate the message |
toolCallId - String
|
ID of the related tool call |
Example
{
"uuid": "7aac93c5-a56c-4528-b43e-457834a796c9",
"content": "abc123",
"sources": [SmartConversationMessageSource],
"role": "xyz789",
"toolCalls": [{}],
"toolCallId": "abc123"
}
SmartConversationMessageSource
Description
AI message sources
Fields
Field Name | Description |
---|---|
source - AnswerSource
|
Source linked to the message |
content - String
|
Content of the Chunk comming from the source |
Example
{
"source": Story,
"content": "abc123"
}
SmartConversationMessageSourceInput
Description
Input type for specifying metadata about a message source in a SmartConversation. Each source can either be associated with a story or an asset.
Example
{
"story": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"asset": "7aac93c5-a56c-4528-b43e-457834a796c9",
"content": "abc123"
}
SmartConversationPostMessageErrors
Description
Error Type of the smartConversationPostMessage
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SmartConversationPostMessageInput
Description
Input type for Mutation smartConversationPostMessage
Fields
Input Field | Description |
---|---|
id - ID!
|
Global ID of the SmartConversation to update |
uuid - UUID!
|
Unique identifier for this message |
createdAt - IsoDateTime!
|
Timestamp indicating when the message was created |
role - String!
|
Role of the message sender (assistant, system, user |
content - String!
|
Text content of the message |
toolCalls - [JSON!]
|
Tools calls made by the AI to generate the message |
toolCallId - String
|
ID of the related tool call |
sources - [SmartConversationMessageSourceInput!]
|
Array of sources added to the conversation |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"uuid": "7aac93c5-a56c-4528-b43e-457834a796c9",
"createdAt": "2016-10-07T01:08:03.420Z",
"role": "abc123",
"content": "xyz789",
"toolCalls": [{}],
"toolCallId": "xyz789",
"sources": [SmartConversationMessageSourceInput]
}
SmartConversationPostMessagePayload
Description
Return Type of Mutation smartConversationPostMessage
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SmartConversationPostMessageErrors!]
|
Errors of the mutation. |
smartConversation - SmartConversation
|
Updated smart conversation |
Example
{
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError],
"smartConversation": SmartConversation
}
SmartConversationUpdateErrors
Description
Error Type of the smartConversationUpdate
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SmartConversationUpdateInput
Description
Input type for Mutation smartConversationUpdate
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"label": "xyz789"
}
SmartConversationUpdatePayload
Description
Return Type of Mutation smartConversationUpdate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SmartConversationUpdateErrors!]
|
Errors of the mutation. |
smartConversation - SmartConversation
|
Updated SmartConversation |
Example
{
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError],
"smartConversation": SmartConversation
}
SmartFeed
Description
A SmartFeed is a content feed pre-filtered with specific criterion
Fields
Field Name | Description |
---|---|
id - ID!
|
ID of the object. |
type - SmartFeedType!
|
Type Of the feed Object. IF SmartFeedType.CONTENT_SEARCH, the feed is a content feed pre-filtered with specific criterion via search, amount, tags, hashtags, schema, space, text, sort IF SmartFeedType.RICH, the feed is a translated Rich Content |
created - IsoDateTime!
|
Creation date for the SmartFeed |
enabled - Boolean!
|
Is the smart feed currently available on the homepage |
label - String!
|
The label of the SmartFeed for the current user's lang. |
labels - TranslatedString!
|
Translated names of the SmartFeed . |
teams - [Team!]
|
List of teams where the SmartFeed is defined (only defined if Only available when |
forEveryone - Boolean!
|
Is the applauncher available for everyone in the platform or only for given teams. |
richContent - RichContent
|
RichContent for the SmartFeedType.RICH for the current user's lang |
richContents - [TranslatedRichContent!]
|
All the available RichContent for the SmartFeedType.RICH |
search - StorySearchResponse
|
Search The configured contents |
Arguments
|
|
amount - Int!
|
Number of results expected |
tags - [Tag!]!
|
List of Tag to filter on |
hashtags - [Hashtag!]!
|
List of Hashtag to filter on |
space - Space
|
Space to filter on |
schema - StorySchema
|
StorySchema to filter on |
text - String
|
Text to filter on |
sort - StorySearchSort
|
Sort order of this smartFeed |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"type": "CONTENT_SEARCH",
"created": "2016-10-07T01:08:03.420Z",
"enabled": true,
"label": "xyz789",
"labels": {"en": "a Name", "fr": "Un Nom"},
"teams": [Team],
"forEveryone": false,
"richContent": RichContent,
"richContents": [TranslatedRichContent],
"search": StorySearchResponse,
"amount": 987,
"tags": [Tag],
"hashtags": [Hashtag],
"space": Space,
"schema": StorySchema,
"text": "abc123",
"sort": "AGENDA"
}
SmartFeedConnection
Description
List of results of SmartFeed
Fields
Field Name | Description |
---|---|
edges - [SmartFeedEdge!]
|
A list of edges. |
pageInfo - PageInfo!
|
Information to aid in pagination. |
totalCount - Int!
|
Identifies the total count of items in the connection. |
Example
{
"edges": [SmartFeedEdge],
"pageInfo": PageInfo,
"totalCount": 987
}
SmartFeedCreateErrors
Description
Error Type of the smartFeedCreate
Mutation
Types
Union Types |
---|
Example
InvalidInputError
SmartFeedCreateInput
Description
Input type for Mutation smartFeedCreate
Fields
Input Field | Description |
---|---|
type - SmartFeedType!
|
Type Of the feed Object. Default = CONTENT_SEARCH |
labels - TranslatedString!
|
Translated labels |
enabled - Boolean!
|
Enable the SmartFeed on the homepage. Default = true |
forEveryone - Boolean!
|
True to make it available for all users |
teams - [ID!]
|
Set to restrain to specific team(s) |
tags - [ID!]
|
Filter by tag(s) If multiple tags, filtered for content with all tags (AND) |
hashtags - [ID!]
|
Filter by hashtag(s) If multiple hashtags, filtered for content with all hashtags (AND) |
schemaId - ID
|
Filter by schema (template) |
spaceId - ID
|
Filter by space |
sort - StorySearchSort
|
Sort the results |
amount - Int!
|
Amount of desired results. Default = 3 |
richContents - [TranslatedRichContentInput!]
|
Translated list of RichContent for the SmartFeedType.RICH |
Example
{
"type": "CONTENT_SEARCH",
"labels": {"en": "a Name", "fr": "Un Nom"},
"enabled": true,
"forEveryone": false,
"teams": ["eWVhaCByaWdodCBpdCdzIGI2NA=="],
"tags": ["eWVhaCByaWdodCBpdCdzIGI2NA=="],
"hashtags": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"schemaId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"spaceId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"sort": "AGENDA",
"amount": 123,
"richContents": [TranslatedRichContentInput]
}
SmartFeedCreatePayload
Description
Return Type of Mutation smartFeedCreate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SmartFeedCreateErrors!]
|
Errors of the mutation. |
edge - SmartFeedEdge
|
The created Smartfeed in an Edge |
smartFeed - SmartFeed
|
Created smart feed |
Example
{
"clientMutationId": "abc123",
"errors": [InvalidInputError],
"edge": SmartFeedEdge,
"smartFeed": SmartFeed
}
SmartFeedDeleteErrors
Description
Error Type of the smartFeedDelete
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SmartFeedDeleteInput
Description
Input type for Mutation smartFeedDelete
Fields
Input Field | Description |
---|---|
id - ID!
|
ID of the smart feed to delete |
Example
{"id": "eWVhaCByaWdodCBpdCdzIGI2NA=="}
SmartFeedDeletePayload
Description
Return Type of Mutation smartFeedDelete
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SmartFeedDeleteErrors!]
|
Errors of the mutation. |
deletedId - ID
|
Global ID of the deleted smart feed |
instance - Instance
|
The currrent Instance |
Example
{
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError],
"deletedId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"instance": Instance
}
SmartFeedEdge
Description
An edge in a connection.
Fields
Field Name | Description |
---|---|
cursor - String!
|
A cursor for use in pagination. |
node - SmartFeed!
|
The item at the end of the edge. |
Example
{
"cursor": "xyz789",
"node": SmartFeed
}
SmartFeedOrderErrors
Description
Error Type of the smartFeedOrder
Mutation
Types
Union Types |
---|
Example
PermissionError
SmartFeedOrderInput
Description
Input type for Mutation smartFeedOrder
Fields
Input Field | Description |
---|---|
ids - [ID!]!
|
Ordered list with smart feeds id |
Example
{"ids": ["eWVhaCByaWdodCBpdCdzIGI2NA=="]}
SmartFeedOrderPayload
Description
Return Type of Mutation smartFeedOrder
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SmartFeedOrderErrors!]
|
Errors of the mutation. |
instance - Instance
|
The updated current instance |
Example
{
"clientMutationId": "xyz789",
"errors": [PermissionError],
"instance": Instance
}
SmartFeedType
Description
Type of the SmartFeed
block to define the behavior of the item
Values
Enum Value | Description |
---|---|
|
SmartFeed is a content feed pre-filtered with specific criterion |
|
SmartFeed is a translated Rich Content |
Example
"CONTENT_SEARCH"
SmartFeedUpdateErrors
Description
Error Type of the smartFeedUpdate
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SmartFeedUpdateInput
Description
Input type for Mutation smartFeedUpdate
Fields
Input Field | Description |
---|---|
id - ID!
|
Global ID of the SmartFeed to update |
type - SmartFeedType
|
Type Of the feed Object to change |
labels - TranslatedString
|
Translated labels |
enabled - Boolean
|
Enable or disable the SmartFeed on the homepage |
forEveryone - Boolean
|
True to make it available for all users |
teams - [ID!]
|
Set to restrain to specific team(s) |
tags - [ID!]
|
Filter by tag(s) (global ID of Tag ) If multiple tags, filtered for content with all tags (AND) |
hashtags - [ID!]
|
Filter by hashtag(s) (global ID of Hashtag ) If multiple hashtags, filtered for content with all hashtags (AND) |
schemaId - ID
|
Filter by schemas (aka Template) (global ID of StorySchema ) |
spaceId - ID
|
Filter by space (global ID of Space ) |
sort - StorySearchSort
|
Sort the results |
amount - Int
|
Amount of desired results |
removeSpaceId - Boolean!
|
Remove the filter on spaceId . Default = false |
removeSchemaId - Boolean!
|
Remove the filter on schemaId . Default = false |
richContents - [TranslatedRichContentInput!]
|
Translated list of RichContent for the SmartFeedType.RICH |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"type": "CONTENT_SEARCH",
"labels": {"en": "a Name", "fr": "Un Nom"},
"enabled": false,
"forEveryone": false,
"teams": ["eWVhaCByaWdodCBpdCdzIGI2NA=="],
"tags": ["eWVhaCByaWdodCBpdCdzIGI2NA=="],
"hashtags": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"schemaId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"spaceId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"sort": "AGENDA",
"amount": 123,
"removeSpaceId": true,
"removeSchemaId": true,
"richContents": [TranslatedRichContentInput]
}
SmartFeedUpdatePayload
Description
Return Type of Mutation smartFeedUpdate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SmartFeedUpdateErrors!]
|
Errors of the mutation. |
smartFeed - SmartFeed
|
Updated smart feed |
Example
{
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError],
"smartFeed": SmartFeed
}
SmartTab
Description
A SpaceTab is a sub-level navigation for a space. This provides a filtered / formatted view of the contents in the space.
Fields
Field Name | Description |
---|---|
hashtags - [Hashtag!]
|
List of hashtags used to search content for the SmartTab. |
icon - OpaqueID
|
Icon name representing the tab. |
id - ID!
|
ID of the object. |
label - String!
|
The label of the tab for the current user's language. |
labels - TranslatedString!
|
Translated names of the tab in various languages. |
layout - SmartTabLayout
|
Layout type of the SmartTab, which determines how content is displayed. |
mainMediaTypes - [MimeType!]
|
List of main media types used to search content for SmartTab. |
pinned - Boolean
|
Indicates whether the tab is pinned or not. unused, will be deleted |
schema - StorySchema
|
StorySchema used to search content for the SmartTab. |
search - StorySearchResponse
|
Perform a search within the SmartTab based on the provided query. |
Arguments
|
|
slug - String!
|
Short human-readable representation of the tab to be used in the URL. |
sort - StorySearchSort
|
Sorting criteria for stories within the SmartTab. |
subtypes - [SubtypeResult!]!
|
List of subtype used to search content forwith the SmartTab. |
tags - [Tag!]
|
List of tags used to search content for the SmartTab. |
Example
{
"hashtags": [Hashtag],
"icon": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"label": "xyz789",
"labels": {"en": "a Name", "fr": "Un Nom"},
"layout": "CLASSIC",
"mainMediaTypes": ["image/png"],
"pinned": false,
"schema": StorySchema,
"search": StorySearchResponse,
"slug": "abc123",
"sort": "AGENDA",
"subtypes": [SubtypeResult],
"tags": [Tag]
}
SmartTabLayout
Description
Layout type for the SmartTab, determining the display format of content.
Values
Enum Value | Description |
---|---|
|
Classic layout, typically a list or standard format for displaying content. |
|
Grid layout, displaying content in a grid format with multiple columns. |
Example
"CLASSIC"
Space
Description
A space acts as a container for the stories. Rights and visibilities can be managed at this level, in addition to the organisation settings.
Fields
Field Name | Description |
---|---|
actions - SpaceActions!
|
Indicate the list of actions available to the current user on this Object |
activities - ActivityConnection
|
Get The activity logs of this space. this goes max to 30 days |
administrators - UserConnection
|
List administrator of the current space |
approvers - UserConnection
|
List users with approval permission for the current space (can be space admins or system admins) |
Arguments
|
|
approvals - StoryApprovalConnection
|
List StoryApprovals of the current space |
Arguments
|
|
additionalViewsStories - StoryConnection
|
List all content that have [at least one] additional views in the current Space . |
adminsCount - Int
|
Count the number of users that have administrative right on this space |
analytics - SpaceAnalytics
|
Statistics about the Space contributions, activity and more |
backdrop - Boolean
|
Should we display a backdrop on header's image |
boxes - [Box!]!
|
In Activity feed, list of informational boxes to display |
color - Color
|
Color of the space, used as a fallback for the header image |
contentFeed - StoryConnection
|
Returns the content feed for this space, ordered by added datetime |
Arguments
|
|
contentStats - SpaceContentStats
|
Statistics about the Space contributions, activity and more |
defaultExpiration - StoryExpirationInterval
|
Default expiration of New content published in the space |
defaultRole - SpaceRole
|
Default role for new users in the space (MEMBER if not defined) |
deletedStories - DeletedStoryConnection
|
Returns the content deleted in the last 30 days in this space. Restricted to space admins |
description - String
|
Description of the Space in current user's preferred language. |
descriptions - TranslatedString
|
Translated descriptions of the Space . |
directory - DirectorySearchResponse
|
Deprecated not possible anymore |
Arguments
|
|
facets - [Facet!]!
|
List Facet available in the current space |
Arguments
|
|
feed - ActivityFeedItemConnection
|
List of Story that have been added, edited or commented recently in the space to be used in Activity Feed Tab |
Arguments
|
|
headerImage - URL
|
URL of the header image of the space as a background image illustration |
headerImageDigest - String
|
Hash digest of the headerImage |
id - ID!
|
ID of the object. |
intro - RichContent
|
Introduction text for the space in current user's preferred language. |
intros - [TranslatedRichContent!]
|
Introduction texts for the space in various languages |
isDefault - Boolean
|
Is the space added by default for new member joining the platform. This parameter is only used when the type parameter is set to 'PUBLIC' or 'MODERATED' |
isApprovalMandatory - Boolean!
|
Before beeing able to publish contents, contributors need to request approval |
meRole - SpaceRole!
|
Get the role of the current user in this space |
meFavorited - Boolean!
|
Get the favorited status for the current user. If the users is not a member it will always be false |
membersAddCompletion - [SpaceMemberAddCompletionResult!]
|
Search for members to add to the space |
Arguments
|
|
membersCount - Int
|
Number of active members (teams are de-referenced) in the Space |
Arguments
|
|
membersDownload - URL
|
Download link for a csv file with the list of members of the space you need spaceActions.edit right to be able to download it |
name - String!
|
Name of the Space in current user's preferred language. |
names - TranslatedString
|
Translated names of the Space . |
notifyAdminsOnPost - Boolean
|
Notify admins of the space when a new content is published |
notifyMembersOnPost - Boolean
|
Notify members of the space when a new content is published |
pendingMembers - [User!]
|
List of members of the current space that are pending approval by an admin |
pinnedStories - [Story!]!
|
Give the first 5 pinned Stories of this Space (ordered by position) PinnedStories are stories that were marked as needing to be promoted before the others |
previewImage - URL
|
Return an URL of either the thumbnail either the header image in smaller dimensions |
promoted - [SpacePromotedLocation!]!
|
List of locations where the space is promoted |
promotedImage - URL
|
URL of a promoted image representing the space |
promotedImageDigest - String
|
Hash digest of the promotedImage |
rootFolder - Folder
|
Give the Folder where stories were imported to |
schemas - [StorySchema!]!
|
List StorySchema available in the current space |
search - StorySearchResponse
|
Search for stories in the space |
Arguments
|
|
showEmbeddedWebsite - URL
|
In Activity Feed, show embedded website |
showPopularTiles - Boolean
|
In Activity Feed, show popular tags |
showPopularUsers - Boolean
|
In Activity Feed, show popular users |
showRecentUsers - Boolean
|
In Activity Feed, show recent users |
showRecomendedUsers - Boolean
|
In Activity Feed, show recommended users |
showTopContributors - Boolean
|
In Activity Feed, show top contributors |
slug - Int!
|
Short human representation of the Space. |
spaceGroup - SpaceGroup
|
Group in which the space belongs if defined |
spaceMembers - SpaceMemberConnection
|
Return teams or users as members |
Arguments
|
|
spaceUsers - UserConnection
|
Return a user list of member of the space (de-reference teams as users) |
Arguments
|
|
status - SpaceStatus
|
Status of the space |
suggestedTags - [Tag!]!
|
Suggest tags from a search term |
tabs - [SpaceTab!]
|
Ordered list of Tabs in a Space. Tabs are displayed as navigation but can be used to organize and filter content. see SmartTab |
tags - [Tag!]!
|
Search for tags that match text , and are available for use in this space. |
thumbnailImage - URL
|
URL of a thumbnail representing the space |
thumbnailImageDigest - String
|
Hash digest of the thumbnailImage |
type - SpaceType!
|
Visibility Type of the space |
Example
{
"actions": SpaceActions,
"activities": ActivityConnection,
"administrators": UserConnection,
"approvers": UserConnection,
"approvals": StoryApprovalConnection,
"additionalViewsStories": StoryConnection,
"adminsCount": 987,
"analytics": SpaceAnalytics,
"backdrop": false,
"boxes": [Box],
"color": "#CCCCCC",
"contentFeed": StoryConnection,
"contentStats": SpaceContentStats,
"defaultExpiration": "ONE_MONTH",
"defaultRole": "ADMIN",
"deletedStories": DeletedStoryConnection,
"description": "xyz789",
"descriptions": {"en": "a Name", "fr": "Un Nom"},
"directory": DirectorySearchResponse,
"facets": [Facet],
"feed": ActivityFeedItemConnection,
"headerImage": "http://www.test.com/",
"headerImageDigest": "xyz789",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"intro": RichContent,
"intros": [TranslatedRichContent],
"isDefault": false,
"isApprovalMandatory": true,
"meRole": "ADMIN",
"meFavorited": true,
"membersAddCompletion": [User],
"membersCount": 987,
"membersDownload": "http://www.test.com/",
"name": "xyz789",
"names": {"en": "a Name", "fr": "Un Nom"},
"notifyAdminsOnPost": false,
"notifyMembersOnPost": false,
"pendingMembers": [User],
"pinnedStories": [Story],
"previewImage": "http://www.test.com/",
"promoted": ["NOT_PROMOTED"],
"promotedImage": "http://www.test.com/",
"promotedImageDigest": "xyz789",
"rootFolder": Folder,
"schemas": [StorySchema],
"search": StorySearchResponse,
"showEmbeddedWebsite": "http://www.test.com/",
"showPopularTiles": true,
"showPopularUsers": false,
"showRecentUsers": true,
"showRecomendedUsers": false,
"showTopContributors": false,
"slug": 987,
"spaceGroup": SpaceGroup,
"spaceMembers": SpaceMemberConnection,
"spaceUsers": UserConnection,
"status": "CLOSED",
"suggestedTags": [Tag],
"tabs": [SpaceTab],
"tags": [Tag],
"thumbnailImage": "http://www.test.com/",
"thumbnailImageDigest": "xyz789",
"type": "PUBLIC"
}
SpaceAcceptErrors
Description
Error Type of the spaceAccept
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SpaceAcceptInput
SpaceAcceptPayload
Description
Return Type of Mutation spaceAccept
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SpaceAcceptErrors!]
|
Errors of the mutation. |
space - Space
|
The related Space if accepted |
rejectedId - ID
|
The rejected Space ID if rejected |
Example
{
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError],
"space": Space,
"rejectedId": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}
SpaceActions
Description
Actions the user is allowed to do on the related Space
Fields
Field Name | Description |
---|---|
acceptSpace - Boolean!
|
User can accept the space request |
denySpace - Boolean!
|
User can deny the space request |
accept - Boolean!
|
User can approve a new member to the space |
analytics - Boolean!
|
User can display the analytics of the space |
decline - Boolean!
|
User can decline a new member to the space |
delete - Boolean!
|
User can delete the space |
edit - Boolean!
|
User can edit the space (name, description, color, ...) |
close - Boolean!
|
User can close the space for contributions |
open - Boolean!
|
User can reopen the space for contributions |
favorite - Boolean!
|
Can the user favorite this space |
join - Boolean!
|
User can join (be a member) the space by himself |
leave - Boolean!
|
User can leave the space by himself |
manage - Boolean!
|
User can manage the space (add members, change settings, ...) |
mention - Boolean!
|
Return True if the current user can mention/ping the space on content. |
postStory - Boolean!
|
User can create and publish new contents in this space see also postDraftStory |
postDraftStory - Boolean!
|
User can create new draft contents in this space see also postStory |
request - Boolean!
|
User can request membership to join the space |
unrequest - Boolean!
|
User can "cancel" a request to join the Space |
viewFull - Boolean!
|
User can fully see the space (name, description, ... but also the contents, members, ..) |
requestApproval - Boolean!
|
User can start a new StoryApproval process in this space |
Example
{
"acceptSpace": true,
"denySpace": true,
"accept": false,
"analytics": false,
"decline": true,
"delete": false,
"edit": false,
"close": true,
"open": false,
"favorite": true,
"join": false,
"leave": true,
"manage": false,
"mention": true,
"postStory": true,
"postDraftStory": true,
"request": true,
"unrequest": true,
"viewFull": false,
"requestApproval": true
}
SpaceAddErrors
Description
Error Type of the spaceAdd
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SpaceAddInput
Description
Input type for Mutation spaceAdd
Fields
Input Field | Description |
---|---|
color - Color
|
The color of the space Used as fallback for the header image |
createDefaultTabs - Boolean!
|
Should the server create default tabs for the space (Library, ContentFeed, ). Default = true |
defaultRole - SpaceRole
|
Default role for new users in the space (MEMBER if not defined) |
descriptions - TranslatedString
|
Description of the space for users |
isDefault - Boolean
|
Is the space automatically added to users when they join the platform This parameter is only used when the type parameter is set to 'PUBLIC' or 'MODERATED'. |
defaultExpiration - StoryExpirationInterval
|
Default expiration of New content published in the space |
names - TranslatedString!
|
Translated names of the space |
spaceGroup - ID
|
Global ID of the SpaceGroup to which the space belongs (if any) |
type - SpaceType!
|
Visibility Type of the space |
promoted - [SpacePromotedLocation!]
|
List of locations where the space is promoted. Not promoted by default |
isApprovalMandatory - Boolean
|
Do contributors need to ask approval before beeing able to publish content |
Example
{
"color": "#CCCCCC",
"createDefaultTabs": false,
"defaultRole": "ADMIN",
"descriptions": {"en": "a Name", "fr": "Un Nom"},
"isDefault": true,
"defaultExpiration": "ONE_MONTH",
"names": {"en": "a Name", "fr": "Un Nom"},
"spaceGroup": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"type": "PUBLIC",
"promoted": ["NOT_PROMOTED"],
"isApprovalMandatory": false
}
SpaceAddPayload
Description
Return Type of Mutation spaceAdd
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SpaceAddErrors!]
|
Errors of the mutation. |
space - Space
|
The created Space |
Example
{
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError],
"space": Space
}
SpaceAddRequestErrors
Description
Error Type of the spaceAddRequest
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SpaceAddRequestInput
Description
Input type for Mutation spaceAddRequest
Fields
Input Field | Description |
---|---|
descriptions - TranslatedString
|
Description of the requested space |
message - String!
|
Message to the space admin for reviewing the request |
names - TranslatedString!
|
Translated name of the requested space |
spaceGroup - ID
|
The Global ID of the SpaceGroup to which the space belongs (if any) |
type - SpaceType!
|
Visibility Type of the space |
Example
{
"descriptions": {"en": "a Name", "fr": "Un Nom"},
"message": "abc123",
"names": {"en": "a Name", "fr": "Un Nom"},
"spaceGroup": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"type": "PUBLIC"
}
SpaceAddRequestPayload
Description
Return Type of Mutation spaceAddRequest
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SpaceAddRequestErrors!]
|
Errors of the mutation. |
space - Space
|
The created SpaceRequest |
Example
{
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError],
"space": Space
}
SpaceAnalytics
Description
Analytics for a given space
Fields
Field Name | Description |
---|---|
id - ID!
|
Global ID of the object. |
activeUsersCount - Int
|
Get the amount of active users for the current space during the selected period |
Arguments
|
|
commentsTrends - TimeSeries
|
Trend of the comments post over the requested period |
Arguments
|
|
resharesTrends - TimeSeries
|
Trend of the reshare posted over the requested period |
Arguments
|
|
contentCount - Int!
|
Total number of content in the given space (archived and draft included) |
likesTrends - TimeSeries
|
Trend of the likes of the stories and story comments over the requested period |
Arguments
|
|
mostActiveContentTable - ActiveContentTableResult
|
Get a list of Content with most activity on the space during the selected period return a list of stories and stats (likes, comments, views, unique_views) |
Arguments
|
|
mostActiveUsers - MostActiveUsersList
|
Get a list of users with most activity on the platform during the selected period return a list of object with view, like, comment, publications, updates + users if team is provided, only (current) members of this team will be returned |
Arguments
|
|
publicationsTrends - TimeSeries
|
Evolution of the number of publications over the requested period publications mean New content beeing created (STORY_PUBLISH) |
Arguments
|
|
updatesTrends - TimeSeries
|
Evolution of the new versions of contents over the requested period in that space this will count update on contents (regular, silent) not draft |
Arguments
|
|
verifiedContent - StoryConnection
|
Returns a connection of contents that are marked as verified |
Arguments
|
|
viewsTrends - TimeSeries
|
Trend of the unique views of the stories over the requested period |
Arguments
|
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"activeUsersCount": 123,
"commentsTrends": [
["2020-08-01T00:00:00Z", 12],
["2020-08-02T00:00:00Z", 13]
],
"resharesTrends": [
["2020-08-01T00:00:00Z", 12],
["2020-08-02T00:00:00Z", 13]
],
"contentCount": 123,
"likesTrends": [["2020-08-01T00:00:00Z", 12], ["2020-08-02T00:00:00Z", 13]],
"mostActiveContentTable": ActiveContentTableResult,
"mostActiveUsers": MostActiveUsersList,
"publicationsTrends": [
["2020-08-01T00:00:00Z", 12],
["2020-08-02T00:00:00Z", 13]
],
"updatesTrends": [["2020-08-01T00:00:00Z", 12], ["2020-08-02T00:00:00Z", 13]],
"verifiedContent": StoryConnection,
"viewsTrends": [["2020-08-01T00:00:00Z", 12], ["2020-08-02T00:00:00Z", 13]]
}
SpaceChangeStatusErrors
Description
Error Type of the spaceChangeStatus
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SpaceChangeStatusInput
Description
Input type for Mutation spaceChangeStatus
Fields
Input Field | Description |
---|---|
id - ID!
|
Node Id of the space to close or Reopen |
status - SpaceStatus!
|
The new status of the space (CLOSED or OPEN) |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"status": "CLOSED"
}
SpaceChangeStatusPayload
Description
Return Type of Mutation spaceChangeStatus
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SpaceChangeStatusErrors!]
|
Errors of the mutation. |
space - Space
|
The related Space |
Example
{
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError],
"space": Space
}
SpaceConnection
Description
List of results of Space
Fields
Field Name | Description |
---|---|
edges - [SpaceEdge!]
|
A list of edges. |
pageInfo - PageInfo!
|
Information to aid in pagination. |
totalCount - Int!
|
Identifies the total count of items in the connection. |
Example
{
"edges": [SpaceEdge],
"pageInfo": PageInfo,
"totalCount": 123
}
SpaceContentStats
Description
Statistics about the Space
contents, activity and more
Example
{"statusCount": 123, "storyCount": 987, "activeStoryCount": 987}
SpaceDeleteErrors
Description
Error Type of the spaceDelete
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SpaceDeleteInput
Description
Input type for Mutation spaceDelete
Fields
Input Field | Description |
---|---|
id - ID!
|
Node Id of the space to delete |
Example
{"id": "eWVhaCByaWdodCBpdCdzIGI2NA=="}
SpaceDeletePayload
Description
Return Type of Mutation spaceDelete
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SpaceDeleteErrors!]
|
Errors of the mutation. |
id - ID
|
Unused @deprecated use deletedId
|
deletedId - ID
|
Global ID of the deleted content |
Example
{
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError],
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"deletedId": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}
SpaceEdge
SpaceFavoriteErrors
Description
Error Type of the spaceFavorite
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SpaceFavoriteInput
Description
Input type for Mutation spaceFavorite
Fields
Input Field | Description |
---|---|
spaceId - ID!
|
Node ID of the Space you want to favorite |
Example
{"spaceId": "eWVhaCByaWdodCBpdCdzIGI2NA=="}
SpaceFavoritePayload
Description
Return Type of Mutation spaceFavorite
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SpaceFavoriteErrors!]
|
Errors of the mutation. |
space - Space
|
The favorited space |
Example
{
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError],
"space": Space
}
SpaceFilter
Description
Possible filters for spaces query
Values
Enum Value | Description |
---|---|
|
Select only spaces where the current user has the permission to create content |
|
Select only spaces where the current user has the permission to create content with StorySchema
|
|
Select All visible spaces for the current user |
|
Select spaces where the current user is a member |
|
Select spaces where the current user is NOT a member no longer used |
|
Select spaces that have enabled the mandatoryApproval setting |
Example
"ADDABLE"
SpaceGroup
Description
A SpaceGroup is a Group of spaces. Unlike the Spaces, they don't contain content
Fields
Field Name | Description |
---|---|
actions - SpaceGroupActions!
|
Indicate the list of actions available to the current user on this Object |
backdrop - Boolean
|
Should we display a backdrop on header's image |
color - Color
|
Color of the space group, used as a fallback for the header image |
headerImage - URL
|
URL of the header image of the space group as a top banner background image illustration |
headerImageDigest - String
|
Hash digest of the headerImage |
id - ID!
|
ID of the object. |
name - String!
|
Name of the SpaceGroup in the current user's lang. |
names - TranslatedString
|
Translated names of the SpaceGroup. |
slug - String!
|
Short human representation of the SpaceGroup . |
spaces - SpaceConnection
|
List / Search spaces in the current SpaceGroup |
Arguments
|
|
thumbnailImage - URL
|
Url of the thumbnail image of the space group use in sidebar or as small illustration |
thumbnailImageDigest - String
|
Hash digest of the thumbnailImage |
Example
{
"actions": SpaceGroupActions,
"backdrop": true,
"color": "#CCCCCC",
"headerImage": "http://www.test.com/",
"headerImageDigest": "xyz789",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"name": "abc123",
"names": {"en": "a Name", "fr": "Un Nom"},
"slug": "abc123",
"spaces": SpaceConnection,
"thumbnailImage": "http://www.test.com/",
"thumbnailImageDigest": "abc123"
}
SpaceGroupActions
Description
Actions the user is allowed to do on the related SpaceGroup
Fields
Field Name | Description |
---|---|
edit - Boolean!
|
You can update the information of the SpaceGroup |
delete - Boolean!
|
You can delete the SpaceGroup |
spaceAddRequest - Boolean!
|
Is the current user allowed to request a new space in this group |
spaceAdd - Boolean!
|
Is the current user allowed to create a new space in this group |
Example
{"edit": true, "delete": true, "spaceAddRequest": true, "spaceAdd": true}
SpaceGroupAddErrors
Description
Error Type of the spaceGroupAdd
Mutation
Types
Union Types |
---|
Example
PermissionError
SpaceGroupAddInput
Description
Input type for Mutation spaceGroupAdd
Fields
Input Field | Description |
---|---|
names - TranslatedString!
|
Translated Names of the SpaceGroup |
Example
{"names": {"en": "a Name", "fr": "Un Nom"}}
SpaceGroupAddPayload
Description
Return Type of Mutation spaceGroupAdd
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SpaceGroupAddErrors!]
|
Errors of the mutation. |
spaceGroup - SpaceGroup
|
The created SpaceGroup |
Example
{
"clientMutationId": "abc123",
"errors": [PermissionError],
"spaceGroup": SpaceGroup
}
SpaceGroupConnection
Description
List of results of SpaceGroup
Fields
Field Name | Description |
---|---|
edges - [SpaceGroupEdge!]
|
A list of edges. |
pageInfo - PageInfo!
|
Information to aid in pagination. |
totalCount - Int!
|
Identifies the total count of items in the connection. |
Example
{
"edges": [SpaceGroupEdge],
"pageInfo": PageInfo,
"totalCount": 987
}
SpaceGroupDeleteErrors
Description
Error Type of the spaceGroupDelete
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SpaceGroupDeleteInput
Description
Input type for Mutation spaceGroupDelete
Fields
Input Field | Description |
---|---|
id - ID!
|
Node Id of the SpaceGroup to delete |
Example
{"id": "eWVhaCByaWdodCBpdCdzIGI2NA=="}
SpaceGroupDeletePayload
Description
Return Type of Mutation spaceGroupDelete
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
deletedId - ID
|
Global ID of the deleted space group |
errors - [SpaceGroupDeleteErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"deletedId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"errors": [ObjectNotFoundError]
}
SpaceGroupEdge
Description
An edge in a connection.
Fields
Field Name | Description |
---|---|
cursor - String!
|
A cursor for use in pagination. |
node - SpaceGroup!
|
The item at the end of the edge. |
Example
{
"cursor": "abc123",
"node": SpaceGroup
}
SpaceGroupOrderErrors
Description
Error Type of the spaceGroupOrder
Mutation
Types
Union Types |
---|
Example
PermissionError
SpaceGroupOrderInput
Description
Input type for Mutation spaceGroupOrder
Fields
Input Field | Description |
---|---|
ids - [ID!]!
|
An ordered list of SpaceGroup Node ID |
Example
{"ids": ["eWVhaCByaWdodCBpdCdzIGI2NA=="]}
SpaceGroupOrderPayload
Description
Return Type of Mutation spaceGroupOrder
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SpaceGroupOrderErrors!]
|
Errors of the mutation. |
spaceGroups - [SpaceGroup!]
|
The ordered list of SpaceGroup |
Example
{
"clientMutationId": "abc123",
"errors": [PermissionError],
"spaceGroups": [SpaceGroup]
}
SpaceGroupResult
Description
Facet Result of the SpaceGroup
Fields
Field Name | Description |
---|---|
spaceGroup - SpaceGroup!
|
SpaceGroup Matching the search criteria |
spaces - [SpaceResult!]!
|
Number of spaces in the SpaceGroup |
Example
{
"spaceGroup": SpaceGroup,
"spaces": [SpaceResult]
}
SpaceGroupUpdateErrors
Description
Error Type of the spaceGroupUpdate
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SpaceGroupUpdateInput
Description
Input type for Mutation spaceGroupUpdate
Fields
Input Field | Description |
---|---|
backdrop - Boolean
|
The SpaceGroup header image should add backdrop effect before displaying text over. |
color - Color
|
The new color for the SpaceGroup. |
headerImage - File
|
The new header image for the SpaceGroup. |
id - ID!
|
The ID of the SpaceGroup node to be updated. |
names - TranslatedString
|
The new names in the different langs defined. |
removeColor - Boolean
|
A flag indicating whether the color of the SpaceGroup should be removed or not. |
removeHeaderImage - Boolean
|
A flag indicating whether the header image of the SpaceGroup should be removed or not. |
removeThumbnailImage - Boolean
|
A flag indicating whether the thumbnail image of the SpaceGroup should be removed or not. |
thumbnailImage - File
|
The new thumbnail image for the SpaceGroup. |
Example
{
"backdrop": false,
"color": "#CCCCCC",
"headerImage": "5ee411f1-6632-4388-b994-9fda4caf5c43",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"names": {"en": "a Name", "fr": "Un Nom"},
"removeColor": true,
"removeHeaderImage": true,
"removeThumbnailImage": false,
"thumbnailImage": "5ee411f1-6632-4388-b994-9fda4caf5c43"
}
SpaceGroupUpdatePayload
Description
Return Type of Mutation spaceGroupUpdate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SpaceGroupUpdateErrors!]
|
Errors of the mutation. |
spaceGroup - SpaceGroup
|
The updated SpaceGroup |
Example
{
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError],
"spaceGroup": SpaceGroup
}
SpaceJoinActivity
Description
An Activity Log event: a user has joined a space
Fields
Field Name | Description |
---|---|
id - ID!
|
ID of the object. |
created - IsoDateTime!
|
The time the action was initiated |
space - Space
|
The space associated with the activity event |
type - ActivityType!
|
Type of activity |
user - User
|
The user who initiated the event |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"created": "2016-10-07T01:08:03.420Z",
"space": Space,
"type": "SPACE_JOIN",
"user": User
}
SpaceJoinErrors
Description
Error Type of the spaceJoin
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SpaceJoinInput
Description
Input type for Mutation spaceJoin
Fields
Input Field | Description |
---|---|
id - ID!
|
Node ID of the Space you want to join |
Example
{"id": "eWVhaCByaWdodCBpdCdzIGI2NA=="}
SpaceJoinPayload
Description
Return Type of Mutation spaceJoin
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SpaceJoinErrors!]
|
Errors of the mutation. |
space - Space
|
Space you just joined |
Example
{
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError],
"space": Space
}
SpaceLeaveActivity
Description
An Activity Log event: a user has left a space
Fields
Field Name | Description |
---|---|
id - ID!
|
ID of the object. |
created - IsoDateTime!
|
The time the action was initiated |
space - Space
|
The space associated with the activity event |
type - ActivityType!
|
Type of activity |
user - User
|
The user who initiated the event |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"created": "2016-10-07T01:08:03.420Z",
"space": Space,
"type": "SPACE_JOIN",
"user": User
}
SpaceLeaveErrors
Description
Error Type of the spaceJoin
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SpaceLeaveInput
Description
Input type for Mutation spaceLeave
Fields
Input Field | Description |
---|---|
id - ID!
|
Node ID of the Space you want to leave |
Example
{"id": "eWVhaCByaWdodCBpdCdzIGI2NA=="}
SpaceLeavePayload
Description
Return Type of Mutation spaceLeave
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SpaceLeaveErrors!]
|
Errors of the mutation. |
space - Space
|
The space you just left |
Example
{
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError],
"space": Space
}
SpaceMember
Description
The affiliation of a space and a member (space or user) with specific role
Fields
Field Name | Description |
---|---|
id - ID!
|
ID of the object. |
joined - IsoDateTime
|
Date when the member joined the space |
member - SpaceMemberMember
|
The member of the space |
role - SpaceRole!
|
Role of the member in the space |
updated - IsoDateTime
|
Latest updated date of the member of the space |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"joined": "2016-10-07T01:08:03.420Z",
"member": User,
"role": "ADMIN",
"updated": "2016-10-07T01:08:03.420Z"
}
SpaceMemberAddCompletionResult
SpaceMemberAddErrors
Description
Error Type of the spaceMemberAdd
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SpaceMemberAddInput
Description
Input type for Mutation spaceMemberAdd
Fields
Input Field | Description |
---|---|
id - ID!
|
Global ID of a Space in which the member needs to be added |
everyone - Boolean
|
Add Every enabled user to the space (either userIds or everyone should be provided) |
memberIds - [ID!]
|
Global ID of the member. ID can be an id of a User , Team or a Space (if it's a space, all member of that space will be added as member of the current space) |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"everyone": false,
"memberIds": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
]
}
SpaceMemberAddPayload
Description
Return Type of Mutation spaceMemberAdd
Fields
Field Name | Description |
---|---|
background - Boolean
|
When adding a lot of member (adding a Space for example), we will process the addition in background, thus not return the new member directly this field indicate if the process is done in background, if true then member will be none |
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SpaceMemberAddErrors!]
|
Errors of the mutation. |
member - SpaceMember
|
The newly added Space Member if sucessful. note: if background is true, this list will be empty and if multiple members are added use members
|
edge - SpaceMemberEdge
|
The newly added Space Member in an Edge note: if background is true, this list will be empty and if multiple members are added use members
|
members - [SpaceMember!]
|
The newly added members Note: if background is true, this list will be empty |
Example
{
"background": true,
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError],
"member": SpaceMember,
"edge": SpaceMemberEdge,
"members": [SpaceMember]
}
SpaceMemberConnection
Description
List of results of SpaceMember
Fields
Field Name | Description |
---|---|
edges - [SpaceMemberEdge!]
|
A list of edges. |
pageInfo - PageInfo!
|
Information to aid in pagination. |
totalCount - Int!
|
Identifies the total count of items in the connection. |
Example
{
"edges": [SpaceMemberEdge],
"pageInfo": PageInfo,
"totalCount": 123
}
SpaceMemberDeleteErrors
Description
Error Type of the spaceMemberDelete
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SpaceMemberDeleteInput
Description
Input type for Mutation spaceMemberDelete
Example
{
"spaceId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"ids": ["eWVhaCByaWdodCBpdCdzIGI2NA=="]
}
SpaceMemberDeletePayload
Description
Return Type of Mutation spaceMemberDelete
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SpaceMemberDeleteErrors!]
|
Errors of the mutation. |
deletedId - ID
|
The deleted SpaceMember ID use deletedIds
|
deletedIds - [ID!]
|
The deleted SpaceMember IDs |
Example
{
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError],
"deletedId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"deletedIds": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
]
}
SpaceMemberEdge
Description
An edge in a connection.
Fields
Field Name | Description |
---|---|
cursor - String!
|
A cursor for use in pagination. |
node - SpaceMember!
|
The item at the end of the edge. |
Example
{
"cursor": "abc123",
"node": SpaceMember
}
SpaceMemberMember
SpaceMemberOrderBy
Description
Ordering options for SpaceMemberConnection
Values
Enum Value | Description |
---|---|
|
Order by user name |
|
Order by status of the user (registered is also part of the status) |
|
Order by the role of the member |
Example
"NAME"
SpaceMemberRoleErrors
Description
Error Type of the spaceMemberRole
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SpaceMemberRoleInput
Description
Input type for Mutation spaceMemberRole
Fields
Input Field | Description |
---|---|
id - ID!
|
Global ID of the SpaceMember to change |
role - SpaceRole!
|
New role to assign to the specified SpaceMember |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"role": "ADMIN"
}
SpaceMemberRolePayload
Description
Return Type of Mutation spaceMemberRole
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SpaceMemberRoleErrors!]
|
Errors of the mutation. |
member - SpaceMember
|
Modified SpaceMember |
Example
{
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError],
"member": SpaceMember
}
SpaceOrderErrors
Description
Error Type of the spaceOrder
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SpaceOrderInput
SpaceOrderPayload
Description
Return Type of Mutation spaceOrder
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SpaceOrderErrors!]
|
Errors of the mutation. |
spaces - [Space!]
|
The ordered list of Space modified |
Example
{
"clientMutationId": "xyz789",
"errors": [ObjectNotFoundError],
"spaces": [Space]
}
SpacePromotedLocation
Description
List of locations where the space can be promoted
Values
Enum Value | Description |
---|---|
|
The space is not promoted, it's the default value |
|
The space is promoted in the overview of all the spaces |
|
The space is promoted in the left sidebar |
Example
"NOT_PROMOTED"
SpaceRequestAcceptErrors
Description
Error Type of the spaceRequestAccept
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SpaceRequestAcceptInput
Description
Input type for Mutation spaceRequestAccept
Example
{
"accept": true,
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"userId": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}
SpaceRequestAcceptPayload
Description
Return Type of Mutation spaceRequestAccept
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SpaceRequestAcceptErrors!]
|
Errors of the mutation. |
member - SpaceMember
|
The newly accepted/rejected Member |
space - Space
|
The Space on which the request was accepted/rejected |
Example
{
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError],
"member": SpaceMember,
"space": Space
}
SpaceRequestErrors
Description
Error Type of the spaceRequest
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SpaceRequestInput
SpaceRequestPayload
Description
Return Type of Mutation spaceRequest
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SpaceRequestErrors!]
|
Errors of the mutation. |
space - Space
|
The SpaceRequest created |
Example
{
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError],
"space": Space
}
SpaceResult
SpaceRole
Description
Role of the users in a space see https://help.elium.com/en/articles/5394472-user-roles-and-rights
Values
Enum Value | Description |
---|---|
|
Admininisrator of the space Admin have "every" rights on the space |
|
Coordinator an add and edit content and perfom some moderation tasks |
|
Can add and edit content in the space |
|
The users is not a member of the space |
|
The user is pending an approval to join the space no permissions are granted until the user is accepted |
|
Can access the space in "read-only" mode, can create comments and download content |
Example
"ADMIN"
SpaceStatus
Description
Status of a space
Values
Enum Value | Description |
---|---|
|
The space is closed, All contents are still accessible but no new content can be created You probably want to reassign the contents to a Space with NORMAL status |
|
The Space is open and active New contents can be created, maintained, etc. |
|
A user requested to create this space, and the request is pending approval |
|
The space is deleted, all contents are deleted and not accessible anymore |
Example
"CLOSED"
SpaceStatusErrors
Description
Error Type of the spaceStatus
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SpaceStatusInput
Description
Input type for Mutation spaceStatus
Fields
Input Field | Description |
---|---|
id - ID!
|
Node ID of the Space to update |
status - SpaceStatus!
|
New status to assign to the specified Space |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"status": "CLOSED"
}
SpaceStatusPayload
Description
Return Type of Mutation spaceStatus
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
space - Space
|
The updated space |
errors - [SpaceStatusErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "abc123",
"space": Space,
"errors": [ObjectNotFoundError]
}
SpaceTab
Description
Interface for a tab in a space
Fields
Field Name | Description |
---|---|
slug - String!
|
Short human representation of the tab. |
label - String!
|
The label of the tab for the current user's lang. |
labels - TranslatedString!
|
Translated names of the tab. |
icon - OpaqueID
|
Icon representing the tab |
Possible Types
SpaceTab Types |
---|
Example
{
"slug": "xyz789",
"label": "abc123",
"labels": {"en": "a Name", "fr": "Un Nom"},
"icon": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}
SpaceTabDeleteErrors
Description
Error Type of the spaceTabDelete
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SpaceTabDeleteInput
Description
Input type for Mutation spaceTabDelete
Fields
Input Field | Description |
---|---|
id - ID!
|
Node ID of the SpaceTab to delete |
Example
{"id": "eWVhaCByaWdodCBpdCdzIGI2NA=="}
SpaceTabDeletePayload
Description
Return Type of Mutation spaceTabDelete
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
space - Space
|
The updated space |
errors - [SpaceTabDeleteErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"space": Space,
"errors": [ObjectNotFoundError]
}
SpaceTabOrderErrors
Description
Error Type of the spaceTabOrder
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SpaceTabOrderInput
SpaceTabOrderPayload
Description
Return Type of Mutation spaceTabOrder
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
space - Space
|
The updated space |
errors - [SpaceTabOrderErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "abc123",
"space": Space,
"errors": [ObjectNotFoundError]
}
SpaceTabType
Description
Types of tabs in a space.
Values
Enum Value | Description |
---|---|
|
Tab showing activity feed Deprecated |
|
Tab showing a content feed |
|
An empty tab, doing nothing (useful for hierarchy) |
|
A library tab: A search view of all the content in the space |
|
A link tab On selection, the user is redirected to the URL or the URL is displayed in an iframe |
|
A separator tab Not navigable, only used to separate visually other tabs. |
|
A smart tab: Display a "search" view filtered by a schema, tags, hashtags, etc. |
|
A story tab: Display a single story in the tab. |
|
A deprecated folders tab (not available anymore). not available anymore |
|
deprecated not available anymore |
Example
"ACTIVITY"
SpaceTabUpdateErrors
Description
Error Type of the spaceTabUpdate
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SpaceTabUpdateInput
Description
Input type for Mutation spaceTabUpdate
Fields
Input Field | Description |
---|---|
hashtags - [ID!]
|
List of hashtag IDs to associate with the space tab for filtering in of SpaceTabType.SMART. |
icon - OpaqueID
|
Icon representing the space tab. |
id - ID
|
Node ID of the SpaceTab that you want to update (null if you want to create one). |
labels - TranslatedString
|
Translated labels for the space tab. |
layout - SmartTabLayout
|
Layout type for the space tab for spaceTabType.SMART. |
mainMediaTypes - [MimeType!]
|
List of main media types to associate with the space tab for filtering in of SpaceTabType.SMART. |
parentTabId - ID
|
Global ID of the parent tab (SpaceTab ) under wich the tab should be displayed. |
removeParentTabId - Boolean!
|
Indicates if the parent tab ID should be removed. Default = false |
removeSchemaId - Boolean!
|
Indicates if the schema ID should be removed for filtering in of SpaceTabType.SMART. Default = false |
removeSubtypes - Boolean!
|
Indicates if subtypes should be removed for filtering in of SpaceTabType.SMART. Default = false |
schemaId - ID
|
Schema ID to associate with the space tab for filtering in of SpaceTabType.SMART. |
sort - StorySearchSort
|
Sort order for the stories in the space tab for filtering in of SpaceTabType.SMART. |
spaceId - ID!
|
ID of the space associated with the space tab for filtering in of SpaceTabType.SMART. |
storyId - ID
|
ID of the story associated with the space tab for SpaceTabType.STORY. |
tags - [ID!]
|
List of tag IDs to associate with the space tab for filtering in of SpaceTabType.SMART. |
type - SpaceTabType
|
Type of the space tab. |
url - URLInput
|
URL to set for the space tab of SpaceTabType.LINK. |
urlDisplay - LinkTabDisplay
|
Display settings for the URL for SpaceTabType.LINK. |
Example
{
"hashtags": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"icon": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"labels": {"en": "a Name", "fr": "Un Nom"},
"layout": "CLASSIC",
"mainMediaTypes": ["image/png"],
"parentTabId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"removeParentTabId": false,
"removeSchemaId": true,
"removeSubtypes": true,
"schemaId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"sort": "AGENDA",
"spaceId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"storyId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"tags": ["eWVhaCByaWdodCBpdCdzIGI2NA=="],
"type": "ACTIVITY",
"url": URLInput,
"urlDisplay": "EMBEDDED"
}
SpaceTabUpdatePayload
Description
Return Type of Mutation spaceTabUpdate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
space - Space
|
The space associated with the updated tab. |
spaceTab - SpaceTab
|
The updated space tab. |
errors - [SpaceTabUpdateErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "abc123",
"space": Space,
"spaceTab": SpaceTab,
"errors": [ObjectNotFoundError]
}
SpaceType
Description
Visibility of a space. See https://help.elium.com/en/articles/5394459-types-of-spaces
Values
Enum Value | Description |
---|---|
|
Space is public, anyone can see the content and join. |
|
Everyone can see the space's contents and request membership. |
|
Space name is visible, but content is hidden unless you are a member. |
|
Space existence and content is only visible to the members. |
Example
"PUBLIC"
SpaceUnFavoriteErrors
Description
Error Type of the spaceUnFavorite
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SpaceUnFavoriteInput
Description
Input type for Mutation spaceUnFavorite
Fields
Input Field | Description |
---|---|
spaceId - ID!
|
Node ID of the Space you want to remove from your favorite |
Example
{"spaceId": "eWVhaCByaWdodCBpdCdzIGI2NA=="}
SpaceUnFavoritePayload
Description
Return Type of Mutation spaceUnFavorite
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SpaceUnFavoriteErrors!]
|
Errors of the mutation. |
space - Space
|
The space that is not favorited anymore |
Example
{
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError],
"space": Space
}
SpaceUnrequestErrors
Description
Error Type of the spaceUnrequest
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SpaceUnrequestInput
Description
Input type for Mutation spaceUnrequest
Fields
Input Field | Description |
---|---|
id - ID!
|
Global ID of the Space you want to unrequest |
Example
{"id": "eWVhaCByaWdodCBpdCdzIGI2NA=="}
SpaceUnrequestPayload
Description
Return Type of Mutation spaceUnrequest
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SpaceUnrequestErrors!]
|
Errors of the mutation. |
space - Space
|
The Space where the request to join was removed |
Example
{
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError],
"space": Space
}
SpaceUpdateErrors
Description
Error Type of the spaceUpdate
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SpaceUpdateInput
Description
Input type for Mutation spaceUpdate
Fields
Input Field | Description |
---|---|
backdrop - Boolean
|
Indicates whether to add a visual background to the image of the space for better visibility of texts. no change if not provided |
color - Color
|
Specifies the colored representation of the space, primarily used when no image is defined for the space. no change if not provided |
defaultRole - SpaceRole
|
Sets the default role assigned to users joining the space. |
defaultExpiration - StoryExpirationInterval
|
Defines the default expiration period for new content published in the space. Can be set to null to remove the default expiration setting. If not specified, the content does not expire. no change if not provided |
descriptions - TranslatedString
|
Provides multilingual descriptions of the content of the space. |
headerImage - File
|
Specifies an image illustration to be used as a header while browsing the space. |
id - ID!
|
The global node ID of the space being updated. Must be provided to identify the specific space instance. |
intros - [TranslatedRichContentInput!]
|
Introductory text displayed on the Activity tab. mostly deprecated |
isDefault - Boolean
|
Determines if the current space is listed among the default spaces added to new members. This parameter is only used when the type parameter is set to 'PUBLIC' or 'MODERATED' no change if not provided |
isApprovalMandatory - Boolean
|
Indicates whether contributors need approval before they can publish content. no change if not provided |
promoted - [SpacePromotedLocation!]
|
Lists locations where the space is promoted. Passing an empty array removes promotion from all locations. no change if not provided |
promotedImage - File
|
Specifies an image to be used when the space is promoted. no change if not provided |
removePromotedImage - Boolean
|
Removes the promoted image by setting this flag to true. Passing true will override any previously set promoted image as passing None to promotedImage will do nothing |
names - TranslatedString
|
Contains translated names of the space across multiple languages. |
notifyAdminsOnPost - Boolean
|
Controls whether admins are notified upon new posts in the space. Set to true to enable notifications |
notifyMembersOnPost - Boolean
|
Controls whether members are notified upon new posts in the space. Set to true to enable notifications |
removeColor - Boolean
|
Removes the color setting from the space, reverting to the default color. Set to true to remove the color customization. |
removeHeaderImage - Boolean
|
Removes the header image from the space, reverting to the default header. Set to true to remove the header image customization. |
removeSpaceGroup - Boolean
|
Removes the space group association, if any. Set to true to disassociate the space from any groups. |
removeThumbnailImage - Boolean
|
Removes the thumbnail image from the space, reverting to the default thumbnail. Set to true to remove the thumbnail image customization. |
showEmbeddedWebsite - Boolean
|
In Activity Feed tab, Enables the display of an embedded website within the space. Set to true to enable embedding; otherwise, false. |
showEmbeddedWebsiteURL - URLInput
|
In Activity Feed tab, Specifies the URL of the embedded website to display within the space. Only applicable if showEmbeddedWebsite is true. |
showPopularTiles - Boolean
|
In Activity Feed tab, Controls the visibility of popular tiles within the space. Set to true to display popular tiles; otherwise, false. |
showPopularUsers - Boolean
|
In Activity Feed tab, Controls the visibility of popular users within the space. Set to true to display popular users; otherwise, false. |
showRecentUsers - Boolean
|
In Activity Feed tab, Controls the visibility of recent users within the space. Set to true to display recent users; otherwise, false. |
showRecomendedUsers - Boolean
|
In Activity Feed tab, Controls the visibility of recommended users within the space. Set to true to display recommended users; otherwise, false. |
showTopContributors - Boolean
|
In Activity Feed tab, Controls the visibility of top contributors within the space. Set to true to display top contributors; otherwise, false. |
spaceGroup - ID
|
Specifies the ID of the space group associated with the space. |
thumbnailImage - File
|
Specifies the thumbnail image for the space. The image should be uploaded and referenced by its file ID. |
type - SpaceType
|
Defines the visibility type of the space. Options include 'public', 'private', etc. |
Example
{
"backdrop": false,
"color": "#CCCCCC",
"defaultRole": "ADMIN",
"defaultExpiration": "ONE_MONTH",
"descriptions": {"en": "a Name", "fr": "Un Nom"},
"headerImage": "5ee411f1-6632-4388-b994-9fda4caf5c43",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"intros": [TranslatedRichContentInput],
"isDefault": true,
"isApprovalMandatory": false,
"promoted": ["NOT_PROMOTED"],
"promotedImage": "5ee411f1-6632-4388-b994-9fda4caf5c43",
"removePromotedImage": false,
"names": {"en": "a Name", "fr": "Un Nom"},
"notifyAdminsOnPost": true,
"notifyMembersOnPost": true,
"removeColor": false,
"removeHeaderImage": false,
"removeSpaceGroup": true,
"removeThumbnailImage": false,
"showEmbeddedWebsite": false,
"showEmbeddedWebsiteURL": URLInput,
"showPopularTiles": false,
"showPopularUsers": false,
"showRecentUsers": true,
"showRecomendedUsers": false,
"showTopContributors": false,
"spaceGroup": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"thumbnailImage": "5ee411f1-6632-4388-b994-9fda4caf5c43",
"type": "PUBLIC"
}
SpaceUpdatePayload
Description
Return Type of Mutation spaceUpdate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SpaceUpdateErrors!]
|
Errors of the mutation. |
space - Space
|
The updated space |
Example
{
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError],
"space": Space
}
SpaceUpdatePinnedErrors
Description
Error Type of the spaceUpdatePinned
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
SpaceUpdatePinnedInput
Description
Input type for Mutation spaceUpdatePinned
Example
{
"addedStories": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"removedStories": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
]
}
SpaceUpdatePinnedPayload
Description
Return Type of Mutation spaceUpdatePinned
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [SpaceUpdatePinnedErrors!]
|
Errors of the mutation. |
space - Space
|
The updated space with the new pinned contents |
Example
{
"clientMutationId": "abc123",
"errors": [ObjectNotFoundError],
"space": Space
}
SpacesToChannelItem
Description
Association between a space and a Slack Channel
Fields
Field Name | Description |
---|---|
channel - SlackChannel!
|
The Slack Channel |
space - Space!
|
The linked space |
Example
{
"channel": SlackChannel,
"space": Space
}
StoriesBox
Story
Description
A Content of the Elium platform.
Fields
Field Name | Description |
---|---|
actions - StoryActions!
|
Indicate the list of actions available to the current user on this Object |
added - IsoDateTime!
|
Date when the content was first published |
analytics - StoryAnalytics
|
Statistics about this story |
annotations - AnnotationConnection
|
Get a list of annotations for the story filtrable by status. Annotations are given for all viewLang's of the story. |
Arguments
|
|
bookmarked - Boolean!
|
Is the current story bookmarked by ther current user |
approval - StoryApproval
|
Get the latest StoryApproval following filter if it exists |
Arguments
|
|
commenters - UserConnection
|
Get a list of commenters |
comments - CommentConnection
|
Get a connection of comments on the Content ordered by creation date |
contributors - UserConnection
|
List Contributors of this content. they can be effective (they have contributed to the content) or invited |
Arguments
|
|
diffVersions - StoryVersionsDiff
|
Returns a slate document with the annotated changes to go from the source version to the target version. documentVersion is the version in which we would like to receive the slate's body of the resultant diff |
editVersion - StoryVersion
|
Get the latest-editable StoryVersion of the current content |
Arguments
|
|
editVersionUUID - UUID
|
Return the UUID of the latest edit version of the story |
Arguments
|
|
event - Event
|
Event details if the content is an event |
expireAt - IsoDateTime
|
Story's expiration date set by contributors |
followed - Boolean!
|
Is the current user following the content (subscription of update, notifcations, ...) |
followers - UserConnection
|
List followers of the content |
globallyPinned - Boolean!
|
This story is globally pinned for the whole platform |
grants - [StoryGrant!]!
|
Additional visibility grants added to the content |
hasSpace - Boolean!
|
Is the content placed on a space (if false, the content is in a personal space) |
hashtags - [Hashtag!]!
|
List of hashtags assigned to the content |
Arguments
|
|
id - ID!
|
ID of the object. |
invitables - InvitableConnection
|
Get a list of invitable users when the content contains an Event |
Arguments
|
|
invitations - InvitationConnection
|
Get a list the invitations of the current content (with event) and with the given RSVP status |
Arguments
|
|
inviteContributors - [User!]!
|
Deprecated use me.mention() with canEdit |
Arguments
|
|
isPublished - Boolean!
|
Does this content have at least one published version |
isSpaceClosed - Boolean!
|
Is the Story part of a Closed space (the space is then null and this field is true) |
lastExpiration - StoryExpirationHistory
|
Get the last expiration details set for this story |
layoutMode - StoryLayoutMode!
|
Return the layout of the story |
hideReadTime - Boolean!
|
Contributors have hidden the estimated read time |
legacy - Boolean!
|
Deprecated unused feature |
liked - Boolean!
|
Did the current user liked this content |
likers - UserConnection
|
List of Users that has liked the current content |
pinned - Boolean!
|
Is the current story marked as "Pinned" (on top of the feed) in the current space |
publicUrl - URL
|
World Wide Web accessible URL for the Story. Only available if shared |
publicSharedBy - User
|
User that have shared the content publicly |
publicShared - IsoDateTime
|
Date when the page was publicly shared |
relateds - StoryConnection
|
List of contents that were marked as related. The can be marked manually or automatically as related (by adding a story block for example) |
reshared - Boolean!
|
The current story is a reshare of another story |
resharedAs - [Story!]!
|
List of content that are a reshare of this one. note that it will only list accessible contents for the current user |
resharedAsCount - Int
|
Number of reshares of this content |
resharedFrom - Story
|
Original story of this reshare. Only filled if the current content is a reshare and the original is accessible to the current user |
restricted - Boolean!
|
Unused @deprecated unused feature |
schema - StorySchema
|
see |
confidentialContent - Boolean!
|
The content is protected against rehares, copy or download |
share - Share
|
If the story is reshared , then there can be a message attached |
slug - Int!
|
An Int readable identifier of a Story , usually what you see in the URL |
space - Space
|
Current space of the content. If space is none, it can be because the current space is Closed (see isSpaceClosed ) or because it's a personal content see Story.hasSpace too |
status - StoryStatus!
|
Publishing status of the current content |
subscriptionToken - OpaqueID
|
Deprecated No longer available |
suggestedTags - [Tag!]!
|
Suggest tags that can be added to the story |
Arguments
|
|
tags - [Tag!]!
|
List of tags assigned to the current story |
Arguments
|
|
type - String!
|
Deprecated unused feature |
updated - IsoDateTime!
|
Date of the last update of the content update might be a new version or another modification like Tag, |
user - User
|
The owner of the content |
usersPermission - [User!]!
|
Return a list of the users passed as ids that are allowed to see the content |
Arguments
|
|
valid - Boolean!
|
Deprecated unused feature |
version - StoryVersion
|
Get A version of a story by lang or uuid. you can either use version {...} without argument to get the latest published version. |
versions - StoryVersionConnection
|
List versions (editions) of the current content |
Arguments
|
|
viewers - UserConnection
|
List users that have seen the content since 365 days |
visibility - StoryVisibility
|
Deprecated Stories have their visibility determined by their space type |
watchToken - OpaqueID
|
Deprecated No longer available |
lock - StoryLock
|
If not null, the story is edited by someone and can't be edited for the moment unless the lock is released |
Example
{
"actions": StoryActions,
"added": "2016-10-07T01:08:03.420Z",
"analytics": StoryAnalytics,
"annotations": AnnotationConnection,
"bookmarked": false,
"approval": StoryApproval,
"commenters": UserConnection,
"comments": CommentConnection,
"contributors": UserConnection,
"diffVersions": StoryVersionsDiff,
"editVersion": StoryVersion,
"editVersionUUID": "7aac93c5-a56c-4528-b43e-457834a796c9",
"event": Event,
"expireAt": "2016-10-07T01:08:03.420Z",
"followed": true,
"followers": UserConnection,
"globallyPinned": true,
"grants": [StoryGrant],
"hasSpace": true,
"hashtags": [Hashtag],
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"invitables": InvitableConnection,
"invitations": InvitationConnection,
"inviteContributors": [User],
"isPublished": true,
"isSpaceClosed": false,
"lastExpiration": StoryExpirationHistory,
"layoutMode": "SMALL",
"hideReadTime": false,
"legacy": true,
"liked": true,
"likers": UserConnection,
"pinned": false,
"publicUrl": "http://www.test.com/",
"publicSharedBy": User,
"publicShared": "2016-10-07T01:08:03.420Z",
"relateds": StoryConnection,
"reshared": true,
"resharedAs": [Story],
"resharedAsCount": 123,
"resharedFrom": Story,
"restricted": true,
"schema": StorySchema,
"confidentialContent": false,
"share": Share,
"slug": 123,
"space": Space,
"status": "DELETED",
"subscriptionToken": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"suggestedTags": [Tag],
"tags": [Tag],
"type": "abc123",
"updated": "2016-10-07T01:08:03.420Z",
"user": User,
"usersPermission": [User],
"valid": false,
"version": StoryVersion,
"versions": StoryVersionConnection,
"viewers": UserConnection,
"visibility": "PRIVATE",
"watchToken": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"lock": StoryLock
}
StoryActions
Description
Actions the user is allowed to do on the related Story
Fields
Field Name | Description |
---|---|
advancedStats - Boolean!
|
Can access advanced stats like storyBroadcasts or uniqueViewsTrends |
annotate - Boolean!
|
Can add StoryAnnotation to current content |
archive - Boolean!
|
Can Archive the content |
autotranslate - Boolean!
|
Is the user allowed to translate this content |
bookmark - Boolean!
|
User can Bookmark the content. Those will then be available into me.bookmarks for quick access |
broadcast - Boolean!
|
User has the ability to send a broadcast of the content see mutation.storyBroadcast |
canDeleteAllReshares - Boolean!
|
Return True if the current user can delete all the reshares of a story |
changeOwner - Boolean!
|
User has the right to change the content's owner see story.owner for more info |
convertSchema - Boolean!
|
Can add a schema to the story |
copyContent - Boolean!
|
Can the user copy past the content, download files, ... related to Story.confidentialContent |
delete - Boolean!
|
User has the ability to delete the content |
deleteVersion - Boolean!
|
Can Delete version of the story |
deleteTranslations - Boolean!
|
Can delete translations of the story |
download - Boolean!
|
User has the ability to download the content (download the main asset) |
edit - Boolean!
|
User has the ability to edit the current content. Note: you might want to check publish too. |
editRelations - Boolean!
|
User has the ability to edit the current content's relations (add or remove) note: you also need to be able to edit the linked content to edit the relation |
expire - Boolean!
|
Can set expiration date to a story |
follow - Boolean!
|
User has right to follow the content |
getEmbedCode - Boolean!
|
Unused @deprecated unused feature |
history - Boolean!
|
Can display version history |
like - Boolean!
|
Can like the content |
migrate - Boolean!
|
Deprecated unused feature |
move - Boolean!
|
User has the ability to change content's Space This will also require writing rights in the destination space |
pin - Boolean!
|
Represents the right to Pin stories for the current space |
pinGlobally - Boolean!
|
Represents the right to pin Stories for the whole platform |
ping - Boolean!
|
Deprecated renamed to inviteToRead |
inviteToRead - Boolean!
|
User can invite another user to read the content see mutation.storyPing |
publish - Boolean!
|
User has the ability/right to publish the current content check StoryVersion.actions.publish |
publishNewVersion - Boolean!
|
Can the user add and publish a new version of the story |
publicShare - Boolean!
|
Represents the right to share the Story publicly |
reshare - Boolean!
|
User has the ability to make a "reshare" of the current content. see mutation.storyReshare |
restore - Boolean!
|
User can Un-archive the content. (content is archived and user has permission) see mutation.storyArchive |
send - Boolean!
|
Right to send the Story in a discussion feature isn't used anymore
|
shareUpdate - Boolean!
|
Right to update the reshare message (if story is reshared ) |
tag - Boolean!
|
User can edit/add tags on the content |
requestApproval - Boolean!
|
User can start a new StoryApproval process on this story |
Example
{
"advancedStats": true,
"annotate": false,
"archive": true,
"autotranslate": false,
"bookmark": false,
"broadcast": true,
"canDeleteAllReshares": true,
"changeOwner": true,
"convertSchema": true,
"copyContent": false,
"delete": true,
"deleteVersion": false,
"deleteTranslations": false,
"download": true,
"edit": true,
"editRelations": false,
"expire": false,
"follow": false,
"getEmbedCode": true,
"history": true,
"like": true,
"migrate": true,
"move": false,
"pin": true,
"pinGlobally": false,
"ping": true,
"inviteToRead": true,
"publish": true,
"publishNewVersion": true,
"publicShare": true,
"reshare": true,
"restore": false,
"send": false,
"shareUpdate": false,
"tag": false,
"requestApproval": true
}
StoryAlert
Description
An important Alert on a story sent to a list of recipients
Fields
Field Name | Description |
---|---|
id - ID!
|
Global Node ID of the StoryAlert |
created - IsoDateTime!
|
Date at which the alert was sent |
sender - User
|
The user that did the alert |
message - String
|
The message of the alert |
story - Story
|
The story for which the alert has been sent |
archived - IsoDateTime
|
The Alert is archived and should not be displayed anymore to end users |
recipientsCount - Int
|
The number of recipients that have seen the content since the alert was sent |
viewsCount - Int
|
The number of recipients that have seen the content since the alert was sent |
recipients - UserConnection
|
Find recipients of the alert |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"created": "2016-10-07T01:08:03.420Z",
"sender": User,
"message": "xyz789",
"story": Story,
"archived": "2016-10-07T01:08:03.420Z",
"recipientsCount": 123,
"viewsCount": 987,
"recipients": UserConnection
}
StoryAlertAddedInput
Description
Input type for storyAlertAdded Subscription
Example
{
"clientSubscriptionId": "xyz789",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}
StoryAlertAddedPayload
Description
Return Type the storyAlertAdded Subscription
Fields
Field Name | Description |
---|---|
clientSubscriptionId - String
|
A unique identifier for the client performing the subscription. |
me - Me
|
The Me object of the current user |
storyAlertEdge - StoryAlertEdge
|
The just added StoryAlert in an Edge |
Example
{
"clientSubscriptionId": "abc123",
"me": Me,
"storyAlertEdge": StoryAlertEdge
}
StoryAlertArchiveErrors
Description
Error Type of the storyAlertArchive
Mutation
Types
Union Types |
---|
Example
PermissionError
StoryAlertArchiveInput
Description
Input type for Mutation storyAlertArchive
Fields
Input Field | Description |
---|---|
id - ID!
|
Node ID of the StoryAlert to archive |
Example
{"id": "eWVhaCByaWdodCBpdCdzIGI2NA=="}
StoryAlertArchivePayload
Description
Return Type of Mutation storyAlertArchive
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
alert - StoryAlert
|
The archived broadcast |
errors - [StoryAlertArchiveErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "abc123",
"alert": StoryAlert,
"errors": [PermissionError]
}
StoryAlertConnection
Description
List of results of StoryAlert
Fields
Field Name | Description |
---|---|
edges - [StoryAlertEdge!]
|
A list of edges. |
pageInfo - PageInfo!
|
Information to aid in pagination. |
totalCount - Int!
|
Identifies the total count of items in the connection. |
Example
{
"edges": [StoryAlertEdge],
"pageInfo": PageInfo,
"totalCount": 987
}
StoryAlertEdge
Description
An edge in a connection.
Fields
Field Name | Description |
---|---|
cursor - String!
|
A cursor for use in pagination. |
node - StoryAlert!
|
The item at the end of the edge. |
Example
{
"cursor": "abc123",
"node": StoryAlert
}
StoryAlertErrors
Description
Error Type of the storyAlert
Mutation
Types
Union Types |
---|
Example
PermissionError
StoryAlertInput
Description
Input type for Mutation storyAlert
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"message": "abc123",
"recipients": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
]
}
StoryAlertPayload
Description
Return Type of Mutation storyAlert
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
story - Story
|
NodeId of the related Story |
alert - StoryAlert
|
The created story alert |
errors - [StoryAlertErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"story": Story,
"alert": StoryAlert,
"errors": [PermissionError]
}
StoryAlertUpdatedInput
Description
Input type for storyAlertUpdated Subscription
Example
{
"clientSubscriptionId": "xyz789",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}
StoryAlertUpdatedPayload
Description
Return Type the storyAlertUpdated Subscription
Fields
Field Name | Description |
---|---|
clientSubscriptionId - String
|
A unique identifier for the client performing the subscription. |
me - Me
|
The Me object of the current user |
storyAlert - StoryAlert
|
The just updated StoryAlert |
Example
{
"clientSubscriptionId": "abc123",
"me": Me,
"storyAlert": StoryAlert
}
StoryAlertsReadErrors
Description
Error Type of the storyAlertsRead
Mutation
Types
Union Types |
---|
Example
PermissionError
StoryAlertsReadInput
Description
Input type for Mutation storyAlertsRead
Fields
Input Field | Description |
---|---|
ids - [ID!]!
|
Node IDsof the StoryAlert to mark as read |
Example
{"ids": ["eWVhaCByaWdodCBpdCdzIGI2NA=="]}
StoryAlertsReadPayload
Description
Return Type of Mutation storyAlertsRead
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
readIds - [ID!]
|
The read StoryAlert |
errors - [StoryAlertsReadErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"readIds": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"errors": [PermissionError]
}
StoryAnalytics
Description
Statistics about the a story
Fields
Field Name | Description |
---|---|
commentsTrends - TimeSeries
|
Trend of the comments post on the stories over the requested period require story.actions.advancedStats |
Arguments
|
|
downloads - Int!
|
Number of downloads over the story (probably cached) using old stats over the last 365 days |
likesTrends - TimeSeries
|
Trend of the likes of the stories and story comments over the requested period. require story.actions.advancedStats |
Arguments
|
|
publicationsTrends - TimeSeries
|
Trend of the publications of the stories over the requested period. require story.actions.advancedStats |
Arguments
|
|
updatesTrends - TimeSeries
|
Evolution of the new versions of contents over the requested period on that content this will count update on contents (regular, silent) not draft |
Arguments
|
|
readers - Int!
|
Number of distinct readers of the story (probably cached) using old stats over the last 365 days |
storyBroadcasts - StoryBroadcastResults
|
Fetch broadcast during given period require story.actions.advancedStats |
Arguments
|
|
storyAlerts - StoryAlertConnection
|
Fetch alerts of the story |
storyPings - StoryPingResults
|
Fetch pings during a given period (between fromDate and toDate ). require story.actions.advancedStats |
Arguments
|
|
uniqueViewsTrends - TimeSeries
|
Trend of the views of the stories over the requested period. require story.actions.advancedStats |
Arguments
|
|
views - Int!
|
Number of views of the story (probably cached) using old stats over the last 365 days |
viewsTrends - TimeSeries
|
Trend of the unique views of the stories over the requested period. require story.actions.advancedStats |
Arguments
|
Example
{
"commentsTrends": [
["2020-08-01T00:00:00Z", 12],
["2020-08-02T00:00:00Z", 13]
],
"downloads": 123,
"likesTrends": [["2020-08-01T00:00:00Z", 12], ["2020-08-02T00:00:00Z", 13]],
"publicationsTrends": [
["2020-08-01T00:00:00Z", 12],
["2020-08-02T00:00:00Z", 13]
],
"updatesTrends": [["2020-08-01T00:00:00Z", 12], ["2020-08-02T00:00:00Z", 13]],
"readers": 987,
"storyBroadcasts": StoryBroadcastResults,
"storyAlerts": StoryAlertConnection,
"storyPings": StoryPingResults,
"uniqueViewsTrends": [
["2020-08-01T00:00:00Z", 12],
["2020-08-02T00:00:00Z", 13]
],
"views": 987,
"viewsTrends": [["2020-08-01T00:00:00Z", 12], ["2020-08-02T00:00:00Z", 13]]
}
StoryApproval
Description
An approval process of a content.
A user can/has to request an approval to be able to publish content on specific Space with mandatoryApproval enabled
Fields
Field Name | Description |
---|---|
id - ID!
|
ID of the object. |
version - StoryVersion
|
StoryVersion related to the request. If the StoryAppproval is approved, it's the approved version |
Arguments
|
|
approver - User
|
User assigned to review the current Approval. It might be choosen or forced assigned |
requester - User
|
User that initiated the requested for approval |
createdDate - IsoDateTime!
|
Date at wich the StoryApproval has been first requested |
updatedDate - IsoDateTime!
|
Date at which the StoryApproval has last been changed |
status - StoryApprovalStatus!
|
Current status of the approval |
outcome - StoryApprovalOutcome!
|
Outcome of the approval or null if still active sort of High level status |
story - Story
|
Related Content of the StoryApproval |
history - [StoryApprovalStep!]!
|
Get history of StoryApproval changes order by date |
Arguments
|
|
phases - [StoryApprovalPhase!]
|
Get the list of phases of the approval process |
currentPhase - StoryApprovalPhase
|
Get the current phase of the approval process |
iteration - Int
|
Get the current iteration of the approval process |
actions - StoryApprovalActions!
|
Indicate the list of actions available to the current user on this Object |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"version": StoryVersion,
"approver": User,
"requester": User,
"createdDate": "2016-10-07T01:08:03.420Z",
"updatedDate": "2016-10-07T01:08:03.420Z",
"status": "WAITING_FOR_APPROVAL",
"outcome": "OPEN",
"story": Story,
"history": [StoryApprovalStep],
"phases": [StoryApprovalPhase],
"currentPhase": StoryApprovalPhase,
"iteration": 987,
"actions": StoryApprovalActions
}
StoryApprovalActions
Description
Actions the user is allowed to do on the related StoryApproval
Fields
Field Name | Description |
---|---|
approve - Boolean!
|
User can change the status to APPROVED |
requestCorrections - Boolean!
|
User can change the status to NEED_CORRECTION |
submitApproval - Boolean!
|
User can change the status to WAITING_FOR_APPROVAL |
withdrawApproval - Boolean!
|
User can change the status to WAITING_FOR_APPROVAL |
cancel - Boolean!
|
User can cancel the StoryApproval |
changeApprover - Boolean!
|
User can change the approver of the StoryApproval |
Example
{
"approve": true,
"requestCorrections": true,
"submitApproval": true,
"withdrawApproval": true,
"cancel": false,
"changeApprover": true
}
StoryApprovalAnyPhase
Description
This is a phase where any of the allowed users can approve
Fields
Field Name | Description |
---|---|
type - StoryApprovalPhaseType!
|
Returns the StoryApprovalPhaseType for this phase |
uuid - UUID!
|
Returns unique phase identifier |
Example
{
"type": "SINGLE",
"uuid": "7aac93c5-a56c-4528-b43e-457834a796c9"
}
StoryApprovalAssignErrors
Description
Error Type of the storyApprovalEdit
Mutation
Types
Union Types |
---|
Example
PermissionError
StoryApprovalAssignInput
Description
Input type for Mutation storyApprovalAssign
Example
{
"approverId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"approvalId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"uuid": "xyz789"
}
StoryApprovalAssignPayload
Description
Return Type of Mutation storyApprovalAssign
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [StoryApprovalAssignErrors!]
|
Errors of the mutation. |
story - Story
|
The story on which you invite users |
approval - StoryApproval
|
The created approval request |
Example
{
"clientMutationId": "xyz789",
"errors": [PermissionError],
"story": Story,
"approval": StoryApproval
}
StoryApprovalCancelErrors
Description
Error Type of the storyApprovalCancel
Mutation
Types
Union Types |
---|
Example
PermissionError
StoryApprovalCancelInput
StoryApprovalCancelPayload
Description
Return Type of Mutation storyApprovalCancel
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [StoryApprovalCancelErrors!]
|
Errors of the mutation. |
story - Story
|
The story on which you invite users |
approval - StoryApproval
|
The created approval request |
Example
{
"clientMutationId": "abc123",
"errors": [PermissionError],
"story": Story,
"approval": StoryApproval
}
StoryApprovalConnection
Description
List of results of StoryApproval
Fields
Field Name | Description |
---|---|
edges - [StoryApprovalEdge!]
|
A list of edges. |
pageInfo - PageInfo!
|
Information to aid in pagination. |
totalCount - Int!
|
Identifies the total count of items in the connection. |
Example
{
"edges": [StoryApprovalEdge],
"pageInfo": PageInfo,
"totalCount": 987
}
StoryApprovalEdge
Description
An edge in a connection.
Fields
Field Name | Description |
---|---|
cursor - String!
|
A cursor for use in pagination. |
node - StoryApproval!
|
The item at the end of the edge. |
Example
{
"cursor": "abc123",
"node": StoryApproval
}
StoryApprovalEditErrors
Description
Error Type of the storyApprovalEdit
Mutation
Types
Union Types |
---|
Example
PermissionError
StoryApprovalEditInput
Description
Input type for Mutation storyApprovalEdit
Fields
Input Field | Description |
---|---|
message - String
|
Message for the approval reviewer |
status - StoryApprovalStatus
|
Approval Status you want to set to the process |
approverId - ID
|
Global ID of a User you want an approval from in case of a content where approval is not mandatory |
approvalId - ID!
|
Global ID of the StoryApproval you want to edit |
uuid - String!
|
UUID of the story version you want to edit an approval on. |
Example
{
"message": "abc123",
"status": "WAITING_FOR_APPROVAL",
"approverId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"approvalId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"uuid": "abc123"
}
StoryApprovalEditPayload
Description
Return Type of Mutation storyApprovalEdit
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [StoryApprovalEditErrors!]
|
Errors of the mutation. |
story - Story
|
The story on which you invite users |
approval - StoryApproval
|
The created approval request |
Example
{
"clientMutationId": "abc123",
"errors": [PermissionError],
"story": Story,
"approval": StoryApproval
}
StoryApprovalFilter
Description
Filter for the status of a StoryApproval
Values
Enum Value | Description |
---|---|
|
ALL StoryApproval |
|
StoryApproval only in Approved and published state |
|
StoryApproval that need an approval, correction or has been approved but needs to be published |
|
StoryApproval only in NEED_CORRECTION state |
|
StoryApproval only in WAITING_FOR_APPROVAL state |
|
StoryApproval only that are not assigned to a approver |
|
StoryApproval only in APPROVED state |
Example
"ALL"
StoryApprovalHistoryFilter
Description
Filter when fetching the history of a StoryApproval
Values
Enum Value | Description |
---|---|
|
Return all history |
|
Return only the history of the current iteration of the approval process |
Example
"ALL"
StoryApprovalOutcome
Description
Description of the outcome of a StoryApproval sort of High level status
Values
Enum Value | Description |
---|---|
|
Approval process is ongoing |
|
Approval process has been approved and the approved version is published |
|
Approval process has been cancelled by one of the parties |
Example
"OPEN"
StoryApprovalPhase
Description
A StoryApprovalPhase always has a StoryApprovalPhaseType
Fields
Field Name | Description |
---|---|
type - StoryApprovalPhaseType!
|
Returns the StoryApprovalPhaseType for this phase |
uuid - UUID!
|
Returns unique phase identifier |
Possible Types
StoryApprovalPhase Types |
---|
Example
{
"type": "SINGLE",
"uuid": "7aac93c5-a56c-4528-b43e-457834a796c9"
}
StoryApprovalPhaseInput
Description
Configuration of a StoryApprovalPhase when creating a StoryApproval
Fields
Input Field | Description |
---|---|
type - StoryApprovalPhaseType!
|
Type of the approval phase |
approverIds - [ID!]!
|
List of User ID to configure the phase. If the phase is of type |
Example
{
"type": "SINGLE",
"approverIds": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
]
}
StoryApprovalPhaseType
Description
Type of approval phase
Values
Enum Value | Description |
---|---|
|
This is a single user phase approval |
|
This is a phase where any of the allowed users can approve This is used for the mandatory approval process |
Example
"SINGLE"
StoryApprovalRequestErrors
Description
Error Type of the storyApprovalRequest
Mutation
Types
Union Types |
---|
Example
PermissionError
StoryApprovalRequestInput
Description
Input type for Mutation storyApprovalRequest
Fields
Input Field | Description |
---|---|
message - String
|
Message for the approval reviewer |
storyId - ID!
|
Global ID of the Story you want to request an approval on. |
uuid - String!
|
UUID of the story version you want to request an approval on. |
phases - [StoryApprovalPhaseInput!]
|
The list of phases to use for this approval process. If no phases are given, a single phase of type ANY will be created. |
Example
{
"message": "abc123",
"storyId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"uuid": "abc123",
"phases": [StoryApprovalPhaseInput]
}
StoryApprovalRequestPayload
Description
Return Type of Mutation storyApprovalRequest
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [StoryApprovalRequestErrors!]
|
Errors of the mutation. |
story - Story
|
The story on which you invite users |
approval - StoryApproval
|
The created approval request |
Example
{
"clientMutationId": "xyz789",
"errors": [PermissionError],
"story": Story,
"approval": StoryApproval
}
StoryApprovalSinglePhase
Description
This is a single user phase approval.
The approver for this approval phase is automatically set to the associated User
Fields
Field Name | Description |
---|---|
type - StoryApprovalPhaseType!
|
Returns the StoryApprovalPhaseType for this phase |
uuid - UUID!
|
Returns unique phase identifier |
approver - User
|
The User that must approve the content and is assigned as approver |
Example
{
"type": "SINGLE",
"uuid": "7aac93c5-a56c-4528-b43e-457834a796c9",
"approver": User
}
StoryApprovalStatus
Description
Description of the status of an open StoryApproval
Values
Enum Value | Description |
---|---|
|
Content is waiting for review or reviewer to be assigned |
|
Content has been reviewed, but need correction before beeing published |
|
Content has been marked as reviewed and can be published in the current form |
Example
"WAITING_FOR_APPROVAL"
StoryApprovalStatusErrors
Description
Error Type of the storyApprovalStatus
Mutation
Types
Union Types |
---|
Example
PermissionError
StoryApprovalStatusInput
Description
Input type for Mutation storyApprovalStatus
Fields
Input Field | Description |
---|---|
message - String
|
Message for the approval reviewer |
status - StoryApprovalStatus!
|
Approval Status you want to set to the process |
approvalId - ID!
|
Global ID of the StoryApproval you want to edit |
uuid - String!
|
UUID of the story version you want to edit an approval on. |
Example
{
"message": "abc123",
"status": "WAITING_FOR_APPROVAL",
"approvalId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"uuid": "xyz789"
}
StoryApprovalStatusPayload
Description
Return Type of Mutation storyApprovalStatus
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [StoryApprovalStatusErrors!]
|
Errors of the mutation. |
story - Story
|
The story on which you invite users |
approval - StoryApproval
|
The created approval request |
Example
{
"clientMutationId": "abc123",
"errors": [PermissionError],
"story": Story,
"approval": StoryApproval
}
StoryApprovalStep
Description
A Step of a StoryApproval process. Might be a status change or a message or something else
Fields
Field Name | Description |
---|---|
creator - User
|
User that as created/changed the approval and thus created this step |
created - IsoDateTime!
|
Date at which the step was created |
status - StoryApprovalStatus!
|
Status at the time of the step |
message - String
|
A message added as the changed was made, for approver or requester |
relatedVersion - StoryVersion
|
Version of the content that was the current version at the time of the Step |
currentPhase - StoryApprovalPhase
|
Get the current approval phase as of this step |
iteration - Int
|
Get the current approval iteration as of this step |
Example
{
"creator": User,
"created": "2016-10-07T01:08:03.420Z",
"status": "WAITING_FOR_APPROVAL",
"message": "abc123",
"relatedVersion": StoryVersion,
"currentPhase": StoryApprovalPhase,
"iteration": 987
}
StoryArchiveErrors
Description
Error Type of the storyArchive
Mutation
Types
Union Types |
---|
Example
PermissionError
StoryArchiveInput
Description
Input type for Mutation storyArchive
Example
{
"archived": false,
"id": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}
StoryArchivePayload
Description
Return Type of Mutation storyArchive
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [StoryArchiveErrors!]
|
Errors of the mutation. |
story - Story
|
The story that was marked as archived |
Example
{
"clientMutationId": "xyz789",
"errors": [PermissionError],
"story": Story
}
StoryAsset
Description
An Asset
that link to a Story
story Block
Fields
Field Name | Description |
---|---|
created - IsoDateTime!
|
Creation date of the current asset |
lang - Lang
|
The language of the asset. currently unused unused |
slug - OpaqueID!
|
Identifier of the asset, you probably don't need it |
metadata - [AssetMetadata!]
|
The metadatas associated with the asset. |
story - Story
|
The Story object referenced by this asset. |
storySlug - Int
|
The slug of the story. This field can be read even if the current user does not have access to the story. |
uuid - UUID!
|
UUID of the asset as referenced in slate body |
Example
{
"created": "2016-10-07T01:08:03.420Z",
"lang": "fr",
"slug": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"metadata": [AssetMetadata],
"story": Story,
"storySlug": 123,
"uuid": "7aac93c5-a56c-4528-b43e-457834a796c9"
}
StoryAssetInput
Description
Input type for Mutation storyAsset
Fields
Input Field | Description |
---|---|
cloudDriveId - OpaqueID
|
Identifier for the cloud drive where the asset is stored. for example with a Google Drive asset, the cloudId is the Google Drive ID only used for CloudAsset |
cloudId - OpaqueID
|
Identifier for the cloud provider where the asset is stored. for example with a Google Drive asset, the cloudId is the ID of the file on google drive only used for CloudAsset |
cloudProvider - CloudProvider
|
Cloud provider where the asset is stored. only used for CloudAsset |
file - File
|
File to add to the content only used for FileAsset |
backgroundColor - Color
|
Background color of the drawing (only applicable for assets of type 'DrawingAsset'). |
elements - JSON
|
All the forms in the drawings (lines, circles, rectangles, texts, etc.). only used for DrawingAsset |
metadata - [AssetMetadataInput!]
|
A list of metadata about the asset. The supported values are in AssetMetadataKey. e.g. [{"key": "URL_DESCRIPTION", "value": "some description or excerpt of this url"}] mainly used for URLAsset |
story - ID
|
The story object referenced by this asset. only used for StoryAsset |
type - AssetType!
|
Type of the asset. |
url - URLInput
|
URL details of the asset. only used for URLAsset |
user - ID
|
Identifier of the user associated with the asset. only used for UserAsset |
uuid - UUID
|
UUID of the asset (to match the one in the Story Body) otherwise a new UUID will be generated |
Example
{
"cloudDriveId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"cloudId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"cloudProvider": "GOOGLE_DRIVE",
"file": "5ee411f1-6632-4388-b994-9fda4caf5c43",
"backgroundColor": "#CCCCCC",
"elements": {},
"metadata": [AssetMetadataInput],
"story": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"type": "CLOUD_FILE",
"url": URLInput,
"user": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"uuid": "7aac93c5-a56c-4528-b43e-457834a796c9"
}
StoryBookmarkErrors
Description
Error Type of the storyBookmark
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
StoryBookmarkInput
StoryBookmarkPayload
Description
Return Type of Mutation storyBookmark
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
me - Me
|
The current user |
story - Story
|
The story that was marked as Bookmark |
errors - [StoryBookmarkErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"me": Me,
"story": Story,
"errors": [ObjectNotFoundError]
}
StoryBroadcastErrors
Description
Error Type of the storyBroadcast
Mutation
Types
Union Types |
---|
Example
TooManyRecipientsError
StoryBroadcastHistory
Description
A broadcast sent of a given story at a given time
Fields
Field Name | Description |
---|---|
created - IsoDateTime!
|
Date at which the broadcast was sent |
id - ID!
|
ID of the object. |
sender - User
|
The user that did sent the broadcast |
story - Story
|
The story that was sent in this broadcast |
Example
{
"created": "2016-10-07T01:08:03.420Z",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"sender": User,
"story": Story
}
StoryBroadcastInput
Description
Input type for Mutation storyBroadcast
Fields
Input Field | Description |
---|---|
id - ID!
|
Node Id of the Story to broadcast |
message - String
|
Optional message to send as introduction of the broadcast |
preview - Boolean!
|
Is the mutation a preview or a real broadcast (preview will be available with a url to see the preview of the broadcast without sending it). Default = true |
recipients - [ID!]!
|
List of recipients to send the broadcast to can be a list of User , Space or Team ID |
subject - String
|
Title of the broadcast (will be used as the email subject for example) |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"message": "abc123",
"preview": true,
"recipients": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"subject": "abc123"
}
StoryBroadcastPayload
Description
Return Type of Mutation storyBroadcast
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
nRecipients - Int
|
Number of recipients. |
previews - [StoryBroadcastPayloadPreview!]
|
Generated preview(s) of the broadcast for the current user. |
story - Story
|
Story currently broadcasted. |
errors - [StoryBroadcastErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "abc123",
"nRecipients": 987,
"previews": [StoryBroadcastPayloadPreview],
"story": Story,
"errors": [TooManyRecipientsError]
}
StoryBroadcastPayloadPreview
Description
Description of the Preview of the story broadcast.
This should be used to display a preview of the broadcast before sending it.
Example
{
"lang": "fr",
"url": "http://www.test.com/"
}
StoryBroadcastResultItem
Description
Details about a broadcast sent of a story
Fields
Field Name | Description |
---|---|
broadcast - StoryBroadcastHistory
|
History of the story broadcast. |
deliveredCount - Int
|
Number of recipients who received the broadcast. (accepted by the mail server, not necessarily read by the user) |
openCount - Int
|
Number of recipients who opened the broadcast. (opened the email, not necessarily read the content as reported by client tracking) |
Example
{
"broadcast": StoryBroadcastHistory,
"deliveredCount": 123,
"openCount": 987
}
StoryBroadcastResults
Description
List of StoryBroadcast sendings with statistics
Fields
Field Name | Description |
---|---|
endCursor - String
|
When paginating forwards, the cursor to continue. |
hasNextPage - Boolean
|
When paginating forwards, are there more items? |
nodes - [StoryBroadcastResultItem!]
|
A list of nodes. |
Example
{
"endCursor": "xyz789",
"hasNextPage": true,
"nodes": [StoryBroadcastResultItem]
}
StoryChangeOwnerErrors
Description
Error Type of the storyChangeOwner
Mutation
Types
Union Types |
---|
Example
ObjectNotFoundError
StoryChangeOwnerInput
StoryChangeOwnerPayload
Description
Return Type of Mutation storyChangeOwner
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
story - Story
|
The modified story with owner changed |
errors - [StoryChangeOwnerErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"story": Story,
"errors": [ObjectNotFoundError]
}
StoryConnection
Description
List of results of Story
Fields
Field Name | Description |
---|---|
edges - [StoryEdge!]
|
A list of edges. |
pageInfo - PageInfo!
|
Information to aid in pagination. |
totalCount - Int!
|
Identifies the total count of items in the connection. |
Example
{
"edges": [StoryEdge],
"pageInfo": PageInfo,
"totalCount": 987
}
StoryDeleteErrors
Description
Error Type of the storyDelete
Mutation
Types
Union Types |
---|
Example
PermissionError
StoryDeleteInput
Description
Input type for Mutation storyDelete
Fields
Input Field | Description |
---|---|
id - ID!
|
The Id of the story to delete |
Example
{"id": "eWVhaCByaWdodCBpdCdzIGI2NA=="}
StoryDeletePayload
Description
Return Type of Mutation storyDelete
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
errors - [StoryDeleteErrors!]
|
Errors of the mutation. |
deletedId - ID
|
Global ID of the deleted content |
id - ID
|
Unused @deprecated use deletedId
|
me - Me
|
The current user |
Example
{
"clientMutationId": "abc123",
"errors": [PermissionError],
"deletedId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"me": Me
}
StoryDuplicateErrors
Description
Error Type of the storyDuplicate
Mutation
Types
Union Types |
---|
Example
PermissionError
StoryDuplicateInput
Description
Input type for Mutation storyDuplicate
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"publish": false,
"spaceId": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}
StoryDuplicatePayload
Description
Return Type of Mutation storyDuplicate
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
story - Story
|
The new duplicated story |
errors - [StoryDuplicateErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"story": Story,
"errors": [PermissionError]
}
StoryEdge
StoryEditErrors
Description
Error Type of the storyEdit
Mutation
Example
PermissionError
StoryEditInput
Description
Input type for Mutation storyEdit
Fields
Input Field | Description |
---|---|
addedAssets - [StoryAssetInput!]
|
List of asset to delete |
addedHashtags - [ID!]
|
Hashtag to add to the current Story |
addedTags - [ID!]
|
Tags to add to the current Story |
attributes - [AttributeInput!]
|
List of attributes values |
body - RichContentInput
|
body(content) of the story (unchanged if none) |
builtins - [BuiltinAttributeInput!]
|
List of builtins values |
comment - String
|
A comment you want to give to this revision |
coverAsset - UUID
|
An Image File Asset used as preview of the story in search /... (unchanged if none) |
id - ID!
|
Global Node ID of the story you want to edit |
lang - Lang
|
Lang of the version you are editing. (if none, then the version won't have lang attached) |
layoutMode - StoryLayoutMode
|
The layout you want for your content |
hideReadTime - Boolean
|
Hide the estimated read time (untouched if not passed) |
mainAsset - UUID
|
Main asset of the story (unchanged if none) |
previousVersion - UUID
|
Verify that your edit is correctly taking place on the latest version available by passing your last known version If the version mismatch, it returns an InvalidInputError with path set to previousVersion |
publish - Boolean!
|
True if you want to publish this version (False will create a Draft version). Default = false |
removeBody - Boolean!
|
True if you wan't to remove the current body. Default = false |
removeCoverAsset - Boolean!
|
True if you wan't to remove the coverAsset . Default = false |
removeMainAsset - Boolean!
|
True if you wan't to remove the mainAsset . Default = false |
removedAssets - [UUID!]
|
List of asset to add to the story (can be used in mainAsset, coverAsset or body) |
removedHashtags - [ID!]
|
Hashtags to remove to the current Story |
removedTags - [ID!]
|
Tags to remove to the current Story |
confidentialContent - Boolean
|
The content is protected against rehares, copy or download |
title - String
|
New title of the story (unchanged if none) |
updateType - StoryVersionType
|
describe the importance of the new version |
releaseLock - Boolean!
|
Indicate to the backend & other user that you are continuing the edition without releasing your current lock. Default = true |
lockToken - String
|
Lock token taken via StoryLock If none is given, backend will try to take one during the operation, if not possible the operation will be rejected |
Example
{
"addedAssets": [StoryAssetInput],
"addedHashtags": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"addedTags": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"attributes": [AttributeInput],
"body": RichContentInput,
"builtins": [BuiltinAttributeInput],
"comment": "abc123",
"coverAsset": "7aac93c5-a56c-4528-b43e-457834a796c9",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"lang": "fr",
"layoutMode": "SMALL",
"hideReadTime": false,
"mainAsset": "7aac93c5-a56c-4528-b43e-457834a796c9",
"previousVersion": "7aac93c5-a56c-4528-b43e-457834a796c9",
"publish": false,
"removeBody": true,
"removeCoverAsset": true,
"removeMainAsset": false,
"removedAssets": [
"7aac93c5-a56c-4528-b43e-457834a796c9"
],
"removedHashtags": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"removedTags": [
"eWVhaCByaWdodCBpdCdzIGI2NA=="
],
"confidentialContent": true,
"title": "xyz789",
"updateType": "IMPORTANT",
"releaseLock": true,
"lockToken": "xyz789"
}
StoryEditPayload
Description
Return Type of Mutation storyEdit
Fields
Field Name | Description |
---|---|
clientMutationId - String
|
A unique identifier for the client performing the mutation. unused, will be deleted |
ignoredHashtags - [Hashtag!]
|
List of Hashtag that couldn't be added/removed from the content reasons can be because of it usage in a StorySchema field |
ignoredTags - [Tag!]
|
List of Tag that couldn't be added/remove from the content reasons can be because of it usage in a StorySchema field |
story - Story
|
The edited story |
errors - [StoryEditErrors!]
|
Errors of the mutation. |
Example
{
"clientMutationId": "xyz789",
"ignoredHashtags": [Hashtag],
"ignoredTags": [Tag],
"story": Story,
"errors": [PermissionError]
}
StoryEventInviteActivity
Description
An Activity Log event : A user has been invited to an event in a story
Fields
Field Name | Description |
---|---|
id - ID!
|
ID of the object. |
created - IsoDateTime!
|
The time the action was initiated. |
invitedSpace - Space
|
The space that was invited |
invitedUser - User
|
The user that was invited. |
space - Space
|
The space associated with the activity event. |
story - Story
|
The story associated with the activity event. |
type - ActivityType!
|
Type of activity. |
user - User
|
The user who initiated the event. |
Example
{
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"created": "2016-10-07T01:08:03.420Z",
"invitedSpace": Space,
"invitedUser": User,
"space": Space,
"story": Story,
"type": "SPACE_JOIN",
"user": User
}
StoryExpirationHistory
Description
Represents the history of expiration reminder set for a story. (expireation reminder is a notification sent to the user before the content is due to verification)
Fields
Field Name | Description |
---|---|
created - IsoDateTime!
|
Date at which the user assigned the expiration date. |
expirationDate - IsoDateTime
|
Expiration date set by the user. |
id - ID!
|
ID of the object. |
user - User
|
User who set the expiration date of the story. |
Example
{
"created": "2016-10-07T01:08:03.420Z",
"expirationDate": "2016-10-07T01:08:03.420Z",
"id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
"user": User
}
StoryExpirationInterval
Description
Default expiration for a content
Values
Enum Value | Description |
---|---|
|
Expire in 1 calendar month |
|
Expire in 3 calendar month |
|
Expire in 1 calendar year |
Example
"ONE_MONTH"
StoryExpireErrors
Description
Represents the possible errors that can occur during the storyExpire
mutation.
Types
Union Types |
---|
Example
PermissionError
StoryExpireInput
Description
Input type for the storyExpire
mutation.
Fields
Input Field | Description |
---|---|
expirationDate - IsoDateTime
|
The new expiration(reminder) date for the story. |
storyId - ID!
|
The ID of the story to update the expiration date for. |
Example
{
"expirationDate": "2016-10-07T01:08:03.420Z",
"storyId": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}
StoryExpirePayload
Description
Return Type of Mutation storyExpire