Skip to main content
GET
List Templates

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

string
required
API key for authentication (starts with pictai_)

Response

array of objects
Array of template objects

Response Examples


Code Examples

Replace YOUR_API_KEY with your actual API key that starts with pictai_

Usage Notes

Templates are returned in the order they were created. Use the templateId to reference specific templates when creating new projects.
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

  1. Filter Active Templates: Always filter for published: true and deprecated: false when presenting templates to users
  2. Cache Template Lists: Cache the template list to reduce API calls, refreshing periodically or when needed
  3. Handle Language: Filter templates by language when building multilingual applications
  4. 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