IRPCConversationOperations.GetConversations
Vault API / standard write session
Gets the caller's conversations, newest first, up to 100 per call.
| Service | Conversations MFiles.IRPCConversationOperations |
|---|---|
| gRPC method | /MFiles.IRPCConversationOperations/GetConversations |
| HTTP (mf-http-grpc) | POST /grpc/v1/get-conversations |
| Request | GetConversationsRequest |
| Response | GetConversationsResponse |
| 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
- Returns only the caller's own conversations. See the service overview for paging.
Request: GetConversationsRequest
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 |
|---|---|---|
sort_key | uint32 | 0 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.
| Field | Type | Description |
|---|---|---|
conversations[] | repeated Conversation | Up to 100 conversations in descending sort_key order. |
conversations[].id | uint32 | The ID of the conversation, assigned by the server. |
conversations[].user_id | uint32 | The ID of the user account that owns the conversation. Set by the server. |
conversations[].type | ConversationType | The kind of conversation. Set when the conversation is created.Values: CONVERSATION_TYPE_UNDEFINED (0), CONVERSATION_TYPE_AINO (1). |
conversations[].title | string | The title of the conversation, as plain text. |
conversations[].sort_key | uint32 | Orders conversations; newer conversations have larger values. Used for paging. |
conversations[].created | google.protobuf.Timestamp | When the conversation was created (UTC). |
conversations[].modified | google.protobuf.Timestamp | When the conversation was created or last renamed (UTC). |
more_results | bool | True if older conversations remain. |