For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Dashboard
GuidesIntegrationsAPI ReferencesRelease notes
GuidesIntegrationsAPI ReferencesRelease notes
  • Introduction
    • Overview
    • Quick Start
    • Projects
    • Billing
  • Uploading
    • Overview
    • Uploading files with API
    • File analysis on upload
  • Optimization
    • Overview
  • Transformations
  • Delivery
    • Overview
    • On-the-fly operations
    • CDN settings
    • Proxy
  • Security
    • Overview
    • Validation and moderation
    • Signed uploads
    • Signed URLs
    • Unsafe content moderation
    • Malware protection
    • HIPAA workflows
  • Storage
    • Uploadcare storage
    • Cloudflare R2
    • Google Cloud Storage
    • Azure Blob Storage
  • File management
    • Overview
    • Managing files
    • File groups
    • Webhooks
    • Arbitrary file metadata
  • CLI
    • Overview
    • Configuration
      • File and metadata
      • Groups
      • Projects
      • Convert, add-ons, and more
  • Migration
    • Migration to Uploadcare
    • Migration from Filestack
Dashboard
LogoLogo
On this page
  • group list
  • group info
  • group create
  • group delete
CLICommand reference

Group commands

Was this page helpful?
Previous

Project commands

Next
Built with

File groups bundle multiple files under a single group ID (format: <uuid>~<count>). They are useful for multi-file uploads and batch operations. See the file groups concept page for details.

Global flags like --json, --jq, -v, and --quiet are available on every command. See Configuration for the full list.

group list

List file groups in the current project.

$uploadcare group list [flags]

Flags:

FlagDefaultDescription
--orderingdatetime_createdSort order. Prefix with - for descending
--limit100Groups per page
--starting-pointStarting point (RFC 3339 datetime)
--page-allfalseStream all pages as NDJSON

JSON fields: id, files_count, datetime_created, datetime_stored, cdn_url, url

Examples:

$uploadcare group list --json all
$uploadcare group list --ordering -datetime_created --json all
$uploadcare group list --page-all --json id

group info

Get details for a file group, including its files.

$uploadcare group info <group-id>

JSON fields: id, files_count, datetime_created, datetime_stored, cdn_url, url, files

Examples:

$uploadcare group info "740e1b8c-1ad8-4324-b7ec-112345678900~3"
$uploadcare group info "740e1b8c-1ad8-4324-b7ec-112345678900~3" --json all

Quote group IDs in your shell to prevent the ~ character from being expanded.


group create

Create a file group from one or more file UUIDs.

$uploadcare group create <uuid>... [flags]

Flags:

FlagDefaultDescription
--from-stdinfalseRead UUIDs from stdin
--dry-runfalseValidate without creating

JSON fields: id, files_count, datetime_created, cdn_url

Examples:

$uploadcare group create UUID1 UUID2 UUID3
$uploadcare group create UUID1 UUID2 --json all
$uploadcare file list --page-all --stored true --json uuid | head -5 | uploadcare group create --from-stdin
$uploadcare group create UUID1 UUID2 --dry-run

group delete

Delete a file group. This removes the group, not the files in it.

$uploadcare group delete <group-id> [flags]

Flags:

FlagDefaultDescription
--dry-runfalseVerify group exists without deleting

JSON fields: id, status

Examples:

$uploadcare group delete "740e1b8c-1ad8-4324-b7ec-112345678900~3"
$uploadcare group delete "740e1b8c-1ad8-4324-b7ec-112345678900~3" --json all
$uploadcare group delete "740e1b8c-1ad8-4324-b7ec-112345678900~3" --dry-run