The Board API helps you manage boards, posts, and comments.
To use the Board API, you need an access token that you can get by authenticating with a user account or a service account. The API scopes are board and board.read.
You can manage boards using the following API operations.
| HTTP request | Description |
|---|---|
| POST /boards | Create a board |
| GET /boards | Get boards |
| GET /boards/{boardId} | Get a board |
| PUT /boards/{boardId} | Update a board |
| DELETE /boards/{boardId} | Delete a board |
While you can set the category, order, permission, and type of a board, the Board API helps you manage only the title (boardName) and description (description) of a board.
{ "boardName": "Board title", "description": "Board description"}Add a post to a board. You can manage posts using the following API operations. Specify a board ID (boardID) when making an API call.
| HTTP request | Description |
|---|---|
| POST /boards/{boardId}/posts | Create a post |
| GET /boards/{boardId}/posts | Get posts |
| GET /boards/{boardId}/posts/{postId} | Get a post |
| PUT /boards/{boardId}/posts/{postId} | Update a post |
| DELETE /boards/{boardId}/posts/{postId} | Delete a post |
| GET /boards/{boardId}/posts/{postId}/readers | Get readers of a post |
You can get specific posts from boards.
| HTTP request | Description |
|---|---|
| GET /boards/recent/posts | Get recent posts |
| GET /boards/my/posts | Get my posts |
| GET /boards/must/posts | Get must-read posts |
Add a post by specifying its title and body. You can include HTML tags in the body. You can also specify whether to use comments (enableComment), whether to send notifications for creating posts (sendNotifications), and the must-read end date (mustReadEndDate).
{ "title": "Post title", "body": "<h1>Post</h1> Body", "enableComment": true, "sendNotifications": true, "mustReadEndDate": "2023-07-20"}You can attach multiple files to a post.
| HTTP request | Description |
|---|---|
| POST /boards/{boardId}/posts/{postId}/attachments | Add a post attachment |
| GET /boards/{boardId}/posts/{postId}/attachments | Get post attachments |
| GET /boards/{boardId}/posts/{postId}/attachments/{attachmentId} | Get a post attachment |
| DELETE /boards/{boardId}/posts/{postId}/attachments/{attachmentId} | Delete a post attachment |
For how to get attachments, see Upload or Download Files.
You can comment on posts. Use the following API operations to manage comments. Specify a board ID (boardId) and a post ID (postId) when making an API call.
| HTTP request | Description |
|---|---|
| POST /boards/{boardId}/posts/{postId}/comments | Create a comment |
| GET /boards/{boardId}/posts/{postId}/comments | Get comments |
| GET /boards/{boardId}/posts/{postId}/comments/{commentId} | Get a comment |
| PUT /boards/{boardId}/posts/{postId}/comments/{commentId} | Update a comment |
| DELETE /boards/{boardId}/posts/{postId}/comments/{commentId} | Delete a comment |
Add a comment by specifying content.
{ "content": "This is a comment"}You can attach multiple files to a comment.
| HTTP request | Description |
|---|---|
| GET /boards/{boardId}/posts/{postId}/comments/{commentId}/attachments | Get comment attachments |
| POST /boards/{boardId}/posts/{postId}/comments/{commentId}/attachments | Add a comment attachment |
| GET /boards/{boardId}/posts/{postId}/comments/{commentId}/attachments/{attachmentId} | Get a comment attachment |
| DELETE /boards/{boardId}/posts/{postId}/comments/{commentId}/attachments/{attachmentId} | Delete a comment attachment |
For how to add and get attachments, see Upload or Download Files.