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

Response

Returns a Node

Arguments
Name Description
id - ID Global Node ID of the object to load

Example

Query
query node($id: ID) {
  node(id: $id) {
    id
  }
}
Variables
{"id": "eWVhaCByaWdodCBpdCdzIGI2NA=="}
Response
{
  "data": {
    "node": {
      "id": "eWVhaCByaWdodCBpdCdzIGI2NA=="
    }
  }
}

nodes

Description

Get a list of node objects via their ids. see node resolver

Response

Returns [Node]

Arguments
Name Description
ids - [ID!]! List of Global Node IDs

Example

Query
query nodes($ids: [ID!]!) {
  nodes(ids: $ids) {
    id
  }
}
Variables
{"ids": ["eWVhaCByaWdodCBpdCdzIGI2NA=="]}
Response
{
  "data": {
    "nodes": [
      {"id": "eWVhaCByaWdodCBpdCdzIGI2NA=="}
    ]
  }
}

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

Arguments
Name Description
token - String! Manadatory access token to access the public content provided by the StoryShare URL
lang - Lang Lang of the requested story version

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)

Response

Returns a Space

Arguments
Name Description
slug - Int! Number id of the space to load

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

Response

Returns a Story

Arguments
Name Description
slug - Int! Number id of the Status to load

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)

Response

Returns a Story

Arguments
Name Description
slug - Int! Number id of the story to load

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
    }
  }
}

storyReshares

Description

Get a list of stories that are reshares of the current story. This may allow viewing an alternative reshare if you don't have access.

Response

Returns [Story!]!

Arguments
Name Description
slug - Int! Number id of the story to load the reshares

Example

Query
query storyReshares($slug: Int!) {
  storyReshares(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": {
    "storyReshares": [
      {
        "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": false,
        "followers": UserConnection,
        "globallyPinned": false,
        "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": 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": false,
        "schema": StorySchema,
        "confidentialContent": false,
        "share": Share,
        "slug": 987,
        "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
      }
    ]
  }
}

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)

Response

Returns a User

Arguments
Name Description
slug - Int! number id of the user to load

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)

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

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

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

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

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

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

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

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

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)

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
    }
  }
}

sharePointAddSearchTab

Description

Create a new SharepointSearchTab integration for users

Response

Returns a SharePointAddSearchTabPayload

Arguments
Name Description
input - SharePointAddSearchTabInput! Required Input for the sharePointAddSearchTab Mutation

Example

Query
mutation sharePointAddSearchTab($input: SharePointAddSearchTabInput!) {
  sharePointAddSearchTab(input: $input) {
    searchTab {
      ...SharePointSearchTabFragment
    }
    clientMutationId
    instance {
      ...InstanceFragment
    }
    errors {
      ... on PermissionError {
        ...PermissionErrorFragment
      }
      ... on UnconfiguredServiceError {
        ...UnconfiguredServiceErrorFragment
      }
    }
  }
}
Variables
{"input": SharePointAddSearchTabInput}
Response
{
  "data": {
    "sharePointAddSearchTab": {
      "searchTab": SharePointSearchTab,
      "clientMutationId": "abc123",
      "instance": Instance,
      "errors": [PermissionError]
    }
  }
}

sharePointRemoveSearchTab

Description

Remove a SharepointSearchTab from the current instance (users won't be able to use it anymore to search contents)

Arguments
Name Description
input - SharePointRemoveSearchTabInput! Required Input for the sharePointRemoveSearchTab Mutation

Example

Query
mutation sharePointRemoveSearchTab($input: SharePointRemoveSearchTabInput!) {
  sharePointRemoveSearchTab(input: $input) {
    clientMutationId
    instance {
      ...InstanceFragment
    }
    errors {
      ... on PermissionError {
        ...PermissionErrorFragment
      }
      ... on UnconfiguredServiceError {
        ...UnconfiguredServiceErrorFragment
      }
      ... on ObjectNotFoundError {
        ...ObjectNotFoundErrorFragment
      }
    }
  }
}
Variables
{"input": SharePointRemoveSearchTabInput}
Response
{
  "data": {
    "sharePointRemoveSearchTab": {
      "clientMutationId": "xyz789",
      "instance": Instance,
      "errors": [PermissionError]
    }
  }
}

sharePointSearchTabUpdate

Description

Modify an exisiting sharePointSearchTab SharepointSearchTab

Arguments
Name Description
input - SharePointSearchTabUpdateInput! Required Input for the sharePointSearchTabUpdate Mutation

Example

Query
mutation sharePointSearchTabUpdate($input: SharePointSearchTabUpdateInput!) {
  sharePointSearchTabUpdate(input: $input) {
    clientMutationId
    instance {
      ...InstanceFragment
    }
    errors {
      ... on PermissionError {
        ...PermissionErrorFragment
      }
      ... on ObjectNotFoundError {
        ...ObjectNotFoundErrorFragment
      }
      ... on UnconfiguredServiceError {
        ...UnconfiguredServiceErrorFragment
      }
    }
  }
}
Variables
{"input": SharePointSearchTabUpdateInput}
Response
{
  "data": {
    "sharePointSearchTabUpdate": {
      "clientMutationId": "xyz789",
      "instance": Instance,
      "errors": [PermissionError]
    }
  }
}

slackActivitiesConfigUpdate

Description

Updates the activities for which a message should be pushed to Slack

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

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

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

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

Use storyApprovalStatus or storyApprovalAssign instead
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

Nothing to migrate
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
    }
  }
}

storyPublicShare

Description

Share publicly a story or edit the related settings

Response

Returns a StoryPublicSharePayload

Arguments
Name Description
input - StoryPublicShareInput! Required Parameter for the storyPublicShare Mutation

Example

Query
mutation storyPublicShare($input: StoryPublicShareInput!) {
  storyPublicShare(input: $input) {
    clientMutationId
    story {
      ...StoryFragment
    }
    errors {
      ... on PermissionError {
        ...PermissionErrorFragment
      }
      ... on ObjectNotFoundError {
        ...ObjectNotFoundErrorFragment
      }
    }
  }
}
Variables
{"input": StoryPublicShareInput}
Response
{
  "data": {
    "storyPublicShare": {
      "clientMutationId": "abc123",
      "story": Story,
      "errors": [PermissionError]
    }
  }
}

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]
    }
  }
}

storyReshare

Description

Create a "Reshare" of a given story Reshares are not editable, automatically linked to the original story and automatically updated. Feed of comments and likes are not shared between the original and the reshare.

Response

Returns a StoryResharePayload

Arguments
Name Description
input - StoryReshareInput! Required Parameter for the storyReshare Mutation

Example

Query
mutation storyReshare($input: StoryReshareInput!) {
  storyReshare(input: $input) {
    activityFeedItemEdge {
      ...ActivityFeedItemEdgeFragment
    }
    clientMutationId
    me {
      ...MeFragment
    }
    reshare {
      ...StoryFragment
    }
    space {
      ...SpaceFragment
    }
    story {
      ...StoryFragment
    }
    errors {
      ... on PermissionError {
        ...PermissionErrorFragment
      }
      ... on ObjectNotFoundError {
        ...ObjectNotFoundErrorFragment
      }
      ... on LockedContentError {
        ...LockedContentErrorFragment
      }
    }
  }
}
Variables
{"input": StoryReshareInput}
Response
{
  "data": {
    "storyReshare": {
      "activityFeedItemEdge": ActivityFeedItemEdge,
      "clientMutationId": "xyz789",
      "me": Me,
      "reshare": Story,
      "space": Space,
      "story": Story,
      "errors": [PermissionError]
    }
  }
}

storySchemaAttributeOrder

Description

Manually order the attributes of a StorySchema

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
    }
  }
}

storyShareUpdate

Description

Update a Reshared Story's Message The message explains why the story is reshared, often displayed in the stories comments

Response

Returns a StoryShareUpdatePayload

Arguments
Name Description
input - StoryShareUpdateInput! Required Parameter for the storyShareUpdate Mutation

Example

Query
mutation storyShareUpdate($input: StoryShareUpdateInput!) {
  storyShareUpdate(input: $input) {
    clientMutationId
    story {
      ...StoryFragment
    }
    errors {
      ... on PermissionError {
        ...PermissionErrorFragment
      }
      ... on ObjectNotFoundError {
        ...ObjectNotFoundErrorFragment
      }
      ... on LockedContentError {
        ...LockedContentErrorFragment
      }
    }
  }
}
Variables
{"input": StoryShareUpdateInput}
Response
{
  "data": {
    "storyShareUpdate": {
      "clientMutationId": "abc123",
      "story": Story,
      "errors": [PermissionError]
    }
  }
}

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

unused
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

Feature will be phased out
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

Description

Stats about active contents (most or less active)

Fields
Field Name Description
stats - JSON

Stats related to the Story in JSON

  {"likes": 0, "comments": 0, "views": 0, "unique_views": 0}
story - Story Related Story
Example
{"stats": {}, "story": Story}

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

Description

Stats item about the activity of user

Fields
Field Name Description
stats - JSON Stats about the user in JSON form. contains: likes, comments, views, publications, updates, reshares, all_events
user - User Related user on wich the stat applies
Example
{"stats": {}, "user": User}

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
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

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination.
node - Activity! The item at the end of the edge.
Example
{
  "cursor": "xyz789",
  "node": Activity
}

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

SPACE_JOIN

A user join a Space

SPACE_LEAVE

A user leaves a Space

STATUS_COMMENT_LIKE

A Like is added to a comment of a status

STATUS_COMMENT_POST

A new comment is added to a status

STATUS_CREATE

A new status is added

STATUS_LIKE

A status is like

STORY_ARCHIVE

A user archive a story

STORY_CHANGE_OWNER

A user change the owner of a story

STORY_COMMENT_LIKE

A like is added to a comment of a story

STORY_COMMENT_POST

A new comment is added to a post

STORY_EVENT_INVITE

A new invitation to an event is sent

STORY_INVITE_CONTRIBUTOR

A user was invited to contribute to a story

STORY_LIKE

A story is liked

STORY_PUBLISH

A user publish a story

STORY_PUBLISH_RESHARE

A user published a new version of a reshare of a story

STORY_RESHARE

A user reshared a story

STORY_RESTORE

A user restore a story

STORY_VERSION_DRAFT

A Story draft is saved

STORY_VERSION_PUBLISH

A Story version is published

STORY_VERSION_PUBLISH_RESHARE

A Story version is reshared

USER_FOLLOW

User follow a user unused

USER_INHERIT

A user inherit contents from another user
Example
"SPACE_JOIN"

AddressAttributeInput

Description

Input type for representing address Attribute

Fields
Input Field Description
city - String The city name
country - String The country name
extra - String Additional information about the address
postCode - String The postal or ZIP code
region - String The region or state
street - String The street address
Example
{
  "city": "xyz789",
  "country": "abc123",
  "extra": "xyz789",
  "postCode": "xyz789",
  "region": "xyz789",
  "street": "xyz789"
}

AddressValue

Description

Type representing an address with various attributes.

Fields
Field Name Description
city - String The city name
country - String The country name
extra - String Additional information about the address
postCode - String The postal or ZIP code
region - String The region or state
street - String The street address
Example
{
  "city": "abc123",
  "country": "xyz789",
  "extra": "xyz789",
  "postCode": "xyz789",
  "region": "abc123",
  "street": "xyz789"
}

AgendaBox

Description

Type representing an agenda box, which implements the `Box interface.

Fields
Field Name Description
events - [Story!]! List of stories or events within the agenda box
title - String The title of the agenda box
Example
{
  "events": [Story],
  "title": "xyz789"
}

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.

Alert.hours, ... will represent "default" settings and Alert.meSubscription.hours the customised version

subscription - AlertSubscription Deprecated, see meSubscription Use meSubscription instead
subscribers - AlertSubscriberConnection

List of AlertSubscriber to the alert.

Those are the explicit subscribers to the alert, either a User or a Team (represented by AlertSubscriberMember union)

The totalCount will then be the number of AlertSubscriber of this Alert. When no Team are subscribed, this will be the same as subscriptions.totalCount

needs AlertActions.edit permission

Arguments
query - String

Filter the list of subscribers by the given query text

before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

subscriptions - AlertSubscriptionConnection

List of AlertSubscription to the alert.

One AlertSubscription per unique user will be returned, by expanding any Team subscriber

The totalCount will then be the number of unique recipients of this Alert. When no Team are subscribed, this will be the same as subscribers.totalCount

needs AlertActions.edit permission

Arguments
query - String

Filter the list of subscriptions users by the given query text

before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

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

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

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

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination.
node - Alert! The item at the end of the edge.
Example
{
  "cursor": "abc123",
  "node": Alert
}

AlertEditErrors

Description

Error Type of the alertEdit Mutation

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

TITLE

Order by Title of the alert

DESCRIPTION

Order by description of the alert

HOUR

Order by Hour of sending the alert

MEMBERS_COUNT

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

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

Description

Subscriber of an alert A subscriber can be a user or a team

Types
Union Types

User

Team

Example
User

AlertSubscriberRemoveErrors

Description

Error Type of the alertSubscriberRemove Mutation

Example
ObjectNotFoundError

AlertSubscriberRemoveInput

Description

Input type for Mutation alertSubscriberRemove

Fields
Input Field Description
id - ID! Global Node ID of the Alert you want to remove subscribers from
subscriberIds - [ID!]! List of AlertSubscriber IDs to remove from the alert
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

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

IMPRESSION

Correspond to a partial view, displayed amongst other content (like in a feed) no longer tracked

VIEW

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

Description

Return Type of Mutation analyticsSignal

Fields
Field Name Description
clientMutationId - String A unique identifier for the client performing the mutation. unused, will be deleted
me - Me Current User
Example
{
  "clientMutationId": "abc123",
  "me": Me
}

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
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

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

Fields
Field Name Description
delete - Boolean! Can delete the current Annotation
edit - Boolean! Can edit (change comment, ...) the current Annotation
resolve - Boolean! Can mark as resolved/unresolved the current Annotation
reply - Boolean! Can add an AnnotationComment to the current Annotation
Example
{"delete": true, "edit": true, "resolve": true, "reply": false}

AnnotationAddedInput

Description

Input type for annotationAdded Subscription

Fields
Input Field Description
clientSubscriptionId - String A unique identifier for the client performing the subscription.
id - ID! Global ID of the Story where the subscription is added
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

Description

Actions the user is allowed to do on the related AnnotationComment Object

Fields
Field Name Description
delete - Boolean! Can delete the current AnnotationComment
edit - Boolean! Can edit the current AnnotationComment
Example
{"delete": true, "edit": false}

AnnotationCommentAddErrors

Description

Error Type of the annotationCommentAdd Mutation

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

Fields
Input Field Description
clientSubscriptionId - String A unique identifier for the client performing the subscription.
id - ID! Global ID of the Annotation where the subscription is added
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

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

Fields
Input Field Description
clientSubscriptionId - String A unique identifier for the client performing the subscription.
id - ID! Global ID of the Annotation to listen for deleted AnnotationComment
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

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

Fields
Input Field Description
clientSubscriptionId - String A unique identifier for the client performing the subscription.
id - ID! Global ID of the Annotation where the subscription is added
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

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

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

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

Fields
Input Field Description
clientSubscriptionId - String A unique identifier for the client performing the subscription.
id - ID! Global ID of the Story where the subscription is added
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

OPEN

The annotation is Open and waiting for attention

RESOLVED

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
includeUnused - Boolean!

Should the unused sources be included in the result

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

Description

Composite type for a story asset source in an answer

Fields
Field Name Description
asset - Asset! The source asset for this answer
story - Story! The story where the asset is used
Example
{"asset": Asset, "story": Story}

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

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination.
node - Answer! The item at the end of the edge.
Example
{
  "cursor": "xyz789",
  "node": Answer
}

AnswerFeedbackError

Description

Error Type of the answerFeedback Mutation

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

NO_RESPONSE

The provided response does not contains an anwser

WRONG_ANSWER

The provided response is not relevant to the question or inexact

CONFUSING_ANSWER

The provided response is confusing or not precise enough

WRONG_SOURCES

The sources provided are not the best sources possible

OTHER

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

USER

Regular mode used by the end user while doing a SmartAssistant request or Answer request

CONFIGURATION

Admin usage of the AI, for example to test or while configuring

DEBUG

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

V1

Old method of indexing, not much criteria available

V2

New method of indexing, more filter likes space, schema, etc
Example
"V1"

AnswerResolveError

Description

Error Type of the answerFeedback Mutation

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

Example
PermissionError

AnswerSendForReviewInput

Description

Input type for Mutation answerSendForReview

Fields
Input Field Description
id - ID! Global ID of the question asked, provided by me.anwser
message - String! Message to send to the team with explanation of the problem
Example
{
  "id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
  "message": "abc123"
}

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

Story

AnswerAssetSource

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 forEveryone is filled)

Only available when InstanceActions.appLauncherEdit

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

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

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

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

PermissionError

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.
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

DISABLED

The antivirus is disabled

INFECTED

An issue was found in the file. Appropriate measures must be taken

NOT_SCANNED

the scan by the AV-scanning engine has not finished yet

SAFE

the engine has scan the file and it's considered safe

SKIPPED

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

EMAIL_CC

The email CC field, which contains the addresses of any carbon copy recipients.

EMAIL_DATE

The date and time the email was sent.

EMAIL_FROM

The email address of the sender.

EMAIL_MSG_ID

The email message ID, which is a unique identifier for the email.

EMAIL_SUBJECT

The subject of the email.

EMAIL_TO

The email address of the primary recipient.

URL_DESCRIPTION

A description of the URL.

URL_FAVICON_URL

The URL of the favicon (the small icon displayed in the browser tab) for the URL.

URL_PROVIDER_DISPLAY

The Display name of the provider URL (eg wikipedia.org for a wikipedia article)

URL_PROVIDER_NAME

The name of the provider of the URL (e.g. "Wikipedia" for a wikipedia article).

URL_PROVIDER_URL

The URL of the provider's website (e.g. "https://fr.wikipedia.org" for a wikipedia article).

URL_TITLE

The title of the page at the URL.
Example
"EMAIL_CC"

AssetPreviewPayload

Description

Preview Result of an asset before beeing saved.

Fields
Field Name Description
asset - Asset The asset as previewed
clientMutationId - String A unique identifier for the client performing the mutation. unused, will be deleted
Example
{
  "asset": Asset,
  "clientMutationId": "abc123"
}

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

CLOUD_FILE

A file stored in the cloud (e.g. in Google Drive or Teams drive). see CloudFileAsset

CLOUD_FOLDER

A folder containing files in the cloud (e.g. in Google Drive or Teams drive). see CloudFolderAsset

EMAIL

An email message. see EmailAsset

FILE

A file on the user's local file system. see FileAsset

STORY

A Story object see StoryAsset

URL

A URL that points to a webpage. sett URLAsset

USER

A user of the application. see UserAsset

DRAWING

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

Description

Error with one of the Attribute.

Fields
Field Name Description
path - String! Path of the field leading to the error
error - String! Translated message of the error
key - String! The schema Field Key related to the error
Example
{
  "path": "abc123",
  "error": "abc123",
  "key": "abc123"
}

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

Description

Interface representing a Box in the sidebar of the space feed

Fields
Field Name Description
title - String The title of the box
Example
{"title": "abc123"}

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

AUTHOR

Represents the author of the content as the "original author" (like Website author, ...)

BODY

Represents the body or text content of the content

COVER_ASSET

Represents the cover asset (thumbnail picture) of the content

EVENT

Represents the event associated with the content

LOCATION

Represents the location associated with the content

MAIN_ASSET

Represents the main asset or featured image of the content

ORDER_STRING

Represents the order string used for sorting the content

PUBLICATION_DATE

Represents the publication date of the content as original Publication date ( Website publication date, Article date, ...)

PUBLISHER

Represents the publisher of the content

SOURCE

Represents the source of the content (website, ...)

TITLE

Represents the title of the content

USER_DESCRIPTION

Represents the user description associated with the content

USER_EMAILS

Represents the user emails associated with the content

USER_FULL_NAME

Represents the full name of the user associated with the content

DECISION_TREE

Represents the Key of a decision tree strucuture associated with a content

SUMMARY

Give a summary / abstract of the content
Example
"AUTHOR"

BulkStoryArchiveErrors

Description

Error Type of the bulkStoryArchive Mutation

Example
PermissionError

BulkStoryArchiveInput

Description

Input type for Mutation bulkStoryArchive

Fields
Input Field Description
ids - [ID!]! The Ids of the stories to archive or restore
archive - Boolean! Archive(true) or restore(false) the stories
Example
{
  "ids": ["eWVhaCByaWdodCBpdCdzIGI2NA=="],
  "archive": true
}

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

Description

Input type for Mutation bulkStoryDelete

Fields
Input Field Description
clientMutationId - String A unique identifier for the client performing the mutation.
ids - [ID!]! The Id of the story to delete
Example
{
  "clientMutationId": "xyz789",
  "ids": ["eWVhaCByaWdodCBpdCdzIGI2NA=="]
}

BulkStoryDeletePayload

Description

Return Type of Mutation bulkStoryDelete

Fields
Field Name Description
clientMutationId - String A unique identifier for the client performing the mutation.
deletedIds - [ID!] Global ID list of the deleted Story
skippedIds - [ID!] List of Story ID that couldn't be deleted
me - Me Reference to current user
Example
{
  "clientMutationId": "abc123",
  "deletedIds": [
    "eWVhaCByaWdodCBpdCdzIGI2NA=="
  ],
  "skippedIds": [
    "eWVhaCByaWdodCBpdCdzIGI2NA=="
  ],
  "me": Me
}

BulkStoryMoveErrors

Description

Error Type of the bulkStoryMove Mutation

Example
PermissionError

BulkStoryMoveInput

Description

Input type for Mutation bulkStoryMove

Fields
Input Field Description
clientMutationId - String A unique identifier for the client performing the mutation.
ids - [ID!]! The Ids of the stories to move
space - ID Move to the given space (id of a Space object)
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

Example
PermissionError

BulkStorySchemaConvertInput

Description

Input type for Mutation bulkStorySchemaConvert

Fields
Input Field Description
ids - [ID!]! The Ids of the stories to convert
schemaId - ID! assign the given schema to the stories (id of a StorySchema object)
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

Example
InvalidInputError

CheckPasswordInput

Description

Input type for Mutation checkPassword

Fields
Input Field Description
password - String! The password to check
slug - Int! Short human representation of the User
token - String! Token obtain via trial server
Example
{
  "password": "xyz789",
  "slug": 987,
  "token": "xyz789"
}

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

GoogleCloudDetails

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)
Arguments
first - Int!

Returns the first n elements from the list.

after - ID

Returns the elements in the list that come after the specified cursor.

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

Fields
Field Name Description
iconURL - URL Icon of the item
id - OpaqueID External Id of the item in the cloud provider
modifiedTime - IsoDateTime Last modification time of the item
name - String Name of the item
owner - String Name of the owner
url - URL URL of the item to open it in the browser
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

Google Drive

ONEDRIVE

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

DARK

Indicates a dark color.

LIGHT

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.
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

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

Description

Actions the user is allowed to do on the related Comment

Fields
Field Name Description
delete - Boolean! Can delete the current Comment
edit - Boolean! Can edit (change content, ...) the current Comment
Example
{"delete": true, "edit": false}

CommentAddedInput

Description

Input type for commentAdded Subscription

Fields
Input Field Description
clientSubscriptionId - String A unique identifier for the client performing the subscription.
id - ID! Node ID of the Story where the subscription is added
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

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

Fields
Input Field Description
clientSubscriptionId - String A unique identifier for the client performing the subscription.
id - ID! ID of the comment to subscribe to
Example
{
  "clientSubscriptionId": "abc123",
  "id": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}

CommentDeletedPayload

Description

Return Type of commentDeleted Subscription

Fields
Field Name Description
clientSubscriptionId - String A unique identifier for the client performing the subscription.
error - String Deprecated unused
id - ID Node ID of the Comment that was deleted
parent - Story Parent Object from which the comment was deleted
Example
{
  "clientSubscriptionId": "xyz789",
  "error": "xyz789",
  "id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
  "parent": Story
}

CommentEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination.
node - Comment! The item at the end of the edge.
Example
{
  "cursor": "abc123",
  "node": Comment
}

CommentEditErrors

Description

Error Type of the commentEdit Mutation

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

Fields
Input Field Description
clientSubscriptionId - String A unique identifier for the client performing the subscription.
id - ID! Node Id of the Comment to subscribe to
Example
{
  "clientSubscriptionId": "abc123",
  "id": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}

CommentEditedPayload

Description

Return Type of commentEdited Subscription

Fields
Field Name Description
clientSubscriptionId - String A unique identifier for the client performing the subscription.
comment - Comment The edited Comment
Example
{
  "clientSubscriptionId": "xyz789",
  "comment": Comment
}

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

ObjectNotFoundError

Example
ObjectNotFoundError

CommentLikeInput

Description

Input type for Mutation commentLike

Fields
Input Field Description
id - ID! Node Id of the Comment to like or unlike
like - Boolean! Like (true) or Unlike (false) status to apply to the comment
Example
{
  "id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
  "like": true
}

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

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.

Fields
Field Name Description
comment - Comment! The matching comment.
highlightedSnippets - [HTML!]!

Highlighted snippets of the comment that match the search query. with tags around the matching words

Example
{
  "comment": Comment,
  "highlightedSnippets": [
    "<html>Hello <h1>world</h1></html>"
  ]
}

CommentSource

Description

Description of where the comment was posted

Values
Enum Value Description

MAIL

Comment was created via a response to a notification email

MOBILE

Comment was created via the mobile app

WEB

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
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

comments - CommentConnection Retrieve a list of comments on the object
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

Possible Types
Commentable Types

Story

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

Example
ObjectNotFoundError

ConnectedAppCreateInput

Description

Input type for Mutation ConnectedAppCreate

Fields
Input Field Description
title - String! A title for the connected app
redirectUri - URLInput! A redirect URI for the connected app
trusted - Boolean! Is the ConnectedApp trusted ?
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

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

Example
ObjectNotFoundError

ConnectedAppEditInput

Description

Input type for Mutation connectedAppEdit

Fields
Input Field Description
id - ID! The global ID of the ConnectedApp to edit
title - String A title for the connected app
redirectUri - URLInput A redirect URI for the connected app
trusted - Boolean Is the ConnectedApp trusted ?
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

ObjectNotFoundError

Example
ObjectNotFoundError

ContentLikeInput

Description

Input type for Mutation contentLike

Fields
Input Field Description
id - ID! Global ID of the Story to like or unlike
like - Boolean! Status to set (true == Like, false == Unlike)
Example
{
  "id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
  "like": false
}

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

Fields
Input Field Description
clientSubscriptionId - String A unique identifier for the client performing the subscription.
id - ID! Node ID of the Story where the subscription is added
Example
{
  "clientSubscriptionId": "abc123",
  "id": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}

ContentLikedPayload

Description

Return Type of contentLiked Subscription

Fields
Field Name Description
clientSubscriptionId - String A unique identifier for the client performing the subscription.
parent - Node The parent object of the liked content (probaly a Story)
userEdge - UserEdge The User that like in an Edge
Example
{
  "clientSubscriptionId": "abc123",
  "parent": Node,
  "userEdge": UserEdge
}

ContributorsFilter

Description

Possible filters to limit contributor results

Values
Enum Value Description

ALL

All contributors are returned (EFFECTIVE as well as INVITED)

EFFECTIVE

Only contributors that have effectively contributed to the content are returned

INVITED

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

DAY

Make a tick every day

WEEK

Make a tick every Week

MONTH

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

INVALID

The base format of the source or target is invalid.

UNKNOWN

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

Default frequency, typically daily.

EVERY_DAY

Generate a digest every day.

EVERY_MONDAY

Generate a digest every Monday.

EVERY_MONDAY_AND_WEDNESDAY

Generate a digest every Monday and Wednesday.

EVERY_MONTH

Generate a digest every month.

NEVER

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
text - String

Query string to look for in the hashtags.

searchTags - [TagResult!] Search for tags within a specific facet matching the given query string.
Arguments
facetId - ID

Facet ID to filter the search by.

text - String

Query string to look for in the tags.

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.

Fields
Field Name Description
highlightedFullName - HTML

Highlighted full name of the user. Highlighted text is wrapped in tags for display.

user - User! User associated with the search result.
Example
{
  "highlightedFullName": "<html>Hello <h1>world</h1></html>",
  "user": User
}

DirectorySearchSort

Description

Defines the sorting options for directory searches.

Values
Enum Value Description

ALPHABETICAL

Sort results alphabetically.

NEWEST

Sort results by newest first.

OLDEST

Sort results by oldest first.

RELEVANCE

Sort results by relevance score. (mix of popularity and recency, accross multiple fields)
Example
"ALPHABETICAL"

DisableStandardContentErrors

Description

Error Type of the disableStandardContent Mutation

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

ALL

Include all drafts in the filter.

COLLABORATIVE

Include only collaborative drafts in the filter. draft that are stored in a space, thus accessible to contributors of the space

MINE

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

Description

Represent the error when trying to use an email that already exists

Fields
Field Name Description
path - String! Path of the field leading to the error
email - String! The email that has is duplicated
Example
{
  "path": "xyz789",
  "email": "abc123"
}

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
publicLinks - Boolean!

Determines whether to include public links in the returned JSON, instead of relative internal links.

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

HTML

Indicates the email content is in HTML format.

PLAIN

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 :

  • be maximum 48 characters long
  • only contain "_-." and alphanumeric characters
  • begin and end with an alphanumeric character
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

Example
ObjectNotFoundError

EmailPipelineCreateInput

Description

Input type for Mutation emailPipelineCreate

Fields
Input Field Description
extension - String!

Email extension part to send to. Extension should :

  • be maximum 48 characters long
  • only contain "_-." and alphanumeric characters
  • begin and end with an alphanumeric character
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

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

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 :

  • be maximum 48 characters long
  • only contain "_-." and alphanumeric characters
  • begin and end with an alphanumeric character
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_FILES

Body of mail is in highlight, and each attachement is a new story with file in highlight

BODY

Body of mail is in highlight, attachements are ignored

FILES

Body is ignored, each attachement creates a new content with file in highlight

LINKS

body is ignored, each links in the body is a new content with link in highlight

AS_CONTENT

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

EXTENSION

Order by the email extension

DESCRIPTION

Order by the description

INGEST_TYPE

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

ALL

does not filter events by status

DECLINED

select only events that are declined

ONGOING

select only events that are ongoing

PAST

select only events that are in the past

PENDING

select only events that are pending a response

UPCOMING

select only events that are in the future

ICS

Select event as an ICS file
Example
"ALL"

EventInviteErrors

Description

Error Type of the eventInvite Mutation

Example
PermissionError

EventInviteInput

Description

Input type for Mutation eventInvite

Fields
Input Field Description
id - ID! Node ID of the Story to invite to
invite - Boolean! Set to true to invite the participants, false to uninvite them
participants - [ID!]! List of participants to invite or uninvite Could be a list of User or Space
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

Description

Possible Participant Union for an Event

Types
Union Types

User

Space

Example
User

EventRespondErrors

Description

Error Type of the eventRespond Mutation

Example
PermissionError

EventRespondInput

Description

Input type for Mutation eventRespond

Fields
Input Field Description
id - ID! Node ID of the Story to respond to the event
rsvp - Rsvp! RSVP response the current user give to the event
Example
{
  "id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
  "rsvp": "INVITED"
}

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

MOBILE

Elium Mobile App

WEB

Elium Web App

EMAIL

Incoming email

SHAREPOINT

Microsoft Office Sharepoint Integration

SLACK

Slack Integration

TEAMS

Microsoft Teams Integration

WOPI

Microsoft Office WOPI edition

WORKPLACE

Facebook Workplace Integration

WEB_EXTENSION

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

ALL

does not filter content by expiration

EXPIRED

select only content where expired date is before now

EXPIRED_AND_EXPIRING

select noth content where expired date is coming soon (in 30 days) or before now

EXPIRING

select only content where expired date is coming soon (in 30 days)

NO_EXPIRATION

select only content where no expiration date is set

SUGGEST

select content with no expiration, but seems to be good candidate for one

VALID

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
text - String

Query string to look for in the tags.

tags - TagConnection Return a list of all tags contained in the facet
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

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

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

ALL

does not filter facet by mandatory status

OPTIONAL

select only Optional facets

REQUIRED

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
publicLinks - Boolean!

Determines whether to include public links in the embedded content.

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
mode - WOPIOpenMode!

Mode of display of the document preview, full view, edit, ..

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
Arguments
start - Int!

Start index for pagination. Default is 0.

limit - Int!

Limit the number of results returned. Default is 20.

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

Example
ObjectNotFoundError

FolderAddTagInput

Description

Input type for Mutation folderAddTag

Fields
Input Field Description
id - ID! Node Id of the Folder to add the tag to
tags - [ID!]! List of Node ids of Tag to add to the folder
Example
{
  "id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
  "tags": ["eWVhaCByaWdodCBpdCdzIGI2NA=="]
}

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

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

Example
ObjectNotFoundError

FolderMoveInput

Description

Input type for Mutation folderMove

Fields
Input Field Description
id - ID! Node ID of the Folder to move.
ownerId - ID Node ID of a User to assign as the new owner of the contents in the folder.
spaceId - ID Node ID of a Space to move the folder to.
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

Description

Input type for providing full name attributes.

Fields
Input Field Description
firstName - String First name of the individual.
lastName - String Last name of the individual.
Example
{
  "firstName": "abc123",
  "lastName": "xyz789"
}

FullNameValue

Description

Type representing a full name value.

Fields
Field Name Description
firstName - String First name of the individual.
lastName - String Last name of the individual.
Example
{
  "firstName": "abc123",
  "lastName": "xyz789"
}

GoogleCloudDetails

Description

Details related to Google Cloud files.

Fields
Field Name Description
fileId - OpaqueID! File ID in Google Cloud.
revision - OpaqueID Revision ID of the file in Google Cloud.
url - URL! URL to access the file in Google Cloud.
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

PermissionError

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

Description

An edge in a connection of HashtagConnection

Fields
Field Name Description
cursor - String! A cursor for use in pagination.
node - Hashtag! The Hashtag item at the end of the edge.
Example
{
  "cursor": "xyz789",
  "node": Hashtag
}

HashtagResult

Description

Facet of a Hashtag

Fields
Field Name Description
hashtag - Hashtag! The hashtag matching the query
totalCount - Int! Number of content matching the query that have the hashtag
Example
{"hashtag": Hashtag, "totalCount": 123}

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
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

usersWithSuccession - UserConnection List users that have succession defined (source users) and at least one content to transfer
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

onlyDisabled - Boolean!

Filter users that are disabled or deleteed only

duplicatedAssets - DuplicatedAssetConnection Get a list of duplicated assets. (They can be duplicated in different stories or in the same story).
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

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
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

extensionFilter - String

Search a given extension. Usefull to find duplicates

orderBy - EmailPipelineOrderBy!

Order results by EmailPipelineOrderBy

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
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

query - String

Filter Space Groups by name text

ssoConfig - InstanceSsoConfig The configuration parameters of the SSO
scimConfig - InstanceScimConfig The configuration parameters for SCIM integration
connectedApps - ConnectedAppConnection The list of OAuth connected applications
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

approvals - StoryApprovalConnection List StoryApprovals.
Arguments
filter - StoryApprovalFilter!

Filter approval by status

before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

publicSharedStories - StoryConnection Get a list of All publicly shared content.
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

spaces - SpaceConnection Returns all existing spaces matching the query. It is only available for platform admins & space admins.
Arguments
query - String

Query string to look for space

onlyMandatoryApproval - Boolean!

Select Only Spaces with mandatory Approval

onlyAnswerReady - Boolean!

Select Only Spaces that are part of the Answer indexing

includeClosed - Boolean!

Include Closed Spaces

includePending - Boolean!

Include Spaces requested by users

includeEnabled - Boolean!

Include Spaces that enabled

orderBy - InstanceSpaceOrderBy!

Order results

before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

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
resolved - Boolean

Look for Resolved feedback or not yet resolved (no filter if not given) (only negative feedback questions are resolvable, do not use this filter in combination with onlyIncorrect)

onlyIncorrect - Boolean!

Look for negative feedback questions only

fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

answerFeedbacksExport - URL Get the URL of the CSV export of the feedbacks made by users using Answer
Arguments
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

searchFeedbacks - SearchFeedbackConnection Fetch the feedbacks made by users using the regular Search
Arguments
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

sharedAlerts - AlertConnection List of Alert that are managed at Instance Level
Arguments
query - String

An optional filter text to look for Shared Alert's title

before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

orderBy - AlertOrderBy!

Specify how to order the results. See AlertOrderBy

sharedAlertsSubscribers - [AlertSubscriberMember!]! List possible subscribers for a shared Alert (optionally filtering out existing subscribers)
Arguments
query - String!

A filter text to look for Shared Alert possible subscribers

id - ID

An optional Alert ID to evaluate existing subscribers and filter them out of possible 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
year - Int!

The year to get stats from

successorsWithContent - UserConnection List of users assigned to inherit content ordered by amount still to process
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

timezones - [Timezone!]! List of supported timezones
teams - TeamConnection Returns all existing teams matching the query. It is only available for platform admins.
Arguments
query - String

Filter Teams by name text

before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

orderBy - TeamOrderBy!

Specify how to order the results. See TeamOrderBy

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:

  [
    {
      "lang": "en",
      "name": "Anglais"
    },
    {
      "lang": "fr",
      "name": "Français"
    }
  ]
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
query - String

Filter users by name or email (+ stats fields)

includeDisabled - Boolean!

Include users that are disabled

includePending - Boolean!

Include users that are invited but not yet activated

includeEnabled - Boolean!

Include User that enabled

before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

orderBy - UserAdminOrderBy!

Specify how to order the results

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
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

appLaunchers - AppLauncherConnection List all the available AppLaunchers require InstanceActions.appLauncherEdit
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

smartFeeds - SmartFeedConnection List all the available SmartFeed require MeActions.smartFeedsManage
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

smartAssistants - SmartAssistantConnection List all the available SmartAssistant require MeActions.smartAssistantsManage
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

storyAlerts - StoryAlertConnection Get all the alerts on contents
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

organizations - [Organization!]! List all the available Organization
auditLogExportURL - URL Get the URL of the CSV export of audit log
Arguments
fromDate - IsoDateTime

Lower date limit for the data date range (inclusive)

toDate - IsoDateTime

Upper date limit for the data date range (exclusive)

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

EXISTING_USER

A user already exists with the same email

INVALID_PASSWORD

The given Password is invalid

INVALID_PLAN

The given Plan is invalid

INVALID_TOKEN

The given Token is invalid or expired
Example
"EXISTING_USER"

InstanceActivateErrors

Description

Possile errors of the InstanceActivate mutation

Example
InvalidInputError

InstanceActivateInput

Description

Input type for Mutation instanceActivate

Fields
Input Field Description
company - String Name of the company owning the instance
password - String! Password of the first user (associated with the user of the token)
token - UUID! Token provided by the instance activation
workPhone - String Work phone of the current user
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

PermissionError

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

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

Description

Contact information for the instance

Fields
Field Name Description
dpoTitle - String Title of the Data Protection Officer
dpoUser - User Data Protection Officer User
Example
{
  "dpoTitle": "xyz789",
  "dpoUser": User
}

InstanceContactsUpdateErrors

Description

Error Type of the instanceContactsUpdate Mutation

Types
Union Types

PermissionError

Example
PermissionError

InstanceContactsUpdateInput

Description

Input type for Mutation instanceContactsUpdate

Fields
Input Field Description
dpoTitle - String Title of the Data Protection Officer
dpoUserId - ID Global Id of the Data Protection Officer User
Example
{
  "dpoTitle": "abc123",
  "dpoUserId": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}

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

PermissionError

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

PermissionError

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

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

STARTED

The export is in progress internal state not broadly available for users

READY

The export is ready to be downloaded

ARCHIVED

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

ALL

Export all data, including history of versions, comments, ...

SIMPLIFIED

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
name - String!

Code of the feature to check ex: ui.feature.brol

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

PermissionError

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

Fields
Field Name Description
engagePayload - JSON Payload sent to fullstory to better segment the sessions
orgId - String Organisation identifier at Fullstory
userId - String Unique identifier for this user to use in fullstory
Example
{
  "engagePayload": {},
  "orgId": "abc123",
  "userId": "xyz789"
}

InstanceGoogleAnalytics

Description

Configuration of Google analytics Integration for the instance

Fields
Field Name Description
active - Boolean Is the Integration enabled for end users
trackingId - String Tracking ID of google analytics looks like UA-000000-2
Example
{"active": false, "trackingId": "xyz789"}

InstanceGoogleAnalyticsUpdateErrors

Description

Error Type of the instanceGoogleAnalyticsUpdate Mutation

Types
Union Types

PermissionError

Example
PermissionError

InstanceGoogleAnalyticsUpdateInput

Description

Input type for Mutation instanceGoogleAnalyticsUpdate

Fields
Input Field Description
active - Boolean Should the integration be activated or deactivated
trackingId - String Tracking ID of google analytics to setup looks like UA-000000-2
Example
{"active": false, "trackingId": "abc123"}

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

PermissionError

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

Description

Deprecated

Fields
Field Name Description
appId - String Deprecated unused service
engagePayload - JSON Deprecated unused service
Example
{"appId": "xyz789", "engagePayload": {}}

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

PermissionError

Example
PermissionError

InstanceInvoiceUpdateInput

Description

Input type for Mutation instanceInvoiceUpdate

Fields
Input Field Description
id - String! Id of the invoice to update
reference - String Client provided reference for the invoice
Example
{
  "id": "abc123",
  "reference": "xyz789"
}

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

Example
PermissionError

InstanceLabFlagUpdateInput

Description

Input type for Mutation instanceLabFlagUpdate

Fields
Input Field Description
activate - Boolean! Should the flag be activated or deactivated
name - OpaqueID! Name of the Flag to update
Example
{
  "activate": false,
  "name": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}

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

PermissionError

Example
PermissionError

InstanceMicrosoftTeamsUpdateInput

Description

Input type for Mutation instanceMicrosoftTeamsUpdate

Fields
Input Field Description
activate - Boolean! Activate or disable the integration for the whole instance
clearToken - Boolean! Clear the currently installed token. Default = false
Example
{"activate": false, "clearToken": false}

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

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

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

PermissionError

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

Description

Refiner.io configuration.

Fields
Field Name Description
engagePayload - JSON Returns the data needed to configure Refiner.io. It returns nothing
projectId - String Returns the project identifier for Refiner.io
Example
{"engagePayload": {}, "projectId": "xyz789"}

InstanceScimConfig

Description

Configuration of the Instance's SingleSignOn

Fields
Field Name Description
scimTenant - String SCIM tenant URL
scimToken - String SCIM connection token
Example
{
  "scimTenant": "abc123",
  "scimToken": "xyz789"
}

InstanceScimConfigUpdateErrors

Description

Error Type of the instanceScimConfigUpdate Mutation

Example
PermissionError

InstanceScimConfigUpdateInput

Description

Input type for Mutation instanceScimConfigUpdate

Fields
Input Field Description
createScimToken - Boolean Set to true to generate a new scim token
deleteScimToken - Boolean Set to true to delete the current scim token
Example
{"createScimToken": false, "deleteScimToken": true}

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

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
}

InstanceSharePoint

Description

Configured SharePoint integration for the current instance

Fields
Field Name Description
active - Boolean True if a platform admin activated the feature toggle it with instanceSettingsUpdate
searchTabs - [SharePointSearchTab!] List of configured SharePointSearchTab that can be searched by users You must then use me.sharePointSearch with the tabId of the SharePointSearchTab
Example
{"active": true, "searchTabs": [SharePointSearchTab]}

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

PermissionError

Example
PermissionError

InstanceSlackUpdateInput

Description

Input type for Mutation instanceSlackUpdate

Fields
Input Field Description
activate - Boolean! Disable the slack integration for everyone
clearToken - Boolean! Clear the currently installed token. Default = false
Example
{"activate": true, "clearToken": false}

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

NAME

Order by Space name

STATUS

Order by status space (enabled, closed, pending)

GROUP_NAME

Order by the SpaceGroup name

TYPE

Order by SpaceType

IS_DEFAULT

Order by default spaces first

MEMBERS_COUNT

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

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
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

team - ID

Global ID of the Team you want to filter on (if any)

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
alertId - ID

Alert Global Id Alert.id. If passed, get results for this alert instead of the activity digest

fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

tickInterval - DateInterval!

The interval size of every data point

team - ID

Global ID of the Team you want to filter on (if any)

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
alertId - ID

Alert Global Id Alert.id. If passed, get results for this alert instead of the activity digest

fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

tickInterval - DateInterval!

The interval size of every data point

team - ID

Global ID of the Team you want to filter on (if any)

commentsTrends - TimeSeries Trend of the comments post over the requested period
Arguments
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

tickInterval - DateInterval!

The interval size of every data point

team - ID

Global ID of the Team you want to filter on (if any)

resharesTrends - TimeSeries Trend of the reshares posted over the requested period
Arguments
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

tickInterval - DateInterval!

The interval size of every data point

team - ID

Global ID of the Team you want to filter on (if any)

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
Arguments
first - Int!

Returns the first n elements from the list.

after - String

Returns the elements in the list that come after the specified cursor.

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
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

first - Int!

Returns the first n elements from the list.

after - String

Returns the elements in the list that come after the specified cursor.

team - ID

Global ID of the Team you want to filter on (if any)

inactiveUsers - UserConnection List of inactive users since at least 30 days. Optionally filter by a team.
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

team - ID

Global ID of the Team you want to filter on (if any)

likesTrends - TimeSeries Trend of the likes of the stories and story comments over the requested period
Arguments
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

tickInterval - DateInterval!

The interval size of every data point

team - ID

Global ID of the Team you want to filter on (if any)

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
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

first - Int!

Returns the first n elements from the list.

after - String

Returns the elements in the list that come after the specified cursor.

team - ID

Global ID of the Team you want to filter on (if any)

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
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

first - Int!

Returns the first n elements from the list.

after - String

Returns the elements in the list that come after the specified cursor.

team - ID

Global ID of the Team you want to filter on (if any)

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
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

team - ID

Global ID of the Team you want to filter on (if any)

first - Int!

Returns the first n elements from the list.

after - String

Returns the elements in the list that come after the specified cursor.

pendingUserCount - Int! Total number of users that didn't finish the registration process
Arguments
team - ID

Global ID of the Team you want to filter on (if any)

publicationsTrends - TimeSeries Evolution of the number of publications over the requested period publications mean New content beeing created (STORY_PUBLISH)
Arguments
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

tickInterval - DateInterval!

The interval size of every data point

team - ID

Global ID of the Team you want to filter on (if any)

updatesTrends - TimeSeries Evolution of the new versions of contents over the requested period this will count update on contents (regular, silent) not draft
Arguments
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

tickInterval - DateInterval!

The interval size of every data point

team - ID

Global ID of the Team you want to filter on (if any)

searchCount - Int! Number of search perfomed durint the period
Arguments
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

team - ID

Global ID of the Team you want to filter on (if any)

searchUsersCount - Int! Number of distinct users who performed a search during the period
Arguments
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

team - ID

Global ID of the Team you want to filter on (if any)

spaceApprovalsStats - ActiveSpaceTableResult List number of approval per spaces and their statuses possible keys are:
Arguments
first - Int!

Returns the first n elements from the list.

after - String

Returns the elements in the list that come after the specified cursor.

topSearches - TopSearchesTableResult Get the Top search phrases for a given period
Arguments
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

first - Int!

Returns the first n elements from the list.

after - String

Returns the elements in the list that come after the specified cursor.

team - ID

Global ID of the Team you want to filter on (if any)

totalUniqueDeliveredDigest - Int! Number of unique people who have received a digest or a shared Alert also see activityDigestDelivered
Arguments
alertId - ID

Alert Global Id Alert.id. If passed, get results for this alert instead of the activity digest

fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

team - ID

Global ID of the Team you want to filter on (if any)

totalUniqueOpenDigest - Int! Number of unique people who have opened a digest or a shared Alert also see activityDigestOpen
Arguments
alertId - ID

Alert Global Id Alert.id. If passed, get results for this alert instead of the activity digest

fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

team - ID

Global ID of the Team you want to filter on (if any)

totalUniqueMailOpenDigest - Int! Number of unique email of Activity Digest or Alert that has been opened on the period
Arguments
alertId - ID

Alert Global Id Alert.id. If passed, get results for this alert instead of the activity digest

fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

team - ID

Global ID of the Team you want to filter on (if any)

totalUniqueMailDeliveredDigest - Int! Number of unique email of Activity Digest or Alert that has been delivered on the period
Arguments
alertId - ID

Alert Global Id Alert.id. If passed, get results for this alert instead of the activity digest

fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

team - ID

Global ID of the Team you want to filter on (if any)

totalUserCount - Int! Total number of users
Arguments
team - ID

Global ID of the Team you want to filter on (if any)

usersActivity - TimeSeries Get distinct count of active users on a product (null means all products). Optionally limited to the members of a team.
Arguments
source - EventSource

Filter results on a specific source. If null, count all sources, if provided , only take activity made through this source

fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

tickInterval - DateInterval!

The interval size of every data point

team - ID

Global ID of the Team you want to filter on (if any)

viewsTrends - TimeSeries Trend of the unique views of the stories over the requested period
Arguments
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

tickInterval - DateInterval!

The interval size of every data point

team - ID

Global ID of the Team you want to filter on (if any)

answerAsk - TimeSeries Get number of question asked to answer
Arguments
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

tickInterval - DateInterval!

The interval size of every data point

team - ID

Global ID of the Team you want to filter on (if any)

answerFeedbackPositive - TimeSeries Get number of positive feedback on question asked to answer
Arguments
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

tickInterval - DateInterval!

The interval size of every data point

team - ID

Global ID of the Team you want to filter on (if any)

answerFeedbackNegative - TimeSeries Get number of negative feedback on question asked to answer
Arguments
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

tickInterval - DateInterval!

The interval size of every data point

team - ID

Global ID of the Team you want to filter on (if any)

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
Arguments
seats - Int

Number of seats to pay for

planId - ID

Plan against which the estimation is made

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.
Arguments
first - Int!

Returns the first n elements from the list.

after - String

Returns the elements in the list that come after the specified cursor.

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
Arguments
planId - OpaqueID

Plan against which the payment is made

seats - Int

Number of seats to pay for

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

ACTIVE

The subscription is currently active.

CANCELLED

The subscription has been cancelled and the instance will shutdown after the grace period

FUTURE

The subscription is scheduled for a future date.

IN_TRIAL

The subscription is in a trial period.

NON_RENEWING

The subscription does not renew automatically.

PAUSED

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 InstanceLimits.whiteLabel

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

PermissionError

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

Fields
Input Field Description
paymentIntentId - OpaqueID The ID of the payment intent to update the subscription with obtained from paymentIntent field in chargebee
planId - OpaqueID The new plan to update the subscription with
seats - Int Number of paying seats to update the subscription with
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

Fields
Field Name Description
adminsCount - Int Current number of "paying admins
pipelinesCount - Int Number of EmailPipeline
seatsCount - Int Number of paying seats used
sharedAlertsCount - Int Number of shared Alert at instance level
spaceGroupsCount - Int Number of SpaceGroup
Example
{
  "adminsCount": 123,
  "pipelinesCount": 123,
  "seatsCount": 987,
  "sharedAlertsCount": 123,
  "spaceGroupsCount": 123
}

InstanceWorkplace

Description

Details about the Facebook Workplace integration of the instance

Fields
Field Name Description
active - Boolean True if a platform admin activated the feature
installed - Boolean True if a workplace access token is stored
setupUrl - URL Url to follow in order to setup the elium <=> workplace integration
Example
{
  "active": false,
  "installed": false,
  "setupUrl": "http://www.test.com/"
}

InstanceWorkplaceUpdateErrors

Description

Error Type of the instanceWorkplaceUpdate Mutation

Types
Union Types

PermissionError

Example
PermissionError

InstanceWorkplaceUpdateInput

Description

Input type for Mutation instanceWorkplaceUpdate

Fields
Input Field Description
activate - Boolean Enable the workplace integration if True (disable if False)
clearCredentials - Boolean Remove the stored credentials if True
Example
{"activate": true, "clearCredentials": false}

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

Description

Represent the error when a supplied format doesn't match what is expected

Fields
Field Name Description
path - String! Path of the field leading to the error
message - String! A message describing the issue
Example
{
  "path": "xyz789",
  "message": "xyz789"
}

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

Description

Represent the error when doing the provided password is Invalid

Fields
Field Name Description
path - String! Path of the field leading to the error
message - String! A message describing the issue
Example
{
  "path": "abc123",
  "message": "xyz789"
}

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

NOT_PAID

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.

PAID

Indicates a paid invoice.

PAYMENT_DUE

Indicates the payment is not yet collected and is being retried as per retry settings.

PENDING

The invoice is yet to be closed (sent for payment collection).

POSTED

Indicates the payment is not yet collected and will be in this state till the due date to indicate the due period

VOIDED

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

Description

Description of a Feature activable by admin

Fields
Field Name Description
name - OpaqueID! Id of the feature as understood by the backend
value - Boolean Is the feature currently enabled
Example
{
  "name": "eWVhaCByaWdodCBpdCdzIGI2NA==",
  "value": false
}

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

Fields
Field Name Description
label - String! Label of the language
lang - Lang! Language code
totalCount - Int! Number of content in this language matching the criterias
Example
{
  "label": "xyz789",
  "lang": "fr",
  "totalCount": 123
}

Language

Description

A language description

Fields
Field Name Description
lang - String! ISO 639-1 code of the language
name - String! Name of the language in the user's prefered lang
Example
{
  "lang": "abc123",
  "name": "abc123"
}

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
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

liked - Boolean! Is the current user liking this object
Possible Types
Likeable Types

Comment

Story

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

EMBEDDED

The link is embeded in the tab as an" iframe"

LINK

The link is opened if the user click on the tab
Example
"EMBEDDED"

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

BIG

The logo is displayed in a "big" size arround 400x400

NO_LOGO

No logo is displayed

SMALL

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
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

aiCompletion - String AI editor integration requires features.aiEditor
Arguments
systemPrompt - String

Sytem prompt to complete

userPrompt - String

User provided part of the prompt

temperature - Int

What sampling temperature to use, between 0 and 200. Higher values like 80 will make the output more random, while lower values like 20 will make it more focused and deterministic.

annotations - AnnotationConnection Return a list of opened annotations on the content you owned
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

smartConversations - SmartConversationConnection List active smartConversation for the current user
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

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
query - String

An optional filter text to look for Shared Alert's title

before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

orderBy - AlertOrderBy!

Specify how to order the results. See AlertOrderBy

myAlerts - AlertConnection List of Alert created and owned by Me
Arguments
query - String

An optional filter text to look for Shared Alert's title

before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

orderBy - AlertOrderBy!

Specify how to order the results. See AlertOrderBy

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
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

boxes - [Box!]! Deprecated part of old homepage
completeStories - [Story!]! Auto Complete search a content in a given space (or not) excluding content via exclude
Arguments
query - String!

QueryString to search in content

spaceId - ID

Search content in a given Space (provide the Space.id)

exclude - [ID!]

Exclude list of provided contents ids from the results (list of Story.id)

excludePersonal - Boolean!

Do not include contents from personal space

contentFeed - StoryConnection Returns the content feed with given connection params ordered by added datetime and only the content added after afterDate when provided.
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

afterDate - IsoDateTime

Only return content added after this date

contentFromSuccessions - StoryConnection List of the content you have inherit from successions to process
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

deviceTokens - [MeDeviceToken!] List of Mobile devices (token) of the current user
directory - DirectorySearchResponse! Search the directory for Users
Arguments
query - DirectorySearchQuery!

The query to search for

drafts - StoryConnection List all the draft the current user is working on (as owner or contributor)
Arguments
filter - DraftsFilter!

Filter the drafts to return

before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

events - StoryConnection List events the current user is invited to the feature is deprecated
Arguments
filter - EventFilter!

Filter the events to return by rsvp or time of occurence

before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

facets - [Facet!]! Fetch list of available Facet for the current user
Arguments
filter - MeFacetFilter!

Filter the facets to return (global or All)

feed - ActivityFeedItemConnection Old Activity feed on the homepage
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

fromCursor - ID

Filter the feed after a given cursor

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 User , Team or Space matching the query usually for a @mention

mention can also be used to invite users to an event, contributors, ...

Arguments
query - String

Search query to match results against

spaceId - ID

Filter users/team that are members of a given Space

storyId - ID

Filter users/team that can view the given content see also canEdit field.

users - Boolean!

Include Users in the results

groups - Boolean!

Include Spaces in the results

teams - Boolean!

Include Teams in the results

canEdit - Boolean!

Filter users that can have the abilty to edit the given content work in compbinaison with storyId or spaceId and Only for User results if false, all viewers will be returned

eventInvite - Boolean!

True if the intent is to invite users to an event

includeDisabled - Boolean!

Filter to include or exclude Disabled users. If disabled users are include the visibilty check passed via storyId or spaceId won't be applied as by definitions those won't work.

exclude - [ID!]

Exclude/skip the given items from the results

ownedContentWithAnnotations - StoryConnection Returns a connection of contents that you are responsible for, that contains "open" annotations.
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

myContent - StoryConnection Returns a connection of contents where you are owner or contributor.
Arguments
content - MyContentFilter!

Filter content base on criteria, like content you own, content needing an approval, ...

expire - ExpireFilter!

Filter contents based on expiration status

before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

notifications - NotificationConnection List the user"s notifications
Arguments
filter - NotificationFilter!

Filter notifications based on criteria (all, unread, read, ...)

before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

notificationsPreferences - MeNotificationsPreferences! User's notifications preferences
personalContent - StoryConnection Returns all the contents in the Personal Content space.
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

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
query - QuickSearchQuery!

Search Criterion

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
limit - Int!

Limit the number of returned results maxmium 10 will be returned.

schemas - [StorySchema!]! Returns a list of schemas for the current user
Arguments
installed - Boolean!

filters schemas with an active status

onlyGlobals - Boolean!

filters schemas installed globally versus linked to a list of Space

filter - String

filters based on the queried schema name (in the content lang of the user)

search - StorySearchResponse Search content using a variety of criteria used for "Advanced search"
Arguments
context - StorySearchContext!

Filtering context for the search

contextId - ID

Global ID of the Reference Object of the context (Space.id when context is SPACE for example) or null if not required by the context

query - StorySearchQuery!

Search Criterion

recordAnalytics - Boolean!

Where there you want the search query to be recorded, for analytics it will only record the query if "stories" field is asked

searchGlobalTags - [TagResult!] Search Tags that are not scoped to a given space
Arguments
text - String!

Search query to match results against

searchTags - [TagResult!] Search Tags that are scoped to any one of the given spaces
Arguments
text - String!

Search query to match results against

spaces - [ID!]!

Filter results to tags that are scoped to any one of the given spaces

searchHashtags - [HashtagResult!] Search Hashtags
Arguments
text - String

Search query to match results against

hashtags - HashtagConnection Return a list of all available Hashtag
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

smartFeeds - SmartFeedConnection List all the available SmartFeed for a the current user
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

smartAssistants - SmartAssistantConnection List all the available SmartAssistant for a the current user
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

spaceGroups - SpaceGroupConnection List the space groups where there are spaces that the user is member of
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

query - String

Filter Space groups by name

spaces - SpaceConnection List the spaces where the user is member has access to or is member (following the filter criteria)
Arguments
filter - SpaceFilter!

Filter spaces results by special criteria (only the spaces where the user is member, only the spaces where the user is member and has access to, ...)

query - String

Filter results by name

withoutSpaceGroup - Boolean!

Exclude spaces with SpaceGroups

promotedInSidebar - Boolean

Filter spaces that are promoted in sidebar (null => no filter, true => only the sidebar promoted, false => only the not sidebar promoted)

promotedInOverview - Boolean

Filter spaces that are promoted in overview (null => no filter, true => only the overview promoted, false => only the not overview promoted)

includeFavorite - Boolean

Filter based on favorite status for current user (null => no filter, true => only favorited, false=> only not favorited)

before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

storiesByAsset - [Story!]! Deprecated No longer available
Arguments
asset - StoryAssetInput!

asset to look

storyAlerts - StoryAlertConnection Get all the active alerts on contents
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

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

InvalidPasswordError

Example
InvalidPasswordError

MeActivateTwoFactorInput

Description

Input type for Mutation meActivateTwoFactor

Fields
Input Field Description
currentPassword - String! Password for the user to be able to activate Two Factor Authentication
verificationCode - String! Two Factor Authentication verification code to activate the feature
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)
Arguments
first - Int!

Returns the first n elements from the list.

after - String

Returns the elements in the list that come after the specified cursor.

preferedPublicationHour - Int Preferred hour of publication (0 is midnight UTC) if a any, else null
Arguments
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

engagementSummary - MeEngagementSummary! Fetch a summary of the activity You generated over the period
Arguments
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

ownedContentsSummary - MeAnalyticsSummary! Fetch a summary of the activity generated by the content you owned
Arguments
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

publishedContentsSummary - MeAnalyticsSummary! Fetch a summary of the activity generated by the content you've published during the period
Arguments
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

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
query - SemanticSearchQuery!

Search Crtierions for the search

answer - Answer AI-powered question answering
Arguments
query - String!

Natural language question to ask the AI

lang - Lang

Override of the usual content language see me.contentLang

method - AnswerMethod

Select answer method to use

mode - AnswerLogMode!

Usage mode might influence the feedback loop and how questions are logged

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

Description

Return Type of Mutation meBookmarksClear

Fields
Field Name Description
clientMutationId - String A unique identifier for the client performing the mutation. unused, will be deleted
me - Me! Currently authenticated user.
Example
{
  "clientMutationId": "xyz789",
  "me": Me
}

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

ANDROID

Google Android OS https://www.android.com

IOS

Apple iOS https://www.apple.com/ios
Example
"ANDROID"

MeDeviceTokenPublishErrors

Description

Error Type of the meDeviceTokenPublish Mutation

Types
Union Types

ObjectNotFoundError

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

ObjectNotFoundError

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

Description

Return Type of Mutation meDisclaimerAccept

Fields
Field Name Description
clientMutationId - String A unique identifier for the client performing the mutation. unused, will be deleted
me - Me! Currently authenticated user.
Example
{
  "clientMutationId": "abc123",
  "me": Me
}

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

All available facets

GLOBAL

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

Description

Return Type of Mutation meNotificationsPreferences

Fields
Field Name Description
clientMutationId - String A unique identifier for the client performing the mutation. unused, will be deleted
me - Me The current user
Example
{
  "clientMutationId": "xyz789",
  "me": Me
}

MePasswordChangeErrors

Description

Error Type of the mePasswordChange Mutation

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
effective - Boolean!

If effective is true, and the user did not set a homepage, the instance configuration will be returned. the default homepage otherwise.

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
type - MeServiceType!

The type of service to retrieve.

refresh - Boolean!

If true, the service information will be refreshed.

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

Default homepage setting.

FEED

Feed homepage setting. (feed of latest contents)

OVERVIEW

Overview homepage setting. (overview of spaces and space groups)
Example
"DEFAULT"

MePreferencesOverview

Description

Overview preferences for the user's homepage.

Values
Enum Value Description

SPACES

Overview showing spaces.

SPACE_GROUPS

Overview showing space groups.
Example
"SPACES"

MePreferencesUpdateErrors

Description

Error Type of the mePreferencesUpdate Mutation

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

Description

Return Type of Mutation mePresenceUpdate

Fields
Field Name Description
clientMutationId - String A unique identifier for the client performing the mutation. unused, will be deleted
me - Me The current user
Example
{
  "clientMutationId": "xyz789",
  "me": Me
}

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

Description

Return Type of Mutation meProfileSetupComplete

Fields
Field Name Description
clientMutationId - String A unique identifier for the client performing the mutation. unused, will be deleted
me - Me The current user
Example
{
  "clientMutationId": "abc123",
  "me": Me
}

MeRemoveTwoFactorErrors

Description

Error Type of the meRemoveTwoFactor Mutation

Example
PermissionError

MeRemoveTwoFactorInput

Description

Input type for Mutation meRemoveTwoFactor

Fields
Input Field Description
currentPassword - String! Current password verification to change the 2FA settings
verificationCode - String! Verification code provided by the 2FA system, if enabled.
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

Example
GoogleMeService

MeServiceResetInput

Description

Input type for Mutation meServiceReset

Fields
Input Field Description
type - MeServiceType! Type of Service to reset
Example
{"type": "GOOGLE"}

MeServiceResetPayload

Description

Return Type of Mutation meServiceReset

Fields
Field Name Description
clientMutationId - String A unique identifier for the client performing the mutation. unused, will be deleted
me - Me The current user
Example
{
  "clientMutationId": "xyz789",
  "me": Me
}

MeServiceTokenErrors

Description

Error Type of the meServiceToken Mutation

Types
Union Types

InvalidInputError

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 / Google Drive

MICROSOFT_TEAMS

Microsoft Teams

ONEDRIVE

Microsoft OneDrive

SLACK

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

Description

Return Type of Mutation meTokenReset

Fields
Field Name Description
clientMutationId - String A unique identifier for the client performing the mutation. unused, will be deleted
me - Me The current user
Example
{
  "clientMutationId": "abc123",
  "me": Me
}

MeTokenType

Description

Type of Token for the meTokenReset mutation

Values
Enum Value Description

API

Deprecated. Use MOBILE_APPS

ATOM

Token for the RSS feed of search results

ICS

Token for ical integration

MOBILE_APPS

Token for the mobile Apps
Example
"API"

MediaTypeResult

Description

Facet of the Media Type

Fields
Field Name Description
assetsCount - Int! Number of assets of the given media type
mediaType - MimeType! Media type
totalCount - Int! Number of stories of the given media type
Example
{
  "assetsCount": 123,
  "mediaType": "image/png",
  "totalCount": 987
}

MentionResult

Description

Possible Object types for Mention in content

Types
Union Types

User

Space

Team

Example
User

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

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

Description

Description of the Microsoft Teams Channel

Fields
Field Name Description
id - OpaqueID External ID of the channel
name - String Human readable name of the channel
Example
{
  "id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
  "name": "abc123"
}

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.
Arguments
teamId - ID!

Filter by Ms Team ID

name - String

Filter channel by name

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

Example
ObjectNotFoundError

MicrosoftTeamsSpacesToChannelRemoveInput

Description

Input type for Mutation microsoftTeamsSpacesToChannelRemove

Fields
Input Field Description
channelId - String! The channel ID of the MS Teams channel to unlink.
spaceId - ID! The Node ID of the space to unlink.
Example
{
  "channelId": "xyz789",
  "spaceId": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}

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

Example
ObjectNotFoundError

MicrosoftTeamsSpacesToChannelUpdateInput

Description

Input type for Mutation microsoftTeamsSpacesToChannelUpdate

Fields
Input Field Description
channelId - String! MS Teams channel Id
channelName - String! The human readable name of the MS Teams channel.
spaceId - ID! The Node ID of the space to link.
teamId - String! the id of the MS Teams
teamName - String! The name of the MS Teams
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

Example
ObjectNotFoundError

MicrosoftTeamsTabEmbedInput

Description

Input type for Mutation microsoftTeamsTabEmbed

Fields
Input Field Description
channelId - String! MS Teams channel Id
tabId - ID! The Node ID of the SpaceTab to embed.
teamId - String! id of the MS team
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

Description

A Team in Microsoft Teams

Fields
Field Name Description
id - OpaqueID External ID of the team in MS Teams
name - String Human readable name of the team
Example
{
  "id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
  "name": "xyz789"
}

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

MyContentFilter

Description

Filter about my content

Values
Enum Value Description

ALL

Return All the content visible

CONTRIBUTOR

select content where you are contributor

OWNER

let you select content where you are owner only

OWNED_APPROVAL

Select All contents with an StoryApproval in progress requested by you.

OWNED_PUBLISHED

Select All contents that are Published (niether draft nor archived)

TO_APPROVE

Select All contents where there is a StoryApproval pending for your review (where you are assigned)
Example
"ALL"

Node

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

Fields
Input Field Description
clientSubscriptionId - String A unique identifier for the client performing the subscription.
id - ID! Global NodeID of the related Me object
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

Description

Input type for notificationCount Subscription

Fields
Input Field Description
clientSubscriptionId - String A unique identifier for the client performing the subscription.
id - ID! Node ID of the Me object
Example
{
  "clientSubscriptionId": "abc123",
  "id": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}

NotificationCountPayload

Description

Return Type of notificationCount Subscription

Fields
Field Name Description
clientSubscriptionId - String A unique identifier for the client performing the subscription.
me - Me The current user
Example
{
  "clientSubscriptionId": "abc123",
  "me": Me
}

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

ALL

Get all Notifications

PINNED

Select only "pinned" notifications

UNREAD

Select only notifications that haven't been read yet

UNSEEN

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

ANNOTATION

Related Object is an Annotation

STORY_APPROVAL

Related Object is a StoryApproval

ANNOTATION_COMMENT

Related Object is an AnnotationComment

COMMENT

Related Object is an Comment

SPACE

Related Object is an Space

STATUS

Deprecated Does not exists anymore

STORY

Related object is of type Story

USER

Related Object is an User

BROADCAST

Related Object is a StoryBroadcast
Example
"ANNOTATION"

NotificationPinErrors

Description

Error Type of the notificationPin Mutation

Types
Union Types

ObjectNotFoundError

Example
ObjectNotFoundError

NotificationPinInput

Description

Input type for Mutation notificationPin

Fields
Input Field Description
id - ID! Node ID of the Notification object to pin
pinned - Boolean! Pinned status to apply to the notification (pin:true)
Example
{
  "id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
  "pinned": false
}

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

Fields
Input Field Description
clientSubscriptionId - String A unique identifier for the client performing the subscription.
id - ID! Node ID of the Notification object to subcribe to
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

APPROVE

The related object has been approved

ASSIGN

The related object has been assigned to the current user

ASSIGN_USER

The related object has been assigned to another user

FOLLOW

User followed another user, deprecated unused

INHERIT

User got contents from another user he need to reassign or classifiy

INVITE_CONTRIBUTE

User is invited to contribute to the related object

INVITE_EVENT

User is invited to an Event

GRANT

User got new permissions on a given object (usually Story)

JOIN

User Joined the related object (usally a Space)

LIKE

A user liked the related object

MENTION

User has been mentionned on related object

PING

The user notified to read the related object

POST

A new related object has been created

REQUEST_CORRECTION

A correction was requested on related object

RESOLVE

The related object was marked as Resolved

RESHARE

The related object was reshared

VERSION_DRAFT

A new draft has been saved

VERSION_PUBLISHED

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

Description

Return Type of Mutation notificationsReadAll

Fields
Field Name Description
clientMutationId - String A unique identifier for the client performing the mutation. unused, will be deleted
me - Me Current User
Example
{
  "clientMutationId": "xyz789",
  "me": Me
}

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

Description

Return Type of Mutation notificationsSeenAll

Fields
Field Name Description
clientMutationId - String A unique identifier for the client performing the mutation. unused, will be deleted
me - Me The current user
Example
{
  "clientMutationId": "abc123",
  "me": Me
}

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

Fields
Input Field Description
clientSubscriptionId - String A unique identifier for the client performing the subscription.
id - ID! Node ID of the Instance object to subcribe to
Example
{
  "clientSubscriptionId": "abc123",
  "id": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}

OnboardingStepCompletedPayload

Description

Return Type of onboardingStepCompleted Subscription

Fields
Field Name Description
clientSubscriptionId - String A unique identifier for the client performing the subscription.
instance - Instance The updated current instance
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

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

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

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

LOW

Ensures the password is different from the user name.

MEDIUM

Also requires the password to be minimum 8 characters long and to contain enough different characters.

HIGH

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

MONTHLY

Renewed every month

SEMESTRIALLY

Renewed every 6 months

YEARLY

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

URLPublicAsset

FilePublicAsset

DrawingPublicAsset

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

Description

Mixpanel information for public shared content

Fields
Field Name Description
host - String! Mixpanel host
token - String! Mixpanel Public token
engagePayload - JSON! Base informations to send to mixpanel
Example
{
  "host": "xyz789",
  "token": "abc123",
  "engagePayload": {}
}

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
assets - [UUID!]

Filter the assets by their UUID (all if not provided)

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

SPACE

In a Space

GLOBAL

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

CreoleRichContent

HTMLRichContent

SlateRichContent

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

CREOLE

Python Creole https://github.com/jedie/python-creole/ (Deprecated) Unused format except some old comments

DRAFTJS

DraftJS encoded state https://draftjs.org/ (Deprecated) Unused format except some old comments

HTML

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

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

INVITED

The user is invited to the event

MAYBE

The user has responded to the event with a maybe

NO

The user has declined the event

YES

The user has accepted the event
Example
"INVITED"

RsvpResult

Description

Result of a RSVP Facet

Fields
Field Name Description
rsvp - Rsvp! The RSVP status
totalCount - Int! The number of content with this RSVP status matching the query
Example
{"rsvp": "INVITED", "totalCount": 987}

Saml2DigestAlgo

Description

Digest algorithms used in SAML2.

Values
Enum Value Description

SHA1

SHA-1 hashing algorithm.

SHA256

SHA-256 hashing algorithm.

SHA384

SHA-384 hashing algorithm.

SHA512

SHA-512 hashing algorithm.
Example
"SHA1"

Saml2SignatureAlgo

Description

Signature algorithms used in SAML2.

Values
Enum Value Description

RSA_SHA1

RSA with SHA-1 hashing.

DSA_SHA1

DSA with SHA-1 hashing.

RSA_SHA256

RSA with SHA-256 hashing.

RSA_SHA384

RSA with SHA-384 hashing.

RSA_SHA512

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
Arguments
query - String!

Search query

limit - Int!

Max Number of results to return

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

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

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

DATE_ONLY

type: DATETIME, Hint datetime is truncated to Date only

EMAIL

type: STRING, Hint string is a valid Email

MULTILINE

type: STRING, Hint string is a multiline text

PHONE

type: STRING, Hint string is a Phone number

SEPARATOR_H1

For separator, Hint the separator is a Level 1 Header

SEPARATOR_H2

For separator, Hint the separator is a Level 2 Header

SKYPE

type: STRING, Hint string is a Skype address

URL

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

Example
ObjectNotFoundError

SchemaAttributeOptionCreateInput

Description

Input type for Mutation schemaAttributeOptionCreate

Fields
Input Field Description
id - ID! Global ID of the SchemaAttribute in which the option should be created
value - String! Name Value of the new option to create ie: the name of the tag
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

SchemaSeparator

SchemaAttribute

Example
SchemaSeparator

SchemaAttributeUpdateErrors

Description

Error Type of the schemaAttributeUpdate Mutation

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

IMPORTANT

Attribute is used on the Top of the Story's body

MANDATORY

Attribute is mandatory for the Story

NORMAL

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

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

Fields
Input Field Description
url - String Url of the search page triggering the feedback
message - String! Accompanying message about the missing element
searchToken - String! searchToken of the related search. Comes from StorySearchResponse.searchToken or QuickSearchResponse.searchToken
Example
{
  "url": "abc123",
  "message": "abc123",
  "searchToken": "abc123"
}

SearchFeedbackPayload

Description

Return Type of Mutation searchFeedback

Fields
Field Name Description
clientMutationId - String A unique identifier for the client performing the mutation. unused, will be deleted
me - Me Current User
Example
{
  "clientMutationId": "xyz789",
  "me": Me
}

SearchHistoryPostInput

Description

Input type for Mutation searchHistoryPost

Fields
Input Field Description
query - String! Query string used for the search
Example
{"query": "abc123"}

SearchHistoryPostPayload

Description

Return Type of Mutation searchHistoryPost

Fields
Field Name Description
clientMutationId - String A unique identifier for the client performing the mutation. unused, will be deleted
me - Me Current User
Example
{
  "clientMutationId": "xyz789",
  "me": Me
}

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"
}

Share

Description

ReSharing details about a content

Fields
Field Name Description
posted - IsoDateTime Date of the re share
rich - RichContent Rich comment about the re share acompanying the content
Example
{
  "posted": "2016-10-07T01:08:03.420Z",
  "rich": RichContent
}

SharePointAddSearchTabError

Description

Error Type of the sharePointAddSearchTab Mutation

Example
PermissionError

SharePointAddSearchTabInput

Description

Input type for Mutation sharePointAddSearchTab

Fields
Input Field Description
names - TranslatedString! Names for this tab
sites - [SharePointSiteInput!]! List of SharepointSite to add to the tab
Example
{
  "names": {"en": "a Name", "fr": "Un Nom"},
  "sites": [SharePointSiteInput]
}

SharePointAddSearchTabPayload

Description

Return Type for Mutation sharePointAddSearchTab

Fields
Field Name Description
searchTab - SharePointSearchTab A unique identifier for the client performing the mutation.
clientMutationId - String A unique identifier for the client performing the mutation. unused, will be deleted
instance - Instance The updated current instance
errors - [SharePointAddSearchTabError!] Errors of the mutation.
Example
{
  "searchTab": SharePointSearchTab,
  "clientMutationId": "abc123",
  "instance": Instance,
  "errors": [PermissionError]
}

SharePointIntegration

Description

Explore informations about connected Sharepoints instance like list sites

Fields
Field Name Description
sites - [SharePointSite!] SharePoint sites matching query, returned from the MS graph
Arguments
query - String!

Filter SharePointSite by name

Example
{"sites": [SharePointSite]}

SharePointRemoveSearchTabError

Description

Error Type of the sharePointRemoveSearchTab Mutation

Example
PermissionError

SharePointRemoveSearchTabInput

Description

Input type for Mutation sharePointRemoveSearchTab

Fields
Input Field Description
tabId - String! ID of the tab
Example
{"tabId": "abc123"}

SharePointRemoveSearchTabPayload

Description

Return Type for Mutation sharePointRemoveSearchTab

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 - [SharePointRemoveSearchTabError!] Errors of the mutation.
Example
{
  "clientMutationId": "abc123",
  "instance": Instance,
  "errors": [PermissionError]
}

SharePointSearchResult

Description

Item Result of of Sharepoint Search

Fields
Field Name Description
summary - String! Summary of the item in sharepoint
lastModifiedBy - String! Identity of the user, device, and application which last modified the item.
lastModifiedDateTime - IsoDateTime! Date and time the item was last modified.
linkingUrl - String Link to open files in the browser if available
webUrl - String! URL that displays the resource in the browser.
name - String! Optional. Filename of the remote item.
mimeType - String! Mimetype of the remote item
site - SharePointSite Site from where the result is originated from
Example
{
  "summary": "abc123",
  "lastModifiedBy": "xyz789",
  "lastModifiedDateTime": "2016-10-07T01:08:03.420Z",
  "linkingUrl": "abc123",
  "webUrl": "xyz789",
  "name": "abc123",
  "mimeType": "abc123",
  "site": SharePointSite
}

SharePointSearchResultConnection

Description

List of SharePoint search results

Fields
Field Name Description
edges - [SharePointSearchResultEdge!] A list of edges.
pageInfo - PageInfo! Information to aid in pagination.
totalCount - Int Total number of results
Example
{
  "edges": [SharePointSearchResultEdge],
  "pageInfo": PageInfo,
  "totalCount": 987
}

SharePointSearchResultEdge

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination.
node - SharePointSearchResult! The item at the end of the edge.
Example
{
  "cursor": "abc123",
  "node": SharePointSearchResult
}

SharePointSearchTab

Description

SharePointSearchTab is a Tab visible in the "full search" where it's posssible to sarch content.

use me.sharePointSearch to look for contents in the tab

Fields
Field Name Description
id - ID! ID of the object.
names - TranslatedString! All the Translated Names of the tab
name - String! Name for the current user
searchableSites - [SharePointSite!] List of Sharepoint Site that are linked to this tab
sharePointSearch - SharePointSearchResultConnection Search in SearchPoint Tabs configured by an admin. Search are performed using the current user's token. Please check sharepoint is enabled first (instance.instanceSharepoint.active). And user is connected (me.preferences.service(type: ONEDRIVE) )
Arguments
query - String!

Query String filter to look for on searchpoint sites

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

Example
{
  "id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
  "names": {"en": "a Name", "fr": "Un Nom"},
  "name": "xyz789",
  "searchableSites": [SharePointSite],
  "sharePointSearch": SharePointSearchResultConnection
}

SharePointSearchTabUpdateError

Description

Error Type of the sharePointSearchTabUpdate Mutation

Example
PermissionError

SharePointSearchTabUpdateInput

Description

Input type for Mutation sharePointSearchTabUpdate

Fields
Input Field Description
removeSiteIds - [String!] List of Sharepoint SiteId site to remove
addSites - [SharePointSiteInput!] List of Sharepoint Sites site to add
names - TranslatedString If given, a list of translated names for the current SharepointSearchTab
tabId - String! ID of the Searchable Tab
Example
{
  "removeSiteIds": ["abc123"],
  "addSites": [SharePointSiteInput],
  "names": {"en": "a Name", "fr": "Un Nom"},
  "tabId": "xyz789"
}

SharePointSearchTabUpdatePayload

Description

Return Type for Mutation sharePointSearchTabUpdate

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 - [SharePointSearchTabUpdateError!] Errors of the mutation.
Example
{
  "clientMutationId": "xyz789",
  "instance": Instance,
  "errors": [PermissionError]
}

SharePointSite

Description

Representation of a Sharepoint Site.

Fields
Field Name Description
siteId - String! Sharepoint Site ID
name - String! Display name of the Sharepoint site
webUrl - URL! Web Url of the Site
Example
{
  "siteId": "abc123",
  "name": "abc123",
  "webUrl": "http://www.test.com/"
}

SharePointSiteInput

Description

Input type for Mutation sharePointAddSearchTab

Fields
Input Field Description
siteId - String! ID of the SharePoint site to add to the Tab
name - String! Name of the SharePoint site
webUrl - String! webURL of the SharePoint site
Example
{
  "siteId": "xyz789",
  "name": "abc123",
  "webUrl": "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

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

Description

Description of a Slack Channel in a workspace

Fields
Field Name Description
id - String External ID of the channel
name - String Human readable name of the channel
Example
{
  "id": "abc123",
  "name": "abc123"
}

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
Arguments
cursor - String

Filter content after this cursor

limit - Int!

Maximum number of channels to return

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

Example
ObjectNotFoundError

SlackSpacesToChannelRemoveInput

Description

Input type for Mutation slackSpacesToChannelRemove

Fields
Input Field Description
channelId - String! The identifier of the Slack channel to unlink.
spaceId - ID! The Node ID of the space to unlink.
Example
{
  "channelId": "abc123",
  "spaceId": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}

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

Example
ObjectNotFoundError

SlackSpacesToChannelUpdateInput

Description

Input type for Mutation slackSpacesToChannelUpdate

Fields
Input Field Description
channelId - String! Slack channel Id
channelName - String! The human readable name of the slack channel.
spaceId - ID! The Node ID of the space to link.
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 forEveryone is filled)

Only available when MeActions.smartAssistantsManage

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
query - SemanticSearchQuery!

Search query for contents in the SmartAssistant

answer - Answer Answer a natural language question on the documents included in this SmartAssistant
Arguments
query - String!

Natural language question to ask the AI

mode - AnswerLogMode!

Usage mode might influence the feedback loop and how questions are logged

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
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

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

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

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

PermissionError

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

Example
ObjectNotFoundError

SmartAssistantUpdateInput

Description

Input type for Mutation smartAssistantUpdate

Fields
Input Field Description
id - ID! Global ID of the SmartAssistantto 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

Example
ObjectNotFoundError

SmartConversationArchiveInput

Description

Input type for Mutation smartConversationArchive

Fields
Input Field Description
id - ID! Global ID of the SmartConversationto 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

Example
InvalidInputError

SmartConversationCreateInput

Description

Input type for Mutation smartConversationCreate

Fields
Input Field Description
smartAssistantId - ID! Related SmartAssistant
label - String label representing the conversation, or a short summary of the conversation
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

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.

Fields
Input Field Description
story - ID! ID for the story associated with the message source
asset - UUID UIID for the asset associated with the message source
content - String! Display label for the source (might be the title, filename, ...)
Example
{
  "story": "eWVhaCByaWdodCBpdCdzIGI2NA==",
  "asset": "7aac93c5-a56c-4528-b43e-457834a796c9",
  "content": "abc123"
}

SmartConversationPostMessageErrors

Description

Error Type of the smartConversationPostMessage Mutation

Example
ObjectNotFoundError

SmartConversationPostMessageInput

Description

Input type for Mutation smartConversationPostMessage

Fields
Input Field Description
id - ID! Global ID of the SmartConversationto 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

Example
ObjectNotFoundError

SmartConversationUpdateInput

Description

Input type for Mutation smartConversationUpdate

Fields
Input Field Description
id - ID! Global ID of the SmartConversation to update
label - String! Label representing the conversation, or a short summary of the conversation
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 forEveryone is filled)

Only available when MeActions.smartFeedsManage

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
recordAnalytics - Boolean!

Where there you want the search query to be recorded, for analytics it will only record the query if "stories" field is asked

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

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

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

PermissionError

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

CONTENT_SEARCH

SmartFeed is a content feed pre-filtered with specific criterion

RICH

SmartFeed is a translated Rich Content
Example
"CONTENT_SEARCH"

SmartFeedUpdateErrors

Description

Error Type of the smartFeedUpdate Mutation

Example
ObjectNotFoundError

SmartFeedUpdateInput

Description

Input type for Mutation smartFeedUpdate

Fields
Input Field Description
id - ID! Global ID of the SmartFeedto 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
query - StorySearchQuery!

Query to search for within the SmartTab.

recordAnalytics - Boolean!

where there you want the search query to be recorded, for analytics it will only record the query if "stories" field is asked

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

Classic layout, typically a list or standard format for displaying content.

GRID

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
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

administrators - UserConnection List administrator of the current space
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

approvers - UserConnection List users with approval permission for the current space (can be space admins or system admins)
Arguments
query - String

Filter users by name

before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

approvals - StoryApprovalConnection List StoryApprovals of the current space
Arguments
filter - StoryApprovalFilter!

Filter approval by status

before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

additionalViewsStories - StoryConnection List all content that have [at least one] additional views in the current Space.
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

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
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

fromCursor - ID

Returns the elements in the list that come after the specified cursor.

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
Arguments
after - String

Returns the elements in the list that come after the specified cursor.

first - Int!

Returns the first n elements from the list.

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
query - DirectorySearchQuery!

Search criterion for user search

facets - [Facet!]! List Facet available in the current space
Arguments
filter - FacetFilter!

Filter facets by type

feed - ActivityFeedItemConnection List of Story that have been added, edited or commented recently in the space to be used in Activity Feed Tab
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

fromCursor - ID

Returns the elements in the list that come after the specified cursor.

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
query - String!

Filter Members by name

membersCount - Int Number of active members (teams are de-referenced) in the Space
Arguments
onlyEnabled - Boolean!

Only select enabled members

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
query - StorySearchQuery!

Search criterions

recordAnalytics - Boolean!

Where there you want the search query to be recorded, for analytics it will only record the query if "stories" field is asked

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
query - String

Filter members by name

before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

orderBy - SpaceMemberOrderBy!

Specify how to order the results

spaceUsers - UserConnection Return a user list of member of the space (de-reference teams as users)
Arguments
query - String

Filter users by name

roles - [SpaceRole!]

Filter members base on role

before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

status - SpaceStatus Status of the space
suggestedTags - [Tag!]! Suggest tags from a search term
Arguments
text - String

Text query to filter tags

fromSimilarStories - Boolean!

If fromSimilarStories is False, search for tags similiar to text if fromSimilarStories is True, search for content (stories) similar to text, and returns their tags

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.
Arguments
text - String

Query string to look for

fuzzy - Boolean!

If true, the search will return non-exact but close matches.

suggest - Boolean!

If true, the search will return suggested tags based on text (deprecated)

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

Example
ObjectNotFoundError

SpaceAcceptInput

Description

Input type for Mutation spaceAccept

Fields
Input Field Description
id - ID! Node Id of the space to accept or reject
accept - Boolean! Accept or reject the request (true => accept, false => reject)
Example
{
  "id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
  "accept": false
}

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

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

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
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

team - ID

Global ID of the Team you want to filter on (if any)

commentsTrends - TimeSeries Trend of the comments post over the requested period
Arguments
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

tickInterval - DateInterval!

The interval size of every data point

team - ID

Filter results by a given Team ID

resharesTrends - TimeSeries Trend of the reshare posted over the requested period
Arguments
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

tickInterval - DateInterval!

The interval size of every data point

team - ID

Filter results by a given Team ID

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
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

tickInterval - DateInterval!

The interval size of every data point

team - ID

Global ID of the Team you want to filter on (if any)

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
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

first - Int!

Returns the first n elements from the list.

after - String

Returns the elements in the list that come after the specified cursor.

team - ID

Global ID of the Team you want to filter on (if any)

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
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

team - ID

Global ID of the Team you want to filter on (if any)

first - Int!

Returns the first n elements from the list.

after - String

Returns the elements in the list that come after the specified cursor.

publicationsTrends - TimeSeries Evolution of the number of publications over the requested period publications mean New content beeing created (STORY_PUBLISH)
Arguments
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

tickInterval - DateInterval!

The interval size of every data point

team - ID

Global ID of the Team you want to filter on (if any)

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
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

tickInterval - DateInterval!

The interval size of every data point

team - ID

Global ID of the Team you want to filter on (if any)

verifiedContent - StoryConnection Returns a connection of contents that are marked as verified
Arguments
expire - ExpireFilter!

Filter by the exiration status of the content

before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

viewsTrends - TimeSeries Trend of the unique views of the stories over the requested period
Arguments
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

tickInterval - DateInterval!

The interval size of every data point

team - ID

Global ID of the Team you want to filter on (if any)

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

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

Fields
Field Name Description
statusCount - Int Deprecated status does not exists anymore
storyCount - Int Number of Story in the current space (archived are counted in)
activeStoryCount - Int Number of "active" Story in the current space. Thus excluding draft and archives
Example
{"statusCount": 123, "storyCount": 987, "activeStoryCount": 987}

SpaceDeleteErrors

Description

Error Type of the spaceDelete Mutation

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

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination.
node - Space! The item at the end of the edge.
Example
{
  "cursor": "xyz789",
  "node": Space
}

SpaceFavoriteErrors

Description

Error Type of the spaceFavorite Mutation

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

ADDABLE

Select only spaces where the current user has the permission to create content

ADDABLE_WITH_STORY_SCHEMAS

Select only spaces where the current user has the permission to create content with StorySchema

ALL

Select All visible spaces for the current user

MEMBER

Select spaces where the current user is a member

NOT_MEMBER

Select spaces where the current user is NOT a member no longer used

MANDATORY_APPROVAL

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
filter - SpaceFilter!

Filter (exclude) spaces based on the filter

promotedInSidebar - Boolean

Filter spaces that are promoted in sidebar (null => no filter, true => only the sidebar promoted, false => only the not sidebar promoted)

promotedInOverview - Boolean

Filter spaces that are promoted in overview (null => no filter, true => only the overview promoted, false => only the not overview promoted)

includeFavorite - Boolean

Filter based on favorite status for current user (null => no filter, true => only favorited, false=> only not favorited)

before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

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

PermissionError

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

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

PermissionError

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

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

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

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

Description

Union of the different types of completion for the spaceMemberAdd Mutation

Types
Union Types

User

Team

Space

Example
User

SpaceMemberAddErrors

Description

Error Type of the spaceMemberAdd Mutation

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

Example
ObjectNotFoundError

SpaceMemberDeleteInput

Description

Input type for Mutation spaceMemberDelete

Fields
Input Field Description
spaceId - ID Global ID of the Space from which the member needs to be removed will be mandatory in the future
ids - [ID!] Global IDs of the member to remove from the space
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

Description

Union of the different types of members in a space

Types
Union Types

User

Team

Example
User

SpaceMemberOrderBy

Description

Ordering options for SpaceMemberConnection

Values
Enum Value Description

NAME

Order by user name

STATUS

Order by status of the user (registered is also part of the status)

ROLE

Order by the role of the member
Example
"NAME"

SpaceMemberRoleErrors

Description

Error Type of the spaceMemberRole Mutation

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

Example
ObjectNotFoundError

SpaceOrderInput

Description

Input type for Mutation spaceOrder

Fields
Input Field Description
ids - [ID!]! An ordered list of Space node IDs
spaceGroup - ID Node ID of the SpaceGroup to order spaces in.
Example
{
  "ids": ["eWVhaCByaWdodCBpdCdzIGI2NA=="],
  "spaceGroup": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}

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

NOT_PROMOTED

The space is not promoted, it's the default value

OVERVIEW

The space is promoted in the overview of all the spaces

SIDEBAR

The space is promoted in the left sidebar
Example
"NOT_PROMOTED"

SpaceRequestAcceptErrors

Description

Error Type of the spaceRequestAccept Mutation

Example
ObjectNotFoundError

SpaceRequestAcceptInput

Description

Input type for Mutation spaceRequestAccept

Fields
Input Field Description
accept - Boolean! Accept or reject the request (true => accept, false => reject)
id - ID! Node ID of the SpaceRequest to accept or reject
userId - ID! Node ID of the User you want to accept/reject to the space
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

Example
ObjectNotFoundError

SpaceRequestInput

Description

Input type for Mutation spaceRequest

Fields
Input Field Description
id - ID! Node Id of the Space to request access to
reason - String Reason why you want to join the space
Example
{
  "id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
  "reason": "xyz789"
}

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

Description

Result item of a Space Facet

Fields
Field Name Description
space - Space! The related space
totalCount - Int! The number of content in the space matching the criteria
Example
{"space": Space, "totalCount": 123}

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

ADMIN

Admininisrator of the space Admin have "every" rights on the space

COORDINATOR

Coordinator an add and edit content and perfom some moderation tasks

MEMBER

Can add and edit content in the space

NONE

The users is not a member of the space

PENDING

The user is pending an approval to join the space no permissions are granted until the user is accepted

READER

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

CLOSED

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

NORMAL

The Space is open and active New contents can be created, maintained, etc.

PENDING

A user requested to create this space, and the request is pending approval

DELETED

The space is deleted, all contents are deleted and not accessible anymore
Example
"CLOSED"

SpaceStatusErrors

Description

Error Type of the spaceStatus Mutation

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
Example
{
  "slug": "xyz789",
  "label": "abc123",
  "labels": {"en": "a Name", "fr": "Un Nom"},
  "icon": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}

SpaceTabDeleteErrors

Description

Error Type of the spaceTabDelete Mutation

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

Example
ObjectNotFoundError

SpaceTabOrderInput

Description

Input type for Mutation spaceTabOrder

Fields
Input Field Description
spaceId - ID! The Gobal ID of the space where to update the tab order
tabs - [ID!]! Ordered list of SpaceTab Node ID
Example
{
  "spaceId": "eWVhaCByaWdodCBpdCdzIGI2NA==",
  "tabs": ["eWVhaCByaWdodCBpdCdzIGI2NA=="]
}

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

ACTIVITY

Tab showing activity feed Deprecated

CONTENT_FEED

Tab showing a content feed

EMPTY

An empty tab, doing nothing (useful for hierarchy)

LIBRARY

A library tab: A search view of all the content in the space

LINK

A link tab On selection, the user is redirected to the URL or the URL is displayed in an iframe

SEPARATOR

A separator tab Not navigable, only used to separate visually other tabs.

SMART

A smart tab: Display a "search" view filtered by a schema, tags, hashtags, etc.

STORY

A story tab: Display a single story in the tab.

FOLDERS

A deprecated folders tab (not available anymore). not available anymore

DIRECTORY

deprecated not available anymore
Example
"ACTIVITY"

SpaceTabUpdateErrors

Description

Error Type of the spaceTabUpdate Mutation

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

PUBLIC

Space is public, anyone can see the content and join.

MODERATED

Everyone can see the space's contents and request membership.

PRIVATE

Space name is visible, but content is hidden unless you are a member.

SECRET

Space existence and content is only visible to the members.
Example
"PUBLIC"

SpaceUnFavoriteErrors

Description

Error Type of the spaceUnFavorite Mutation

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

ObjectNotFoundError

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

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

Example
ObjectNotFoundError

SpaceUpdatePinnedInput

Description

Input type for Mutation spaceUpdatePinned

Fields
Input Field Description
addedStories - [ID!] List of IDs of Story you want to add to the pinned list
id - ID! The Global Node ID of the Space you want to update pins
removedStories - [ID!] List of IDs of Story you want to remove from the pinned list
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

Description

A Box that contains a list of stories

Fields
Field Name Description
stories - [Story!]! The list of stories that are referenced in the box
title - String Title of the box
Example
{
  "stories": [Story],
  "title": "xyz789"
}

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
status - AnnotationStatus

Filter annotations by status (no filters if not provided)

before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

bookmarked - Boolean! Is the current story bookmarked by ther current user
approval - StoryApproval Get the latest StoryApproval following filter if it exists
Arguments
filter - StoryApprovalFilter!

Filter approval by status

commenters - UserConnection Get a list of commenters
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

comments - CommentConnection Get a connection of comments on the Content ordered by creation date
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

contributors - UserConnection List Contributors of this content. they can be effective (they have contributed to the content) or invited
Arguments
filter - ContributorsFilter!

Filter contributors results

before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

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
Arguments
source - UUID

Earliest version to compare to

target - UUID!

Latest version to compare to

lang - Lang

Lang of the version to compare to

documentVersion - Int

Returns the diff in the Slate format with the given documentVersion most probably 4

editVersion - StoryVersion Get the latest-editable StoryVersion of the current content
Arguments
lang - Lang

Lang can be passed to select the Lang to edit, if none is given, the user's default (with fallback) is selected

editVersionUUID - UUID Return the UUID of the latest edit version of the story
Arguments
lang - Lang

Lang can be passed to select the Lang to edit, if none is given, the user's default (with fallback) is selected

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
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

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
limit - Int

Return only up to limit hashtags if specified

id - ID! ID of the object.
invitables - InvitableConnection Get a list of invitable users when the content contains an Event
Arguments
query - String!

Filter invitable by name

before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

invitations - InvitationConnection Get a list the invitations of the current content (with event) and with the given RSVP status
Arguments
rsvp - Rsvp!

Filter invitations by RSVP status

before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

inviteContributors - [User!]! Deprecated use me.mention() with canEdit
Arguments
query - String

Filter users by name

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
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

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)
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

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

StorySchema attached to to story if Any Also known as "Template" in the UI

see StorySchema for more info

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
fromSimilarStories - Boolean!

If False, return tags similiar to the title of the story if fromSimilarStories is True, search for stories with a similar content and return their tags

tags - [Tag!]! List of tags assigned to the current story
Arguments
limit - Int

Return only up to limit tags if specified

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
users - [ID!]!

List of User Node Id to check the permissions

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.

Arguments
lang - Lang

Lang of the version to fetch. if none is provided the prefered lang of the user (with fallbacks) will be used. this will determine the lang of the content, assets, ...

uuid - UUID

UUID of the version to fetch. If none is provided the latest published will be used.

versions - StoryVersionConnection List versions (editions) of the current content
Arguments
lang - Lang

If provided the result versions will be displayed for the lang provided

before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

viewers - UserConnection List users that have seen the content since 365 days
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

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
Arguments
hasRead - Boolean

Filter recipient by read status if not passed, all recipients are returned

after - String

When paginating forwards, the cursor to continue.

before - String

When paginating backwards, the cursor to continue.

first - Int

The number of items to return.

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

Fields
Input Field Description
clientSubscriptionId - String A unique identifier for the client performing the subscription.
id - ID! Global NodeID of the related Me object
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

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

Example
PermissionError

StoryAlertInput

Description

Input type for Mutation storyAlert

Fields
Input Field Description
id - ID! NodeId of the Story you want to send
message - String Invitation message
recipients - [ID!]! List of NodeId of recipients you want to invite to read. Can be Team, User or Space
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

Fields
Input Field Description
clientSubscriptionId - String A unique identifier for the client performing the subscription.
id - ID! Global NodeID of the related StoryAlert object
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

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
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

tickInterval - DateInterval!

The interval size of every data point

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
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

tickInterval - DateInterval!

The interval size of every data point

publicationsTrends - TimeSeries Trend of the publications of the stories over the requested period. require story.actions.advancedStats
Arguments
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

tickInterval - DateInterval!

The interval size of every data point

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
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

tickInterval - DateInterval!

The interval size of every data point

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
fromDate - IsoDateTime!

Start date of the range to fetch storyBroadcasts

toDate - IsoDateTime!

End date of the range to fetch storyBroadcasts

first - Int!

Returns the first n elements from the list.

after - String

Returns the elements in the list that come after the specified cursor.

storyAlerts - StoryAlertConnection Fetch alerts of the story
Arguments
before - String

Returns the elements in the list that come before the specified cursor.

after - String

Returns the elements in the list that come after the specified cursor.

first - Int

Returns the first n elements from the list.

last - Int

Returns the last n elements from the list.

storyPings - StoryPingResults Fetch pings during a given period (between fromDate and toDate). require story.actions.advancedStats
Arguments
fromDate - IsoDateTime!

Start date of the range to fetch storyPings

toDate - IsoDateTime!

End date of the range to fetch storyPings

first - Int!

Returns the first n elements from the list.

after - String

Returns the elements in the list that come after the specified cursor.

uniqueViewsTrends - TimeSeries Trend of the views of the stories over the requested period. require story.actions.advancedStats
Arguments
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

tickInterval - DateInterval!

The interval size of every data point

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
fromDate - IsoDateTime!

Lower date limit for the data date range

toDate - IsoDateTime!

Upper date limit for the data date range

tickInterval - DateInterval!

The interval size of every data point

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
lang - Lang

Lang of the version to fetch. if none is provided the prefered lang of the user (with fallbacks) will be used. this will determine the lang of the content, assets, ...

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
filter - StoryApprovalHistoryFilter!

Filter approval process history according to StoryApprovalHistoryFilter, defaults to ALL

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

Example
PermissionError

StoryApprovalAssignInput

Description

Input type for Mutation storyApprovalAssign

Fields
Input Field Description
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
{
  "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

Example
PermissionError

StoryApprovalCancelInput

Description

Input type for Mutation storyApprovalCancel

Fields
Input Field Description
message - String Message for the approval reviewer
approvalId - ID! Global ID of the StoryApproval you want to edit
Example
{
  "message": "xyz789",
  "approvalId": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}

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

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

ALL StoryApproval

PUBLISHED

StoryApproval only in Approved and published state

IN_PROGRESS

StoryApproval that need an approval, correction or has been approved but needs to be published

NEED_CORRECTION

StoryApproval only in NEED_CORRECTION state

WAITING_FOR_APPROVAL

StoryApproval only in WAITING_FOR_APPROVAL state

UNASSIGNED

StoryApproval only that are not assigned to a approver

APPROVED

StoryApproval only in APPROVED state
Example
"ALL"

StoryApprovalHistoryFilter

Description

Filter when fetching the history of a StoryApproval

Values
Enum Value Description

ALL

Return all history

CURRENT_ITERATION

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

OPEN

Approval process is ongoing

PUBLISHED

Approval process has been approved and the approved version is published

CANCELLED

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

StoryApprovalAnyPhase

StoryApprovalSinglePhase

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 ANY, the list is ignored If the phase is of type SINGLE, the first element of the list is used as the approver

Example
{
  "type": "SINGLE",
  "approverIds": [
    "eWVhaCByaWdodCBpdCdzIGI2NA=="
  ]
}

StoryApprovalPhaseType

Description

Type of approval phase

Values
Enum Value Description

SINGLE

This is a single user phase approval

ANY

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

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

WAITING_FOR_APPROVAL

Content is waiting for review or reviewer to be assigned

NEED_CORRECTION

Content has been reviewed, but need correction before beeing published

APPROVED

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

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

Example
PermissionError

StoryArchiveInput

Description

Input type for Mutation storyArchive

Fields
Input Field Description
archived - Boolean! True if the story should be marked as archived, False if the story should be restored
id - ID! The ID of the Story to mark as archived
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

ObjectNotFoundError

Example
ObjectNotFoundError

StoryBookmarkInput

Description

Input type for Mutation storyBookmark

Fields
Input Field Description
bookmark - Boolean! Bookmark status to apply to the story for the current user
id - ID! Node ID of the Story to bookmark/unbookmark
Example
{
  "bookmark": false,
  "id": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}

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

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.

Fields
Field Name Description
lang - Lang Language of the preview.
url - URL! URL of the web page with preview. to be displayed in an IFrame
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

Example
ObjectNotFoundError

StoryChangeOwnerInput

Description

Input type for Mutation storyChangeOwner

Fields
Input Field Description
id - ID! Node Id of the Story to change owner
owner - ID! Node ID of the new User owner
Example
{
  "id": "eWVhaCByaWdodCBpdCdzIGI2NA==",
  "owner": "eWVhaCByaWdodCBpdCdzIGI2NA=="
}

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

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

Example
PermissionError

StoryDuplicateInput

Description

Input type for Mutation storyDuplicate

Fields
Input Field Description
id - ID! Node If of the Story to duplicate
publish - Boolean! Should the duplicated Story be immediately published. Default = false
spaceId - ID Node id of the Space where the duplicated Story should be created (Not given == Personal Space)
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

Description

An edge in a connection.

Fields
Field Name Description
cursor - String! A cursor for use in pagination.
node - Story! The item at the end of the edge.
Example
{
  "cursor": "xyz789",
  "node": Story
}

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

ONE_MONTH

Expire in 1 calendar month

THREE_MONTH

Expire in 3 calendar month

ONE_YEAR

Expire in 1 calendar year
Example
"ONE_MONTH"

StoryExpireErrors

Description

Represents the possible errors that can occur during the storyExpire mutation.

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