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

Options

str
required
Repository name.
str
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.
str | None
Organization override.
str | None
Change description. Required when files is non-empty. When files is omitted, pass None to omit the field and create the change with no description, or pass "" explicitly.
list[SigningKeyAuthor] | None
Commit authors, in order, with at least one entry. Private-key clients set this.
Author | None
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.
Author | None
Committer identity. When omitted, the first author is used.
list[FileChange] | None
File operations to apply atomically. Entries are FileUpsert or FileDelete.

Response

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

CommitIdentity

str
Author or committer display name.
str
Author or committer email address.
datetime | None
Timestamp for this identity when provided.