---
title: "List the user's named chat or agent-workflow sessions"
method: GET
path: "/assistant/chat/sessions"
tags: ["Chat"]
---

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

`GET /assistant/chat/sessions`

## Request

- Base URL: `https://api.mobilerun.ai`
- URL: `https://api.mobilerun.ai/assistant/chat/sessions`
- Auth: HTTP bearer

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.

## Query parameters

- `kind` 'chat' | 'agent_workflow'
- `workflowId` string
- `mine` 'true' | 'false'

## Response `200`

Sessions for the requested kind

- object
  - `sessions` union[], required
    - union
      - object
        - `id` string, required
        - `title` string, required
        - `description` string, nullable, required
        - `agent` string, nullable, required
        - `status` string, required
        - `createdAt` string, required
        - `lastActiveAt` string, required
        - `turnActive` boolean, required
        - `turnStartedAt` string, nullable, required
        - `pinned` boolean, required
        - `costCents` number, required
        - `costUsd` number, required
        - `creditsUsed` number, nullable, required
        - `peakPromptTokens` number, nullable, required
        - `basePromptTokens` number, nullable, required
        - `contextExhaustedAt` string, nullable, required
        - `createdBy` string, nullable
        - `promptStatus` 'ready' | 'machine_replaced', required
        - `kind` 'chat', required
        - `workflowId` unknown, required
        - `sourceExecutionId` unknown, required
        - `episode` integer, required
      - object
        - `id` string, required
        - `title` string, required
        - `description` string, nullable, required
        - `agent` string, nullable, required
        - `status` string, required
        - `createdAt` string, required
        - `lastActiveAt` string, required
        - `turnActive` boolean, required
        - `turnStartedAt` string, nullable, required
        - `pinned` boolean, required
        - `costCents` number, required
        - `costUsd` number, required
        - `creditsUsed` number, nullable, required
        - `peakPromptTokens` number, nullable, required
        - `basePromptTokens` number, nullable, required
        - `contextExhaustedAt` string, nullable, required
        - `createdBy` string, nullable
        - `promptStatus` 'ready' | 'machine_replaced', required
        - `kind` 'agent_workflow', required
        - `workflowId` string, required
        - `sourceExecutionId` string, required
        - `episode` integer, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `500`: Internal Server Error

## Changes

- **2026-10-16** `4ad548c528a8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/droidrun/apis/droidrun-cloud/changes/assistant/chat/sessions/get.md)

---

[API](https://skmtc.dev/droidrun/apis/droidrun-cloud.md) - [All operations](https://skmtc.dev/droidrun/apis/droidrun-cloud/llms.txt) - [OpenAPI document](https://skmtc.dev/droidrun/apis/droidrun-cloud/revisions/1cc95586c933?raw)