Update Template
Video Templates
Update Template
Update the scene configuration of an existing video template
PUT
Update Template
Overview
Update the scene structure and content of an existing video template. This endpoint allows you to modify the template’s scene array, which defines the video’s structure, content, and visual elements.You need a valid API key to use this endpoint. Get your API key from the API Access page in your Pictory dashboard.
API Endpoint
Request Parameters
Path Parameters
The unique identifier of the template to updateExample:
202512230204424435786014d42904bbc95813430789fe736Headers
API key for authentication (starts with
pictai_)Body Parameters
Array of scene objects that define the template structure. Each scene represents a segment in the video template with its own content, visuals, and timing.
Response
Indicates whether the update was successful
Confirmation message about the update
The ID of the updated template
Response Examples
Code Examples
Usage Notes
Scene Structure: The scenes array should match the structure used in Pictory projects. Refer to the Update Project endpoint documentation for scene object examples.
Common Use Cases
1. Update Template Text Content
Modify the text content across all scenes in a template:2. Add New Scene to Template
Add additional scenes to an existing template:3. Batch Update Multiple Templates
Update multiple templates with similar modifications:4. Update Template with Validation
Validate scene structure before updating:5. Rollback Template Changes
Implement a rollback mechanism for template updates:Best Practices
Safety Guidelines
- Backup First: Always backup the current template configuration before making updates
- Validate Structure: Validate scene structure before sending updates to prevent errors
- Test Changes: Test template updates in a development environment first
- Version Control: Maintain version history of template configurations
- Gradual Rollout: When updating production templates, do so gradually and monitor results
Common Pitfalls
- ❌ No Backup: Updating without backing up the current configuration
- ❌ Invalid Structure: Sending incorrectly structured scene objects
- ❌ Missing Fields: Omitting required fields in scene objects
- ❌ Production Testing: Testing changes directly on production templates
Performance Tips
- Batch similar updates to reduce API calls
- Cache template configurations locally to avoid repeated fetches
- Use validation before updates to prevent failed requests
- Implement retry logic for transient failures
Related Endpoints
- Get Templates - Retrieve all available templates
- Create Template - Create a new template
- Update Project - Update project scenes (similar structure)
