Skip to main content
DELETE
Delete file

Authorizations

Authorization
string
header
required

Use a JWT bearer token or a Veryfront API key in the Authorization header.

Path Parameters

project_reference
string
required

Project slug, UUID, or domain

file_path
string
required

File path whose deletion appends a deletion version in main or the selected branch; immutable history remains. URL-encode this path when supplied in a REST URL.

Query Parameters

ref
string

Mutable content to address: main or branch:. Omit for main. Release and environment selectors return 400. Supplied aliases must name the same content.

Example:

"branch:feature-x"

branch
string

Branch name or ID; legacy alias for ref=branch:. Supplied aliases must agree.

branch_id
string<uuid>

Branch UUID; legacy alias for ref=branch:. Supplied aliases must agree.

expected_version_id
string<uuid>

Expected current version ID. Omit for an unguarded deletion; a stale version returns 409.

Response

File deleted.

ok
enum<boolean>
required
Available options:
true