Google Dialogflow

Google Dialogflow Documents API

The documents API from Google Dialogflow — 13 operation(s) for documents.

GitHub OpenAPI

Operations 22

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}/documents/{documentsId} Delete a document from a knowledge base · Dialogflow projects knowledge bases documents delete #
Ask an LLM
“Can I remove an outdated FAQ document from a project-level knowledge base?”
“Is deleting a single knowledge document possible without touching the rest of the base?”
Tell an agent destructive · confirm first
Delete document {document} from knowledge base {knowledge_base} in project {project}.
Remove project-level knowledge document {document} from base {knowledge_base}.
GET /v2/projects/{projectsId}/knowledgeBases/{knowledgeBasesId}/documents/{documentsId} Retrieve a document from a knowledge base · Dialogflow projects knowledge bases documents get #
Ask an LLM
“How can I see the details of one document in a project-level Dialogflow knowledge base?”
“Can I check a knowledge document's MIME type and latest reload status?”
Tell an agent
Get document {document} from knowledge base {knowledge_base} in project {project}.
Show the project-level knowledge document {document} stored in {knowledge_base}.
PATCH /v2/projects/{projectsId}/knowledgeBases/{knowledgeBasesId}/documents/{documentsId} Update a knowledge base document · Dialogflow projects knowledge bases documents patch #
Ask an LLM
“How do I rename a document in a project-level knowledge base?”
“Can I switch on automatic reloading for a knowledge document I already added?”
Tell an agent
Rename document {document} in knowledge base {knowledge_base} of project {project} to {display_name}.
Turn auto-reload {enable_auto_reload} on for project-level document {document}.
POST /v2/projects/{projectsId}/knowledgeBases/{knowledgeBasesId}/documents/{documentsId}:reload Reload a knowledge document from its source · Dialogflow projects knowledge bases documents reload #
Ask an LLM
“Can I make Dialogflow re-fetch a knowledge document after its source file changed?”
“Is it possible to reload a project-level knowledge document from a new Cloud Storage URI?”
Tell an agent
Reload document {document} in knowledge base {knowledge_base} of project {project}.
Refresh project-level knowledge document {document} from content URI {content_uri}.
GET /v2/projects/{projectsId}/knowledgeBases/{knowledgeBasesId}/documents List documents in a knowledge base · Dialogflow projects knowledge bases documents list #
Ask an LLM
“What documents are loaded into my project-level knowledge base?”
“Can I filter a knowledge base's document list, for example by state or type?”
Tell an agent
List all documents in knowledge base {knowledge_base} of project {project}.
Show project-level documents in {knowledge_base} matching filter {filter}.
POST /v2/projects/{projectsId}/knowledgeBases/{knowledgeBasesId}/documents Add a document to a knowledge base · Dialogflow projects knowledge bases documents create #
Ask an LLM
“How do I add an FAQ page or article to a project-level knowledge base?”
“Can a new knowledge document be created from raw content rather than a URL?”
Tell an agent
Create document {display_name} in knowledge base {knowledge_base} of project {project} from {content_uri}.
Add a project-level knowledge document of type {knowledge_types} with MIME type {mime_type} to {knowledge_base}.
POST /v2/projects/{projectsId}/knowledgeBases/{knowledgeBasesId}/documents/{documentsId}:export Export a knowledge document to Cloud Storage · Dialogflow projects knowledge bases documents export #
Ask an LLM
“Can I export a project-level knowledge document to a Cloud Storage bucket?”
“Does exporting a knowledge document include its full content or just metadata?”
Tell an agent
Export document {document} from knowledge base {knowledge_base} in project {project} to {gcs_destination}.
Export the full content of project-level document {document} to bucket path {gcs_destination}.
POST /v2/projects/{projectsId}/knowledgeBases/{knowledgeBasesId}/documents:import Bulk-import documents into a knowledge base · Dialogflow projects knowledge bases documents import #
Ask an LLM
“How can I bulk-import many files from Cloud Storage into a project-level knowledge base?”
“Can imported knowledge documents share a template for type and MIME settings?”
Tell an agent
Import documents from {gcs_source} into knowledge base {knowledge_base} of project {project}.
Bulk-load project-level knowledge files from {gcs_source} using document template {template}.
GET /v2/projects/{projectsId}/locations/{locationsId}/knowledgeBases/{knowledgeBasesId}/documents/{documentsId} Retrieve a document from a regional knowledge base · Dialogflow projects locations knowledge bases documents get #
Ask an LLM
“Can I look up one document in a knowledge base hosted in a specific region?”
“What state is a regional knowledge document in right now?”
Tell an agent
Get regional document {document} from knowledge base {knowledge_base} in project {project}, location {location}.
Show the {location} knowledge document {document} in {knowledge_base}.
DELETE /v2/projects/{projectsId}/locations/{locationsId}/knowledgeBases/{knowledgeBasesId}/documents/{documentsId} Delete a document from a regional knowledge base · Dialogflow projects locations knowledge bases documents delete #
Ask an LLM
“Can I delete a document from a knowledge base that lives in a particular location?”
“Is there a way to drop one regional knowledge document while keeping the base?”
Tell an agent destructive · confirm first
Delete regional document {document} from knowledge base {knowledge_base} in project {project}, location {location}.
Remove {location} knowledge document {document} from {knowledge_base}.
PATCH /v2/projects/{projectsId}/locations/{locationsId}/knowledgeBases/{knowledgeBasesId}/documents/{documentsId} Update a document in a regional knowledge base · Dialogflow projects locations knowledge bases documents patch #
Ask an LLM
“Can I change metadata on a document stored in a regional knowledge base?”
“Is it possible to point a regional knowledge document at a different content URI?”
Tell an agent
Update regional document {document} in knowledge base {knowledge_base}, project {project}, location {location} with metadata {metadata}.
Change the display name of {location} knowledge document {document} to {display_name}.
POST /v2/projects/{projectsId}/locations/{locationsId}/knowledgeBases/{knowledgeBasesId}/documents/{documentsId}:export Export a regional knowledge document · Dialogflow projects locations knowledge bases documents export #
Ask an LLM
“Can I copy a document from a regional knowledge base out to Cloud Storage?”
“Which destination does a regional knowledge document export write to?”
Tell an agent
Export regional document {document} from knowledge base {knowledge_base} in project {project}, location {location} to {gcs_destination}.
Send {location} knowledge document {document} to Cloud Storage at {gcs_destination} with full content.
POST /v2/projects/{projectsId}/locations/{locationsId}/knowledgeBases/{knowledgeBasesId}/documents:import Bulk-import documents into a regional knowledge base · Dialogflow projects locations knowledge bases documents import #
Ask an LLM
“Can I import a folder of files into a knowledge base in a specific region?”
“Does a regional knowledge import also bring in custom metadata from Cloud Storage?”
Tell an agent
Import files from {gcs_source} into regional knowledge base {knowledge_base} in project {project}, location {location}.
Bulk-import {location} knowledge documents from {gcs_source} with template {template}.
GET /v2/projects/{projectsId}/locations/{locationsId}/knowledgeBases/{knowledgeBasesId}/documents List documents in a regional knowledge base · Dialogflow projects locations knowledge bases documents list #
Ask an LLM
“Which documents sit in my knowledge base in a given location?”
“Can I page through a regional knowledge base's documents with a filter?”
Tell an agent
List documents in regional knowledge base {knowledge_base} in project {project}, location {location}.
Show {page_size} documents at a time from {location} knowledge base {knowledge_base}.
POST /v2/projects/{projectsId}/locations/{locationsId}/knowledgeBases/{knowledgeBasesId}/documents Add a document to a regional knowledge base · Dialogflow projects locations knowledge bases documents create #
Ask an LLM
“How do I add a new document to a knowledge base hosted in a particular region?”
“Can I create a regional knowledge document that reloads itself automatically?”
Tell an agent
Create regional document {display_name} in knowledge base {knowledge_base}, project {project}, location {location} from {content_uri}.
Add a {location} knowledge document {display_name} with raw content {raw_content}.
POST /v2/projects/{projectsId}/locations/{locationsId}/knowledgeBases/{knowledgeBasesId}/documents/{documentsId}:reload Reload a document in a regional knowledge base · Dialogflow projects locations knowledge bases documents reload #
Ask an LLM
“Can I trigger a re-crawl of a document stored in a regional knowledge base?”
“Is a reload of a regional knowledge document able to use a new source URI?”
Tell an agent
Reload regional document {document} in knowledge base {knowledge_base}, project {project}, location {location}.
Re-fetch {location} knowledge document {document} from {content_uri}.
PATCH /v2/projects/{projectsId}/agent/knowledgeBases/{knowledgeBasesId}/documents/{documentsId} Update a document in an agent's knowledge base · Dialogflow projects agent knowledge bases documents patch #
Ask an LLM
“Can I edit the name or metadata of a document on my ES agent's knowledge base?”
“Is there a field-mask update for agent knowledge documents?”
Tell an agent
Update document {document} in my agent's knowledge base {knowledge_base}, project {project}, setting display name {display_name}.
Patch agent knowledge document {document} fields {update_mask} with metadata {metadata}.
GET /v2/projects/{projectsId}/agent/knowledgeBases/{knowledgeBasesId}/documents/{documentsId} Retrieve a document from an agent's knowledge base · Dialogflow projects agent knowledge bases documents get #
Ask an LLM
“What does a document attached to my ES agent's knowledge base look like?”
“Can I read one agent knowledge document by ID?”
Tell an agent
Get document {document} from my agent's knowledge base {knowledge_base} in project {project}.
Display agent knowledge document {document} under base {knowledge_base}.
DELETE /v2/projects/{projectsId}/agent/knowledgeBases/{knowledgeBasesId}/documents/{documentsId} Delete a document from an agent's knowledge base · Dialogflow projects agent knowledge bases documents delete #
Ask an LLM
“Can I stop my ES agent answering from a document by deleting it from the agent's knowledge base?”
“Is removing an agent knowledge document permanent?”
Tell an agent destructive · confirm first
Delete document {document} from my agent's knowledge base {knowledge_base} in project {project}.
Drop agent knowledge document {document} out of base {knowledge_base}.
GET /v2/projects/{projectsId}/agent/knowledgeBases/{knowledgeBasesId}/documents List documents in an agent's knowledge base · Dialogflow projects agent knowledge bases documents list #
Ask an LLM
“Which documents feed my ES agent's knowledge base answers?”
“Can I filter the agent knowledge document list?”
Tell an agent
List documents in my agent's knowledge base {knowledge_base} in project {project}.
Show agent knowledge documents in {knowledge_base} that match {filter}.
POST /v2/projects/{projectsId}/agent/knowledgeBases/{knowledgeBasesId}/documents Add a document to an agent's knowledge base · Dialogflow projects agent knowledge bases documents create #
Ask an LLM
“How do I give my ES agent a new FAQ document to answer from?”
“Can I attach a document to an agent's knowledge base straight from a URL?”
Tell an agent
Create document {display_name} in my agent's knowledge base {knowledge_base}, project {project}, from {content_uri}.
Attach an agent knowledge document of type {knowledge_types} to base {knowledge_base}.
POST /v2/projects/{projectsId}/agent/knowledgeBases/{knowledgeBasesId}/documents/{documentsId}:reload Reload a document in an agent's knowledge base · Dialogflow projects agent knowledge bases documents reload #
Ask an LLM
“Can I refresh a document my ES agent uses after the source page was updated?”
“Is reloading an agent knowledge document from a different URI supported?”
Tell an agent
Reload document {document} in my agent's knowledge base {knowledge_base}, project {project}.
Refresh agent knowledge document {document} using source {content_uri}.

Documentation

📖
Documentation
https://cloud.google.com/dialogflow/cx/docs
📖
APIReference
https://cloud.google.com/dialogflow/cx/docs/reference/rest
📖
GettingStarted
https://cloud.google.com/dialogflow/cx/docs/quick/setup
📖
Quickstart
https://cloud.google.com/dialogflow/cx/docs/quick/build-agent
📖
Authentication
https://cloud.google.com/dialogflow/cx/docs/concept/access-control
📖
Documentation
https://cloud.google.com/dialogflow/es/docs
📖
APIReference
https://cloud.google.com/dialogflow/es/docs/reference/rest/v2-overview
📖
GettingStarted
https://cloud.google.com/dialogflow/es/docs/quick/setup
📖
Quickstart
https://cloud.google.com/dialogflow/es/docs/quick/build-agent
📖
Authentication
https://cloud.google.com/dialogflow/es/docs/access-control

Specifications

⚙
OpenAPI
https://artifacts.apis.io/google-dialogflow/openapi/google-dialogflow-documents-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/google-dialogflow/json-schema/google-dialogflow-google-cloud-dialogflow-v2-document-schema.json
📊
JSONSchema
https://artifacts.apis.io/google-dialogflow/json-schema/google-dialogflow-google-longrunning-operation-schema.json
📊
JSONSchema
https://artifacts.apis.io/google-dialogflow/json-schema/google-dialogflow-google-cloud-dialogflow-v2-import-documents-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/google-dialogflow/json-schema/google-dialogflow-google-cloud-dialogflow-v2-export-document-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/google-dialogflow/json-schema/google-dialogflow-google-cloud-dialogflow-v2-list-documents-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/google-dialogflow/json-schema/google-dialogflow-google-cloud-dialogflow-v2-reload-document-request-schema.json

Other Resources

🔗
Discovery
https://artifacts.apis.io/google-dialogflow/discovery/google-dialogflow-v3.json
🔗
Discovery
https://artifacts.apis.io/google-dialogflow/discovery/google-dialogflow-v3beta1.json
🔗
Protobuf
https://artifacts.apis.io/google-dialogflow/grpc/cx-v3/session.proto
🔗
Protobuf
https://artifacts.apis.io/google-dialogflow/grpc/cx-v3/agent.proto
🔗
Protobuf
https://artifacts.apis.io/google-dialogflow/grpc/cx-v3/webhook.proto
🔗
Protobuf
https://artifacts.apis.io/google-dialogflow/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://artifacts.apis.io/google-dialogflow/discovery/google-dialogflow-v2.json
🔗
Discovery
https://artifacts.apis.io/google-dialogflow/discovery/google-dialogflow-v2beta1.json
🔗
Protobuf
https://artifacts.apis.io/google-dialogflow/grpc/v2/session.proto
🔗
Protobuf
https://artifacts.apis.io/google-dialogflow/grpc/v2/agent.proto
🔗
Protobuf
https://artifacts.apis.io/google-dialogflow/grpc/v2/intent.proto
🔗
Protobuf
https://artifacts.apis.io/google-dialogflow/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-documents-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.

GitHub Google LinkedIn

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

OpenAPI Specification

google-dialogflow-documents-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Dialogflow ES API (v2) Documents 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:


# --- truncated at 32 KB (44 KB total) ---
# Full source: https://artifacts.apis.io/google-dialogflow/openapi/google-dialogflow-documents-api-openapi.yml