Google Dialogflow Knowledge Bases API

The Knowledge Bases API from Google Dialogflow — 6 operation(s) for knowledge bases.

Operations 15

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

DELETE /v2/projects/{projectsId}/knowledgeBases/{knowledgeBasesId} Delete a project-level knowledge base · Dialogflow projects knowledge bases delete #
Ask an LLM
“Can I delete a knowledge base that still has documents in it?”
“Is a forced delete needed to remove a non-empty project-level knowledge base?”
Tell an agent destructive · confirm first
Delete knowledge base {knowledge_base} in project {project}.
Force-delete project-level knowledge base {knowledge_base} along with its documents, force={force}.
GET /v2/projects/{projectsId}/knowledgeBases/{knowledgeBasesId} Retrieve a project-level knowledge base · Dialogflow projects knowledge bases get #
Ask an LLM
“What language and display name does one of my Dialogflow knowledge bases have?”
“Can I fetch a project-level knowledge base by its ID?”
Tell an agent
Get knowledge base {knowledge_base} in project {project}.
Show the details of project-level knowledge base {knowledge_base}.
PATCH /v2/projects/{projectsId}/knowledgeBases/{knowledgeBasesId} Update a project-level knowledge base · Dialogflow projects knowledge bases patch #
Ask an LLM
“How do I rename a knowledge base in my project?”
“Can I change the language code of an existing project-level knowledge base?”
Tell an agent
Rename knowledge base {knowledge_base} in project {project} to {display_name}.
Set the language of project-level knowledge base {knowledge_base} to {language}.
POST /v2/projects/{projectsId}/knowledgeBases Create a project-level knowledge base · Dialogflow projects knowledge bases create #
Ask an LLM
“How do I create a new knowledge base to hold FAQ documents?”
“Can I set the language when creating a project-level knowledge base?”
Tell an agent
Create a knowledge base named {display_name} in project {project}.
Make a new project-level knowledge base {display_name} in language {language}.
GET /v2/projects/{projectsId}/knowledgeBases List project-level knowledge bases · Dialogflow projects knowledge bases list #
Ask an LLM
“Which knowledge bases exist in my Google Cloud project?”
“Can I filter my knowledge bases, for instance by display name or language?”
Tell an agent
List the knowledge bases in project {project}.
Show project {project}'s knowledge bases that match filter {filter}.
DELETE /v2/projects/{projectsId}/locations/{locationsId}/knowledgeBases/{knowledgeBasesId} Delete a regional knowledge base · Dialogflow projects locations knowledge bases delete #
Ask an LLM
“Can I delete a knowledge base hosted in a particular location?”
“Does removing a regional knowledge base with documents require the force flag?”
Tell an agent destructive · confirm first
Delete regional knowledge base {knowledge_base} in project {project}, location {location}.
Remove the {location} knowledge base {knowledge_base} even if it has documents, force={force}.
GET /v2/projects/{projectsId}/locations/{locationsId}/knowledgeBases/{knowledgeBasesId} Retrieve a regional knowledge base · Dialogflow projects locations knowledge bases get #
Ask an LLM
“Can I look up a knowledge base that is stored in a specific region?”
“What settings does a regional knowledge base have?”
Tell an agent
Get regional knowledge base {knowledge_base} in project {project}, location {location}.
Show the {location} knowledge base {knowledge_base}.
PATCH /v2/projects/{projectsId}/locations/{locationsId}/knowledgeBases/{knowledgeBasesId} Update a regional knowledge base · Dialogflow projects locations knowledge bases patch #
Ask an LLM
“How can I rename a knowledge base that lives in a specific region?”
“Can I update only selected fields of a regional knowledge base?”
Tell an agent
Rename regional knowledge base {knowledge_base} in project {project}, location {location} to {display_name}.
Update fields {update_mask} on the {location} knowledge base {knowledge_base}.
POST /v2/projects/{projectsId}/locations/{locationsId}/knowledgeBases Create a knowledge base in a region · Dialogflow projects locations knowledge bases create #
Ask an LLM
“How do I create a knowledge base that keeps its data in a specific region?”
“Can a regional knowledge base be created for a non-English language?”
Tell an agent
Create a regional knowledge base {display_name} in project {project}, location {location}.
Make a {location} knowledge base named {display_name} for language {language}.
GET /v2/projects/{projectsId}/locations/{locationsId}/knowledgeBases List knowledge bases in a region · Dialogflow projects locations knowledge bases list #
Ask an LLM
“Which knowledge bases do I have in a given location?”
“Can regional knowledge bases be listed with a filter and page size?”
Tell an agent
List knowledge bases in project {project}, location {location}.
Show {page_size} knowledge bases at a time from region {location}.
DELETE /v2/projects/{projectsId}/agent/knowledgeBases/{knowledgeBasesId} Delete a knowledge base attached to an agent · Dialogflow projects agent knowledge bases delete #
Ask an LLM
“Can I detach and delete a knowledge base from my ES agent?”
“Will deleting an agent knowledge base fail if documents remain unless forced?”
Tell an agent destructive · confirm first
Delete my agent's knowledge base {knowledge_base} in project {project}.
Drop agent knowledge base {knowledge_base} with force set to {force}.
PATCH /v2/projects/{projectsId}/agent/knowledgeBases/{knowledgeBasesId} Update a knowledge base attached to an agent · Dialogflow projects agent knowledge bases patch #
Ask an LLM
“Can I rename the knowledge base my ES agent answers from?”
“Is the language of an agent knowledge base editable?”
Tell an agent
Rename my agent's knowledge base {knowledge_base} in project {project} to {display_name}.
Change agent knowledge base {knowledge_base} to language {language}.
GET /v2/projects/{projectsId}/agent/knowledgeBases/{knowledgeBasesId} Retrieve a knowledge base attached to an agent · Dialogflow projects agent knowledge bases get #
Ask an LLM
“What knowledge base is my ES agent using, and what are its settings?”
“Can I read an agent knowledge base by ID?”
Tell an agent
Get my agent's knowledge base {knowledge_base} in project {project}.
Display agent knowledge base {knowledge_base}.
POST /v2/projects/{projectsId}/agent/knowledgeBases Create a knowledge base for an agent · Dialogflow projects agent knowledge bases create #
Ask an LLM
“How do I give my ES agent its own knowledge base?”
“Can I pick a language for a knowledge base created under my agent?”
Tell an agent
Create a knowledge base {display_name} for my agent in project {project}.
Add agent knowledge base {display_name} in language {language} to project {project}.
GET /v2/projects/{projectsId}/agent/knowledgeBases List knowledge bases attached to an agent · Dialogflow projects agent knowledge bases list #
Ask an LLM
“Which knowledge bases are connected to my project's ES agent?”
“Can I filter the list of agent knowledge bases?”
Tell an agent
List my agent's knowledge bases in project {project}.
Show agent knowledge bases in project {project} matching {filter}.

Documentation

Specifications

Other Resources

🔗
Discovery
https://raw.githubusercontent.com/api-evangelist/google-dialogflow/refs/heads/main/discovery/google-dialogflow-v3.json
🔗
Discovery
https://raw.githubusercontent.com/api-evangelist/google-dialogflow/refs/heads/main/discovery/google-dialogflow-v3beta1.json
🔗
Protobuf
https://raw.githubusercontent.com/api-evangelist/google-dialogflow/refs/heads/main/grpc/cx-v3/session.proto
🔗
Protobuf
https://raw.githubusercontent.com/api-evangelist/google-dialogflow/refs/heads/main/grpc/cx-v3/agent.proto
🔗
Protobuf
https://raw.githubusercontent.com/api-evangelist/google-dialogflow/refs/heads/main/grpc/cx-v3/webhook.proto
🔗
Protobuf
https://raw.githubusercontent.com/api-evangelist/google-dialogflow/refs/heads/main/grpc/cx-v3/tool.proto
🔗
Pricing
https://cloud.google.com/dialogflow/pricing
🔗
Console
https://dialogflow.cloud.google.com/cx
🔗
Webhooks
https://cloud.google.com/dialogflow/cx/docs/concept/webhook
🔗
Discovery
https://raw.githubusercontent.com/api-evangelist/google-dialogflow/refs/heads/main/discovery/google-dialogflow-v2.json
🔗
Discovery
https://raw.githubusercontent.com/api-evangelist/google-dialogflow/refs/heads/main/discovery/google-dialogflow-v2beta1.json
🔗
Protobuf
https://raw.githubusercontent.com/api-evangelist/google-dialogflow/refs/heads/main/grpc/v2/session.proto
🔗
Protobuf
https://raw.githubusercontent.com/api-evangelist/google-dialogflow/refs/heads/main/grpc/v2/agent.proto
🔗
Protobuf
https://raw.githubusercontent.com/api-evangelist/google-dialogflow/refs/heads/main/grpc/v2/intent.proto
🔗
Protobuf
https://raw.githubusercontent.com/api-evangelist/google-dialogflow/refs/heads/main/grpc/v2/webhook.proto
🔗
Console
https://dialogflow.cloud.google.com/
🔗
Webhooks
https://cloud.google.com/dialogflow/es/docs/fulfillment-webhook

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/google-dialogflow:google-dialogflow-knowledge-bases-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

google-dialogflow-knowledge-bases-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Dialogflow ES API (v2) Knowledge Bases API
  version: v2
  description: Dialogflow ES (Essentials) builds conversational interfaces with intents, entity types, contexts, sessions, knowledge bases, conversation profiles and Agent Assist. This OpenAPI is a mechanical conversion of the first-party Google Discovery Document served by dialogflow.googleapis.com.
  contact:
    name: Google Cloud
    url: https://cloud.google.com/dialogflow/
  termsOfService: https://cloud.google.com/terms
  license:
    name: Google APIs Terms of Service
    url: https://developers.google.com/terms
  x-discovery-source: https://dialogflow.googleapis.com/$discovery/rest?version=v2
  x-discovery-revision: '20260825'
  x-discovery-id: dialogflow:v2
servers:
- url: https://dialogflow.googleapis.com
  description: Dialogflow API
security:
- OAuth2:
  - https://www.googleapis.com/auth/dialogflow
  - https://www.googleapis.com/auth/cloud-platform
- BearerAuth: []
tags:
- name: Knowledge Bases
paths:
  /v2/projects/{projectsId}/knowledgeBases/{knowledgeBasesId}:
    delete:
      operationId: dialogflow_projects_knowledgeBases_delete
      tags:
      - Knowledge Bases
      parameters:
      - name: projectsId
        in: path
        description: 'Part of `name`. Resource name pattern: `^projects/[^/]+/knowledgeBases/[^/]+$`.'
        required: true
        schema:
          type: string
      - name: knowledgeBasesId
        in: path
        description: 'Part of `name`. Resource name pattern: `^projects/[^/]+/knowledgeBases/[^/]+$`.'
        required: true
        schema:
          type: string
      - name: force
        in: query
        schema:
          type: boolean
      x-discovery-path-template: v2/{name}
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleProtobufEmpty'
        default:
          description: Error response (google.rpc.Status)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcStatus'
      security:
      - OAuth2:
        - https://www.googleapis.com/auth/cloud-platform
        - https://www.googleapis.com/auth/dialogflow
      - BearerAuth: []
      summary: Dialogflow projects knowledge bases delete
      x-summary-source: derived
    get:
      operationId: dialogflow_projects_knowledgeBases_get
      tags:
      - Knowledge Bases
      parameters:
      - name: projectsId
        in: path
        description: 'Part of `name`. Resource name pattern: `^projects/[^/]+/knowledgeBases/[^/]+$`.'
        required: true
        schema:
          type: string
      - name: knowledgeBasesId
        in: path
        description: 'Part of `name`. Resource name pattern: `^projects/[^/]+/knowledgeBases/[^/]+$`.'
        required: true
        schema:
          type: string
      x-discovery-path-template: v2/{name}
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleCloudDialogflowV2KnowledgeBase'
        default:
          description: Error response (google.rpc.Status)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcStatus'
      security:
      - OAuth2:
        - https://www.googleapis.com/auth/cloud-platform
        - https://www.googleapis.com/auth/dialogflow
      - BearerAuth: []
      summary: Dialogflow projects knowledge bases get
      x-summary-source: derived
    patch:
      operationId: dialogflow_projects_knowledgeBases_patch
      tags:
      - Knowledge Bases
      parameters:
      - name: projectsId
        in: path
        description: 'Part of `name`. Resource name pattern: `^projects/[^/]+/knowledgeBases/[^/]+$`.'
        required: true
        schema:
          type: string
      - name: knowledgeBasesId
        in: path
        description: 'Part of `name`. Resource name pattern: `^projects/[^/]+/knowledgeBases/[^/]+$`.'
        required: true
        schema:
          type: string
      - name: updateMask
        in: query
        schema:
          type: string
      x-discovery-path-template: v2/{name}
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GoogleCloudDialogflowV2KnowledgeBase'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleCloudDialogflowV2KnowledgeBase'
        default:
          description: Error response (google.rpc.Status)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcStatus'
      security:
      - OAuth2:
        - https://www.googleapis.com/auth/cloud-platform
        - https://www.googleapis.com/auth/dialogflow
      - BearerAuth: []
      summary: Dialogflow projects knowledge bases patch
      x-summary-source: derived
  /v2/projects/{projectsId}/knowledgeBases:
    post:
      operationId: dialogflow_projects_knowledgeBases_create
      tags:
      - Knowledge Bases
      parameters:
      - name: projectsId
        in: path
        description: 'Part of `parent`. Resource name pattern: `^projects/[^/]+$`.'
        required: true
        schema:
          type: string
      x-discovery-path-template: v2/{parent}/knowledgeBases
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GoogleCloudDialogflowV2KnowledgeBase'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleCloudDialogflowV2KnowledgeBase'
        default:
          description: Error response (google.rpc.Status)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcStatus'
      security:
      - OAuth2:
        - https://www.googleapis.com/auth/cloud-platform
        - https://www.googleapis.com/auth/dialogflow
      - BearerAuth: []
      summary: Dialogflow projects knowledge bases create
      x-summary-source: derived
    get:
      operationId: dialogflow_projects_knowledgeBases_list
      tags:
      - Knowledge Bases
      parameters:
      - name: projectsId
        in: path
        description: 'Part of `parent`. Resource name pattern: `^projects/[^/]+$`.'
        required: true
        schema:
          type: string
      - name: filter
        in: query
        schema:
          type: string
      - name: pageToken
        in: query
        schema:
          type: string
      - name: pageSize
        in: query
        schema:
          type: integer
          format: int32
      x-discovery-path-template: v2/{parent}/knowledgeBases
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleCloudDialogflowV2ListKnowledgeBasesResponse'
        default:
          description: Error response (google.rpc.Status)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcStatus'
      security:
      - OAuth2:
        - https://www.googleapis.com/auth/cloud-platform
        - https://www.googleapis.com/auth/dialogflow
      - BearerAuth: []
      summary: Dialogflow projects knowledge bases list
      x-summary-source: derived
  /v2/projects/{projectsId}/locations/{locationsId}/knowledgeBases/{knowledgeBasesId}:
    delete:
      operationId: dialogflow_projects_locations_knowledgeBases_delete
      tags:
      - Knowledge Bases
      parameters:
      - name: projectsId
        in: path
        description: 'Part of `name`. Resource name pattern: `^projects/[^/]+/locations/[^/]+/knowledgeBases/[^/]+$`.'
        required: true
        schema:
          type: string
      - name: locationsId
        in: path
        description: 'Part of `name`. Resource name pattern: `^projects/[^/]+/locations/[^/]+/knowledgeBases/[^/]+$`.'
        required: true
        schema:
          type: string
      - name: knowledgeBasesId
        in: path
        description: 'Part of `name`. Resource name pattern: `^projects/[^/]+/locations/[^/]+/knowledgeBases/[^/]+$`.'
        required: true
        schema:
          type: string
      - name: force
        in: query
        schema:
          type: boolean
      x-discovery-path-template: v2/{name}
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleProtobufEmpty'
        default:
          description: Error response (google.rpc.Status)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcStatus'
      security:
      - OAuth2:
        - https://www.googleapis.com/auth/cloud-platform
        - https://www.googleapis.com/auth/dialogflow
      - BearerAuth: []
      summary: Dialogflow projects locations knowledge bases delete
      x-summary-source: derived
    get:
      operationId: dialogflow_projects_locations_knowledgeBases_get
      tags:
      - Knowledge Bases
      parameters:
      - name: projectsId
        in: path
        description: 'Part of `name`. Resource name pattern: `^projects/[^/]+/locations/[^/]+/knowledgeBases/[^/]+$`.'
        required: true
        schema:
          type: string
      - name: locationsId
        in: path
        description: 'Part of `name`. Resource name pattern: `^projects/[^/]+/locations/[^/]+/knowledgeBases/[^/]+$`.'
        required: true
        schema:
          type: string
      - name: knowledgeBasesId
        in: path
        description: 'Part of `name`. Resource name pattern: `^projects/[^/]+/locations/[^/]+/knowledgeBases/[^/]+$`.'
        required: true
        schema:
          type: string
      x-discovery-path-template: v2/{name}
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleCloudDialogflowV2KnowledgeBase'
        default:
          description: Error response (google.rpc.Status)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcStatus'
      security:
      - OAuth2:
        - https://www.googleapis.com/auth/cloud-platform
        - https://www.googleapis.com/auth/dialogflow
      - BearerAuth: []
      summary: Dialogflow projects locations knowledge bases get
      x-summary-source: derived
    patch:
      operationId: dialogflow_projects_locations_knowledgeBases_patch
      tags:
      - Knowledge Bases
      parameters:
      - name: projectsId
        in: path
        description: 'Part of `name`. Resource name pattern: `^projects/[^/]+/locations/[^/]+/knowledgeBases/[^/]+$`.'
        required: true
        schema:
          type: string
      - name: locationsId
        in: path
        description: 'Part of `name`. Resource name pattern: `^projects/[^/]+/locations/[^/]+/knowledgeBases/[^/]+$`.'
        required: true
        schema:
          type: string
      - name: knowledgeBasesId
        in: path
        description: 'Part of `name`. Resource name pattern: `^projects/[^/]+/locations/[^/]+/knowledgeBases/[^/]+$`.'
        required: true
        schema:
          type: string
      - name: updateMask
        in: query
        schema:
          type: string
      x-discovery-path-template: v2/{name}
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GoogleCloudDialogflowV2KnowledgeBase'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleCloudDialogflowV2KnowledgeBase'
        default:
          description: Error response (google.rpc.Status)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcStatus'
      security:
      - OAuth2:
        - https://www.googleapis.com/auth/cloud-platform
        - https://www.googleapis.com/auth/dialogflow
      - BearerAuth: []
      summary: Dialogflow projects locations knowledge bases patch
      x-summary-source: derived
  /v2/projects/{projectsId}/locations/{locationsId}/knowledgeBases:
    post:
      operationId: dialogflow_projects_locations_knowledgeBases_create
      tags:
      - Knowledge Bases
      parameters:
      - name: projectsId
        in: path
        description: 'Part of `parent`. Resource name pattern: `^projects/[^/]+/locations/[^/]+$`.'
        required: true
        schema:
          type: string
      - name: locationsId
        in: path
        description: 'Part of `parent`. Resource name pattern: `^projects/[^/]+/locations/[^/]+$`.'
        required: true
        schema:
          type: string
      x-discovery-path-template: v2/{parent}/knowledgeBases
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GoogleCloudDialogflowV2KnowledgeBase'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleCloudDialogflowV2KnowledgeBase'
        default:
          description: Error response (google.rpc.Status)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcStatus'
      security:
      - OAuth2:
        - https://www.googleapis.com/auth/cloud-platform
        - https://www.googleapis.com/auth/dialogflow
      - BearerAuth: []
      summary: Dialogflow projects locations knowledge bases create
      x-summary-source: derived
    get:
      operationId: dialogflow_projects_locations_knowledgeBases_list
      tags:
      - Knowledge Bases
      parameters:
      - name: projectsId
        in: path
        description: 'Part of `parent`. Resource name pattern: `^projects/[^/]+/locations/[^/]+$`.'
        required: true
        schema:
          type: string
      - name: locationsId
        in: path
        description: 'Part of `parent`. Resource name pattern: `^projects/[^/]+/locations/[^/]+$`.'
        required: true
        schema:
          type: string
      - name: pageSize
        in: query
        schema:
          type: integer
          format: int32
      - name: pageToken
        in: query
        schema:
          type: string
      - name: filter
        in: query
        schema:
          type: string
      x-discovery-path-template: v2/{parent}/knowledgeBases
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleCloudDialogflowV2ListKnowledgeBasesResponse'
        default:
          description: Error response (google.rpc.Status)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcStatus'
      security:
      - OAuth2:
        - https://www.googleapis.com/auth/cloud-platform
        - https://www.googleapis.com/auth/dialogflow
      - BearerAuth: []
      summary: Dialogflow projects locations knowledge bases list
      x-summary-source: derived
  /v2/projects/{projectsId}/agent/knowledgeBases/{knowledgeBasesId}:
    delete:
      operationId: dialogflow_projects_agent_knowledgeBases_delete
      tags:
      - Knowledge Bases
      parameters:
      - name: projectsId
        in: path
        description: 'Part of `name`. Resource name pattern: `^projects/[^/]+/agent/knowledgeBases/[^/]+$`.'
        required: true
        schema:
          type: string
      - name: knowledgeBasesId
        in: path
        description: 'Part of `name`. Resource name pattern: `^projects/[^/]+/agent/knowledgeBases/[^/]+$`.'
        required: true
        schema:
          type: string
      - name: force
        in: query
        schema:
          type: boolean
      x-discovery-path-template: v2/{name}
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleProtobufEmpty'
        default:
          description: Error response (google.rpc.Status)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcStatus'
      security:
      - OAuth2:
        - https://www.googleapis.com/auth/cloud-platform
        - https://www.googleapis.com/auth/dialogflow
      - BearerAuth: []
      summary: Dialogflow projects agent knowledge bases delete
      x-summary-source: derived
    patch:
      operationId: dialogflow_projects_agent_knowledgeBases_patch
      tags:
      - Knowledge Bases
      parameters:
      - name: projectsId
        in: path
        description: 'Part of `name`. Resource name pattern: `^projects/[^/]+/agent/knowledgeBases/[^/]+$`.'
        required: true
        schema:
          type: string
      - name: knowledgeBasesId
        in: path
        description: 'Part of `name`. Resource name pattern: `^projects/[^/]+/agent/knowledgeBases/[^/]+$`.'
        required: true
        schema:
          type: string
      - name: updateMask
        in: query
        schema:
          type: string
      x-discovery-path-template: v2/{name}
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GoogleCloudDialogflowV2KnowledgeBase'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleCloudDialogflowV2KnowledgeBase'
        default:
          description: Error response (google.rpc.Status)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcStatus'
      security:
      - OAuth2:
        - https://www.googleapis.com/auth/cloud-platform
        - https://www.googleapis.com/auth/dialogflow
      - BearerAuth: []
      summary: Dialogflow projects agent knowledge bases patch
      x-summary-source: derived
    get:
      operationId: dialogflow_projects_agent_knowledgeBases_get
      tags:
      - Knowledge Bases
      parameters:
      - name: projectsId
        in: path
        description: 'Part of `name`. Resource name pattern: `^projects/[^/]+/agent/knowledgeBases/[^/]+$`.'
        required: true
        schema:
          type: string
      - name: knowledgeBasesId
        in: path
        description: 'Part of `name`. Resource name pattern: `^projects/[^/]+/agent/knowledgeBases/[^/]+$`.'
        required: true
        schema:
          type: string
      x-discovery-path-template: v2/{name}
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleCloudDialogflowV2KnowledgeBase'
        default:
          description: Error response (google.rpc.Status)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcStatus'
      security:
      - OAuth2:
        - https://www.googleapis.com/auth/cloud-platform
        - https://www.googleapis.com/auth/dialogflow
      - BearerAuth: []
      summary: Dialogflow projects agent knowledge bases get
      x-summary-source: derived
  /v2/projects/{projectsId}/agent/knowledgeBases:
    post:
      operationId: dialogflow_projects_agent_knowledgeBases_create
      tags:
      - Knowledge Bases
      parameters:
      - name: projectsId
        in: path
        description: 'Part of `parent`. Resource name pattern: `^projects/[^/]+/agent$`.'
        required: true
        schema:
          type: string
      x-discovery-path-template: v2/{parent}/knowledgeBases
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GoogleCloudDialogflowV2KnowledgeBase'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleCloudDialogflowV2KnowledgeBase'
        default:
          description: Error response (google.rpc.Status)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcStatus'
      security:
      - OAuth2:
        - https://www.googleapis.com/auth/cloud-platform
        - https://www.googleapis.com/auth/dialogflow
      - BearerAuth: []
      summary: Dialogflow projects agent knowledge bases create
      x-summary-source: derived
    get:
      operationId: dialogflow_projects_agent_knowledgeBases_list
      tags:
      - Knowledge Bases
      parameters:
      - name: projectsId
        in: path
        description: 'Part of `parent`. Resource name pattern: `^projects/[^/]+/agent$`.'
        required: true
        schema:
          type: string
      - name: filter
        in: query
        schema:
          type: string
      - name: pageSize
        in: query
        schema:
          type: integer
          format: int32
      - name: pageToken
        in: query
        schema:
          type: string
      x-discovery-path-template: v2/{parent}/knowledgeBases
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleCloudDialogflowV2ListKnowledgeBasesResponse'
        default:
          description: Error response (google.rpc.Status)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcStatus'
      security:
      - OAuth2:
        - https://www.googleapis.com/auth/cloud-platform
        - https://www.googleapis.com/auth/dialogflow
      - BearerAuth: []
      summary: Dialogflow projects agent knowledge bases list
      x-summary-source: derived
components:
  schemas:
    GoogleCloudDialogflowV2ListKnowledgeBasesResponse:
      type: object
      properties:
        knowledgeBases:
          type: array
          items:
            $ref: '#/components/schemas/GoogleCloudDialogflowV2KnowledgeBase'
        nextPageToken:
          type: string
    GoogleRpcStatus:
      type: object
      properties:
        message:
          type: string
        code:
          type: integer
          format: int32
        details:
          type: array
          items:
            type: object
            additionalProperties:
              description: Properties of the object. Contains field @type with type URL.
    GoogleCloudDialogflowV2KnowledgeBase:
      type: object
      properties:
        name:
          type: string
        languageCode:
          type: string
        displayName:
          type: string
    GoogleProtobufEmpty:
      type: object
  securitySchemes:
    OAuth2:
      type: oauth2
      description: Google OAuth 2.0. Scopes are declared per operation in the Discovery Document.
      flows:
        authorizationCode:
          authorizationUrl: https://accounts.google.com/o/oauth2/v2/auth
          tokenUrl: https://oauth2.googleapis.com/token
          scopes:
            https://www.googleapis.com/auth/dialogflow: View, manage and query your Dialogflow agents
            https://www.googleapis.com/auth/cloud-platform: See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account.
    BearerAuth:
      type: http
      scheme: bearer
      description: 'Google OAuth 2.0 access token or service-account-minted bearer token, sent as Authorization: Bearer <token>.'
externalDocs:
  description: Dialogflow ES documentation
  url: https://cloud.google.com/dialogflow/es/docs