Note API

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.

Manage the team/group note feature {#manage-groupnote}

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 requestDescription
POST /orgunitsAdd a team
PUT /orgunits/{orgUnitId}Update a team
PATCH /orgunits/{orgUnitId}Update part of a team
HTTP requestDescription
POST /groupsAdd 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 requestDescription
POST /groups/{groupId}/noteCreate 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 requestDescription
DELETE /groups/{groupId}/noteDelete a team/group note

Manage team/group note posts {#manage-groupnote-post}

You can manage note posts using the following API operations with a team/group ID (groupId) specified.

HTTP requestDescription
POST /groups/{groupId}/note/postsTeam/group note - Create a post
GET /groups/{groupId}/note/postsTeam/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}

Manage team/group note post attachments {#manage-groupnote-post-attachment}

You can attach multiple files to a note post.

HTTP requestDescription
POST /groups/{groupId}/note/posts/{postId}/attachmentsTeam/group note - Add a post attachment
GET /groups/{groupId}/note/posts/{postId}/attachmentsTeam/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.