Delete movie

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

Deletes the rendered video file right away, instead of waiting for the automatic 7-day expiry. Use it to release storage as soon as you have downloaded or forwarded the video.

The movie entry itself is kept: its status, timings and consumed credits stay in your render history, so your usage record is not rewritten. Only the video file is removed — url becomes null and a deleted_at timestamp is added. Both are visible through GET /v2/movies.

The operation is idempotent: deleting the same movie twice, or deleting one whose file already expired, returns success.

Request

Headers

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

Query parameters

Parameter	Type	Description
`project`	string	Required. The 16-character project ID returned by `POST /v2/movies`.
`id`	string	Alias for `project`.

Body

None.

Response

200 OK

{
    "success": true,
    "project": "AbCdEfGhIjKlMnOp",
    "deleted_at": "2026-07-27T16:04:11.312Z",
    "timestamp": "2026-07-27T16:04:11.480Z"
}

Errors

Every failure comes back as HTTP 400 with success: false and a message describing the cause.

Message	Cause
`Error: API Key not provided`	Missing `x-api-key` header.
`A 16-character project ID must be provided in the 'project' query parameter`	Missing or malformed `project`.
`Insufficient permissions`	API key role is below `render`.
`Movie {project} not found`	No such movie on this account. Movies belonging to another account also report as not found.
`Movie {project} is still rendering. Wait until it finishes before deleting it.`	The render is `pending` or `running`. Deleting cannot cancel a render — poll until it reaches `done`, `error` or `timeout`, then delete.
`Error deleting the movie files. Please try again.`	Storage error. Nothing was marked as deleted; retrying is safe.

Examples

Delete a rendered movie

curl --location --request DELETE \
  'https://api.json2video.com/v2/movies?project=AbCdEfGhIjKlMnOp' \
  --header 'x-api-key: YOUR_API_KEY'

Render, download, then delete

# 1. Poll until the render is finished
curl -s 'https://api.json2video.com/v2/movies?project=AbCdEfGhIjKlMnOp' \
  --header 'x-api-key: YOUR_API_KEY'

# 2. Download the video from movie.url
curl -o movie.mp4 'https://json2video-cdn1.s3.amazonaws.com/clients/.../movie.mp4'

# 3. Release the storage immediately
curl --location --request DELETE \
  'https://api.json2video.com/v2/movies?project=AbCdEfGhIjKlMnOp' \
  --header 'x-api-key: YOUR_API_KEY'

Delete movie#

Request#

Headers#

Query parameters#

Body#

Response#

200 OK#

Errors#

Examples#

Delete a rendered movie#

Render, download, then delete#