API referenceProjects

Get render status

Poll the latest render job for a project: phase, per-scene progress, stitch progress, and the final MP4 URL (render_url / job.output_url) once completed.

GET
/projects/{id}/render

Authorization

bearerAuth
AuthorizationBearer <token>

Typecut API key. Generate one in app.typecut.ai → Settings → API keys. Send as Authorization: Bearer tc_live_….

In: header

Path Parameters

id*string
Formatuuid

Response Body

application/json

application/json

curl -X GET "https://example.com/projects/497f6eca-6276-4993-bfeb-53cbbbba6f08/render"
{
  "data": {
    "project_id": "405d8375-3514-403b-8c43-83ae74cfe0e9",
    "project_status": "string",
    "render_url": "string",
    "editor_url": "http://example.com",
    "job": {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "status": "pending",
      "total_scenes": 0,
      "rendered_scenes": 0,
      "cached_scenes": 0,
      "failed_scenes": 0,
      "stitch_progress": 0,
      "output_url": "string",
      "output_duration": 0,
      "error_message": "string",
      "started_at": "string",
      "completed_at": "string",
      "created_at": "string"
    }
  }
}
{
  "error": {
    "type": "string",
    "code": "string",
    "message": "string"
  }
}