Skip to content
Edit SquareDocs
Open with AI

Create a new render

POST
/v1/renders
curl --request POST \
  --url https://proficient-seahorse-829.eu-west-1.convex.site/v1/renders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "name": "example", "project_id": "example", "template_id": "example", "values": { "additionalProperty": "example" } }'

Queues a render of a project. Pass template_id and values to render the project with a form submission applied; omit both to render it as it stands.

Authorizations

Section titled “Authorizations”

Request Body

Section titled “Request Body”
Media typeapplication/json
object
name
required
string
>= 1 characters <= 250 characters
project_id
required
string
>= 1 characters
template_id
string
values
object
key
additional properties
Examplegenerated
{
  "name": "example",
  "project_id": "example",
  "template_id": "example",
  "values": {
    "additionalProperty": "example"
  }
}

Responses

Section titled “ Responses ”

201

Section titled “201”

Render created successfully

Media typeapplication/json
object
id
required
string
name
required
string
status
required
string
Allowed values: initializing ready queued processing finalizing complete failed
type
required
string
Allowed values: local cloud
project
required
object
id
required
string
team
required
string
output

Signed URLs for the finished video, keyed by variant (the master plus any smaller encodes). Present once the render is complete. The URLs are time-limited.

object
key
additional properties
string
created_by
required
string | null
created_at
required
number
updated_at
required
number | null
Example
{
  "id": "rend_jh716ctpaqbye9aw64tgkqwtks7gvx7g",
  "name": "My New Shiny Render",
  "status": "initializing",
  "type": "local",
  "project": {
    "id": "proj_jd71dcg41pjy7rax1v2h4pvcmd7gtar9",
    "team": "team_jn7fw41m8n5jtht7hxsy69tzg97gvef8"
  },
  "output": {
    "master": "https://files.editsquare.com/renders/rend_jh716ctpaqbye9aw64tgkqwtks7gvx7g/master.mp4?signature=..."
  },
  "created_by": "user_k970b359khfwwny0q8fjah1hc97gtcwm",
  "created_at": 1748875980,
  "updated_at": 1748875986
}

400

Section titled “400”

Invalid request data

Media typeapplication/json
object
error
required
string
Example
{
  "error": "Render not found"
}