Files

Purge a stored file

Drops the bytes. Signings that already referenced the token are untouched, because they hold their own copy.

delete/v1/files/{fileToken}

Request

  • Base URL: https://sign-api.tvarka.pro
  • URL: https://sign-api.tvarka.pro/v1/files/{fileToken}
  • Auth: one of:
    • HTTP bearer
    • API key in header X-Api-Key
    • OAuth 2 (authorization code, authorization URL https://sign-api.tvarka.pro/oauth/authorize, token URL https://sign-api.tvarka.pro/oauth/token, scopes: sign.read, sign.signings)

Path parameters

fileTokenstring uuid required

Response

The file, now purged.

fileTokenstring uuid
namestring
mediaTypestring
sha256string
bytesinteger
createdAtstring date-time
expiresAtstring date-time

An unreferenced upload is not kept forever just because nobody deleted it. Re-upload after this, or post the bytes inline.

usedCountinteger

How many signings have copied these bytes.

Changes

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