Sign in
Assets

Upload a new asset

Changed on

Upload a binary file as a new asset. The uploaded asset can then be attached to a bookmark via the POST /bookmarks/{bookmarkId}/assets endpoint.

post/assets

Request

  • Base URL: https://try.karakeep.app/api/v1
  • URL: https://try.karakeep.app/api/v1/assets
  • Auth: HTTP bearer

Response

The asset was uploaded successfully. Returns metadata about the uploaded asset.

assetIdstring required

The unique identifier assigned to the uploaded asset.

contentTypestring required

The MIME type of the uploaded file.

sizenumber required

The size of the uploaded file in bytes.

fileNamestring required

The original file name of the uploaded file.

Changes

  • 69b85ed2cdbfRevision changes
    • info

      the request property type was generalized from no type to string, and format from no format to binary

  • 6210da080616Revision changes
    • info

      api operation id uploadAsset was added

    • info

      added the non-success response with the status