Delete template

DELETE https://api.json2video.com/v2/templates

Removes a template owned by the authenticated account. Both the database row and the S3-backed movie payload are deleted. Templates in use by running jobs are not protected — those jobs continue to use their already-resolved movie body.

Request

Headers

Header	Required	Value
`x-api-key`	yes	API key issued from the dashboard. Requires role `editor`, `manager`, or `admin`.

Query parameters

Parameter	Type	Description
`id`	string	Required. The template ID to delete.

Body

None.

Response

200 OK

{
    "success": true,
    "timestamp": "2026-05-12T10:49:52.924Z"
}

Errors

Status	Message	Cause
`400`	`No template ID provided`	Missing `id` query parameter.
`403`	`Insufficient permissions`	API key role is below `editor`.
`500`	`Error deleting template`	Server error. Retry with exponential backoff.

Examples

Delete a template

curl --location --request DELETE \
  'https://api.json2video.com/v2/templates?id=abc123def456ghi789jk' \
  --header 'x-api-key: YOUR_API_KEY'

Delete template#

Request#

Headers#

Query parameters#

Body#

Response#

200 OK#

Errors#

Examples#

Delete a template#