watsonwork · chris-price-772 · May 9, 2018 · May 9, 2018 · Jul 18, 2018 · Jul 18, 2018
diff --git a/guides/V1_Get_Public_Meeting.md b/guides/V1_Get_Public_Meeting.md
@@ -0,0 +1,50 @@
+---
+copyright: 'Copyright IBM Corp. 2017'
+link: 'get-public-meeting'
+is: 'experimental'
+---
+# Get Public Meeting Details
+
+This REST GET request allows the API caller to get details about a public meeting.
+
+### Version information
+- Version: 1.0.0
+
+### URI scheme
+_Host_ : **api.watsonwork.ibm.com**
+_Scheme_: **HTTPS**
+
+### Path
+```
+GET v1/publicMeeting/bySpaceId/<spaceId>
+```
+
+#### Responses
+
+|HTTP Code|Description|Schema|
+|---|---|---|
+|**200**|The meeting data returned.|MeetingData(see below)|
+
+
+#### Produces
+
+* `application/json`
+
+
+<a name="meetingdata"></a>
+
+#### MeetingData
+Entity that represents the requested meeting.
+
+|Name|Description|Schema|
+|---|---|---|
+|**meetingId**  <br>*required*|Id of the meeting.|string|
+|**meetingNumber**  <br>*optional*|The Zoom meeting number if the meeting is currently active or otherwise null.|string|
+|**password**  <br>*optional*|The Zoom meeting password if the meeting is currently active or otherwise null.|string|
+|**active**  <br>*required*|Boolean representing whether the meeting is currently active.|string|
+|**allowPublic**  <br>*required*|Boolean representing whether the meeting open to the public.|string|
+|**startTime**  <br>*optional*|Start time of the active meeting or otherwise null.|string|
+|**meetingProviderJoinUrl**  <br>*optional*|A URL to join the meeting with the Zoom client or otherwise null.|string|
+|**meetingProviderJoinUrl**  <br>*optional*|A URL to join the meeting with the Zoom client or otherwise null.|string|
+|**pstnPasscode**  <br>*optional*|The PSTN passcode of the active meeting if present or otherwise null.|string|
+|**dialInNumbers**  <br>*optional*|An array of country code identifier plus dial-in number forthe active meeting or otherwise null.|string|
diff --git a/guides/V1_Meeting.md b/guides/V1_Meeting.md
@@ -0,0 +1,79 @@
+---
+copyright: 'Copyright IBM Corp. 2018'
+link: 'meeting'
+is: 'experimental'
+---
+
+# Get meeting details
+
+## Concepts
+
+The _meeting_ query allows the API caller to get details about the meeting.  The query accepts a Space ID (spaceId) and will return meeting details if the calling user has access to the meeting.  The calling user will have access to the meeting if the user has access to the space which contains the meeting, or the meeting has been marked to allow public participants.
+
+## Schema
+
+### Meeting Query
+
+
+```graphql
+type QueryRoot {
+  ...
+  meeting(spaceId: ID!): Meeting
+}
+
+type Meeting {
+  active: Boolean!
+  meetingNumber: String
+  password: String
+  allowPublic: Boolean!
+  startTime: Date
+  joinInfo: JoinInfo
+}
+
+type JoinInfo {
+  meetingProviderJoinUrl: String
+  pstnPasscode: String
+  dialInNumbers : [DialInNumber]
+}
+
+type DialInNumber {
+  countryCode: String!
+  number: String!
+}
+
+```
+
+## Example Request
+
+~~~~
+Method: POST
+URL: https://api.watsonwork.ibm.com/graphql
+Headers: 'Content-Type: application/graphql' , 'x-graphql-view: PUBLIC, EXPERIMENTAL'
+Body:
+{
+  query {
+    meeting(spaceId: "5a9ee86ee4b0cb1ca3dfef33") {
+      active
+    	password
+    	joinInfo {
+    	  meetingProviderJoinUrl
+    	}
+    }
+  }
+}
+~~~~
+## Example Result
+
+~~~~
+{
+    "data": {
+        "meeting": {
+            "active": true,
+            "password": "53621872",
+            "joinInfo": {
+                "meetingProviderJoinUrl": "https://zoom.us/j/240286814?pwd=vBRBlZBaXAKwIumekTziMw"
+            }
+        }
+    }
+}
+~~~~
diff --git a/guides/V1_Start_Meeting.md b/guides/V1_Start_Meeting.md
@@ -0,0 +1,55 @@
+---
+copyright: 'Copyright IBM Corp. 2018'
+link: 'start-meeting'
+is: 'experimental'
+---
+
+# Start a meeting within a space
+
+## Concepts
+
+The _startMeeting_ mutation allows the API caller to start a meeting with a **space**.  The mutation accepts a Space ID (spaceId) as an argument, and makes the request on behalf of the caller, starting a meeting within the specified space.  The result will reflect the whether the call was accepted for processing by the service.
+
+## Schema
+
+### Start Meeting Mutation
+
+
+
+```graphql
+type MutationRoot {
+  ...
+  startMeeting(input: StartMeetingInput!): MeetingMutationOutput
+}
+
+type MeetingMutationOutput {
+  accepted: Boolean!
+}
+```
+
+## Example Request
+
+~~~~
+Method: POST
+URL: https://api.watsonwork.ibm.com/graphql
+Headers: 'Content-Type: application/graphql' , 'x-graphql-view: PUBLIC, EXPERIMENTAL'
+Body:
+{
+  mutation {
+    startMeeting(input: {spaceId : "5ad0fabfe4b078066d690a24"}) {
+      accepted
+    }
+  }
+}
+~~~~
+## Example Result
+
+~~~~
+{
+  "data": {
+    "startMeeting": {
+      "accepted": "true"
+    }
+  }
+}
+~~~~
diff --git a/guides/V1_Update_Meeting.md b/guides/V1_Update_Meeting.md
@@ -0,0 +1,55 @@
+---
+copyright: 'Copyright IBM Corp. 2018'
+link: 'update-meeting'
+is: 'experimental'
+---
+
+# Update a meeting
+
+## Concepts
+
+The _updateMeeting_ mutation allows the API caller to configure options on the meeting.  The mutation accepts a Space ID (spaceId), and an allowPublic boolean as arguments, and makes the request on behalf of the caller, updating the meeting within the specified space.  The result will reflect the whether the call was accepted for processing by the service.
+
+## Schema
+
+### Update Meeting Mutation
+
+
+
+```graphql
+type MutationRoot {
+  ...
+  updateMeeting(input: UpdateMeetingInput!): MeetingMutationOutput
+}
+
+type MeetingMutationOutput {
+  accepted: Boolean!
+}
+```
+
+## Example Request
+
+~~~~
+Method: POST
+URL: https://api.watsonwork.ibm.com/graphql
+Headers: 'Content-Type: application/graphql' , 'x-graphql-view: PUBLIC, EXPERIMENTAL'
+Body:
+{
+  mutation {
+    updateMeeting(input: {spaceId : "5ad0fabfe4b078066d690a24", allowPublic: true}) {
+      accepted
+    }
+  }
+}
+~~~~
+## Example Result
+
+~~~~
+{
+  "data": {
+    "updateMeeting": {
+      "accepted": "true"
+    }
+  }
+}
+~~~~
diff --git a/guides/V1_spaces_main.md b/guides/V1_spaces_main.md
@@ -23,3 +23,4 @@ Watson Work Services represents a Space with this object.
 | members(before: String, after: String, first: Int, last: Int) | PersonCollection | The members of this space provided as a PersonCollection
 | membersUpdated | Date | The date the membership was updated |
 | conversation |Conversation | The conversation object for this space |
+| activeMeeting | Meeting | Indicates that there is a meeting active within this space.  Will only contain a sub-selection of all available meeting details, so this is suitable to use in a list view of spaces.  This requires the `EXPERIMENTAL` value in `x-graphql-view header`. |
diff --git a/guides/V1_wwsg_Meetings.md b/guides/V1_wwsg_Meetings.md
@@ -0,0 +1,26 @@
+---
+copyright: 'Copyright IBM Corp. 2018'
+link: 'meetings-overview'
+is: 'experimental'
+---
+## Meetings Overview
+
+Watson Work Services provides a set of **meeting** APIs for callers to start and get details about meetings.  Meetings are online collaboration sessions which allow users to communicate with one another using the Workspace client, Zoom client, or a basic telephone.  Meetings include audio, video, screensharing, and whiteboarding.  Meetings happen within the context of a **space** and can either be restricted to only members of that space, or can be opened to public access so you can meet with people outside of your team or company.
+
+### External APIs
+
+ * GraphQL mutation for starting a meeting
+    * **startMeeting** [Start a meeting within a space](https://github.com/watsonwork/watsonwork-developer-docs/blob/master/guides/V1_Start_Meeting.md)
+    <br>
+* GraphQL mutation for updating a meeting
+   * **updateMeeting** [Update a meeting](https://github.com/watsonwork/watsonwork-developer-docs/blob/master/guides/V1_Update_Meeting.md)
+   <br>
+ * GraphQL query for meeting details
+    * **meeting** [Get information about the meeting](https://github.com/watsonwork/watsonwork-developer-docs/blob/master/guides/V1_Meeting.md)
+    <br>
+ * GraphQL query for getting an active meeting within a space
+    * **Space.activeMeeting** [Optional inclusion of activeMeeting on a space](https://github.com/watsonwork/watsonwork-developer-docs/blob/master/guides/V1_spaces_main.md)
+    <br>
+ * REST request for getting details of a public meeting
+    * **/api/v1/publicMeeting/bySpaceId/** [Get information about a public meeting](https://github.com/watsonwork/watsonwork-developer-docs/blob/master/guides/V1_Get_Public_Meeting.md)
+<br>