# Assets

Upload, organize, rename, move, and delete media assets in a workspace. Assets can be referenced directly in project creation requests.

## List assets

 - [GET /auth/workspace/{workspaceId}/assets](https://api-docs.shuffll.com/apis/assets/listassets.md): Retrieve all assets in a workspace.

Use the type query parameter to filter by asset type (e.g., image, video, audio).
Use the folder query parameter to list assets within a specific folder path.

The uploadPath field on each asset is the CDN URL you can use directly in videosToAdd[].url when creating a project.

## Upload asset

 - [POST /auth/workspace/{workspaceId}/assets](https://api-docs.shuffll.com/apis/assets/uploadasset.md): Upload one or more files to a workspace as assets.

Files are uploaded as multipart/form-data. Each uploaded file becomes an asset in the workspace.

For video files, a DASH streaming version is automatically generated.

The returned uploadPath on each asset is the CDN URL that can be used directly in videosToAdd[].url when creating a project.

## Delete assets

 - [DELETE /auth/workspace/{workspaceId}/assets](https://api-docs.shuffll.com/apis/assets/deleteassets.md): Delete one or more assets from a workspace by their IDs.

This action is permanent and cannot be undone.

## Create folder

 - [POST /auth/workspace/{workspaceId}/assets/folder](https://api-docs.shuffll.com/apis/assets/createassetfolder.md): Create a new folder in the workspace asset library.

Folders are used to organize assets. The folder name must be unique within the workspace.

## Move assets

 - [PUT /auth/workspace/{workspaceId}/assets/move](https://api-docs.shuffll.com/apis/assets/moveassets.md): Move one or more assets to a different folder.

The target folder must exist. Use POST /auth/workspace/{workspaceId}/assets/folder to create a folder first if needed.

## Rename asset

 - [PUT /auth/workspace/{workspaceId}/assets/{assetId}/file](https://api-docs.shuffll.com/apis/assets/renameasset.md): Rename an existing asset by updating its display name.