curl --request GET \
--url https://www.genviral.io/api/partner/v1/editor/projects/b1d4e8f2-3a5c-4d7e-8f90-1a2b3c4d5e6f/render \
--header 'Authorization: Bearer <token>'
{
"ok": true,
"code": 200,
"message": "Editor render status retrieved",
"data": {
"project_id": "b1d4e8f2-3a5c-4d7e-8f90-1a2b3c4d5e6f",
"status": "completed",
"progress": 1,
"output_url": "https://example.com/renders/launch-cut.mp4",
"error": null,
"is_current": true
}
}
Video Editor
Get Editor Render
Status of the latest render of a project.
GET
/
api
/
partner
/
v1
/
editor
/
projects
/
{projectId}
/
render
curl --request GET \
--url https://www.genviral.io/api/partner/v1/editor/projects/b1d4e8f2-3a5c-4d7e-8f90-1a2b3c4d5e6f/render \
--header 'Authorization: Bearer <token>'
{
"ok": true,
"code": 200,
"message": "Editor render status retrieved",
"data": {
"project_id": "b1d4e8f2-3a5c-4d7e-8f90-1a2b3c4d5e6f",
"status": "completed",
"progress": 1,
"output_url": "https://example.com/renders/launch-cut.mp4",
"error": null,
"is_current": true
}
}
Returns the status of the latest render of the project’s active version. Poll it every few
seconds after Render Editor Project until
status is
completed or failed.
Path Parameters
string (UUID)
required
The project id.
Response
string
string
rendering, completed, or failed.number
From
0 to 1.string | null
The MP4 URL once
status is completed.string | null
A short reason when
status is failed. Credits for a failed
render are refunded.boolean
false when the cut was edited after this render started. Render again to get the new cut.curl --request GET \
--url https://www.genviral.io/api/partner/v1/editor/projects/b1d4e8f2-3a5c-4d7e-8f90-1a2b3c4d5e6f/render \
--header 'Authorization: Bearer <token>'
{
"ok": true,
"code": 200,
"message": "Editor render status retrieved",
"data": {
"project_id": "b1d4e8f2-3a5c-4d7e-8f90-1a2b3c4d5e6f",
"status": "completed",
"progress": 1,
"output_url": "https://example.com/renders/launch-cut.mp4",
"error": null,
"is_current": true
}
}
Error Responses
401- authentication failed (missing/invalid/revoked token)404 project_not_found- the project does not exist in the key scope404 render_not_found- the project has not been rendered yet422 invalid_payload-projectIdis not a valid UUID
