IRPCConversationOperations.GetConversations

View as Markdown

Vault API / standard write session

Gets the caller's conversations, newest first, up to 100 per call.

ServiceConversations MFiles.IRPCConversationOperations
gRPC method/MFiles.IRPCConversationOperations/GetConversations
HTTP (mf-http-grpc)POST /grpc/v1/get-conversations
RequestGetConversationsRequest
ResponseGetConversationsResponse
Book and levelVault API, standard
Kindwrite
SessionRequired: the session ID from LogIn in the mfiles-session-id-bin metadata.
Idempotentno
Returns metadata structure versionno
Streamingnone (unary)

Remarks

Request: GetConversationsRequest

Nested message fields are expanded to depth 3; follow a type link for deeper levels and for the type's own page.

FieldTypeDescription
sort_keyuint320 for the first page; for the next page, the smallest sort_key of the previous page.

Response: GetConversationsResponse

Nested message fields are expanded to depth 3; follow a type link for deeper levels and for the type's own page.

FieldTypeDescription
conversations[]repeated ConversationUp to 100 conversations in descending sort_key order.
conversations[].iduint32The ID of the conversation, assigned by the server.
conversations[].user_iduint32The ID of the user account that owns the conversation. Set by the server.
conversations[].typeConversationTypeThe kind of conversation. Set when the conversation is created.Values: CONVERSATION_TYPE_UNDEFINED (0), CONVERSATION_TYPE_AINO (1).
conversations[].titlestringThe title of the conversation, as plain text.
conversations[].sort_keyuint32Orders conversations; newer conversations have larger values. Used for paging.
conversations[].createdgoogle.protobuf.TimestampWhen the conversation was created (UTC).
conversations[].modifiedgoogle.protobuf.TimestampWhen the conversation was created or last renamed (UTC).
more_resultsboolTrue if older conversations remain.