Full name: projects.locations.instances.users.conversations.list
ListConversations is used to retrieve existing conversations.
HTTP request
GET https://chronicle.googleapis.com/v1alpha/{parent}/conversations
Path parameters
Parameters
parent
string
Required. The parent, which owns this collection of conversations. Format: projects/{project}/locations/{location}/instances/{instance}/users/{user}
Query parameters
Parameters
pageSize
integer
Optional. The maximum number of conversations to return. The service may return fewer than this value. If unspecified, at most 100 conversations will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
pageToken
string
Optional. A page token, received from a previous ListConversations call. Provide this to retrieve the subsequent page.
When paginating, all other parameters provided to ListConversations must match the call that provided the page token.
Request body
The request body must be empty.
Response body
Response message for ListConversations method.
If successful, the response body contains data with the following structure:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-14 UTC."],[[["\u003cp\u003eThis page details how to use the \u003ccode\u003eListConversations\u003c/code\u003e method to retrieve existing conversations within a specified instance.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request utilizes a \u003ccode\u003eGET\u003c/code\u003e method with a specific URL structure, including a required \u003ccode\u003eparent\u003c/code\u003e path parameter defining the project, location, instance, and user.\u003c/p\u003e\n"],["\u003cp\u003eOptional query parameters, such as \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e, allow for managing the number of conversations returned and retrieving subsequent pages of results.\u003c/p\u003e\n"],["\u003cp\u003eThe request body for \u003ccode\u003eListConversations\u003c/code\u003e must be empty, while the response body contains a list of conversation objects and a potential \u003ccode\u003enext_page_token\u003c/code\u003e for pagination.\u003c/p\u003e\n"],["\u003cp\u003eAccessing this method requires the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope and the \u003ccode\u003echronicle.conversations.list\u003c/code\u003e IAM permission on the parent resource.\u003c/p\u003e\n"]]],[],null,[]]