Google Dialogflow

Google Dialogflow Versions API

The versions API from Google Dialogflow — 14 operation(s) for versions.

GitHub OpenAPI

Operations 27

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

POST /v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/playbooks/{playbooksId}/versions/{versionsId}:restore Restore a playbook to a saved version · Dialogflow projects locations agents playbooks versions restore #
Ask an LLM
“Can I roll a Dialogflow CX playbook back to an earlier saved version?”
“What happens to my current playbook when I restore an older snapshot of it?”
Tell an agent
Restore playbook {playbook} on agent {agent} to version {version} (project {project}, location {location}).
Roll playbook {playbook} back to its saved version {version}.
GET /v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/playbooks/{playbooksId}/versions/{versionsId} Get a saved playbook version · Dialogflow projects locations agents playbooks versions get #
Ask an LLM
“Where can I see what a specific saved version of my playbook contains?”
“Can I inspect an old playbook snapshot without restoring it?”
Tell an agent
Show me version {version} of playbook {playbook} on agent {agent} in project {project}, location {location}.
Fetch the details of playbook snapshot {version} for playbook {playbook}.
DELETE /v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/playbooks/{playbooksId}/versions/{versionsId} Delete a saved playbook version · Dialogflow projects locations agents playbooks versions delete #
Ask an LLM
“Can I remove a playbook version snapshot I no longer need?”
“Is deleting an old playbook version permanent?”
Tell an agent destructive · confirm first
Delete version {version} of playbook {playbook} on agent {agent} (project {project}, location {location}).
Remove the stale playbook snapshot {version} from playbook {playbook}.
POST /v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/playbooks/{playbooksId}/versions Save a new version of a playbook · Dialogflow projects locations agents playbooks versions create #
Ask an LLM
“How do I snapshot a playbook before I start editing it?”
“Can I attach a description when saving a playbook version?”
Tell an agent
Create a new version of playbook {playbook} on agent {agent} in project {project}, location {location}.
Snapshot playbook {playbook} with the note {description}.
GET /v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/playbooks/{playbooksId}/versions List saved versions of a playbook · Dialogflow projects locations agents playbooks versions list #
Ask an LLM
“Which saved versions exist for one of my CX playbooks?”
“How do I page through every snapshot taken of a playbook?”
Tell an agent
List all saved versions of playbook {playbook} on agent {agent} in project {project}, location {location}.
Show the first {page_size} snapshots of playbook {playbook}.
DELETE /v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/tools/{toolsId}/versions/{versionsId} Delete a saved tool version · Dialogflow projects locations agents tools versions delete #
Ask an LLM
“Can I delete a tool version even if something still references it?”
“Is there a force option when removing an old tool snapshot?”
Tell an agent destructive · confirm first
Delete version {version} of tool {tool} on agent {agent} (project {project}, location {location}).
Force-delete tool snapshot {version} of tool {tool} even if it is referenced.
GET /v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/tools/{toolsId}/versions/{versionsId} Get a saved tool version · Dialogflow projects locations agents tools versions get #
Ask an LLM
“Can I look at an earlier saved version of an agent tool's definition?”
“Where do I find what a particular tool snapshot looked like?”
Tell an agent
Get version {version} of tool {tool} on agent {agent} in project {project}, location {location}.
Show me tool snapshot {version} for tool {tool}.
GET /v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/tools/{toolsId}/versions List saved versions of a tool · Dialogflow projects locations agents tools versions list #
Ask an LLM
“What versions have been saved for one of my agent's tools?”
“Is there a way to page through the history of a tool's snapshots?”
Tell an agent
List the saved versions of tool {tool} on agent {agent} in project {project}, location {location}.
Show {page_size} tool snapshots at a time for tool {tool}.
POST /v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/tools/{toolsId}/versions Save a new version of a tool · Dialogflow projects locations agents tools versions create #
Ask an LLM
“How do I take a snapshot of an agent tool before changing it?”
“Can I give a tool version its own display name?”
Tell an agent
Create a new version of tool {tool} on agent {agent} in project {project}, location {location}.
Save tool {tool} as a version named {display_name}.
POST /v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/tools/{toolsId}/versions/{versionsId}:restore Restore a tool to a saved version · Dialogflow projects locations agents tools versions restore #
Ask an LLM
“Can I revert an agent tool to a previously saved version?”
“What does restoring a tool snapshot do to the live tool definition?”
Tell an agent
Restore tool {tool} on agent {agent} to its version {version} (project {project}, location {location}).
Revert tool {tool} to saved snapshot {version}.
PATCH /v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/flows/{flowsId}/versions/{versionsId} Update a flow version's details · Dialogflow projects locations agents flows versions patch #
Ask an LLM
“Can I rename or re-describe a flow version after it was created?”
“Which fields of an existing flow version am I allowed to change?”
Tell an agent
Update the description of flow {flow} version {version} on agent {agent} (project {project}, location {location}) to {description}.
Rename flow version {version} of flow {flow} to {display_name}.
GET /v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/flows/{flowsId}/versions/{versionsId} Get a flow version · Dialogflow projects locations agents flows versions get #
Ask an LLM
“How can I view the details of one specific version of a CX flow?”
“Can I check the training state of a flow version?”
Tell an agent
Get flow version {version} of flow {flow} on agent {agent} in project {project}, location {location}.
Show me the state and description of flow {flow} version {version}.
DELETE /v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/flows/{flowsId}/versions/{versionsId} Delete a flow version · Dialogflow projects locations agents flows versions delete #
Ask an LLM
“Can I delete a flow version that I no longer deploy anywhere?”
“Is removing an old version of a flow reversible?”
Tell an agent destructive · confirm first
Delete version {version} of flow {flow} on agent {agent} (project {project}, location {location}).
Remove obsolete flow version {version} from flow {flow}.
POST /v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/flows/{flowsId}/versions Create a version of a flow · Dialogflow projects locations agents flows versions create #
Ask an LLM
“How do I freeze the current state of a flow as a new version?”
“Can I label a new flow version with a display name before deploying it?”
Tell an agent
Create a new version of flow {flow} on agent {agent} in project {project}, location {location}.
Cut a version of flow {flow} called {display_name}.
GET /v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/flows/{flowsId}/versions List versions of a flow · Dialogflow projects locations agents flows versions list #
Ask an LLM
“Which versions have been cut from one of my CX flows?”
“Can I see the version history of a flow page by page?”
Tell an agent
List every version of flow {flow} on agent {agent} in project {project}, location {location}.
Show the next page of flow {flow} versions using token {page_token}.
POST /v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/flows/{flowsId}/versions/{versionsId}:load Load a flow version into the draft · Dialogflow projects locations agents flows versions load #
Ask an LLM
“How do I bring an older flow version back into the draft flow?”
“Can loading a flow version also override agent-level resources like intents?”
Tell an agent
Load version {version} of flow {flow} into the draft on agent {agent} (project {project}, location {location}).
Load flow {flow} version {version} into draft and set override of agent resources to {allow_override}.
POST /v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/flows/{flowsId}/versions/{versionsId}:compareVersions Compare two versions of a flow · Dialogflow projects locations agents flows versions compare versions #
Ask an LLM
“What changed between two versions of the same CX flow?”
“Can I diff a flow version against another one for a specific language?”
Tell an agent
Compare flow {flow} version {version} with {target_version} on agent {agent} (project {project}, location {location}).
Diff flow {flow} version {version} against {target_version} in language {language_code}.
DELETE /v2/projects/{projectsId}/locations/{locationsId}/agent/versions/{versionsId} Delete an ES agent version in a region · Dialogflow projects locations agent versions delete #
Ask an LLM
“Can I delete a version of my regional ES agent?”
“Is it permanent when I remove an agent version from a regional location?”
Tell an agent destructive · confirm first
Delete ES agent version {version} for project {project} in location {location}.
Remove the regional agent version {version} stored in {location} for project {project}.
GET /v2/projects/{projectsId}/locations/{locationsId}/agent/versions/{versionsId} Get an ES agent version in a region · Dialogflow projects locations agent versions get #
Ask an LLM
“Can I look up one version of my regional Dialogflow ES agent?”
“Where do I see the status of an agent version stored in a specific location?”
Tell an agent
Get ES agent version {version} for project {project} in location {location}.
Show the status and number of regional agent version {version} in {location} for project {project}.
PATCH /v2/projects/{projectsId}/locations/{locationsId}/agent/versions/{versionsId} Update an ES agent version in a region · Dialogflow projects locations agent versions patch #
Ask an LLM
“Can I change the description on a regional ES agent version?”
“Which fields of a regional agent version can I edit after creating it?”
Tell an agent
Set the description of ES agent version {version} in location {location}, project {project}, to {description}.
Update regional agent version {version} in {location} for project {project} with mask {update_mask}.
POST /v2/projects/{projectsId}/locations/{locationsId}/agent/versions Create an ES agent version in a region · Dialogflow projects locations agent versions create #
Ask an LLM
“How do I snapshot my regional ES agent as a new version?”
“Can I add a description when creating a version of an agent in a specific location?”
Tell an agent
Create a new ES agent version for project {project} in location {location}.
Snapshot the regional agent in {location} for project {project} with description {description}.
GET /v2/projects/{projectsId}/locations/{locationsId}/agent/versions List ES agent versions in a region · Dialogflow projects locations agent versions list #
Ask an LLM
“What versions exist for my ES agent in a particular region?”
“Can I page through the agent versions kept in one location?”
Tell an agent
List ES agent versions for project {project} in location {location}.
Show {page_size} regional agent versions per page in {location} for project {project}.
PATCH /v2/projects/{projectsId}/agent/versions/{versionsId} Update a version of the default ES agent · Dialogflow projects agent versions patch #
Ask an LLM
“Can I edit the description on a version of my global ES agent?”
“What can I change on an existing default-location agent version?”
Tell an agent
Change the description of global ES agent version {version} in project {project} to {description}.
Patch default-location agent version {version} for project {project} using mask {update_mask}.
GET /v2/projects/{projectsId}/agent/versions/{versionsId} Get a version of the default ES agent · Dialogflow projects agent versions get #
Ask an LLM
“Can I fetch one version of the ES agent in my project's default location?”
“How can I see the status of an agent version on my global ES agent?”
Tell an agent
Get version {version} of the global ES agent in project {project}.
Fetch default-location agent version {version} for project {project}.
DELETE /v2/projects/{projectsId}/agent/versions/{versionsId} Delete a version of the default ES agent · Dialogflow projects agent versions delete #
Ask an LLM
“Can I delete a version of my global ES agent?”
“Does removing a default-location agent version affect environments using it?”
Tell an agent destructive · confirm first
Delete version {version} of the global ES agent in project {project}.
Remove default-location agent version {version} from project {project}.
GET /v2/projects/{projectsId}/agent/versions List versions of the default ES agent · Dialogflow projects agent versions list #
Ask an LLM
“Which versions exist for my global ES agent?”
“Is there a paged list of default-location agent versions in a project?”
Tell an agent
List all versions of the global ES agent in project {project}.
Show default-location agent versions for project {project}, {page_size} per page.
POST /v2/projects/{projectsId}/agent/versions Create a version of the default ES agent · Dialogflow projects agent versions create #
Ask an LLM
“How do I save my global ES agent as a new version?”
“Can I describe what changed when I version the default-location agent?”
Tell an agent
Create a new version of the global ES agent in project {project}.
Version the default-location agent for project {project} with description {description}.

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

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/google-dialogflow/json-schema/google-dialogflow-google-cloud-dialogflow-cx-v3-version-schema.json
📊
JSONSchema
https://artifacts.apis.io/google-dialogflow/json-schema/google-dialogflow-google-cloud-dialogflow-v2-version-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-playbook-version-schema.json
📊
JSONSchema
https://artifacts.apis.io/google-dialogflow/json-schema/google-dialogflow-google-cloud-dialogflow-cx-v3-tool-version-schema.json
📊
JSONSchema
https://artifacts.apis.io/google-dialogflow/json-schema/google-dialogflow-google-cloud-dialogflow-cx-v3-list-playbook-versions-response-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-versions-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-versions-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Google Dialogflow Versions API
  contact:
    name: Google Cloud
    url: https://cloud.google.com/dialogflow/
  license:
    name: Google APIs Terms of Service
    url: https://developers.google.com/terms
  termsOfService: https://cloud.google.com/terms
  x-refined-note:
  - x-discovery-id differs across the merged source definitions and was not carried
  - x-discovery-source differs across the merged source definitions and was not carried
  x-discovery-revision: '20260825'
  version: '1.0'
  description: 'Operations tagged versions across 2 of this provider''s published API definitions: google-dialogflow-cx-v3-openapi.yml, google-dialogflow-es-v2-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://dialogflow.googleapis.com
  description: Dialogflow API
tags:


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