Skip to main content
Patch a change. You can update metadata, apply file operations, use a base commit guard, or apply conflict resolutions. Required scope: write
Resolve conflicts:
A patch that applies conflict resolutions keeps the existing commit authors, so it accepts neither author nor authors.

Options

string
required
Repository name.
string
required
Change ID to patch.
string | undefined
Organization override.
string | undefined
Replacement change description. Omit to preserve the existing description; pass "" to clear it.
[{ name: string; email?: string }, ...]
Commit authors, in order, with at least one entry. Private-key clients set this, but omit it when you apply resolutions.
object | undefined
A backward-compatible single author for a private-key client. Prefer authors, and do not combine it with authors or resolutions. Access-token clients cannot override the authors encoded in their token.
object | undefined
Replacement committer identity.
array | undefined
Non-empty file operations to apply. Cannot be combined with resolutions.
string | undefined
Optional optimistic concurrency guard. The patch fails if the change no longer points at this commit.
array | undefined
Conflict resolutions to apply, at least one. Cannot be combined with files.

Response

string
Change ID.
string
Current commit OID for the change.
boolean
Whether the current commit still contains unresolved conflicts.
string
Current change description. Empty string means the change has no description.
CommitIdentity
Commit author identity.
CommitIdentity
Committer identity.
string[]
Parent change IDs for this change.
string
Creation time.
string
Last update time.

CommitIdentity

string
Author or committer display name.
string
Author or committer email address.
string | undefined
Timestamp for this identity when provided.