From 5347ce24a5eb9bb2d3bd515f4b058f7e5dab01b5 Mon Sep 17 00:00:00 2001 From: Jon Brunn Date: Mon, 13 Aug 2018 16:30:39 -0600 Subject: [PATCH] Move moments API from beta to public --- guides/V1_get_moment.md | 13 ++++++------- guides/V1_get_moments.md | 8 ++++++-- guides/V1_get_moments_in_conversation.md | 13 +++---------- guides/V1_moment_main.md | 14 ++++---------- 4 files changed, 19 insertions(+), 29 deletions(-) diff --git a/guides/V1_get_moment.md b/guides/V1_get_moment.md index 46d12a5..4e0e55f 100644 --- a/guides/V1_get_moment.md +++ b/guides/V1_get_moment.md @@ -1,14 +1,9 @@ --- link: 'get-moment-by-id' -is: 'beta' +is: 'published' --- ## Get a moment by id -**NOTE**: This graphql object is currently in `BETA` release and is only available with the following http request header: - - x-graphql-view: BETA - - This is a sample GraphQL query to get moment by id. Be sure to switch "moment-id" to the actual id you're curious about. ``` @@ -23,4 +18,8 @@ query getMomentById { ``` -Try it out with our GraphQL tool - Get a moment by id +Get a moment by ID, see it in action with our GraphQL tool. + +
+ Try it now +
diff --git a/guides/V1_get_moments.md b/guides/V1_get_moments.md index 9e148ec..a6b9a8f 100644 --- a/guides/V1_get_moments.md +++ b/guides/V1_get_moments.md @@ -1,7 +1,7 @@ --- copyright: 'Copyright IBM Corp. 2017' link: 'get-a-list-of-moments' -is: 'beta' +is: 'published' --- ## Get a list of moments @@ -66,4 +66,8 @@ query getMoments($spaceId: String!) { ``` -Try it out with our GraphQL tool - Get a list of moments +Get a list of moments in a space, see it in action with our GraphQL tool. + +
+ Try it now +
diff --git a/guides/V1_get_moments_in_conversation.md b/guides/V1_get_moments_in_conversation.md index 8238f65..051ff8f 100644 --- a/guides/V1_get_moments_in_conversation.md +++ b/guides/V1_get_moments_in_conversation.md @@ -1,17 +1,10 @@ --- copyright: 'Copyright IBM Corp. 2018' link: 'get-a-list-of-moments-in-conversation' -is: 'beta' +is: 'published' --- ## Get a list of moments in conversation -**NOTE**: This graphql object is currently in `BETA` release and is only available with the following http request header: - - x-graphql-view: BETA - -or with apiType=beta on the graphical GraphQL tool URL. - - This is a sample GraphQL query to get moments in a conversation. Be sure to switch "conversation-id" to the id of the conversation you're curious about. ``` @@ -32,8 +25,8 @@ query getMomentsInConversation { } ``` -Get a list of moments in conversation, see it in action with our GraphQL tool. +Get a list of moments in a conversation, see it in action with our GraphQL tool.
- Try it now + Try it now
diff --git a/guides/V1_moment_main.md b/guides/V1_moment_main.md index 1c86b1f..9845633 100644 --- a/guides/V1_moment_main.md +++ b/guides/V1_moment_main.md @@ -1,17 +1,10 @@ --- copyright: 'Copyright IBM Corp. 2018' link: 'moment' -is: 'beta' +is: 'published' --- # Moment -**NOTE**: This graphql object is currently in `BETA` release and is only available with the following http request header: - - x-graphql-view: BETA - -or with apiType=beta on the graphical GraphQL tool URL. - - Watson Work Services analyzes messages in each space to identify **moments**. Each moment includes a summary of a group of messages. The summary includes summary phrases, participants, and other information extracted from messages. @@ -25,7 +18,7 @@ The [Conversation](./guides/V1_conversation_main.md) object also references the | property | type | description | | ------------- |:------------- |:-----| | id | ID | The unique ID for this moment. 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. | -| live | Boolean | The status whether this moment is still under updating | +| live | Boolean | True indicates this moment is ongoing and may receive updates | | startTime | Date | Date and time this moment started | | endTime | Date | Date and time this moment ended | | keyMessage | Message | A messages which is most representative of the discussion in the moment | @@ -42,6 +35,8 @@ The [Conversation](./guides/V1_conversation_main.md) object also references the | label | String | The display string of this phrase | | score | Float | The confidence of this phrase, if applicable | +An line fragment can be used to see more details for each type of SummaryPhrase. See also https://graphql.org/learn/queries/#inline-fragments. + ### Keyword (implements SummaryPhrase) The keyword interface is used to distinguish a keyword summary phrase, but currently adds no unique properties of its own. @@ -51,7 +46,6 @@ The keyword interface is used to distinguish a keyword summary phrase, but curre | ------------- |:------------- |:-----| | count | Int | The count of this entity phrase in the moment | - ## Participant | property | type | description | | ------------- |:------------- |:-----|