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

# List the user's named chat or agent-workflow sessions

> Default (`kind` absent or `chat`): active named chat sessions, pinned first then most recent activity — `workflowId` must be absent, or the request 400s. `mine=true` (only valid with `kind=chat`) narrows to sessions the caller created. `kind=agent_workflow`: workflow-linked sessions for one workflow (`workflowId` required, or the request 400s), no status filter, newest episode first.



## OpenAPI

````yaml /api-reference/mobilerun-va-chat.yaml get /assistant/chat/sessions
openapi: 3.1.0
info:
  title: Mobilerun VA Chat
  version: v1
servers:
  - description: Droidrun Cloud API
    url: https://api.mobilerun.ai/v1
security:
  - bearerAuth: []
paths:
  /assistant/chat/sessions:
    get:
      tags:
        - Chat
      summary: List the user's named chat or agent-workflow sessions
      description: >-
        Default (`kind` absent or `chat`): active named chat sessions, pinned
        first then most recent activity — `workflowId` must be absent, or the
        request 400s. `mine=true` (only valid with `kind=chat`) narrows to
        sessions the caller created. `kind=agent_workflow`: workflow-linked
        sessions for one workflow (`workflowId` required, or the request 400s),
        no status filter, newest episode first.
      operationId: chatSessionsList
      parameters:
        - in: query
          name: kind
          required: false
          schema:
            enum:
              - chat
              - agent_workflow
            type: string
        - in: query
          name: workflowId
          required: false
          schema:
            minLength: 1
            type: string
        - in: query
          name: mine
          required: false
          schema:
            enum:
              - 'true'
              - 'false'
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  sessions:
                    items:
                      oneOf:
                        - properties:
                            agent:
                              type:
                                - string
                                - 'null'
                            basePromptTokens:
                              type:
                                - number
                                - 'null'
                            contextExhaustedAt:
                              type:
                                - string
                                - 'null'
                            costCents:
                              type: number
                            costUsd:
                              type: number
                            createdAt:
                              type: string
                            createdBy:
                              type:
                                - string
                                - 'null'
                            description:
                              type:
                                - string
                                - 'null'
                            episode:
                              minimum: 1
                              type: integer
                            id:
                              type: string
                            kind:
                              enum:
                                - chat
                              type: string
                            lastActiveAt:
                              type: string
                            peakPromptTokens:
                              type:
                                - number
                                - 'null'
                            pinned:
                              type: boolean
                            promptStatus:
                              enum:
                                - ready
                                - machine_replaced
                              type: string
                            sourceExecutionId:
                              type: 'null'
                            status:
                              type: string
                            title:
                              type: string
                            turnActive:
                              type: boolean
                            turnStartedAt:
                              type:
                                - string
                                - 'null'
                            workflowId:
                              type: 'null'
                          required:
                            - id
                            - title
                            - description
                            - agent
                            - status
                            - createdAt
                            - lastActiveAt
                            - turnActive
                            - turnStartedAt
                            - pinned
                            - costCents
                            - costUsd
                            - peakPromptTokens
                            - basePromptTokens
                            - contextExhaustedAt
                            - promptStatus
                            - kind
                            - workflowId
                            - sourceExecutionId
                            - episode
                          type: object
                        - properties:
                            agent:
                              type:
                                - string
                                - 'null'
                            basePromptTokens:
                              type:
                                - number
                                - 'null'
                            contextExhaustedAt:
                              type:
                                - string
                                - 'null'
                            costCents:
                              type: number
                            costUsd:
                              type: number
                            createdAt:
                              type: string
                            createdBy:
                              type:
                                - string
                                - 'null'
                            description:
                              type:
                                - string
                                - 'null'
                            episode:
                              minimum: 1
                              type: integer
                            id:
                              type: string
                            kind:
                              enum:
                                - agent_workflow
                              type: string
                            lastActiveAt:
                              type: string
                            peakPromptTokens:
                              type:
                                - number
                                - 'null'
                            pinned:
                              type: boolean
                            promptStatus:
                              enum:
                                - ready
                                - machine_replaced
                              type: string
                            sourceExecutionId:
                              type: string
                            status:
                              type: string
                            title:
                              type: string
                            turnActive:
                              type: boolean
                            turnStartedAt:
                              type:
                                - string
                                - 'null'
                            workflowId:
                              type: string
                          required:
                            - id
                            - title
                            - description
                            - agent
                            - status
                            - createdAt
                            - lastActiveAt
                            - turnActive
                            - turnStartedAt
                            - pinned
                            - costCents
                            - costUsd
                            - peakPromptTokens
                            - basePromptTokens
                            - contextExhaustedAt
                            - promptStatus
                            - kind
                            - workflowId
                            - sourceExecutionId
                            - episode
                          type: object
                    type: array
                required:
                  - sessions
                type: object
          description: Sessions for the requested kind
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '500':
          description: Internal Server Error
      x-codeSamples:
        - lang: JavaScript
          source: |-
            import Mobilerun from '@mobilerun/sdk';

            const client = new Mobilerun({
              apiKey: process.env['MOBILERUN_CLOUD_API_KEY'], // This is the default and can be omitted
            });

            const conversations = await client.assistant.conversations.list();

            console.log(conversations.sessions);
        - lang: Python
          source: |-
            import os
            from mobilerun_sdk import Mobilerun

            client = Mobilerun(
                api_key=os.environ.get("MOBILERUN_CLOUD_API_KEY"),  # This is the default and can be omitted
            )
            conversations = client.assistant.conversations.list()
            print(conversations.sessions)
components:
  securitySchemes:
    bearerAuth:
      bearerFormat: Opaque
      description: Bearer token via Authorization header
      scheme: bearer
      type: http

````