Skip to Content
Skip to Content
Files, conversations, and integrations

Files, conversations, and integrations

Find file and conversation IDs, and check connected services and available models from your terminal.

View My Drive and manage folders

aipctl drive list aipctl drive usage

List My Drive items and check storage usage.

aipctl drive mkdir "Reports" aipctl drive rename ENTRY_ID "New name"

mkdir creates a folder at the root. The CLI does not let you specify a parent folder for creation. For rename, use the ID of the file or folder as ENTRY_ID.

aipctl drive list aipctl drive delete ENTRY_ID --force

To delete several items, separate their IDs with spaces. Check every target before running the command.

aipctl drive delete ENTRY_ID_1 ENTRY_ID_2 --force

Deleting a folder affects its contents. Check the target and contents first. Deletion is rejected if the folder and its descendants total more than 1,000 items; use the web interface to clean up in smaller batches.

Transfer My Drive files

Upload or download My Drive files you can access. Use the web interface where CLI transfers are restricted.

aipctl drive upload ./report.pdf aipctl drive list

Uploads go to the root; there is no parent-folder option. Check the ID in the completion message and the file list. If storage or file limits cause a failure, check the cause before retrying. If the outcome is unclear, check the list before uploading a duplicate.

aipctl drive download ENTRY_ID --output ./downloads/report.pdf

A destination path is required. You can use -o instead of --output. Existing files at that path are overwritten, so check the destination first. Verify the path and size in the success message. If the command is unavailable or rejected, transfer through the web interface.

View your conversations

aipctl chat list aipctl chat get CONVERSATION_ID aipctl chat messages CONVERSATION_ID

You can query only conversations you own. Organization administrators cannot use these commands to read all other users’ conversations.

  • A conversation list returns up to 50 items per query.
  • Message text masks sensitive information and shows up to 500 characters per message. Read the full content in the web interface.
  • chat messages does not support --json.
  • Message queries are limited to 1,000 messages and 8 MiB of total data. Exceeding a limit returns an error rather than presenting a partial result as a success.
  • Conversation details do not reproduce all attachments, tags, or archived state shown in the web interface.

To send a question to an agent, check version and server requirements, then see Chat with an agent. Send new messages in regular conversations through the web interface.

Check connected MCP servers

aipctl integration list

Check accessible integrations and policy status. AI Operators can also retrieve details, available integrations, and tool lists.

aipctl admin integration available aipctl admin integration get INTEGRATION_ID aipctl admin integration tools INTEGRATION_ID

The tool list shows names, descriptions, and policy status. It does not execute tools.

Test, update, or delete an integration

Test a connection or update and delete its settings. You need the permissions for each operation. Use the web interface where execution is restricted.

aipctl integration test INTEGRATION_ID

This requests a connection check for the external service. Review the success or failure message. On failure, check authentication and settings. Integrations that do not support connection tests may reject the request. A successful test does not guarantee that every tool will run successfully.

AI Operators can update or delete integrations where permitted.

aipctl admin integration get INTEGRATION_ID aipctl admin integration update INTEGRATION_ID ./integration-update.json aipctl admin integration get INTEGRATION_ID

Prepare the update file using the format required by the integration and server version. There is no single JSON structure for all integrations, and detail query results should not be used directly as update input. If you cannot confirm the required format, configure the integration through the web interface. Restrict storage and sharing of files containing credentials.

aipctl admin integration delete INTEGRATION_ID --force aipctl integration list

Deletion can affect agents, presets, and other tasks using the integration. Check dependencies and the ID first, then verify the list after deletion.

Check available models

aipctl model list

model list lists model IDs. It does not run models or generate images.

Last updated on