| Field | Type | Required | Description |
|---|---|---|---|
filePath | String! | Yes | |
content | String! | Yes | |
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. |