filescom-chat-sessions · diff

git:20260629.dce077b to git:20260629.17de3c6

2 added, 2 removed. Audit A to A.

---

name: filescom-chat-sessions

description: |

A ChatSession represents one conversation with the Files.com AI Assistant.

---

# filescom-chat-sessions

A ChatSession represents one conversation with the Files.com AI Assistant.

All subcommands also accept the global flags documented in [`CONTEXT.md`](../../CONTEXT.md) (`--api-key`, `--format`, `--workspace-id`, `--debug`, and the pagination flags `--cursor` / `--per-page` / `--max-pages` on `list`). Those are not repeated below.

## Commands

### `files-cli chat-sessions list`

List Chat Sessions.

| Flag | Type | Description |

| --- | --- | --- |

- | `--sort-by` | object | If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `id` and `workspace_id`. |

- | `--filter` | object | If set, return records where the specified field is equal to the supplied value. Valid fields are `ai_task_id`, `user_id` or `workspace_id`. Valid field combinations are `[ workspace_id, ai_task_id ]` and `[ workspace_id, user_id ]`. |

+ | `--sort-by` | object | If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `id`. |

+ | `--filter` | object | If set, return records where the specified field is equal to the supplied value. Valid fields are `ai_task_id`, `user_id` or `workspace_id`. |

### `files-cli chat-sessions find`

Show Chat Session.

| Flag | Type | Description |

| --- | --- | --- |

| `--id` | string | Chat Session ID. **Required.** |