API Reference
Upload User Media
Upload video or image files directly to your media library for use in projects
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 returneduserMediaId.
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 auserMediaId, you can reference it in the items array when creating or uploading projects:
Error Responses
object
object
object
object
object
object
object

