> ## Documentation Index
> Fetch the complete documentation index at: https://docs.itoflow.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List chats

> Lists your own chats, most recently active first, with the id and title of each chat. Use it to find an earlier chat, then read that chat or its files. Set runtime=cloudflare for current chats or runtime=api for older archived chats; omit runtime to list both.

Operation ID: get__chats.



## OpenAPI

````yaml /openapi/itoflow-public.openapi.json get /chats
openapi: 3.1.0
info:
  description: >-
    All Itoflow APIs are experimental and may change without notice. Read-only
    operations marked interactive can be tried from the documentation; the
    others are reference-only.
  title: Itoflow Developer API
  version: 1.0.0
servers:
  - description: Itoflow API
    url: https://api.itoflow.ai
security: []
tags:
  - name: Account
  - name: Billing
  - name: Brokers
  - name: Chat
  - name: Connected MCP servers
  - name: GitHub
  - name: Market data
  - name: Monitors
  - name: Notifications
  - name: Portfolios
  - name: Risk runs
  - name: Sharing and data
  - name: Strategies
paths:
  /chats:
    get:
      tags:
        - Chat
      summary: List chats
      description: >-
        Lists your own chats, most recently active first, with the id and title
        of each chat. Use it to find an earlier chat, then read that chat or its
        files. Set runtime=cloudflare for current chats or runtime=api for older
        archived chats; omit runtime to list both.


        Operation ID: get__chats.
      operationId: get__chats
      parameters:
        - in: query
          name: limit
          required: false
          schema:
            default: 50
            maximum: 100
            minimum: 1
            type: integer
        - in: query
          name: offset
          required: false
          schema:
            default: 0
            minimum: 0
            type:
              - integer
              - 'null'
        - in: query
          name: runtime
          required: false
          schema:
            enum:
              - api
              - cloudflare
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ChatListResponse'
          description: List chats
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Bad request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Authentication required
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Forbidden
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Not found
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Server error
      security:
        - bearerAuth: []
components:
  schemas:
    ChatListResponse:
      additionalProperties: {}
      properties:
        chats:
          items:
            additionalProperties: {}
            properties:
              id:
                type: string
              resource_type:
                enum:
                  - chat
                  - null
                type:
                  - string
                  - 'null'
              title:
                type: string
            type: object
          type: array
        pagination:
          properties:
            hasMore:
              type: boolean
            limit:
              type: integer
            offset:
              type: integer
            total:
              type: integer
          required:
            - hasMore
            - limit
            - offset
            - total
          type: object
      required:
        - chats
      type: object
    Error:
      properties:
        available:
          description: Optional available amount or value
          type: string
        billing_action:
          $ref: '#/components/schemas/BillingAction'
        code:
          description: Machine-readable error code
          type: string
        currentVersion:
          description: Current server-side version, when relevant
          type: number
        details:
          description: Optional structured error details
        error:
          description: Error type or code
          type: string
        expectedVersion:
          description: Client-provided expected version, when relevant
          type: number
        message:
          description: Human-readable error message
          type: string
        requested:
          description: Optional requested amount or value
          type: string
        usage:
          description: Optional usage metadata for limit errors
      required:
        - error
      type: object
    BillingAction:
      description: Action that resolves a billing-related rejection
      properties:
        href:
          type: string
        kind:
          enum:
            - upgrade
            - payment_method
            - spending_cap
            - billing
          type: string
        label:
          type: string
      required:
        - href
        - label
        - kind
      type: object
  securitySchemes:
    bearerAuth:
      bearerFormat: JWT
      description: Itoflow access token issued for the Itoflow API.
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.