Fluxiom

Fluxiom

Interact with the Fluxiom digital asset management API using curl.

Configuration

Config file: ~/.config/fluxiom/config.json

{
  "subdomain": "acme",
  "domain": "fluxiom.com",
  "user": "jane@acme.example.com",
  "password": "your-password"
}

All requests use HTTP Basic Auth over HTTPS. Read credentials from the config file:

FLUXIOM_SUBDOMAIN=$(jq -r .subdomain ~/.config/fluxiom/config.json)
FLUXIOM_DOMAIN=$(jq -r '.domain // "fluxiom.com"' ~/.config/fluxiom/config.json)
FLUXIOM_USER=$(jq -r .user ~/.config/fluxiom/config.json)
FLUXIOM_PASS=$(jq -r .password ~/.config/fluxiom/config.json)

Quick Reference

Account

Get Account Info

# Read credentials (do this once per session)
FLUXIOM_SUBDOMAIN=$(jq -r .subdomain ~/.config/fluxiom/config.json)
FLUXIOM_DOMAIN=$(jq -r '.domain // "fluxiom.com"' ~/.config/fluxiom/config.json)
FLUXIOM_USER=$(jq -r .user ~/.config/fluxiom/config.json)
FLUXIOM_PASS=$(jq -r .password ~/.config/fluxiom/config.json)

curl -s -u "$FLUXIOM_USER:$FLUXIOM_PASS" \
  "https://$FLUXIOM_SUBDOMAIN.$FLUXIOM_DOMAIN/api/account.json"

Response:

{
  "subdomain": "acme",
  "plan": "Basic",
  "stats": { "used_space": "8456140", "available_space": "30056314932" },
  "country": "AT",
  "trial": "false",
  "account_holder_id": "1",
  "branding": "active",
  "branding_info": { "title": "Acme", "logo": "/branding/logo.png" },
  "billing_email": "billing@acme.example.com",
  "created_on": "2009-08-19T22:00:00Z",
  "updated_on": "2009-08-19T22:00:00Z"
}

Assets

List / Search Assets

curl -s -u "$FLUXIOM_USER:$FLUXIOM_PASS" \
  "https://$FLUXIOM_SUBDOMAIN.$FLUXIOM_DOMAIN/api/assets.json?query=logo&tags=design&page=1&per_page=25"

Parameters: query (search term), tags (comma-separated names or IDs), page, per_page (max 100).

Response:

[
  {
    "id": 18552,
    "title": "fluxiom logo",
    "filename": "logo.gif",
    "description": "The fluxiom logo",
    "thumb_url": "/t/.../ebc62ck6w8p7c5nodq9_64.jpg"
  }
]

Get Single Asset

curl -s -u "$FLUXIOM_USER:$FLUXIOM_PASS" \
  "https://$FLUXIOM_SUBDOMAIN.$FLUXIOM_DOMAIN/api/assets/ID.json"

Response includes full metadata: size, content_type, created_on, updated_on, version, user_id, tags array, and image metadata fields (metadata_pixel_width, metadata_pixel_height, metadata_color_space, etc.).

Download Asset

curl -s -u "$FLUXIOM_USER:$FLUXIOM_PASS" \
  -o output.jpg \
  "https://$FLUXIOM_SUBDOMAIN.$FLUXIOM_DOMAIN/api/assets/download/ID.json"

Upload a File

curl -s -u "$FLUXIOM_USER:$FLUXIOM_PASS" \
  -F "file=@/path/to/file.png" \
  -F "title=My File" \
  -F "description=File description" \
  -F "tags=design,branding" \
  "https://$FLUXIOM_SUBDOMAIN.$FLUXIOM_DOMAIN/api/assets.json"

Parameters: file (required, postdata), title, description, tags (comma-separated).

Update Asset

curl -s -u "$FLUXIOM_USER:$FLUXIOM_PASS" \
  -X PUT \
  -d "title=Updated Title" \
  -d "description=New description" \
  -d "tags=new-tag,other-tag" \
  "https://$FLUXIOM_SUBDOMAIN.$FLUXIOM_DOMAIN/api/assets/ID.json"

Parameters: title, description, tags (comma-separated).

Delete Asset

curl -s -u "$FLUXIOM_USER:$FLUXIOM_PASS" \
  -X DELETE \
  "https://$FLUXIOM_SUBDOMAIN.$FLUXIOM_DOMAIN/api/assets/ID.json"

Asset Versions

List versions:

curl -s -u "$FLUXIOM_USER:$FLUXIOM_PASS" \
  "https://$FLUXIOM_SUBDOMAIN.$FLUXIOM_DOMAIN/api/assets/ID/versions.json"

Get single version:

curl -s -u "$FLUXIOM_USER:$FLUXIOM_PASS" \
  "https://$FLUXIOM_SUBDOMAIN.$FLUXIOM_DOMAIN/api/assets/ID/versions/VID.json"

Create new version:

curl -s -u "$FLUXIOM_USER:$FLUXIOM_PASS" \
  -F "file=@/path/to/updated-file.png" \
  -F "comment=Updated logo with new colors" \
  "https://$FLUXIOM_SUBDOMAIN.$FLUXIOM_DOMAIN/api/assets/ID/versions.json"

Version response includes: id, version, comment, size, content_type, filename, user_id, created_on, updated_on, and metadata object.

Tags

List Tags

curl -s -u "$FLUXIOM_USER:$FLUXIOM_PASS" \
  "https://$FLUXIOM_SUBDOMAIN.$FLUXIOM_DOMAIN/api/tags.json"

Response:

[
  { "tag": "fluxiom", "id": 13409, "documents_count": 20, "stages_count": 1 }
]

Create Tag

curl -s -u "$FLUXIOM_USER:$FLUXIOM_PASS" \
  -X POST -d "tag=my-new-tag" \
  "https://$FLUXIOM_SUBDOMAIN.$FLUXIOM_DOMAIN/api/tags.json"

Update Tag

curl -s -u "$FLUXIOM_USER:$FLUXIOM_PASS" \
  -X PUT -d "tag=renamed-tag" \
  "https://$FLUXIOM_SUBDOMAIN.$FLUXIOM_DOMAIN/api/tags/ID.json"

Delete Tag

curl -s -u "$FLUXIOM_USER:$FLUXIOM_PASS" \
  -X DELETE \
  "https://$FLUXIOM_SUBDOMAIN.$FLUXIOM_DOMAIN/api/tags/ID.json"

Users

List Users

curl -s -u "$FLUXIOM_USER:$FLUXIOM_PASS" \
  "https://$FLUXIOM_SUBDOMAIN.$FLUXIOM_DOMAIN/api/users.json"

Response:

[
  {
    "id": 22,
    "first_name": "Jane",
    "last_name": "Smith",
    "email": "jane@acme.example.com",
    "permissions": ["login", "manage_assets"],
    "created_on": "2009-03-24T09:05:02+01:00",
    "updated_on": "2010-07-15T16:52:18+02:00"
  }
]

Get Current User

curl -s -u "$FLUXIOM_USER:$FLUXIOM_PASS" \
  "https://$FLUXIOM_SUBDOMAIN.$FLUXIOM_DOMAIN/api/user.json"