Update file

updateFile(input: UpdateFileInput!): UpdateFilePayload!

Requires project.files.write.

Arguments

Argument	Type	Required
`input`	`UpdateFileInput!`	Yes

Field	Type	Required	Description
`filePath`	`String!`	Yes
`content`	`String!`	Yes	Replacement textual content in main or the selected branch, stored as a new immutable version. Source-file MIME type is not writable.
`expectedChecksum`	`String`	No	Expected current content checksum. Null or omission disables this guard.
`expectedVersionId`	`String`	No	Expected current version ID. Null or omission disables this guard.
`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.

Returns UpdateFilePayload!. Open the type for its fields and nested types.

Field	Type	Description
`path`	`String!`
`success`	`Boolean!`
`error`	`String`
`id`	`String`	File ID; null when the mutation failed.
`versionId`	`String`	Version ID the write produced; null when the mutation failed.
`type`	`String`	File kind: page, function, component or file; null when the mutation failed.
`content`	`String`	Content of the file after the mutation; null when the mutation failed.
`sizeBytes`	`Int`	Size of the content encoded as UTF-8, in bytes; null when the mutation failed.

All fields of UpdateFilePayload. Types marked with ! cannot be null. Lists use [Type] notation. The type index lists all published input and response types.

mutation UpdateFile($input: UpdateFileInput!) {
  updateFile(input: $input) {
    id
    updatedAt
    checksum
    content
    error
  }
}

{
  "input": {
    "filePath": "example",
    "content": "example"
  }
}