Google Dialogflow

Google Dialogflow Agents API

The agents API from Google Dialogflow — 7 operation(s) for agents.

GitHub OpenAPI

Operations 11

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

PATCH /v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId} Update a CX agent's settings · Dialogflow projects locations agents patch #
Ask an LLM
“How do I change my CX agent's time zone or supported languages?”
“Can I lock a conversational agent to prevent further edits?”
Tell an agent
Set the time zone of CX agent {agent} in project {project}, location {location} to {time_zone}.
Lock conversational agent {agent} by setting locked to {locked}.
GET /v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId} Retrieve a CX agent · Dialogflow projects locations agents get #
Ask an LLM
“What are the default language, time zone and start flow of my Dialogflow CX agent?”
“Can I look up a single conversational agent's settings by its ID?”
Tell an agent
Get CX agent {agent} in project {project}, location {location}.
Show the settings of conversational agent {agent}.
DELETE /v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId} Delete a CX agent · Dialogflow projects locations agents delete #
Ask an LLM
“Can I permanently delete a conversational agent I no longer use?”
“Is deleting a whole CX agent something I can do by its ID?”
Tell an agent destructive · confirm first
Delete CX agent {agent} in project {project}, location {location}.
Remove the entire conversational agent {agent}.
GET /v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/generativeSettings Get a CX agent's generative AI settings · Dialogflow projects locations agents get generative settings #
Ask an LLM
“Which LLM model and safety settings is my conversational agent using for generative features?”
“Can I see an agent's generative fallback settings for a given language?”
Tell an agent
Get the generative settings of CX agent {agent} in project {project}, location {location}.
Show agent {agent}'s generative AI settings for language {language}.
PATCH /v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/generativeSettings Update a CX agent's generative AI settings · Dialogflow projects locations agents update generative settings #
Ask an LLM
“How do I change the LLM model my conversational agent uses?”
“Can I adjust generative safety or knowledge connector settings on an agent?”
Tell an agent
Update the generative settings of CX agent {agent} in project {project}, location {location} with LLM settings {llm_settings}.
Set generative safety settings {safety_settings} on agent {agent}.
POST /v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}:export Export a CX agent · Dialogflow projects locations agents export #
Ask an LLM
“How can I back up a whole conversational agent to Cloud Storage?”
“Can an agent export be pushed to a git branch instead of a file?”
Tell an agent
Export CX agent {agent} in project {project}, location {location} to {agent_uri}.
Export agent {agent} from environment {environment} in {format} format.
POST /v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}:validate Validate a CX agent · Dialogflow projects locations agents validate #
Ask an LLM
“Can I check my conversational agent for configuration problems before deploying?”
“Does agent validation run per language?”
Tell an agent
Validate CX agent {agent} in project {project}, location {location}.
Run validation on agent {agent} for language {language}.
GET /v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/validationResult Get the latest validation result of a CX agent · Dialogflow projects locations agents get validation result #
Ask an LLM
“What issues did the last validation of my conversational agent find?”
“Can I read an agent's stored validation report for one language?”
Tell an agent
Get the validation result of CX agent {agent} in project {project}, location {location}.
Show the latest validation findings for agent {agent} in {language}.
GET /v3/projects/{projectsId}/locations/{locationsId}/agents List CX agents in a location · Dialogflow projects locations agents list #
Ask an LLM
“Which conversational agents exist in my project and region?”
“Can I page through all my CX agents in a location?”
Tell an agent
List CX agents in project {project}, location {location}.
Show {page_size} agents per page in location {location}.
POST /v3/projects/{projectsId}/locations/{locationsId}/agents Create a CX agent · Dialogflow projects locations agents create #
Ask an LLM
“How do I create a new Dialogflow CX agent?”
“Can a new conversational agent start with a playbook instead of a flow?”
Tell an agent
Create a CX agent named {display_name} in project {project}, location {location} with default language {language} and time zone {time_zone}.
Make a new agent {display_name} that starts with playbook {start_playbook}.
POST /v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}:restore Restore a CX agent from a backup · Dialogflow projects locations agents restore #
Ask an LLM
“Can I overwrite my conversational agent with a previously exported backup?”
“Is restoring an agent from a git source supported?”
Tell an agent destructive · confirm first
Restore CX agent {agent} in project {project}, location {location} from {agent_uri}.
Replace agent {agent} with the backup from git source {git_source} using restore option {restore_option}.

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-agents-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/google-dialogflow/json-schema/google-dialogflow-google-cloud-dialogflow-cx-v3-agent-schema.json
📊
JSONSchema
https://artifacts.apis.io/google-dialogflow/json-schema/google-dialogflow-google-cloud-dialogflow-cx-v3-generative-settings-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-cx-v3-export-agent-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/google-dialogflow/json-schema/google-dialogflow-google-cloud-dialogflow-cx-v3-restore-agent-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/google-dialogflow/json-schema/google-dialogflow-google-cloud-dialogflow-cx-v3-agent-validation-result-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-agents-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-agents-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Dialogflow CX API (v3) - Conversational Agents API
  version: v3
  description: Dialogflow CX (Conversational Agents) builds flow- and playbook-based agents with pages, routes, webhooks, tools, test cases, environments, experiments and data stores. 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=v3
  x-discovery-revision: '20260825'
  x-discovery-id: dialogflow:v3
servers:
- url: https://dialogflow.googleapis.com
  description: Dialogflow API
security:
- OAuth2:
  - https://www.googleapis.com/auth/cloud-platform
  - https://www.googleapis.com/auth/dialogflow
- BearerAuth: []
tags:


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