Discussions
The Discussion API lets you create, list and comment discussions in books.
List discussions for a book
List all opened discussions in a book, all or closed discussions can be listed using the state parameter.
This method is paginated.
GET /book/:author/:book/discussions
Parameters
| Name | Type | Description |
|---|---|---|
state |
string | State of the discussions (open, closed or all), default is open |
filename |
string | Optional file to filter discussions |
Create a new discussion
Any user with read access can create a discussion.
POST /book/:author/:book/discussions
Parameters
| Name | Type | Description |
|---|---|---|
title |
string | Required. Title of the discussion. |
body |
string | The contents of the discussion. |
Close a list of discussions
Mark a list of discussions as closed for a book.
POST /book/:author/:book/discussions/close
Parameters
| Name | Type | Description |
|---|---|---|
list |
array | Required. An array containing the threads numbers to mark as closed. |
Open a list of discussions
Mark a list of discussions as open for a book.
POST /book/:author/:book/discussions/open
Parameters
| Name | Type | Description |
|---|---|---|
list |
array | Required. An array containing the threads numbers to mark as open. |