Since there is at most one conversational agent per project, this method is useful primarily for listing all agents across projects the caller has access to. One can achieve that with a wildcard project collection id "-". Refer to List Sub-Collections.
HTTP request
GET https://{endpoint}/v2/{parent=projects/*/locations/*}/agent:search
[[["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-06-27 UTC."],[[["\u003cp\u003eThis endpoint retrieves a list of agents across projects that the caller has access to, utilizing a wildcard project collection ID for comprehensive coverage.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request is a \u003ccode\u003eGET\u003c/code\u003e operation to a specific URL, which uses gRPC Transcoding syntax and requires a defined endpoint and parent project location.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eparent\u003c/code\u003e parameter, representing the project, is mandatory and must have the correct IAM permissions \u003ccode\u003edialogflow.agents.search\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eOptional query parameters, \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e, allow for control over the number of items returned and the navigation through multiple pages of results.\u003c/p\u003e\n"],["\u003cp\u003eThe request body is empty for this operation, and a successful response will be contained in the \u003ccode\u003eSearchAgentsResponse\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,[]]