Git mirrors

Reconfigure a Git mirror

Replaces mirror configuration when expectedVersion matches and queues a sync. Reusing requestId with the same input returns the prior receipt; 202 does not mean the sync completed. Requires authenticated authority and enforces current resource policy.

put/api/repos/{owner}/{repo}/mirrors/{mirror}

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:metadata:write, repo:contents:write

Path parameters

ownerstring required
repostring required
mirrorstring required

Request body

requestIdstring uuid required
expectedVersioninteger required
urlstring required
localRefstring required
remoteRefstring required
direction'push' | 'pull' | 'bidirectional' required
conflictWinner'gitcafe' | 'remote'
intervalMinutesinteger
maxPackBytesinteger

Response

Response for status 202

jobIdstring nullable required

Changes

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