Upload

Upload an asset.

Request Details

HTTP Method(s)

POST

Resource URI

https://services-sandbox.sheerid.com/rest/0.5/asset

Accepted Content Type(s)

multipart/form-data

Parameters

Name Type Description
various mixed one or more files, with parameter keys prefixed by file (Ex: file0, file1...). File type must be one of our supported MIME types.
assetType string the type of document the user is uploading
assetTypeDescription string free form text to provide additional details of assetType
failure string A URL to which the request will be redirected upon a failed upload. If omitted, will not redirect upon failure.
mergeMultipleDocuments boolean to merge multiple documents into one when possible (default value: true)
success string A URL to which the request will be redirected upon a successful upload. If omitted, will not redirect upon success.
token string a valid asset token obtained from Issue Token

Response Details

Expected Response

A list of Asset objects

Response Content Type(s)

application/json

Errors (HTTP Status Codes)

HTTP Status Code Description
400 either no files have been supplied or at least one file is larger than the maximum upload size
401 the asset token supplied is invalid, expired or has already been used to perform an upload
403 if the request state does not allow upload
415 at least one file is an unsupported MIME type