| Field | Type | Required | Description |
|---|---|---|---|
projectReference | String | No | |
projectId | ID | No | Deprecated: Use projectReference. |
entityId | ID! | Yes | |
entityType | DraftEntityType! | Yes | |
branchId | ID | No | |
body | String! | Yes | |
branchReference | String | No | Branch name or UUID; equivalent branchId aliases are accepted, conflicting ones rejected. Omit/null for main. |
expectedDraftVersion | Int | No | Expected current draft sequence (0 means no prior draft), not a committed-file version ID. Omit/null for unconditional replacement; stale values are concurrency errors409. |