Chat Sessions
A ChatSession represents one conversation with the Files.com AI Assistant.
List Chat Sessions
Command
files-cli chat-sessions list
Output
Outputs a list of ChatSession objects according to the output format.
Authorization Requirement
Requires either a Site-Wide API key or User API key or session from a User with Site Admin permissions.
Additional Arguments
Show Chat Session
Command
files-cli chat-sessions find
Output
Outputs a ChatSession object according to the output format.
Authorization Requirement
Requires either a Site-Wide API key or User API key or session from a User with Site Admin permissions.
Flags
| Flag | Description |
|---|---|
| --id= string Required | Chat Session ID. |
The ChatSession Object
Some of the commands above return a ChatSession object. The attributes of this object are listed below.
| Attribute | Description |
|---|---|
| id string | Chat Session ID. |
| title string | Short AI-generated chat title. |
| user_id int64 | User ID. |
| ai_task_id int64 | AI Task ID. Present when the conversation was started by an AI Task. |
| workspace_id int64 | Workspace ID. 0 means the default workspace. |
| last_active_at date-time | Most recent chat activity date/time. |
| created_at date-time | Chat session creation date/time. |
| messages array(object) | Visible conversation messages in this chat session. For performance reasons, this is not provided when listing chat sessions. |