Create Discussion

This example request illustrates how to create a discussion. Note that discussions are first created, then added to the person by reference in a separate operation.

JSON

Request

POST /platform/discussions/discussions
Content-Type: application/x-fs-v1+json
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE{
  "discussions" : [ {
    "id" : "dis-MMMM-MMM",
    "title" : "1900 US Census, Ethel Hollivet",
    "details" : "Ethel Hollivet (line 75) with husband Albert Hollivet (line 74); also in the dwelling: step-father Joseph E Watkins (line 72), mother Lina Watkins (line 73), and grandmother -- Lina's mother -- Mary Sasnett (line 76).  ",
    "contributor" : {
      "resource" : "https://familysearch.org/platform/users/agents/JNYR-KJP",
      "resourceId" : "JNYR-KJP"
    },
    "numberOfComments" : 2
  } ]
}

Response

HTTP/1.1 201 Created
Content-type: text/html
X-entity-id: dis-MMMM-MMM
X-processing-time: 3
Vary: Accept,Accept-Language,Accept-Encoding,Expect
Date: Sun, 03 Apr 1836 10:00:00 GMT-5
Cache-control: no-cache, no-store, no-transform, must-revalidate, max-age=0
Location: https://api.familysearch.org/platform/discussions/discussions/dis-MMMM-MMM
Transfer-encoding: chunked

XML

Request

POST /platform/discussions/discussions
Content-Type: application/x-fs-v1+xml
Authorization: Bearer YOUR_ACCESS_TOKEN_HERE<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<fs:familysearch xmlns:fs="http://familysearch.org/v1/" xmlns="http://gedcomx.org/v1/" xmlns:atom="http://www.w3.org/2005/Atom">
    <fs:discussion id="dis-MMMM-MMM">
        <fs:title>1900 US Census, Ethel Hollivet</fs:title>
        <fs:details>Ethel Hollivet (line 75) with husband Albert Hollivet (line 74); also in the dwelling: step-father Joseph E Watkins (line 72), mother Lina Watkins (line 73), and grandmother -- Lina's mother -- Mary Sasnett (line 76).  </fs:details>
        <fs:contributor resource="https://familysearch.org/platform/users/agents/JNYR-KJP" resourceId="JNYR-KJP"/>
        <fs:numberOfComments>2</fs:numberOfComments>
    </fs:discussion>
</fs:familysearch>

Response

HTTP/1.1 201 Created
Content-type: text/html
X-entity-id: dis-MMMM-MMM
X-processing-time: 3
Vary: Accept,Accept-Language,Accept-Encoding,Expect
Date: Sun, 03 Apr 1836 10:00:00 GMT-5
Cache-control: no-cache, no-store, no-transform, must-revalidate, max-age=0
Location: https://api.familysearch.org/platform/discussions/discussions/dis-MMMM-MMM
Transfer-encoding: chunked