pCloud
The robomotion pcloud CLI connects to pCloud for cloud file storage management. It uploads, downloads, lists, and deletes files; creates and manages folders; and handles file operations on pCloud storage.
When to use
- Upload or download files between local filesystem and pCloud
- List files and create/delete folders
- Manage files and folder structure in pCloud
Prerequisites
robomotionCLI installed- Package installed:
robomotion install pcloud - pCloud access token configured via Robomotion vault
IMPORTANT: Session Mode Required for Multi-Step Operations
Each CLI command runs as a separate process — connection IDs from connect do NOT persist across calls.
You MUST use --session on connect and pass --session-id to all subsequent commands.
Workflow
- Install (once):
robomotion install pcloud - Connect with session:
robomotion pcloud pcloud_connect --session --output json # → {"outClientId":"<client-id>","session_id":"<session-id>"} - Use the returned
client-idandsession-idin all subsequent commands:robomotion pcloud pcloud_upload_file --client-id "<client-id>" --file-path <local> --folder-id <folder> --session-id "<session-id>" --output json - Disconnect when done:
robomotion pcloud pcloud_disconnect --client-id "<client-id>" --session-id "<session-id>" --output json
Always append --output json to get structured JSON results.
Commands Reference
robomotion pcloud copy_file --client-id --source-path --target-path --session-id "<session-id>" --output jsonCopy a file from one location to another in pCloudrobomotion pcloud create_folder --client-id --path --session-id "<session-id>" --output jsonCreate a new folder at the specified path in pCloudrobomotion pcloud delete_file --client-id --path --session-id "<session-id>" --output jsonDelete a file at the specified path in pCloudrobomotion pcloud delete_folder --client-id --path --session-id "<session-id>" --output jsonDelete a folder and all its contents recursively in pCloudrobomotion pcloud login [--region] --output jsonLogin to pCloud using username and password credentialsrobomotion pcloud rename_file --client-id --source-path --target-path --session-id "<session-id>" --output jsonRename or move a file to a new path in pCloudrobomotion pcloud rename_folder --client-id --source-path --target-path --session-id "<session-id>" --output jsonRename or move a folder to a new path in pCloudrobomotion pcloud upload_file --client-id --file-path --folder-id --remote-file-name --session-id "<session-id>" --output jsonUpload a file from local filesystem to pCloudrobomotion pcloud get_public_link --client-id --path [--type] --session-id "<session-id>" --output jsonGenerate a public sharing link for a file or folder in pCloud
Environment
- ROBOMOTION_API_TOKEN (if vault credentials are needed)