GET agent/chats — Google Flow API

List agent chats

October 16, 2026

Request Headers
Query Parameters
Responses
Model
Examples
Try It

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=email&projectId=projectId

Request Headers

Authorization: Bearer {API token}

API token is required, see Setup useapi.net for details.

Query Parameters

email is required, the Google Flow account, see GET /accounts.
projectId is optional, a Flow project of the account, from GET /assets/projects/email.
Default: the account’s agent project.

Responses

200 OK

{
  "chats": [
    {
      "chatId": "c-u12345-email:[email protected]:f166200a-ea22-461a-bc68-47ff6d3ee500-chat:41fbc779-b18f-468a-ac02-f31a3bde30b0-bot:google-flow",
      "email": "[email protected]",
      "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:[email protected]:f166200a-ea22-461a-bc68-47ff6d3ee500-chat:77bd5e0b-2a34-4ee0-ad13-de366e41622c-bot:google-flow",
      "email": "[email protected]",
      "title": "Flow Creative Capabilities Overview",
      "created": "2026-10-16T21:47:07.000Z",
      "updated": "2026-10-16T21:47:39.280Z",
      "running": false
    }
  ]
}

400 Bad Request

{
  "error": "Parameter email is required",
  "code": 400
}

401 Unauthorized

Invalid API token.

{
  "error": "useapi.net ⁝ Unauthorized",
  "code": 401
}

404 Not Found

The account is not added, or projectId is not a project of the account.

{
  "error": "Google Flow account [email protected] not found",
  "code": 404
}

When projectId is not a project of the account:

{
  "error": "Project not found",
  "code": 404
}

503 Service Unavailable

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/email and add it again by following Setup Google Flow.

Model

{ // TypeScript, all fields are optional
  chats: {
    chatId: string
    email: string
    title?: string
    created?: string
    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('[email protected]')}`, {
  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': '[email protected]'},
)
for c in r.json()['chats']:
    print(c.get('updated'), c.get('title'), c['chatId'])