Board API

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.

Manage boards {#manage-board}

You can manage boards using the following API operations.

HTTP requestDescription
POST /boardsCreate a board
GET /boardsGet 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"}

Manage posts {#manage-post}

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 requestDescription
POST /boards/{boardId}/postsCreate a post
GET /boards/{boardId}/postsGet 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}/readersGet readers of a post

You can get specific posts from boards.

HTTP requestDescription
GET /boards/recent/postsGet recent posts
GET /boards/my/postsGet my posts
GET /boards/must/postsGet 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"}

Manage attachments {#manage-post-attachment}

You can attach multiple files to a post.

HTTP requestDescription
POST /boards/{boardId}/posts/{postId}/attachmentsAdd a post attachment
GET /boards/{boardId}/posts/{postId}/attachmentsGet 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.

Manage comments {#manage-comment}

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 requestDescription
POST /boards/{boardId}/posts/{postId}/commentsCreate a comment
GET /boards/{boardId}/posts/{postId}/commentsGet 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"}

Manage comment attachments {#manage-comment-attachment}

You can attach multiple files to a comment.

HTTP requestDescription
GET /boards/{boardId}/posts/{postId}/comments/{commentId}/attachmentsGet comment attachments
POST /boards/{boardId}/posts/{postId}/comments/{commentId}/attachmentsAdd 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.