Templates

Update a template

PATCH /api/v1/templates/{template_id}

Update an existing template. Include `folder_mappings` to replace its folder mappings entirely.

Authentication

Send your API key in the Authorization header: Authorization: Bearer <key>. Create a key.

Path parameters

Name	Type	Description
`template_id` required	integer	ID of the template to update.

Body parameters

Name	Type	Description
`name`	string
`prompt`	string
`output_type`	string	Output type: video (default) or image.
`model`	string	Video models: gen4.5, gen4_turbo, veo3, veo3.1, veo3.1_fast, seedance2, seedance2_fast, seedance2_mini, happyhorse_1_0, gemini_omni_flash. Image models: gen4_image, gen4_image_turbo, gemini_2.5_flash. gen4_turbo requires an input image for video.
`ratio`	string	Aspect ratio, e.g. 1280:720 or 1920:1080.
`duration`	integer	Duration in seconds for video (model-dependent).
`include_audio`	boolean	Include audio (Veo 3.1 and Seedance video models only).
`output_count`	integer	Number of images to generate (1 or 4; image templates only).
`reference_tag`	string	Reference tag for image templates using folder watch (use @tag in prompt).
`folder_mappings`	array

import os import requests url = "https://videitos.click/api/v1/templates/42" headers = {"Authorization": f"Bearer {os.environ['VIDEITOS_API_KEY']}"} payload = { "prompt": "New prompt", "duration": 8, } resp = requests.patch(url, headers=headers, json=payload) print(resp.json())

package main import ( "bytes" "fmt" "io" "net/http" "os" ) func main() { payload := bytes.NewBufferString(`{"prompt": "New prompt", "duration": 8}`) req, _ := http.NewRequest("PATCH", "https://videitos.click/api/v1/templates/42", payload) req.Header.Set("Authorization", "Bearer "+os.Getenv("VIDEITOS_API_KEY")) req.Header.Set("Content-Type", "application/json") resp, _ := http.DefaultClient.Do(req) defer resp.Body.Close() out, _ := io.ReadAll(resp.Body) fmt.Println(string(out)) }

<?php $ch = curl_init("https://videitos.click/api/v1/templates/42"); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "PATCH"); curl_setopt($ch, CURLOPT_HTTPHEADER, [ "Authorization: Bearer " . getenv("VIDEITOS_API_KEY"), "Content-Type: application/json", ]); curl_setopt($ch, CURLOPT_POSTFIELDS, '{"prompt": "New prompt", "duration": 8}'); $response = curl_exec($ch); echo $response;

{ "template": { "id": 42, "name": "Product loops", "model": "gen4.5", "prompt": "Slow cinematic dolly around the product on a white pedestal", "ratio": "1280:720", "duration_seconds": 4, "include_audio": false, "is_enabled": true, "folders": [ { "source_folder": "/incoming", "source_connection_id": 7, "destination_folder": "/processed", "destination_connection_id": 7, "provider": "dropbox" } ], "default_destination_folder": "/processed" }, "message": "Template 'Product loops' updated." }