Store Object

Stores a file.

The Store Object API takes a file, reference, or an input URL and stores the contents of the document for use in other APIs. It returns the object store reference, which you can pass to other APIs to process the document that you store.

Quick Start

The API returns an object store reference.

curl -X POST[async|sync]/storeobject/v1 --form "file=@mydoc.doc"

  "reference": "98ca9183-0902-4981-9a2b-0942ea4e1a67"

You can use the reference in many of the Haven OnDemand APIs, so that you do not have to send the whole document multiple times. For example:



Tip: If you have a container file (that is, a file that contains other files, such as ZIP archive, or a PST file), you can use the Expand Container API to extract the files from the container, and to store and return a reference for each of the contained files.

Note: API input is subject to a maximum size quota. If you upload text or a file that is too large, the API returns an error. For more information, see Rate Limiting, Quotas, Data Expiry, and Maximums.


This API requires an authentication token to be supplied in the following parameter:

Parameter Description
apikey The API key to use to authenticate the API request.

This API accepts the following parameters:

Name Type Description
binary The file to store.
string A Haven OnDemand reference obtained from either the Expand Container or Store Object API. The corresponding document is passed to the API.
string A publicly accessible HTTP URL from which the file to store can be retrieved.

This API returns a JSON response that is described by the model below. This single model is presented both as an easy to read abstract definition and as the formal JSON schema.

Asynchronous Use

Additional requests are required to get the result if this API is invoked asynchronously.

You can use /1/job/status/<job-id> to get the status of the job, including results if the job is finished.

You can also use /1/job/result/<job-id>, which waits until the job has finished and then returns the result.

This is an abstract definition of the response that describes each of the properties that might be returned.
Store Object Response {
reference ( string ) The object store reference of the extracted file.
Model Schema
This is a JSON schema that describes the syntax of the response. See for a complete reference.
    "properties": {
        "reference": {
            "type": "string"
    "required": [
    "type": "object"

If you would like to provide us with more information then please use the box below:

We will use your submission to help improve our product.