PUT
/
v1
/
projects
/
{id}
curl -X PUT "https://api.submagic.co/v1/projects/550e8400-e29b-41d4-a716-446655440000" \
  -H "x-api-key: sk-your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "startTime": 10.5,
        "endTime": 15.2,
        "userMediaId": "123e4567-e89b-12d3-a456-426614174000"
      },
      {
        "startTime": 25.0,
        "endTime": 30.8,
        "userMediaId": "987fcdeb-51a2-43d7-b123-556644330099"
      }
    ]
  }'

{
  "message": "Project updated successfully",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "processing"
}

​
Update Project

Update an existing video project by adding user media (B-roll) at specific time intervals. This endpoint allows you to enhance your video with custom media content from your library.
This endpoint requires authentication and has a rate limit of 100 requests per hour. After modifying a video, you’ll need to re-export to see the changes using the export endpoint.

​
Authentication

​
x-api-key
string
required
Your Submagic API key starting with sk-

​
Path Parameters

​
id
string
required
The unique identifier (UUID) of the project to update

​
Request Body

​
items
array
required
Array of user media items to insert into the video

​
Finding User Media ID

To find your userMediaId:
  1. Go to the Submagic editor
  2. Navigate to the ‘B-roll’ tab
  3. Add a B-roll to access your media library
  4. Go to the ‘My videos’ tab
  5. Each video will display its unique media ID that you can use with this API
Example.png

​
Response

​
message
string
Success message confirming the project update
​
id
string
The unique identifier of the updated project
​
status
string
Updated processing status of the project

​
Error Responses

​
error
string
Error code: NOT_FOUND or VALIDATION_ERROR
​
message
string
Detailed error message explaining what went wrong
curl -X PUT "https://api.submagic.co/v1/projects/550e8400-e29b-41d4-a716-446655440000" \
  -H "x-api-key: sk-your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "startTime": 10.5,
        "endTime": 15.2,
        "userMediaId": "123e4567-e89b-12d3-a456-426614174000"
      },
      {
        "startTime": 25.0,
        "endTime": 30.8,
        "userMediaId": "987fcdeb-51a2-43d7-b123-556644330099"
      }
    ]
  }'

{
  "message": "Project updated successfully",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "processing"
}
Important: After updating a project with user media, you must re-export the project to see the changes in the final video. Use the export endpoint to generate the updated video with your B-roll insertions.