Google Dialogflow Conversations API

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

Operations 9

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

GET /v2/projects/{projectsId}/locations/{locationsId}/conversations/{conversationsId} Get a regional conversation · Dialogflow projects locations conversations get #
Ask an LLM
“Can I look up the state of one Agent Assist conversation stored in a specific region?”
“Where do I check which conversation profile a regional conversation uses?”
Tell an agent
Get conversation {conversation} in project {project}, location {location}.
Show the lifecycle state of regional conversation {conversation} in {location}, project {project}.
POST /v2/projects/{projectsId}/locations/{locationsId}/conversations/{conversationsId}:complete Complete a regional conversation · Dialogflow projects locations conversations complete #
Ask an LLM
“How do I end an Agent Assist conversation in a specific location?”
“Can a regional conversation be reopened once I mark it complete?”
Tell an agent destructive · confirm first
Complete conversation {conversation} in project {project}, location {location}.
Close out regional conversation {conversation} in {location} for project {project}.
POST /v2/projects/{projectsId}/locations/{locationsId}/conversations Start a conversation in a region · Dialogflow projects locations conversations create #
Ask an LLM
“How do I start a new Agent Assist conversation in a particular location?”
“Can I choose my own ID for a regional conversation?”
Tell an agent
Create a conversation in project {project}, location {location}, using conversation profile {profile}.
Start regional conversation {conversation_id} in {location} for project {project}.
GET /v2/projects/{projectsId}/locations/{locationsId}/conversations List conversations in a region · Dialogflow projects locations conversations list #
Ask an LLM
“Which conversations exist in one region of my project?”
“Can I filter regional conversations to only those still in progress?”
Tell an agent
List conversations in project {project}, location {location}.
Show regional conversations in {location} for project {project} matching {filter}.
POST /v2/projects/{projectsId}/locations/{locationsId}/conversations/{conversationsId}:ingestContextReferences Add context references to a conversation · Dialogflow projects locations conversations ingest context references #
Ask an LLM
“Can I attach extra context documents to a conversation for generators to use?”
“What kind of context references can be ingested into an existing conversation?”
Tell an agent
Ingest context references {references} into conversation {conversation}, project {project}, location {location}.
Attach the context {references} to regional conversation {conversation}.
POST /v2/projects/{projectsId}/conversations/{conversationsId}:complete Complete a conversation · Dialogflow projects conversations complete #
Ask an LLM
“Can I mark a conversation on the global endpoint as finished?”
“What happens to a default-location conversation after it is completed?”
Tell an agent destructive · confirm first
Complete global conversation {conversation} in project {project}.
End default-location conversation {conversation} for project {project}.
GET /v2/projects/{projectsId}/conversations List conversations in a project · Dialogflow projects conversations list #
Ask an LLM
“Which conversations does my project have at the global location?”
“Can I filter default-location conversations by lifecycle state?”
Tell an agent
List the global conversations in project {project}.
Show project {project}'s default-location conversations filtered by {filter}.
POST /v2/projects/{projectsId}/conversations Start a conversation in a project · Dialogflow projects conversations create #
Ask an LLM
“How can I open a new conversation on the global endpoint?”
“Which conversation profile does a default-location conversation need?”
Tell an agent
Create a global conversation in project {project} with profile {profile}.
Start default-location conversation {conversation_id} in project {project}.
GET /v2/projects/{projectsId}/conversations/{conversationsId} Get a conversation · Dialogflow projects conversations get #
Ask an LLM
“Can I fetch one conversation from the global endpoint by ID?”
“Is a default-location conversation still active or already completed?”
Tell an agent
Get global conversation {conversation} in project {project}.
Check the state of default-location conversation {conversation} for project {project}.

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-conversations-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-conversations-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Dialogflow ES API (v2) Conversations 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 (36 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/google-dialogflow/refs/heads/main/openapi/google-dialogflow-conversations-api-openapi.yml