List agent chats

October 16, 2026 (November 16, 2026)

Table of contents

  1. Request Headers
  2. Query Parameters
  3. Responses
  4. Model
  5. Examples
  6. 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}
Query Parameters
Responses
  • 200 OK

    {
      "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
        }
      ]
    }
    
  • 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 john@gmail.com 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

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'])
    
Try It