[ Web Proxy ]
URL:
Viewing: https://cloud.google.com/dialogflow/es/docs/reference/rest/v2/projects.agent.knowledgeBases/list [Back]  [Original]

Method: projects.agent.knowledgeBases.list  |  Dialogflow ES  |  Google Cloud Documentation Skip to main content
Google Cloud Documentation [Google Cloud Documentation]
Send feedback

Method: projects.agent.knowledgeBases.list Stay organized with collections Save and categorize content based on your preferences.

Returns the list of all knowledge bases of the specified agent.

HTTP request

GET https://{endpoint}/v2/{parent=projects/*/agent}/knowledgeBases

Where {endpoint} is one of the supported service endpoints.

The URLs use gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The project to list of knowledge bases for. Format: projects/<Project ID>/locations/<Location ID>.

Authorization requires the following IAM permission on the specified resource parent:

  • dialogflow.knowledgeBases.list

Query parameters

Parameters
pageSize

integer

The maximum number of items to return in a single page. By default 10 and at most 100.

pageToken

string

The nextPageToken value returned from a previous list request.

filter

string

The filter expression used to filter knowledge bases returned by the list method. The expression has the following syntax:

[AND ] ...

The following fields and operators are supported:

  • displayName with has(:) operator
  • languageCode with equals(=) operator

Examples:

  • 'languageCode=en-us' matches knowledge bases with en-us language code.
  • 'displayName:articles' matches knowledge bases whose display name contains "articles".
  • 'displayName:"Best Articles"' matches knowledge bases whose display name contains "Best Articles".
  • 'languageCode=en-gb AND displayName=articles' matches all knowledge bases whose display name contains "articles" and whose language code is "en-gb".

Note: An empty filter string (i.e. "") is a no-op and will result in no filtering.

For more information about filtering, see API Filtering.

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of ListKnowledgeBasesResponse.

Authorization scopes

Requires one of the following OAuth scopes:

For more information, see the Authentication Overview.

Send feedback

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-06-27 UTC.

Need to tell us more? [[["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."],[],[]]

Web Proxy Viewer  |  New URL  |  Original Page