Repositories

Commit a changeset

Builds one commit on the server from parents and path edits (write, delete, mode, rename; each with an optional expected-old object or absence) and moves a branch from its exact expected tip, under current push policy. No clone or pack is needed: cost scales with the change. 202 is a durable push receipt; a retry with the same requestKey and input rejoins it. A changed pinned path fails the job with a path conflict; a moved branch fails it with a conflict. Requires authenticated authority and enforces current resource policy.

post/api/repos/{owner}/{repo}/changesets/

Request

  • Base URL
    https://git.cafe
  • Auth
    • API key in cookie gc-session
    • or HTTP bearer
    • or HTTP basic
    • or HTTP token
    • or OAuth 2
      Authorization code: /api/oauth/authorize
      Token URL: /api/oauth/token scopes: repo:contents:write

Path parameters

ownerstring required
repostring required

Request body

requestKeystring uuid required
refstring required
expectedOidstring nullable required
parentsstring[]
baseTreestring
messagestring required
allowEmptyboolean

Response

Response for status 202

idstring required
repoIdstring required
actorIdstring required
state'admitted' | 'receiving' | 'unknown' | 'succeeded' | 'failed' | 'cancelled' | 'superseded' required
versioninteger required
effectPermittedboolean required
cancellationRequestedboolean required
accountedboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.