Attachments

Reserve an attachment upload

Creates an idempotent upload reservation for the declared SHA-256 digest and byte count, capped at 10 MiB. Requires authenticated authority and enforces current resource policy.

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

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:attachments:write

Path parameters

ownerstring required
repostring required

Request body

requestKeystring required
sha256string required
sizeinteger required

Response

Response for status 201

idstring required
state'reserved' | 'writing' | 'ready' | 'deleting' | 'deleted' | 'rejected' required
sizeinteger required
contentType'image/png' | 'image/jpeg' | 'image/gif' | 'image/webp' | 'null' nullable required

Changes

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