| Field | Type | Required | Description |
|---|---|---|---|
projectReference | String | No | Project ID or slug. Requires project.files.write. |
projectId | ID | No | Deprecated: Use projectReference. |
fileReferences | [String!] | No | File paths or UUIDs. Omit/null commits all pending changes; [] commits none. |
branchReference | String | No | Branch name or UUID. Omit/null selects main. |
expectedVersionId | ID | No | Expected persisted version UUID; requires exactly one selected file. |
expectedVersions | JSON | No | Map from file paths or UUIDs to expected persisted version UUIDs. |