filePath | String! | Yes | 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. |
expectedVersionId | String | No | Optional optimistic-concurrency guard: the delete is rejected before any mutation when the file’s current version no longer matches. |
ref | String | No | Canonical content selector: main, branch:<name-or-id>, release:<version> or env:<name>. An unresolvable reference is rejected; it never falls back to main. A release or environment is read-only, so a write addressed to one is refused rather than applied elsewhere. |
branchId | String | No | Legacy alias for ref=branch:<value>. Supplying both is accepted when they name the same content and rejected when they do not. |