Kvasir Documentation main Help

Storage

Each Kvasir pod exposes an Amazon S3 compatible storage API at the base path /{podId}/s3. This API can be used to store and retrieve files in the pod's storage. Kvasir can be configured to automatically ingest files uploaded to the S3 API into the Knowledge Graph. At the time of writing, this feature is restricted to files of limited size in JSON-LD or Turtle format.

Uploading a file

The following example uploads a text-file to the S3 API of the pod of Alice:

PUT http://localhost:8080/alice/s3/test.txt

Request headers may include a sha256 hash of the file content for verification:

X-Amz-Content-Sha256: beaead3198f7da1e70d03ab969765e0821b24fc913697e929e726aeaebf0eba3

Request body:

Hello World!

This should return a 200 OK response.

Downloading a file

The following example retrieves the file from the S3 API of the pod of Alice:

GET http://localhost:8080/alice/s3/test.txt

Response body:

Hello World!
Last modified: 02 January 2025