Repositories

Retire a repository

Records repository retirement and returns its durable status. repoId and expectedVersion fence stale requests; 202 does not mean native data is already absent. Requires authenticated authority and enforces current resource policy.

delete/api/repos/{owner}/{repo}/

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:administration:admin

Path parameters

ownerstring required
repostring required

Request body

repoIdstring required
expectedVersioninteger required

Response

Response for status 202

repoIdstring required
state'retained' | 'absent' required
reason'owner-delete' | 'collaborator-revoked' | 'org-member-revoked' | 'org-member-role-changed' | 'team-member-revoked' required
failureCode'native-retirement-unavailable' | 'null' nullable required
createdAtstring date-time required
completedAtstring date-time nullable required

Changes

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