Skip to main content
Create a new change, optionally applying initial file operations atomically. File content must be base64-encoded. Required scope: write

Options

string
required
Repository name.
string
required
Change to create the new change on top of. Use Mesa’s virtual root change ID for the first change in an empty repository.
string | undefined
Organization override.
string | undefined
Change description. Required when files is non-empty. When files is omitted, omit message to create the change with no description, or pass "" explicitly.
[{ name: string; email?: string }, ...]
Commit authors, in order, with at least one entry. Private-key clients set this.
object | undefined
A backward-compatible single author for a private-key client. Prefer authors, and do not pass both. Access-token clients cannot override the authors encoded in their token.
object | undefined
Committer identity. When omitted, the first author is used.
array | undefined
File operations to apply atomically. Upserts use { path, content, encoding?, action?, mode? }; deletes use { path, action: 'delete' }.

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.