Protocol Documentation

Table of Contents

• api/v1/common.proto

  • RowStatus

• api/v1/user_service.proto

  • CreateUserAccessTokenRequest

  • CreateUserAccessTokenResponse

  • CreateUserRequest

  • CreateUserResponse

  • DeleteUserAccessTokenRequest

  • DeleteUserAccessTokenResponse

  • DeleteUserRequest

  • DeleteUserResponse

  • GetUserRequest

  • GetUserResponse

  • ListUserAccessTokensRequest

  • ListUserAccessTokensResponse

  • ListUsersRequest

  • ListUsersResponse

  • UpdateUserRequest

  • UpdateUserResponse

  • User

  • UserAccessToken

  • UserService

• Scalar Value Types

Top

api/v1/common.proto

RowStatus

Name	Number	Description
ROW_STATUS_UNSPECIFIED	0
ACTIVE	1
ARCHIVED	2

Top

api/v1/user_service.proto

CreateUserAccessTokenRequest

Field	Type	Label	Description
name	string		The name of the user. Format: users/{username}
description	string
expires_at	google.protobuf.Timestamp	optional

CreateUserAccessTokenResponse

Field	Type	Label	Description
access_token	UserAccessToken

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/{username}
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/{username}

DeleteUserResponse

GetUserRequest

Field	Type	Label	Description
name	string		The name of the user. Format: users/{username}

GetUserResponse

Field	Type	Label	Description
user	User

ListUserAccessTokensRequest

Field	Type	Label	Description
name	string		The name of the user. Format: users/{username}

ListUserAccessTokensResponse

Field	Type	Label	Description
access_tokens	UserAccessToken	repeated

ListUsersRequest

ListUsersResponse

Field	Type	Label	Description
users	User	repeated

UpdateUserRequest

Field	Type	Label	Description
user	User
update_mask	google.protobuf.FieldMask

UpdateUserResponse

Field	Type	Label	Description
user	User

User

Field	Type	Label	Description
name	string		The name of the user. Format: users/{username}
id	string
username	string
email	string
nickname	string
avatar_url	string
password	string
created_at	google.protobuf.Timestamp
updated_at	google.protobuf.Timestamp

UserAccessToken

Field	Type	Label	Description
access_token	string
description	string
issued_at	google.protobuf.Timestamp
expires_at	google.protobuf.Timestamp

UserService

Method Name	Request Type	Response Type	Description
ListUsers	ListUsersRequest	ListUsersResponse	ListUsers returns a list of users.
GetUser	GetUserRequest	GetUserResponse	GetUser gets a user by name.
CreateUser	CreateUserRequest	CreateUserResponse	CreateUser creates a new user.
UpdateUser	UpdateUserRequest	UpdateUserResponse	UpdateUser updates a user.
DeleteUser	DeleteUserRequest	DeleteUserResponse	DeleteUser deletes a user.
ListUserAccessTokens	ListUserAccessTokensRequest	ListUserAccessTokensResponse	ListUserAccessTokens returns a list of access tokens for a user.
CreateUserAccessToken	CreateUserAccessTokenRequest	CreateUserAccessTokenResponse	CreateUserAccessToken creates a new access token for a user.
DeleteUserAccessToken	DeleteUserAccessTokenRequest	DeleteUserAccessTokenResponse	DeleteUserAccessToken deletes an access token for a user.

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)