IRPCConversationOperations.GetConversationById

Vault API / standard write session

Gets one of the caller's conversations by ID.

Service	Conversations `MFiles.IRPCConversationOperations`
gRPC method	`/MFiles.IRPCConversationOperations/GetConversationById`
HTTP (mf-http-grpc)	`POST /grpc/v1/get-conversation-by-id`
Request	`GetConversationByIdRequest`
Response	`GetConversationByIdResponse`
Book and level	Vault API, standard
Kind	write
Session	Required: the session ID from LogIn in the mfiles-session-id-bin metadata.
Idempotent	no
Returns metadata structure version	no
Streaming	none (unary)

Remarks

A conversation of another user, or an ID that does not exist, fails with "Access is denied.". ID 0 fails with "The parameter is incorrect.".

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

Field	Type	Description
`id`	`uint32`	The ID of the conversation.

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

Field	Type	Description
`updated_conversation`	`Conversation`	The requested conversation of the caller.
`updated_conversation.id`	`uint32`	The ID of the conversation, assigned by the server.
`updated_conversation.user_id`	`uint32`	The ID of the user account that owns the conversation. Set by the server.
`updated_conversation.type`	`ConversationType`	The kind of conversation. Set when the conversation is created.Values: `CONVERSATION_TYPE_UNDEFINED` (0), `CONVERSATION_TYPE_AINO` (1).
`updated_conversation.title`	`string`	The title of the conversation, as plain text.
`updated_conversation.sort_key`	`uint32`	Orders conversations; newer conversations have larger values. Used for paging.
`updated_conversation.created`	`google.protobuf.Timestamp`	When the conversation was created (UTC).
`updated_conversation.modified`	`google.protobuf.Timestamp`	When the conversation was created or last renamed (UTC).