You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Protocol Documentation
Table of Contents
Top
api/v2/activity_service.proto
Activity
Field |
Type |
Label |
Description |
memo_id |
int32 |
|
|
related_memo_id |
int32 |
|
|
ActivityPayload
ActivityVersionUpdatePayload
Field |
Type |
Label |
Description |
version |
string |
|
|
GetActivityRequest
Field |
Type |
Label |
Description |
id |
int32 |
|
|
GetActivityResponse
Field |
Type |
Label |
Description |
activity |
Activity |
|
|
ActivityService
Top
api/v2/common.proto
PageToken
Used internally for obfuscating the page token.
Field |
Type |
Label |
Description |
limit |
int32 |
|
|
offset |
int32 |
|
|
RowStatus
Name |
Number |
Description |
ROW_STATUS_UNSPECIFIED |
0 |
|
ACTIVE |
1 |
|
ARCHIVED |
2 |
|
Top
api/v2/user_service.proto
CreateUserAccessTokenRequest
CreateUserAccessTokenResponse
CreateUserRequest
Field |
Type |
Label |
Description |
user |
User |
|
|
CreateUserResponse
Field |
Type |
Label |
Description |
user |
User |
|
|
DeleteUserAccessTokenRequest
Field |
Type |
Label |
Description |
name |
string |
|
The name of the user. Format: users/{id} |
access_token |
string |
|
access_token is the access token to delete. |
DeleteUserAccessTokenResponse
DeleteUserRequest
Field |
Type |
Label |
Description |
name |
string |
|
The name of the user. Format: users/{id} |
DeleteUserResponse
GetUserRequest
Field |
Type |
Label |
Description |
name |
string |
|
The name of the user. Format: users/{id} |
GetUserResponse
Field |
Type |
Label |
Description |
user |
User |
|
|
GetUserSettingRequest
Field |
Type |
Label |
Description |
name |
string |
|
The name of the user. Format: users/{id} |
GetUserSettingResponse
ListUserAccessTokensRequest
Field |
Type |
Label |
Description |
name |
string |
|
The name of the user. Format: users/{id} |
ListUserAccessTokensResponse
ListUsersRequest
ListUsersResponse
Field |
Type |
Label |
Description |
users |
User |
repeated |
|
SearchUsersRequest
Field |
Type |
Label |
Description |
filter |
string |
|
Filter is used to filter users returned in the list. Format: "username == frank" |
SearchUsersResponse
Field |
Type |
Label |
Description |
users |
User |
repeated |
|
UpdateUserRequest
UpdateUserResponse
Field |
Type |
Label |
Description |
user |
User |
|
|
UpdateUserSettingRequest
UpdateUserSettingResponse
User
UserAccessToken
UserSetting
Field |
Type |
Label |
Description |
name |
string |
|
The name of the user. Format: users/{id} |
locale |
string |
|
The preferred locale of the user. |
appearance |
string |
|
The preferred appearance of the user. |
memo_visibility |
string |
|
The default visibility of the memo. |
telegram_user_id |
string |
|
The telegram user id of the user. |
User.Role
Name |
Number |
Description |
ROLE_UNSPECIFIED |
0 |
|
HOST |
1 |
|
ADMIN |
2 |
|
USER |
3 |
|
UserService
Top
api/v2/auth_service.proto
GetAuthStatusRequest
GetAuthStatusResponse
Field |
Type |
Label |
Description |
user |
User |
|
|
SignInRequest
SignInResponse
Field |
Type |
Label |
Description |
user |
User |
|
|
SignInWithSSORequest
SignInWithSSOResponse
Field |
Type |
Label |
Description |
user |
User |
|
|
SignOutRequest
SignOutResponse
SignUpRequest
Field |
Type |
Label |
Description |
username |
string |
|
|
password |
string |
|
|
SignUpResponse
Field |
Type |
Label |
Description |
user |
User |
|
|
AuthService
Top
api/v2/inbox_service.proto
DeleteInboxRequest
Field |
Type |
Label |
Description |
name |
string |
|
The name of the inbox to delete. Format: inboxes/{uid} |
DeleteInboxResponse
Inbox
ListInboxesRequest
Field |
Type |
Label |
Description |
user |
string |
|
Format: users/{username} |
ListInboxesResponse
Field |
Type |
Label |
Description |
inboxes |
Inbox |
repeated |
|
UpdateInboxRequest
UpdateInboxResponse
Field |
Type |
Label |
Description |
inbox |
Inbox |
|
|
Inbox.Status
Name |
Number |
Description |
STATUS_UNSPECIFIED |
0 |
|
UNREAD |
1 |
|
ARCHIVED |
2 |
|
Inbox.Type
Name |
Number |
Description |
TYPE_UNSPECIFIED |
0 |
|
TYPE_MEMO_COMMENT |
1 |
|
TYPE_VERSION_UPDATE |
2 |
|
InboxService
Top
api/v2/link_service.proto
GetLinkMetadataRequest
Field |
Type |
Label |
Description |
link |
string |
|
|
GetLinkMetadataResponse
LinkMetadata
LinkService
Top
api/v2/memo_relation_service.proto
MemoRelation
Field |
Type |
Label |
Description |
memo |
string |
|
The name of memo. Format: "memos/{uid}" |
related_memo |
string |
|
The name of related memo. Format: "memos/{uid}" |
type |
MemoRelation.Type |
|
|
MemoRelation.Type
Name |
Number |
Description |
TYPE_UNSPECIFIED |
0 |
|
REFERENCE |
1 |
|
COMMENT |
2 |
|
Top
api/v2/reaction_service.proto
Reaction
Reaction.Type
Name |
Number |
Description |
TYPE_UNSPECIFIED |
0 |
|
THUMBS_UP |
1 |
|
THUMBS_DOWN |
2 |
|
HEART |
3 |
|
FIRE |
4 |
|
CLAPPING_HANDS |
5 |
|
LAUGH |
6 |
|
OK_HAND |
7 |
|
ROCKET |
8 |
|
EYES |
9 |
|
THINKING_FACE |
10 |
|
CLOWN_FACE |
11 |
|
QUESTION_MARK |
12 |
|
Top
api/v2/resource_service.proto
CreateResourceRequest
CreateResourceResponse
Field |
Type |
Label |
Description |
resource |
Resource |
|
|
DeleteResourceRequest
Field |
Type |
Label |
Description |
name |
string |
|
|
DeleteResourceResponse
GetResourceRequest
Field |
Type |
Label |
Description |
name |
string |
|
|
GetResourceResponse
Field |
Type |
Label |
Description |
resource |
Resource |
|
|
ListResourcesRequest
ListResourcesResponse
Field |
Type |
Label |
Description |
resources |
Resource |
repeated |
|
Resource
SearchResourcesRequest
Field |
Type |
Label |
Description |
filter |
string |
|
|
SearchResourcesResponse
Field |
Type |
Label |
Description |
resources |
Resource |
repeated |
|
UpdateResourceRequest
UpdateResourceResponse
Field |
Type |
Label |
Description |
resource |
Resource |
|
|
ResourceService
Top
api/v2/memo_service.proto
Field |
Type |
Label |
Description |
memo |
Memo |
|
|
CreateMemoRequest
CreateMemoResponse
Field |
Type |
Label |
Description |
memo |
Memo |
|
|
DeleteMemoReactionRequest
Field |
Type |
Label |
Description |
name |
string |
|
The name of the memo. Format: memos/{id} |
reaction_id |
int32 |
|
|
DeleteMemoReactionResponse
DeleteMemoRequest
Field |
Type |
Label |
Description |
name |
string |
|
The name of the memo. Format: memos/{id} |
DeleteMemoResponse
ExportMemosRequest
Field |
Type |
Label |
Description |
filter |
string |
|
Same as ListMemosRequest.filter |
ExportMemosResponse
Field |
Type |
Label |
Description |
content |
bytes |
|
|
GetMemoRequest
Field |
Type |
Label |
Description |
name |
string |
|
The name of the memo. Format: memos/{id} |
GetMemoResponse
Field |
Type |
Label |
Description |
memo |
Memo |
|
|
GetUserMemosStatsRequest
GetUserMemosStatsResponse
Field |
Type |
Label |
Description |
stats |
GetUserMemosStatsResponse.StatsEntry |
repeated |
stats is the stats of memo creating/updating activities. key is the year-month-day string. e.g. "2020-01-01". |
GetUserMemosStatsResponse.StatsEntry
Field |
Type |
Label |
Description |
name |
string |
|
The name of the memo. Format: memos/{id} |
Field |
Type |
Label |
Description |
memos |
Memo |
repeated |
|
ListMemoReactionsRequest
Field |
Type |
Label |
Description |
name |
string |
|
The name of the memo. Format: memos/{id} |
ListMemoReactionsResponse
Field |
Type |
Label |
Description |
reactions |
Reaction |
repeated |
|
ListMemoRelationsRequest
Field |
Type |
Label |
Description |
name |
string |
|
The name of the memo. Format: memos/{id} |
ListMemoRelationsResponse
Field |
Type |
Label |
Description |
relations |
MemoRelation |
repeated |
|
ListMemoResourcesRequest
Field |
Type |
Label |
Description |
name |
string |
|
The name of the memo. Format: memos/{id} |
ListMemoResourcesResponse
Field |
Type |
Label |
Description |
resources |
Resource |
repeated |
|
ListMemosRequest
Field |
Type |
Label |
Description |
page_size |
int32 |
|
The maximum number of memos to return. |
page_token |
string |
|
A page token, received from a previous ListMemos call. Provide this to retrieve the subsequent page. |
filter |
string |
|
Filter is used to filter memos returned in the list. Format: "creator == users/{uid} && visibilities == ['PUBLIC', 'PROTECTED']" |
ListMemosResponse
Field |
Type |
Label |
Description |
memos |
Memo |
repeated |
|
next_page_token |
string |
|
A token, which can be sent as page_token to retrieve the next page. If this field is omitted, there are no subsequent pages. |
Memo
SearchMemosRequest
Field |
Type |
Label |
Description |
filter |
string |
|
Filter is used to filter memos returned. Format: "creator == users/{uid} && visibilities == ['PUBLIC', 'PROTECTED']" |
SearchMemosResponse
Field |
Type |
Label |
Description |
memos |
Memo |
repeated |
|
SetMemoRelationsRequest
Field |
Type |
Label |
Description |
name |
string |
|
The name of the memo. Format: memos/{id} |
relations |
MemoRelation |
repeated |
|
SetMemoRelationsResponse
SetMemoResourcesRequest
Field |
Type |
Label |
Description |
name |
string |
|
The name of the memo. Format: memos/{id} |
resources |
Resource |
repeated |
|
SetMemoResourcesResponse
UpdateMemoRequest
UpdateMemoResponse
Field |
Type |
Label |
Description |
memo |
Memo |
|
|
UpsertMemoReactionRequest
Field |
Type |
Label |
Description |
name |
string |
|
The name of the memo. Format: memos/{id} |
reaction |
Reaction |
|
|
UpsertMemoReactionResponse
Field |
Type |
Label |
Description |
reaction |
Reaction |
|
|
Visibility
Name |
Number |
Description |
VISIBILITY_UNSPECIFIED |
0 |
|
PRIVATE |
1 |
|
PROTECTED |
2 |
|
PUBLIC |
3 |
|
MemoService
Top
api/v2/tag_service.proto
BatchUpsertTagRequest
BatchUpsertTagResponse
DeleteTagRequest
Field |
Type |
Label |
Description |
tag |
Tag |
|
|
DeleteTagResponse
GetTagSuggestionsRequest
Field |
Type |
Label |
Description |
user |
string |
|
The creator of tags. Format: users/{id} |
GetTagSuggestionsResponse
Field |
Type |
Label |
Description |
tags |
string |
repeated |
|
ListTagsRequest
Field |
Type |
Label |
Description |
user |
string |
|
The creator of tags. Format: users/{id} |
ListTagsResponse
Field |
Type |
Label |
Description |
tags |
Tag |
repeated |
|
RenameTagRequest
Field |
Type |
Label |
Description |
user |
string |
|
The creator of tags. Format: users/{id} |
old_name |
string |
|
|
new_name |
string |
|
|
RenameTagResponse
Field |
Type |
Label |
Description |
tag |
Tag |
|
|
Tag
Field |
Type |
Label |
Description |
name |
string |
|
|
creator |
string |
|
The creator of tags. Format: users/{id} |
UpsertTagRequest
Field |
Type |
Label |
Description |
name |
string |
|
|
UpsertTagResponse
Field |
Type |
Label |
Description |
tag |
Tag |
|
|
TagService
Top
api/v2/webhook_service.proto
CreateWebhookRequest
CreateWebhookResponse
Field |
Type |
Label |
Description |
webhook |
Webhook |
|
|
DeleteWebhookRequest
Field |
Type |
Label |
Description |
id |
int32 |
|
|
DeleteWebhookResponse
GetWebhookRequest
Field |
Type |
Label |
Description |
id |
int32 |
|
|
GetWebhookResponse
Field |
Type |
Label |
Description |
webhook |
Webhook |
|
|
ListWebhooksRequest
Field |
Type |
Label |
Description |
creator_id |
int32 |
|
|
ListWebhooksResponse
Field |
Type |
Label |
Description |
webhooks |
Webhook |
repeated |
|
UpdateWebhookRequest
UpdateWebhookResponse
Field |
Type |
Label |
Description |
webhook |
Webhook |
|
|
Webhook
WebhookService
Top
api/v2/workspace_service.proto
GetWorkspaceProfileRequest
GetWorkspaceProfileResponse
WorkspaceProfile
Field |
Type |
Label |
Description |
owner |
string |
|
The name of intance owner. Format: "users/{id}" |
version |
string |
|
version is the current version of instance |
mode |
string |
|
mode is the instance mode (e.g. "prod", "dev" or "demo"). |
disallow_signup |
bool |
|
disallow_signup is whether the signup is disallowed. |
disable_password_login |
bool |
|
disable_password_login is whether the password login is disabled. |
additional_script |
string |
|
additional_script is the additional script. |
additional_style |
string |
|
additional_style is the additional style. |
WorkspaceService
Top
api/v2/workspace_setting_service.proto
GetWorkspaceSettingRequest
Field |
Type |
Label |
Description |
name |
string |
|
The resource name of the workspace setting. Format: settings/{setting} |
GetWorkspaceSettingResponse
SetWorkspaceSettingRequest
Field |
Type |
Label |
Description |
setting |
WorkspaceSetting |
|
setting is the setting to update. |
SetWorkspaceSettingResponse
WorkspaceGeneralSetting
Field |
Type |
Label |
Description |
instance_url |
string |
|
instance_url is the instance URL. |
disallow_signup |
bool |
|
disallow_signup is the flag to disallow signup. |
disallow_password_login |
bool |
|
disallow_password_login is the flag to disallow password login. |
additional_script |
string |
|
additional_script is the additional script. |
additional_style |
string |
|
additional_style is the additional style. |
WorkspaceSetting
Field |
Type |
Label |
Description |
name |
string |
|
name is the name of the setting. Format: settings/{setting} |
general_setting |
WorkspaceGeneralSetting |
|
general_setting is the general setting of workspace. |
WorkspaceSettingService
Scalar Value Types
.proto Type |
Notes |
C++ |
Java |
Python |
Go |
C# |
PHP |
Ruby |
double |
|
double |
double |
float |
float64 |
double |
float |
Float |
float |
|
float |
float |
float |
float32 |
float |
float |
Float |
int32 |
Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint32 instead. |
int32 |
int |
int |
int32 |
int |
integer |
Bignum or Fixnum (as required) |
int64 |
Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint64 instead. |
int64 |
long |
int/long |
int64 |
long |
integer/string |
Bignum |
uint32 |
Uses variable-length encoding. |
uint32 |
int |
int/long |
uint32 |
uint |
integer |
Bignum or Fixnum (as required) |
uint64 |
Uses variable-length encoding. |
uint64 |
long |
int/long |
uint64 |
ulong |
integer/string |
Bignum or Fixnum (as required) |
sint32 |
Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int32s. |
int32 |
int |
int |
int32 |
int |
integer |
Bignum or Fixnum (as required) |
sint64 |
Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int64s. |
int64 |
long |
int/long |
int64 |
long |
integer/string |
Bignum |
fixed32 |
Always four bytes. More efficient than uint32 if values are often greater than 2^28. |
uint32 |
int |
int |
uint32 |
uint |
integer |
Bignum or Fixnum (as required) |
fixed64 |
Always eight bytes. More efficient than uint64 if values are often greater than 2^56. |
uint64 |
long |
int/long |
uint64 |
ulong |
integer/string |
Bignum |
sfixed32 |
Always four bytes. |
int32 |
int |
int |
int32 |
int |
integer |
Bignum or Fixnum (as required) |
sfixed64 |
Always eight bytes. |
int64 |
long |
int/long |
int64 |
long |
integer/string |
Bignum |
bool |
|
bool |
boolean |
boolean |
bool |
bool |
boolean |
TrueClass/FalseClass |
string |
A string must always contain UTF-8 encoded or 7-bit ASCII text. |
string |
String |
str/unicode |
string |
string |
string |
String (UTF-8) |
bytes |
May contain any arbitrary sequence of bytes. |
string |
ByteString |
str |
[]byte |
ByteString |
string |
String (ASCII-8BIT) |