CLI

The Uploadcare CLI is a non-interactive interface to the Uploadcare platform, designed for automation, scripting, and agent-based workflows.

Use it when you need to:

• run file operations in CI/CD pipelines
• process files in bulk without writing integration code
• integrate Uploadcare into AI agent workflows
• automate repetitive tasks without using the dashboard or SDKs

Every command is scriptable, outputs structured data, and supports piping, making it suitable for both developers and automated systems.

When to use CLI

Use the CLI when:

• you need quick automation without building an integration
• you are working inside a terminal, script, or CI/CD pipeline
• you want to chain operations using piping and structured output
• you are building AI agents that need a predictable interface

For application-level integrations, SDKs or direct API usage may be more appropriate.

Install

Install on Linux or macOS with a single command:

$
curl -fsSL https://raw.githubusercontent.com/uploadcare/uploadcare-cli/main/scripts/install.sh | sh

The install script supports the following environment variables:

$
# Install a specific version
$
curl -fsSL https://raw.githubusercontent.com/uploadcare/uploadcare-cli/main/scripts/install.sh | VERSION=0.1.0 sh
$
$
# Install to a custom directory
$
curl -fsSL https://raw.githubusercontent.com/uploadcare/uploadcare-cli/main/scripts/install.sh | INSTALL_DIR=~/.local/bin sh
$
$
# Uninstall
$
curl -fsSL https://raw.githubusercontent.com/uploadcare/uploadcare-cli/main/scripts/install.sh | UNINSTALL=1 sh

Pre-built binaries for all platforms (Linux, macOS, Windows) are available on the GitHub Releases page.

First steps

$
export UPLOADCARE_PUBLIC_KEY="your_public_key"
$
export UPLOADCARE_SECRET_KEY="your_secret_key"

$
uploadcare file upload photo.jpg

UUID                                  SIZE      FILENAME    STORED
a1b2c3d4-e5f6-7890-abcd-ef1234567890  2.4 MB   photo.jpg   true

$
uploadcare file list

$
uploadcare --help
$
uploadcare file --help

AI agent usage

The CLI exposes its full command surface via:

$
uploadcare api-schema

This allows AI agents to:

• discover available commands, flags, and arguments
• understand available JSON fields for each command
• generate valid commands without parsing --help output

The command returns a machine-readable schema describing all available operations, making the CLI suitable for agent-based workflows.

Example: delete files from a list

$
cat file_ids.txt | uploadcare file delete --from-stdin --dry-run

Remove --dry-run to execute the deletion.

What’s next