The Note API helps you manage note posts of a team/group.
To use the Note API, you need an access token that you can get by authenticating with a user account, not a service account.
The API scopes are as follows:
group.note or group.note.read: Only the API operations associated with the team/group note are available.The team/group note is part of the team/group features. To enable or disable the team/group note, you need to use the useNote property of the API that manages teams or groups.
Managing teams requires the orgunit or directory scope, and managing groups requires the group or directory scope.
| HTTP request | Description |
|---|---|
| POST /orgunits | Add a team |
| PUT /orgunits/{orgUnitId} | Update a team |
| PATCH /orgunits/{orgUnitId} | Update part of a team |
| HTTP request | Description |
|---|---|
| POST /groups | Add a group |
| PUT /groups/{groupId} | Update a group |
| PATCH /groups/{groupId} | Update part of a group |
To use the team/group note after enabling it using useNote, you need to create a note using the following API operation.
| HTTP request | Description |
|---|---|
| POST /groups/{groupId}/note | Create a team/group note |
Even if you disable the team/group note using useNote, the note data will remain unchanged. To actually delete the note data, you need to use the following API operation.
| HTTP request | Description |
|---|---|
| DELETE /groups/{groupId}/note | Delete a team/group note |
You can manage note posts using the following API operations with a team/group ID (groupId) specified.
| HTTP request | Description |
|---|---|
| POST /groups/{groupId}/note/posts | Team/group note - Create a post |
| GET /groups/{groupId}/note/posts | Team/group note - Get posts |
| GET /groups/{groupId}/note/posts/{postId} | Team/group note - Get a post |
| PUT /groups/{groupId}/note/posts/{postId} | Team/group note - Update a post |
| PATCH /groups/{groupId}/note/posts/{postId} | Team/group note - Update part of a post |
| DELETE /groups/{groupId}/note/posts/{postId} | Team/group note - Delete a post |
Add a post by specifying its title and body. You can include HTML tags in the body. You can also specify whether to allow co-editing (enableCollaboration ), whether it is a notice (isNotice), and whether to send a notification when a post is created (sendNotifications).
{ "title": "Post title", "body": "<h1>Post</h1> Body", "enableCollaboration": false, "isNotice": false, "sendNotifications": false}You can attach multiple files to a note post.
| HTTP request | Description |
|---|---|
| POST /groups/{groupId}/note/posts/{postId}/attachments | Team/group note - Add a post attachment |
| GET /groups/{groupId}/note/posts/{postId}/attachments | Team/group note - Get post attachments |
| GET /groups/{groupId}/note/posts/{postId}/attachments/{attachmentId} | Team/group note - Get a post attachment |
| DELETE /groups/{groupId}/note/posts/{postId}/attachments/{attachmentId} | Team/group note - Delete a post attachment |
For how to get attachments, see Upload or Download Files.