Skip to content
API Reference/
/
Upload asset

Upload asset

Request

Upload multipart files (HTTP 201), or supply application/json with 1–20 public asset URLs. URL uploads return uploaded and failed arrays: 201 all succeeded, 207 partial success, 422 all invalid/unprocessable, 502 all failed with a download failure. Private/local URLs and unsafe redirects are rejected. Media conversion may continue asynchronously.

Security
ShuffllApiKey
Path
organizationIdstringrequired

Unique identifier for the organization

Example:693fb82afd8d1c43077ba0fb
workspaceIdstringrequired

Unique identifier for the workspace

Example:693fb82afd8d1c43077ba0fe
Query
folderstring

Target folder path for the uploaded file (defaults to /)

Example:folder=/
Body
required
filestring, (binary)

The file to upload. Supported types — images (JPEG, PNG, GIF, WebP, SVG), videos (MP4, MOV, WebM), audio (MP3, WAV, OGG), and PDFs.

curl -i -X POST \
  'https://api-docs.shuffll.com/_mock/apis/auth/organization/693fb82afd8d1c43077ba0fb/workspace/693fb82afd8d1c43077ba0fe/assets?folder=%2F' \
  -H 'Content-Type: multipart/form-data' \
  -H 'x-api-key: YOUR_API_KEY_HERE' \
  -F file=string

Responses

Files uploaded

Bodyapplication/json
uploadedArray of objects(Asset)

Array of successfully uploaded assets

failedArray of objects
Response
{
  "uploaded": [
    { … }
  ]
}