List Templates
Video Templates
List Templates
Retrieve a list of all video templates associated with your account
GET
List Templates
Documentation Index
Fetch the complete documentation index at: https://docs.pictory.ai/llms.txt
Use this file to discover all available pages before exploring further.
Overview
Retrieve a list of all video templates created and associated with your account. Templates are reusable video project configurations that can be used to quickly create new videos with consistent branding, structure, and variable placeholders.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
Headers
API key for authentication (starts with
pictai_)Response
Array of template objects
Response Examples
Code Examples
Usage Notes
Published Status: Only templates with
published: true are available for creating new videos. Draft or unpublished templates will have published: false.Deprecated Templates: Templates marked with
deprecated: true should not be used for new projects, though they may still be accessible for backward compatibility.Common Use Cases
1. List All Available Templates
Retrieve and display all templates:2. Filter Published Templates
Get only published, non-deprecated templates:3. Group Templates by Language
Organize templates by language:4. Find Template by Name
Search for a specific template by name:5. Export Template List
Export template list to a file:6. Template Status Summary
Generate a summary report of template statuses:Best Practices
Template Selection
- Filter Active Templates: Always filter for
published: trueanddeprecated: falsewhen presenting templates to users - Cache Template Lists: Cache the template list to reduce API calls, refreshing periodically or when needed
- Handle Language: Filter templates by language when building multilingual applications
- Sort by Name: Sort templates alphabetically for better user experience
Performance Tips
- Cache template list responses for 5-10 minutes to reduce API calls
- Only fetch template list when needed (e.g., on page load or user action)
- Use client-side filtering and sorting after fetching the list once
- Monitor for deprecated templates and notify users to update their workflows
