Skip to main content
POST

Upload User Media

Upload video or image files directly to your user media library. This media can then be referenced in your video projects as custom B-roll using the returned userMediaId.
This endpoint requires authentication and has a rate limit of 500 requests per hour.

Authentication

string
required
Your Submagic API key starting with sk-

Request Body (multipart/form-data)

file
required
Video or image file to upload. Must be in a supported format.

Response

string
Unique identifier for the uploaded media (UUID format). Use this ID to reference the media in your video projects.

Using User Media in Projects

Once you have a userMediaId, you can reference it in the items array when creating or uploading projects:
See the Create Project or Upload Project documentation for more details on using user media in your videos.

Error Responses

object
object
object
object
object
object
object