Get Started
Usage API
More information

POST api/2.0/community/forum/{threadid} This function requires authentication

Description

Adds a new topic to the existing thread with a subject, content and topic type specified in the request.

Parameters
Name Description Type Example
threadid
sent in url
Thread ID number 1234
subject
sent in body
Topic subject string some text
content
sent in body
Topic text string some text
topicType
sent in body
Topic type Informational, Poll
Example
POST api/2.0/community/forum/1234
Host: yourportal.onlyoffice.com
Content-Type: application/json
Accept: application/json

{
  "subject": "some text",
  "content": "some text",
  "topicType": "informational"
}
Returns

Added topic

Example Response

application/json

{
  "status": 0,
  "response": {
    "id": 10,
    "title": "Sample topic",
    "created": "2021-10-27T06:29:16.1175351Z",
    "updated": "2021-10-27T06:29:16.1175351Z",
    "text": "This is sample post",
    "updatedBy": {
      "id": "00000000-0000-0000-0000-000000000000",
      "displayName": "Mike Zanyatski",
      "title": "Manager",
      "avatarSmall": "url to small avatar",
      "profileUrl": ""
    },
    "threadTitile": null,
    "status": 2,
    "type": 0,
    "posts": [
      {
        "id": 123,
        "subject": "Sample subject",
        "text": "Post text",
        "created": "2021-10-27T06:29:16.1175351Z",
        "updated": "2021-10-27T06:29:16.1175351Z",
        "createdBy": {
          "id": "00000000-0000-0000-0000-000000000000",
          "displayName": "Mike Zanyatski",
          "title": "Manager",
          "avatarSmall": "url to small avatar",
          "profileUrl": ""
        },
        "threadTitle": null,
        "attachments": [
          {
            "name": "picture.jpg",
            "contentType": "image\/jpeg",
            "created": "2021-10-27T06:29:16.1175351Z",
            "updated": "2021-10-27T06:29:16.1175351Z",
            "size": 122345,
            "path": "url to file"
          }
        ]
      }
    ],
    "tags": [
      "Tag1",
      "Tag2"
    ]
  }
}

text/xml

<result>
  <status>0</status>
  <response>
    <id>10</id>
    <title>Sample topic</title>
    <created>2021-10-27T06:29:16.1175351Z</created>
    <updated>2021-10-27T06:29:16.1175351Z</updated>
    <text>This is sample post</text>
    <updatedBy>
      <id>00000000-0000-0000-0000-000000000000</id>
      <displayName>Mike Zanyatski</displayName>
      <title>Manager</title>
      <avatarSmall>url to small avatar</avatarSmall>
      <profileUrl></profileUrl>
    </updatedBy>
    <threadTitile />
    <status>2</status>
    <type>0</type>
    <posts>
      <id>123</id>
      <subject>Sample subject</subject>
      <text>Post text</text>
      <created>2021-10-27T06:29:16.1175351Z</created>
      <updated>2021-10-27T06:29:16.1175351Z</updated>
      <createdBy>
        <id>00000000-0000-0000-0000-000000000000</id>
        <displayName>Mike Zanyatski</displayName>
        <title>Manager</title>
        <avatarSmall>url to small avatar</avatarSmall>
        <profileUrl></profileUrl>
      </createdBy>
      <threadTitle />
      <attachments>
        <name>picture.jpg</name>
        <contentType>image/jpeg</contentType>
        <created>2021-10-27T06:29:16.1175351Z</created>
        <updated>2021-10-27T06:29:16.1175351Z</updated>
        <size>122345</size>
        <path>url to file</path>
      </attachments>
    </posts>
    <tags>Tag1</tags>
    <tags>Tag2</tags>
  </response>
</result>