# List assets

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.

Endpoint: GET /auth/workspace/{workspaceId}/assets
Version: 1.2.0
Security: ShuffllApiKey

## Path parameters:

  - `workspaceId` (string, required)
    Unique identifier for the workspace
    Example: "693fb82afd8d1c43077ba0fe"

## Query parameters:

  - `type` (string)
    Filter assets by type prefix (e.g., image, video, audio)
    Enum: "image", "video", "audio", "pdf"

  - `folder` (string)
    Filter assets by folder path (e.g., /my-folder)
    Example: "/"

## Response 200 fields (application/json):

  - `_id` (string)
    Unique asset identifier
    Example: "6947b539cc95ea68854bb523"

  - `displayName` (string)
    Display name of the asset
    Example: "product-demo.mp4"

  - `uploadPath` (string)
    CDN URL of the asset file. Use this value as videosToAdd[].url when creating a project.
    Example: "https://content.shuffll.com/workspace/product-demo.mp4"

  - `dashPath` (string)
    MPEG-DASH streaming URL (available for video assets after processing)
    Example: "https://content.shuffll.com/workspace/product-demo.mpd"

  - `mimetype` (string)
    MIME type of the file
    Example: "video/mp4"

  - `type` (string)
    Asset category, automatically determined from MIME type
    Enum: "image", "video", "audio", "pdf", "folder"

  - `folder` (string)
    Folder path the asset belongs to
    Example: "/"

  - `userEmail` (string)
    Email of the user who uploaded the asset
    Example: "user@example.com"

  - `createdAt` (string)
    Upload timestamp
    Example: "2025-12-15T07:26:34.333Z"

  - `aspectRatio` (string)
    Aspect ratio of the asset (for images and videos)
    Example: "16:9"

  - `analytics` (object)
    AI-generated analysis of the asset content

  - `analytics.description` (string)
    AI-generated description of the asset

  - `analytics.videoPrompt` (string)
    Suggested video prompt based on asset content

  - `analytics.directions` (string)
    Suggested usage directions

  - `analytics.textHeaderPosition` (number)
    Suggested text overlay position

## Response 401 fields (application/problem+json):

  - `type` (string)
    Example: "object"

  - `title` (string)
    Example: "Validation failed"

  - `message` (string)
    Example: "Bad Request"

## Response 404 fields (application/problem+json):

  - `type` (string)
    Example: "object"

  - `title` (string)
    Example: "Validation failed"

  - `message` (string)
    Example: "Bad Request"