Returns the list of agents. 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 toList Sub-Collections.
HTTP request
GET https://{endpoint}/v2beta1/{parent=projects/*}/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, useful for viewing all agents across projects accessible to the caller.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request uses the \u003ccode\u003eGET\u003c/code\u003e method with a specified endpoint and parent project in the path parameters, formatted as \u003ccode\u003eprojects/<Project ID or '-'>\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eRequired path parameter \u003ccode\u003eparent\u003c/code\u003e indicates the project from which to list agents, requiring \u003ccode\u003edialogflow.agents.search\u003c/code\u003e IAM permission.\u003c/p\u003e\n"],["\u003cp\u003eOptional query parameters \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e allow for pagination of results, with a default page size of 100, up to 1000.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must be empty, and a successful response returns a \u003ccode\u003eSearchAgentsResponse\u003c/code\u003e object, and it requires authorization with \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/dialogflow\u003c/code\u003e scopes.\u003c/p\u003e\n"]]],[],null,["# Method: projects.agent.search\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nReturns the list of agents. 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](https://cloud.google.com/apis/design/design_patterns#list_sub-collections).\n\n### HTTP request\n\n`GET https://{endpoint}/v2beta1/{parent=projects/*}/agent:search`\n\nWhere `{endpoint}` is one of the [supported service endpoints](/dialogflow/es/docs/reference/rest#rest_endpoints).\n\nThe URLs use [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [SearchAgentsResponse](/dialogflow/es/docs/reference/rest/v2beta1/SearchAgentsResponse).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n- `\n https://www.googleapis.com/auth/dialogflow`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp)."]]
