Visual Experience Platform
Help CenterRelease NotesBlogWebsite
  • VXP - Visual Experience Platform
    • The VXP
      • Token
    • Settings
      • My Account
        • Profile
        • Support
      • Organisation
        • General Organisation Settings
        • Billing
          • Payment
          • Invoices
          • Plan
        • Users
          • Users
          • Roles
        • Teams
      • Project
        • Branding
        • Subscription
        • Analytics
          • Standard Dashboards
            • Multi tenants
            • User Dashboard
            • DAM Storage
            • Workflows Monitoring
            • Traffic Origin
            • Caching (Volumetry)
            • CDN performance
          • Custom Dashboard
        • Access
          • API keys
          • Security templates
          • OAuth2
  • Digital Asset Management (DAM)
    • Library
      • Assets
        • Asset Details window
          • Asset actions
            • Regional settings
            • Context menu ("..." button)
            • Add to My favorites (heart icon)
            • Edit media (image, video, etc)
              • Edit image
              • Edit video (coming soon)
              • Edit design template (coming soon)
            • Share
          • Asset information tabs
            • General
            • Metadata
            • Variations
            • Comments
            • Approvals
            • History
      • Folders
      • Collections
      • Labels
      • Products
      • My favorites
      • Help
      • Sharebox
      • Airbox
      • Search and Filters
        • Faceted Search
    • Plugins & Connectors
      • Plugins
        • Adobe Creative Cloud
        • Adobe Commerce (Magento)
        • Canva
        • Contentful
        • Contentstack
        • Directus
        • Drupal
        • Opencart
          • Opencart (v4)
        • Prestashop
        • Shopware
        • Storyblok
        • Strapi (v4)
        • Sylius
        • Uniform CMS
        • Wordpress
      • Connectors
        • Akeneo PIM App
        • Canva App
        • CI-Hub
        • Commercetools FaaS App
        • Hygraph app
        • Kontent.ai
        • OneTeg
        • Pabbly Connect
        • Prismic
        • Shopify / Shopify plus app
        • Zapier automation
    • Settings
      • Library
        • Featured components
        • Interface customization
      • Metadata
        • Metadata Configuration
        • Assets
      • Tags
        • Configuration
        • Dictionary
      • Notifications
      • Automations
        • Post processing
        • Webhooks
        • Workflows
      • Storage
        • Providers
        • Upload
        • Video
        • Listing
        • Download
        • Custom routing
  • Visual AI
    • Welcome
    • Visual AI
      • Images
        • Classification models
          • Auto-tagging
          • Brand detect
          • Dominant color extraction
          • Faces
            • Face analysis
            • Face clustering
          • Image quality
          • OCR
          • Number Plate recognition
          • Product type
          • Property classification
          • Scene Classification
          • Sport Classification
        • Generative AI models
          • Image-to-text
          • Plate blurring
          • Quality improvement (remove artifacts)
          • Remove background
          • Text-to-Image
        • Moderation models
          • Face count
          • NSFW - Not Safe For Work
          • Real estate authenticity
          • Watermark detection
      • Videos
        • Face detection
      • Search & find assets
        • Text Search
        • Similar Assets
  • Portals
    • Welcome
    • Creating a Portal
    • Editing a Portal
      • Pages
      • Sections
      • Design
      • Fonts
    • Managing a Portal
      • Settings
      • Access
      • Users
      • Labeling, Cloning, Archiving
    • Publishing a Portal
  • Dynamic Media Optimization (DMO)
    • Welcome
      • Responsive libraries
      • Native plugins
      • 360° view builder
      • Service status
    • Insights
      • Delivery
      • Optimization
      • Alerts
      • Logs
    • Transformations
      • Image optimization
        • Operations
          • Width and height
          • Prevent enlargement
          • Crop
            • Automatic Gravity Crop
            • Positionable Crop
            • Focal point Crop
            • Face Crop
            • Face hide
            • Aspect ratio crop
          • Fit
          • Cropfit
          • Bound
          • Boundmin
          • Cover
          • Device pixel ratio
          • Flip
          • Rotate
          • Trim
          • Rounded corners
        • Filters
          • Adjustment
            • Brightness
            • Contrast
            • Saturate
          • Color manipulation
            • Color overlay
            • Grayscale
            • Duotone
          • Blur
          • Pixelate
          • Sharpen
        • Watermarking
          • Static watermark
          • Dynamic watermark
          • Text watermark
        • Image compression
          • Image formats
          • Optipress
      • Video optimization
        • Video API
          • Editing
            • Chapters
            • Combine
            • Trim
          • Optimizing
            • Convert
            • Compress
            • Transcode
        • On-the-fly-video optimization
      • Static content optimization
        • PDF to image
        • JS/CSS optimization
    • Invalidation
    • Settings
      • Asset Origin
        • AWS S3 or any other S3-compatible storage provider
        • Google Cloud storage (GCP)
        • Azure Blob storage
        • Own HTTP-based Storage
      • Images
        • Compression
        • Optimization
        • Watermark
      • Static content
      • Delivery
        • CNAME
        • URL format
        • Rules
        • Security
        • Caching
        • Default behaviors
  • Developers / Headless
    • Headless DAM
      • DAM APIs
        • API Authentication
        • API Reference
      • Command Line Interface (CLI)
      • Media Asset Widget(MAW)
        • Overview
        • Developer reference
        • V2 End-of-life
Powered by GitBook
LogoLogo

Quick links

  • Go to website
  • Legal Center

©2024 Scaleflex SAS

On this page
  • Use cases and features
  • Installation
  • MacOS
  • Linux
  • Configuration
  • Usage
  • Examples
Export as PDF
  1. Developers / Headless
  2. Headless DAM

Command Line Interface (CLI)

A versatile command-line interface tool for seamless server-side interaction with the headless DAM API

PreviousAPI AuthenticationNextMedia Asset Widget(MAW)

Last updated 6 months ago

The CLI is a command-line interface tool designed to interact with the DAM API. It enables server-side use and provides a convenient way to perform various operations on digital assets, such as uploading, downloading, deleting, moving and renaming files. Additionally, it allows users to list and query asset information, including tags and metadata.

The DAM CLI provides all the functionality of DAM and its APIs. It can be used from the terminal or in a script to access the features of Scaleflex DAM in a convenient way. Using the tool, all media assets can be managed via simple commands on macOS or Linux.

For example, you can perform Admin and Upload API operations by typing commands directly into a terminal. This saves you time as you do not need to set up a development environment. You can also build scripts with multiple CLI commands to implement more complex processes and workflows.

Complete documentation of the tool is available on its GitHub page:

What follows is a brief introduction and a quick-start guide to get you up to speed in no time.

Use cases and features

The DAM CLI provides a range of use cases that demonstrate its versatility:

  • Bulk upload - Upload a large number of assets to the DAM in a single command, saving time and effort;

  • Automated workflows - Incorporate the CLI application into server-side scripts or workflows to perform scheduled asset management tasks;

  • Asset manipulation - Rename, move or delete assets based on specific criteria;

  • Metadata management - Query and update asset metadata;

  • Backup and recovery - Download assets from the DAM for backup or recovery purposes;

  • Integration with other systems - Integrate the CLI into third-party tools or systems for seamless asset management.

The features of DAM CLI include:

  • Uploading/Downloading multiple assets;

  • Batch asset deletion;

  • Listing assets;

  • Querying asset information such as metadata, tags, etc.;

  • Moving assets between folders;

  • Renaming assets.

The following DAM APIs are supported: Delete, Download, Inspect, List, Move, Product, Rename and Upload.

Complete information about the Filerobot API endpoints is available in an always up-to-date documentation, that can be accessed via the following link:

There, you can find details about the API endpoints, together with all required request parameters, so you know how to interact with them.

Installation

Filerobot API can be installed by running one of the following commands depending on your operating system. They download the latest release of the tool from the GitHub page, move it to an appropriate directory and make it available for use.

MacOS

sudo curl -L "https://github.com/scaleflex/filerobot-cli/releases/latest/download/filerobot-cli-darwin-x86_64" -o /usr/local/bin/filerobot && sudo chmod +x /usr/local/bin/filerobot

Linux

sudo curl -L "https://github.com/scaleflex/filerobot-cli/releases/latest/download/filerobot-cli-linux-x86_64" -o /usr/local/bin/filerobot && sudo chmod +x /usr/local/bin/filerobot

You can confirm that the installation was successful by running:

filerobot version

The version of the tool should appear on the screen:

Filerobot CLI v. 1.5.0

Configuration

Configuring the CLI requires a DAM Token (mytoken) and API Secret Key (mysupersecretkey) both of which are available from the Filerobot Asset Hub.

filerobot config --token=mytoken --key=mysupersecretkey

Usage

The following commands are available:

Command
Description

config

sets the token and key provided by Scaleflex, required to use the tool

delete

deletes a file by UUID

download

downloads a file by path or UUID

help

displays the help info for a command

inspect

gets file information by UUID

list

lists files and directories from your Filerobot store

move

moves files to a new folder. The folder is created if it doesn't exist

product

allows access to the Product API functionalities

rename

renames a file by UUID.

upload

uploads a file to a specific folder

version

prints the version number of Filerobot CLI

Additional info for any command can be accessed using filerobot [command] --help.

Examples

Inspect the current token and key:

filerobot config -i

List the contents of a directory:

filerobot list /test

Inspect a specific resource:

filerobot inspect bb1ce06f-2677-581a-85e7-28c00ec50000

Download a file by UUID:

filerobot download bb1ce06f-2677-581a-85e7-28c00ec50000

Upload a file to a specific folder:

filerobot upload face.png --folder=/Marketing

Upload all .jpg images in the current directory:

for i in *.jpg; do filerobot upload $i -f /cli/upload; done
LogoGitHub - scaleflex/filerobot-cli: A CLI for interacting with Filerobot Digital Asset Management. For questions and issues, please use: https://github.com/scaleflex/filerobot-cli/issuesGitHub
LogoScaleflex API for Digital Asset Management (DAM), Visual AI and Media OptimizationScaleflex API