The commands listed in this article help you manipulate project Discussions in activeCollab.

About Discussions #

The following Discussion fields are available:

• name (string) - The Discussion topic is a required field when creating a new discussion.
• body (string) - The first message body is a required field when creating a new discussion.
• category_id (integer) - The discussion category ID.
• visibility (integer) - Discussion visibility. 0 marks private and 1 stands for normal visibility.
• milestone_id (integer) - The ID of the parent Milestone.

Additional resources used by Discussions can be found in the following articles:

• Categories
• Attachments
• Comments
• Reminders

More commands are available here:

• Subscription Related Commands
• Object State Related Commands

projects/:project_id/discussions #

This command displays all non-archived Discussions in a project.

Method: GET

Example response:

1
2
3
4
5
6
7
8

<discussions>
  <discussion>
    <id>1</id>
    <name> ... </name>
     ...
  </discussion>
  ...
</discussions>

projects/:project_id/discussions/add #

This command creates a new Discussion in the specified project.

Method: POST

Request example:

1
2
3

discussion[name]=New Discussion
discussion[body]=Message for discussion from api
submitted=submitted

Response:

1
2
3
4
5
6
7

<discussion>
  <id>3</id>
  <name>
    <![CDATA[New Discussion]]>
  </name>
   ...
</discussion>

projects/:project_id/discussions/archive #

This command displays all archived Discussions in a project.

Method: GET

Example response:

1
2
3
4
5
6
7
8
9

<discussion>
  <discussion>
    <id>12</id>
    <name>
      <![CDATA[Discussion example]]>
    </name>
     ...
  </discussion>
</discussion>

projects/:project_id/discussions/:discussion_id #

This command displays the Discussion details.

Method: GET

Response:

1
2
3
4
5

<discussion>
  <id>1</id>
  <name> ... </name>
  ...
</discussion>

projects/:project_id/discussions/:discussion_id/edit #

This command updates the details of an existing Discussion.

Method: POST

Request example:

1
2

discussion[name]=Updated Discussion Topic
submitted=submitted

Response:

1
2
3
4
5
6
7

<discussion>
  <id>1</id>
  <name>
    <![CDATA[Updated Discussion Topic]]>
  </name>
  ...
</discussion>