List agent chats
October 16, 2026 (November 16, 2026)
Table of contents
List the agent chats of one Google Flow account in one project, newest activity first. The list comes from Google, so it includes chats started in the Flow web app in the same project, and it is how you find a chatId you lost.
Without projectId, the list covers the account’s own agent project, the one POST /agent/chats uses by default. An account that has never chatted through the API has none yet, and the list is empty.
https://api.useapi.net/v1/google-flow/agent/chats?email=
projectId
Request Headers
Authorization: Bearer {API token}
API tokenis required, see Setup useapi.net for details.
Query Parameters
emailis required, the Google Flow account, see GET /accounts.projectIdis optional, a Flow project of the account, from GET /assets/projects/email.
Default: the account’s agent project.
Responses
-
{ "chats": [ { "chatId": "c-u12345-email:john@gmail.com-project:f166200a-ea22-461a-bc68-47ff6d3ee500-chat:41fbc779-b18f-468a-ac02-f31a3bde30b0-bot:google-flow", "email": "john@gmail.com", "title": "Creative Asset Component Overview", "created": "2026-10-16T21:48:53.000Z", "updated": "2026-10-16T21:49:19.646Z", "running": false }, { "chatId": "c-u12345-email:john@gmail.com-project:f166200a-ea22-461a-bc68-47ff6d3ee500-chat:77bd5e0b-2a34-4ee0-ad13-de366e41622c-bot:google-flow", "email": "john@gmail.com", "title": "Flow Creative Capabilities Overview", "created": "2026-10-16T21:47:07.000Z", "updated": "2026-10-16T21:47:39.280Z", "running": false } ] } -
{ "error": "Parameter email is required", "code": 400 } -
Invalid API token.
{ "error": "useapi.net ⁝ Unauthorized", "code": 401 } -
The account is not added, or
projectIdis not a project of the account.{ "error": "Google Flow account john@gmail.com not found", "code": 404 }When
projectIdis not a project of the account:{ "error": "Project not found", "code": 404 } -
Google Flow could not be reached, and nothing happened. Retry shortly.
{ "error": "Google Flow is not reachable right now and could not list the chats. Retry", "code": 503 } -
596 Session Error
The account’s Google session is no longer valid. Delete the account with DELETE /accounts/
emailand add it again by following Setup Google Flow.
Model
The account’s agent chats, newest activity first, each with its chatId, title and whether a turn is running.
The list of chats, field by field
{ // TypeScript, all fields are optional
chats: { // the chats, newest activity first
chatId: string // the chat's id for the other agent chat calls
email: string // the account the chat runs on
title?: string // Google's title for the chat
created?: string // ISO 8601 timestamp, from Google
updated?: string // last activity
running: boolean // a turn is running now
}[]
}
Examples
-
curl -H "Authorization: Bearer YOUR_API_TOKEN" \ "https://api.useapi.net/v1/google-flow/agent/chats?email=john%40gmail.com" -
const token = 'YOUR_API_TOKEN' const response = await fetch(`https://api.useapi.net/v1/google-flow/agent/chats?email=${encodeURIComponent('john@gmail.com')}`, { headers: { 'Authorization': `Bearer ${token}` } }) const { chats } = await response.json() chats.forEach(c => console.log(c.updated, c.title, c.chatId)) -
import requests token = 'YOUR_API_TOKEN' r = requests.get( 'https://api.useapi.net/v1/google-flow/agent/chats', headers={'Authorization': f'Bearer {token}'}, params={'email': 'john@gmail.com'}, ) for c in r.json()['chats']: print(c.get('updated'), c.get('title'), c['chatId'])