Media

Media commands manage the files and folders in your media library. Most commands accept either a UUID or a name for files and folders — when a name matches multiple items, the CLI prompts you to pick one interactively.

Names can be UUID-prefixed (for example f200d255-...-photo.pdf). The CLI extracts the leading UUID automatically, falling back to a name search if that lookup fails.

Files

media:upload

Upload a file to your media library. The CLI handles presigned URL generation and the upload to S3 automatically.

so-me media:upload [file] [options]

Argument	Description
`[file]`	Path to the file. Omit to be prompted (supports drag & drop — surrounding quotes/whitespace are stripped).

Option	Description
`--folder <id-or-name>`	Upload into a specific folder (resolved by UUID or name)

The MIME type is inferred from the file extension. Recognized extensions:

Type	Extensions
Image	`.png`, `.jpg`, `.jpeg`, `.gif`, `.webp`, `.svg`
Video	`.mp4`, `.mov`, `.avi`, `.webm`
Audio	`.mp3`, `.wav`
Document	`.pdf`

Any other extension is uploaded as application/octet-stream.

Examples

# Upload an image
so-me media:upload ./photo.jpg

# Upload into a folder (by name)
so-me media:upload ./banner.png --folder "Campaign Assets"

# Interactive — prompts for a path (drag & drop a file)
so-me media:upload

Response

{
  "fileId": "f200d255-...",
  "url": "https://cdn.so-me.studio/...",
  "filename": "photo.jpg",
  "size": 1024000
}

media:list

List media files and folders. With --folder, lists the contents of that folder; with --file, returns the details of a single file.

so-me media:list [options]

Option	Description
`--folder <id-or-name>`	List the contents of a specific folder (resolved by UUID or name)
`--file <id-or-name>`	Get the details of a specific file (resolved by UUID, UUID-prefixed name, or name search)

Examples

# List all media as a table
so-me media:list --table

# List files inside a folder
so-me media:list --folder "Campaign Assets"

# Get a specific file by name
so-me media:list --file "banner.png"

You can reference files and folders by name or UUID. When multiple items match a name, the CLI prompts you to select one.

media:search

Search for media files by name across all folders.

so-me media:search <term>

Argument	Description
`<term>`	Search term matched against file names

Example

so-me media:search "banner"

media:get

Get detailed metadata for a specific media file by its UUID.

so-me media:get <id>

Argument	Description
`<id>`	File UUID

Example

so-me media:get f200d255-1234-4abc-89de-0123456789ab

media:delete

Delete one or more media files, or a single folder. By default the target type is file; pass --type folder to delete a folder instead. Items can be referenced by UUID or name.

so-me media:delete <items...> [options]

Argument	Description
`<items...>`	One or more file/folder IDs or names

Option	Description	Default
`--type <type>`	Target type: `file` or `folder`	`file`
`-y, --yes`	Skip the confirmation prompt	—

When deleting files, a single file is removed directly while multiple files use the bulk-delete endpoint. Only one folder can be deleted at a time.

Examples

# Delete a file by name
so-me media:delete "old-photo.jpg"

# Delete multiple files, skipping confirmation
so-me media:delete file-id-1 file-id-2 -y

# Delete a folder and all its contents
so-me media:delete "Old Assets" --type folder

Deleting a folder removes all files inside it. This cannot be undone.

media:bulk-delete

Delete multiple media files by UUID. Useful when you already have the IDs and want a single bulk operation.

so-me media:bulk-delete <ids...> [options]

Argument	Description
`<ids...>`	One or more file UUIDs

Option	Description
`-y, --yes`	Skip the confirmation prompt

Examples

so-me media:bulk-delete file-id-1 file-id-2 file-id-3
so-me media:bulk-delete file-id-1 file-id-2 -y

media:move

Move a file or folder to a different location. The source is resolved across both files and folders — if a name matches more than one item, you’re prompted to choose.

so-me media:move <id-or-name> --to <folder-id-or-name>

Argument	Description
`<id-or-name>`	File or folder ID or name to move

Option	Description
`--to <folder-id-or-name>`	Destination folder ID, name, or `root` (required)

Examples

# Move a file into a folder
so-me media:move "banner.png" --to "Campaign Assets"

# Move a file back to the root
so-me media:move "banner.png" --to root

# Move a folder into another folder
so-me media:move "Old Folder" --to "Archive"

media:rename

Rename a file or folder. Defaults to renaming a file; pass --type folder to rename a folder.

so-me media:rename <id-or-name> --name <new-name> [options]

Argument	Description
`<id-or-name>`	File or folder ID or name

Option	Description	Default
`--name <new-name>`	New name (required)	—
`--type <type>`	Target type: `file` or `folder`	`file`

Examples

so-me media:rename "banner.png" --name "launch-banner.png"
so-me media:rename "Assets" --name "2026 Assets" --type folder

Folders

media:folders

List all media folders.

so-me media:folders

Example

so-me media:folders --table

media:create-folder

Create a media folder, optionally nested inside an existing parent folder.

so-me media:create-folder --name <name> [options]

Option	Description
`--name <name>`	Folder name (required)
`--parent <id-or-name>`	Parent folder ID or name (creates a nested folder)

Examples

# Create a top-level folder
so-me media:create-folder --name "Campaign Assets"

# Create a nested folder under an existing parent
so-me media:create-folder --name "Q3" --parent "Campaign Assets"

media:rename-folder

Rename a media folder. (Equivalent to media:rename --type folder.)

so-me media:rename-folder <id-or-name> --name <new-name>

Argument	Description
`<id-or-name>`	Folder ID or name

Option	Description
`--name <new-name>`	New name (required)

Example

so-me media:rename-folder "Assets" --name "2026 Assets"

media:move-folder

Move a folder into another parent folder. (Equivalent to running media:move on a folder.)

so-me media:move-folder <id-or-name> --to <parent-id-or-name>

Argument	Description
`<id-or-name>`	Folder ID or name

Option	Description
`--to <parent-id-or-name>`	Target parent folder ID, name, or `root` (required)

Examples

# Nest a folder under another
so-me media:move-folder "Q3" --to "Campaign Assets"

# Move a folder back to the root
so-me media:move-folder "Q3" --to root

Getting Started

Publishing

AI Studio

Inbox & Engagement

Analytics

Biolink

Team & Collaboration

Settings & Billing

Webhooks

Support

Files

media:upload

media:list

media:search

media:get

media:delete

media:bulk-delete

media:move

media:rename

Folders

media:folders

media:create-folder

media:rename-folder

media:move-folder

​Files

​media:upload

​media:list

​media:search

​media:get

​media:delete

​media:bulk-delete

​media:move

​media:rename

​Folders

​media:folders

​media:create-folder

​media:rename-folder

​media:move-folder

Files

media:upload

media:list

media:search

media:get

media:delete

media:bulk-delete

media:move

media:rename

Folders

media:folders

media:create-folder

media:rename-folder

media:move-folder