API Reference for Document Store Service (1.0)

Download OpenAPI specification:Download

Many blockchain use cases require the pinning of on-chain transactions to securely stored documents that cannot be held on-chain, either because they are too large or the information is too sensitive to put into your immutable shared ledger. Kaleido’s Document Store was created for these use cases, providing a private store solely for your individual use. We provide the mechanism to generate hashes that uniquely tie an on-chain asset, token, or transaction to off-chain data.

documentstore

Configuration

Retrieves the document store service configuration

Retrieves the document store service configuration.

Responses

Response samples

Content type
application/json
{
  • "provider": "internal",
  • "region": "string",
  • "bucket_or_container": "string"
}

Documents

When the path matches a folder, it retrieves the (

When the path matches a folder, it retrieves the (paginated) list of documents and subfolders contained within it. When the path matches a document, it returns either its content or, if query parameter details_only is true, its metadata. Use empty string for root folder.

path Parameters
path
required
string

Path to document or folder.

query Parameters
offset
integer
Default: 0

Number of entries to skip.

limit
integer
Default: 100

Maximum number of entries.

Responses

Response samples

Content type
Example
{
  • "is_truncated": true,
  • "entries":
    [
    ]
}

Uploads a document. If the path doesn't exist, it

Uploads a document. If the path doesn't exist, it will be automatically created.

path Parameters
path
required
string

Path to document or folder.

Request Body schema: multipart/form-data
document
required
string <binary>

Document to upload.

Responses

Response samples

Content type
application/json
{
  • "result": "string",
  • "hash": "string"
}

Calculates and stores the hash of a document. Usef

Calculates and stores the hash of a document. Useful when working with external storage (AWS or Azure) where files may be uploaded through means other than the document store API.

path Parameters
path
required
string

Path to document or folder.

Responses

Response samples

Content type
application/json
{
  • "result": "string",
  • "hash": "string"
}

Uploads a document, overwriting it if it already e

Uploads a document, overwriting it if it already existed. If the path doesn't exist, it will be automatically created.

path Parameters
path
required
string

Path to document or folder.

Request Body schema: multipart/form-data
document
required
string <binary>

Document to upload.

Responses

Response samples

Content type
application/json
{
  • "result": "string",
  • "hash": "string"
}

Deletes a document.

Deletes a document.

path Parameters
path
required
string

Path to document or folder.

Responses

Response samples

Content type
application/json
{
  • "errorMessage": "string"
}

Transfers

Retrieves the (paginated) document transfer log.

Retrieves the (paginated) document transfer log.

query Parameters
offset
integer
Default: 0

Number of entries to skip.

limit
integer
Default: 100

Maximum number of entries.

Responses

Response samples

Content type
application/json
{
  • "is_truncated": true,
  • "entries":
    [
    ]
}

Transfers a document.

Transfers a document.

Request Body schema: application/json
from
required
string

Sender destination.

to
required
string

Recepient destination.

document
required
string

Path to document to send.

Responses

Request samples

Content type
application/json
{
  • "from": "string",
  • "to": "string",
  • "document": "string"
}

Response samples

Content type
application/json
{
  • "result": "string",
  • "transfer_id": "string"
}

Search

Searches for document by name or hash. Result will

Searches for document by name or hash. Result will contain at most 100 entries.

query Parameters
query
required
string

String to search.

by_hash
boolean
Default: false

True to search by hash, false to search by name.

Responses

Response samples

Content type
application/json