Repositories

Request Git maintenance

Queues bounded native Git maintenance. requestKey makes retries idempotent and expectedVersion fences configuration changes; 202 is a job receipt, not completion. Requires authenticated authority and enforces current resource policy.

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

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
strategy'accelerators' | 'geometric' required
maxRewriteBytesinteger required
geometricFactorinteger
expectedVersioninteger required

Response

Response for status 202

idstring required
repoIdstring required
versioninteger required
state'queued' | 'running' | 'blocked' | 'succeeded' | 'failed' | 'cancelled' required
effectPermittedboolean required
cancellationRequestedboolean required
reason'authority_changed' | 'native_unavailable' | 'native_pending' | 'invalid_evidence' | 'configuration_changed' | 'null' nullable required

Changes

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