Skip to navigation
v2Blobs

Upload single-part blob

This endpoint uploads a blob in a single API call.

Blobs larger than 10MB should be uploaded in multiple parts. The data64 parameter is the base64-encoded part contents, and the md5 parameter is the hex-encoded MD5 hash of the part contents. For example, given the string hello, data64 is aGVsbG8= and md5 is 5d41402abc4b2a76b9719d911017c592.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
data64stringRequiredformat: "byte"
base64 encoded file contents
md5stringRequired

The MD5 hash of the blob part. Note: this should be the hash of the raw data of the blob part, not the hash of the base64 encoding.

namestringRequired<=1000 characters
Name of the blob
typeenumRequired

One of RAW_FILE or VISUALIZATION. If VISUALIZATION, the blob may be displayed as an image preview.

Allowed values:
mimeTypestringOptional<=100 charactersDefaults to application/octet-stream

eg. application/jpeg

Response

Created
idstringOptionalformat: "uuid"

The universally unique identifier (UUID) for the blob.

mimeTypestringOptional<=100 characters

eg. application/jpeg

namestringOptional<=1000 characters
Name of the blob
typeenumOptional

One of RAW_FILE or VISUALIZATION. If VISUALIZATION, the blob may be displayed as an image preview.

Allowed values:
uploadStatusenumOptional
Allowed values:

Errors

400
Bad Request Error