canva-asset-manager

name	canva-asset-manager
description	Upload and manage assets (images, videos, audio) in your Canva account. Use this skill when user wants to upload files to Canva, manage their asset library, or work with uploaded media. Handles image, video, and audio uploads. Follows 3-mode workflow. For organizing uploaded assets use canva-folder-organizer.
allowed-tools	["Bash","Read","Write","Glob","AskUserQuestion"]

Canva Asset Manager Skill

QUICK REFERENCE

• Scripts location: scripts/ (NOT skills/canva-asset-manager/scripts/ - those don't exist)
• Auth check: .venv\Scripts\python.exe scripts/auth_check.py
• API client: scripts/canva_client.py (import: from canva_client import get_client)
• Sample script: scripts/samples/sample_canva_operations.py

WARNING: Commands below referencing skills/canva-asset-manager/scripts/*.py are WRONG paths. Write custom Python using canva_client.py. See scripts/samples/sample_canva_operations.py.

Upload and manage media assets in your Canva account.

Scope of This Skill

This skill handles:

• Upload images to Canva
• Upload videos to Canva
• Upload audio files to Canva
• Manage uploaded assets (rename, delete)
• View asset library
• Add tags to assets
• URL-based uploads

NOT handled by this skill:

• Using assets in designs → Use canva-image-editor
• Organizing into folders → Use canva-folder-organizer
• Exporting designs → Use canva-export

Supported File Types

Images

Format	Max Size	Notes
PNG	25MB	Supports transparency
JPG/JPEG	25MB	Best for photos
SVG	3MB	Vector graphics
GIF	25MB	Static or animated
WebP	25MB	Modern format
HEIC	25MB	Apple format

Videos

Format	Max Size	Notes
MP4	1GB	Most common
MOV	1GB	Apple format
WebM	1GB	Web format
M4V	1GB	Apple format

Audio

Format	Max Size	Notes
MP3	250MB	Most common
WAV	250MB	High quality
M4A	250MB	Apple format
OGG	250MB	Open format

3-Mode Workflow

MODE 1: PLAN

1. Identify Upload Requirements

   # Check what files need uploading
   # Verify file types and sizes
   # Determine upload destination
   

2. Document Upload Plan

   ## Asset Upload Plan
   
   ### Files to Upload
   | File | Type | Size | Status |
   |------|------|------|--------|
   | hero-image.png | PNG | 2.1MB | Ready ✓ |
   | promo-video.mp4 | MP4 | 45MB | Ready ✓ |
   | logo.svg | SVG | 120KB | Ready ✓ |
   
   ### Upload Destination
   - Folder: Uploads (default) or specific folder
   
   ### Naming Convention
   - Keep original names OR
   - Rename to: project_asset_date format
   
   ### Tags to Apply
   - "Project Alpha"
   - "2024"
   - "Marketing"
   

MODE 2: CLARIFY

Upload-specific questions:

1. File Verification

   • "Upload all 5 images or select specific ones?"
   • "File 'large-video.mp4' is 500MB. This may take time. Proceed?"

2. Naming

   • "Keep original filenames or rename?"
   • "Use a naming pattern like 'project_001'?"

3. Organization

   • "Upload to default Uploads folder or specific folder?"
   • "Create a new folder for these uploads?"

4. Tagging

   • "Add any tags for easy searching later?"
   • "Apply project name as tag?"

MODE 3: IMPLEMENT

# Upload single file
python skills/canva-asset-manager/scripts/upload_asset.py \
  --file "path/to/image.png" \
  --name "Custom Name" \
  --tags "tag1,tag2"

# Upload multiple files
python skills/canva-asset-manager/scripts/batch_upload.py \
  --folder "input/images/" \
  --pattern "*.png" \
  --tags "batch-upload"

# Upload from URL
python skills/canva-asset-manager/scripts/upload_from_url.py \
  --url "https://example.com/image.png" \
  --name "Downloaded Image"

# Update asset metadata
python skills/canva-asset-manager/scripts/update_asset.py \
  --id "ASSET_ID" \
  --name "New Name" \
  --tags "new-tag,another-tag"

# Delete asset
python skills/canva-asset-manager/scripts/delete_asset.py \
  --id "ASSET_ID" \
  --confirm true

Available Scripts

Upload Scripts

• upload_asset.py - Upload single file
• batch_upload.py - Upload multiple files
• upload_from_url.py - Upload from URL
• check_upload_status.py - Check async upload progress

Management Scripts

• list_assets.py - List uploaded assets
• get_asset.py - Get asset details
• update_asset.py - Update name/tags
• delete_asset.py - Delete asset
• search_assets.py - Search by name/tag

Utility Scripts

• validate_files.py - Check file compatibility
• resize_before_upload.py - Resize large images
• convert_format.py - Convert to supported format

Upload Process

Canva uploads are asynchronous:

# Step 1: Initiate upload
job_id = start_upload(file_path, metadata)

# Step 2: Upload file data
upload_file_data(job_id, file_bytes)

# Step 3: Poll for completion
while True:
    status = check_status(job_id)
    if status == "completed":
        asset_id = get_asset_id(job_id)
        break
    elif status == "failed":
        handle_error()
        break
    time.sleep(2)

The scripts handle this automatically.

Batch Upload

For uploading multiple files:

# Upload all PNGs from a folder
python skills/canva-asset-manager/scripts/batch_upload.py \
  --folder "input/images/" \
  --pattern "*.png" \
  --naming "original" \
  --tags "project-x,batch-2024"

# Upload with custom naming
python skills/canva-asset-manager/scripts/batch_upload.py \
  --folder "input/images/" \
  --pattern "*.jpg" \
  --naming "prefix" \
  --prefix "campaign_" \
  --tags "marketing"

# Upload specific files from list
python skills/canva-asset-manager/scripts/batch_upload.py \
  --files "file1.png,file2.jpg,file3.svg" \
  --tags "selected-uploads"

URL Upload

Upload directly from URLs:

# Single URL
python skills/canva-asset-manager/scripts/upload_from_url.py \
  --url "https://example.com/image.png" \
  --name "External Image"

# Multiple URLs from file
python skills/canva-asset-manager/scripts/batch_url_upload.py \
  --urls-file "input/urls.txt" \
  --tags "from-web"

Note: URL uploads have a 100MB limit.

Asset Management

Viewing Assets

# List all uploaded assets
python skills/canva-asset-manager/scripts/list_assets.py

# Get specific asset details
python skills/canva-asset-manager/scripts/get_asset.py --id "ASSET_ID"

# Search by name
python skills/canva-asset-manager/scripts/search_assets.py --query "logo"

# Search by tag
python skills/canva-asset-manager/scripts/search_assets.py --tag "marketing"

Updating Assets

# Rename asset
python skills/canva-asset-manager/scripts/update_asset.py \
  --id "ASSET_ID" \
  --name "Better Name"

# Add tags
python skills/canva-asset-manager/scripts/update_asset.py \
  --id "ASSET_ID" \
  --tags "new-tag,another-tag" \
  --mode "add"

# Replace tags
python skills/canva-asset-manager/scripts/update_asset.py \
  --id "ASSET_ID" \
  --tags "only-this-tag" \
  --mode "replace"

Deleting Assets

# Delete single asset
python skills/canva-asset-manager/scripts/delete_asset.py \
  --id "ASSET_ID" \
  --confirm true

# Bulk delete by tag
python skills/canva-asset-manager/scripts/bulk_delete.py \
  --tag "temp-uploads" \
  --confirm true

Input Folder

The input/ folder is for files to upload:

input/
├── images/          # Images to upload
│   ├── hero.png
│   ├── banner.jpg
│   └── icons/
├── videos/          # Videos to upload
│   └── promo.mp4
├── audio/           # Audio to upload
│   └── background.mp3
└── urls.txt         # URLs for URL-based upload

File Validation

Before uploading, validate files:

python skills/canva-asset-manager/scripts/validate_files.py \
  --folder "input/images/"

# Output:
# Validation Results:
# ✓ hero.png - Valid (PNG, 2.1MB)
# ✓ banner.jpg - Valid (JPEG, 1.5MB)
# ✗ huge.png - Too large (30MB > 25MB limit)
# ✗ document.pdf - Unsupported format

Resize Before Upload

For images that are too large:

python skills/canva-asset-manager/scripts/resize_before_upload.py \
  --file "input/huge-image.png" \
  --max-size 25 \      # MB
  --output "input/resized/"

Safety Guidelines

1. Validate before upload - Check file types and sizes
2. Use meaningful names - Makes assets easier to find
3. Tag consistently - Develop a tagging strategy
4. Don't upload duplicates - Check existing assets first
5. Large files take time - Be patient with video uploads

Example Interactions

"Upload my logo to Canva"

[PLAN]
- File: logo.png (500KB)
- Format: PNG ✓
- Size: Valid ✓

[CLARIFY]
- "Upload with name 'logo' or custom name?"
- "Add any tags?"

[IMPLEMENT]
- Upload file
- Return asset ID
- "Uploaded successfully: Asset ID xxx"

"Upload all images from my folder"

[PLAN]
- Folder: input/campaign/
- Found: 12 images (8 PNG, 4 JPG)
- Total size: 15MB

[CLARIFY]
- "Upload all 12 images?"
- "Use original names or rename?"
- "Apply tags to all?"

[IMPLEMENT]
- Upload in batches
- Report progress
- List all asset IDs

"Upload this video for my reel"

[PLAN]
- File: promo.mp4 (120MB)
- Format: MP4 ✓
- Duration: 30 seconds

[CLARIFY]
- "Video is 120MB, upload may take 1-2 minutes."
- "Any specific name for this video?"

[IMPLEMENT]
- Upload video
- Monitor progress
- Return asset ID when complete

Rate Limits

Asset API limits:

• Upload initiation: 30 requests/user
• Status checks: 180 requests/user
• Updates: 30 requests/user

For bulk uploads, implement delays between requests.

Output Files

Upload logs saved to:

• output/uploads/upload_log.json - All upload operations
• output/uploads/assets.json - Uploaded asset IDs and details
• output/uploads/errors.json - Failed uploads