Skip to main content

EstuaryClient.ContentApi

All URIs are relative to https://api.estuary.tech

MethodHTTP requestDescription
contentAddCarPostPOST /content/add-carAdd Car object
contentAddIpfsPostPOST /content/add-ipfsAdd IPFS object
contentAddPostPOST /content/addAdd new content
contentAggregatedContentGetGET /content/aggregated/{content}Get aggregated content stats
contentAllDealsGetGET /content/all-dealsGet all deals for a user
contentBwUsageContentGetGET /content/bw-usage/{content}Get content bandwidth
contentCreatePostPOST /content/createAdd a new content
contentDealsGetGET /content/dealsContent with deals
contentEnsureReplicationDatacidGetGET /content/ensure-replication/{datacid}Ensure Replication
contentFailuresContentGetGET /content/failures/{content}List all failures for a content
contentIdGetGET /content/{id}Content
contentImportdealPostPOST /content/importdealImport a deal
contentListGetGET /content/listList all pinned content
contentReadContGetGET /content/read/{cont}Read content
contentStagingZonesGetGET /content/staging-zonesGet staging zone for user
contentStatsGetGET /content/statsGet content statistics
contentStatusIdGetGET /content/status/{id}Content Status
# **contentAddCarPost** > contentAddCarPost(body, opts)

Add Car object

This endpoint is used to add a car object to the network. The object can be a file or a directory.

Example

var EstuaryClient = require('estuary-client');
var defaultClient = EstuaryClient.ApiClient.instance;

// Configure API key authorization: bearerAuth
var bearerAuth = defaultClient.authentications['bearerAuth'];
bearerAuth.apiKey = 'YOUR API KEY';
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//bearerAuth.apiKeyPrefix = 'Token';

var apiInstance = new EstuaryClient.ContentApi();

var body = "body_example"; // String | Car

var opts = {
'ignoreDupes': "ignoreDupes_example", // String | Ignore Dupes
'filename': "filename_example" // String | Filename
};

var callback = function(error, data, response) {
if (error) {
console.error(error);
} else {
console.log('API called successfully.');
}
};
apiInstance.contentAddCarPost(body, opts, callback);

Parameters

NameTypeDescriptionNotes
bodyStringCar
ignoreDupesStringIgnore Dupes[optional]
filenameStringFilename[optional]

Return type

null (empty response body)

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json
# **contentAddIpfsPost** > contentAddIpfsPost(body, opts)

Add IPFS object

This endpoint is used to add an IPFS object to the network. The object can be a file or a directory.

Example

var EstuaryClient = require('estuary-client');
var defaultClient = EstuaryClient.ApiClient.instance;

// Configure API key authorization: bearerAuth
var bearerAuth = defaultClient.authentications['bearerAuth'];
bearerAuth.apiKey = 'YOUR API KEY';
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//bearerAuth.apiKeyPrefix = 'Token';

var apiInstance = new EstuaryClient.ContentApi();

var body = new EstuaryClient.UtilContentAddIpfsBody(); // UtilContentAddIpfsBody | IPFS Body

var opts = {
'ignoreDupes': "ignoreDupes_example" // String | Ignore Dupes
};

var callback = function(error, data, response) {
if (error) {
console.error(error);
} else {
console.log('API called successfully.');
}
};
apiInstance.contentAddIpfsPost(body, opts, callback);

Parameters

NameTypeDescriptionNotes
bodyUtilContentAddIpfsBodyIPFS Body
ignoreDupesStringIgnore Dupes[optional]

Return type

null (empty response body)

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json
# **contentAddPost** > UtilContentAddResponse contentAddPost(data, opts)

Add new content

This endpoint is used to upload new content.

Example

var EstuaryClient = require('estuary-client');
var defaultClient = EstuaryClient.ApiClient.instance;

// Configure API key authorization: bearerAuth
var bearerAuth = defaultClient.authentications['bearerAuth'];
bearerAuth.apiKey = 'YOUR API KEY';
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//bearerAuth.apiKeyPrefix = 'Token';

var apiInstance = new EstuaryClient.ContentApi();

var data = "/path/to/file.txt"; // File | File to upload

var opts = {
'filename': "filename_example", // String | Filenam to use for upload
'coluuid': "coluuid_example", // String | Collection UUID
'replication': 56, // Number | Replication value
'ignoreDupes': "ignoreDupes_example", // String | Ignore Dupes true/false
'lazyProvide': "lazyProvide_example", // String | Lazy Provide true/false
'dir': "dir_example" // String | Directory
};

var callback = function(error, data, response) {
if (error) {
console.error(error);
} else {
console.log('API called successfully. Returned data: ' + data);
}
};
apiInstance.contentAddPost(data, opts, callback);

Parameters

NameTypeDescriptionNotes
dataFileFile to upload
filenameStringFilenam to use for upload[optional]
coluuidStringCollection UUID[optional]
replicationNumberReplication value[optional]
ignoreDupesStringIgnore Dupes true/false[optional]
lazyProvideStringLazy Provide true/false[optional]
dirStringDirectory[optional]

Return type

UtilContentAddResponse

Authorization

bearerAuth

HTTP request headers

  • Content-Type: multipart/form-data
  • Accept: application/json
# **contentAggregatedContentGet** > 'String' contentAggregatedContentGet(content)

Get aggregated content stats

This endpoint returns aggregated content stats

Example

var EstuaryClient = require('estuary-client');
var defaultClient = EstuaryClient.ApiClient.instance;

// Configure API key authorization: bearerAuth
var bearerAuth = defaultClient.authentications['bearerAuth'];
bearerAuth.apiKey = 'YOUR API KEY';
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//bearerAuth.apiKeyPrefix = 'Token';

var apiInstance = new EstuaryClient.ContentApi();

var content = "content_example"; // String | Content ID


var callback = function(error, data, response) {
if (error) {
console.error(error);
} else {
console.log('API called successfully. Returned data: ' + data);
}
};
apiInstance.contentAggregatedContentGet(content, callback);

Parameters

NameTypeDescriptionNotes
contentStringContent ID

Return type

'String'

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json
# **contentAllDealsGet** > contentAllDealsGet(begin, duration, all)

Get all deals for a user

This endpoint is used to get all deals for a user

Example

var EstuaryClient = require('estuary-client');
var defaultClient = EstuaryClient.ApiClient.instance;

// Configure API key authorization: bearerAuth
var bearerAuth = defaultClient.authentications['bearerAuth'];
bearerAuth.apiKey = 'YOUR API KEY';
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//bearerAuth.apiKeyPrefix = 'Token';

var apiInstance = new EstuaryClient.ContentApi();

var begin = "begin_example"; // String | Begin

var duration = "duration_example"; // String | Duration

var all = "all_example"; // String | All


var callback = function(error, data, response) {
if (error) {
console.error(error);
} else {
console.log('API called successfully.');
}
};
apiInstance.contentAllDealsGet(begin, duration, all, callback);

Parameters

NameTypeDescriptionNotes
beginStringBegin
durationStringDuration
allStringAll

Return type

null (empty response body)

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json
# **contentBwUsageContentGet** > contentBwUsageContentGet(content)

Get content bandwidth

This endpoint returns content bandwidth

Example

var EstuaryClient = require('estuary-client');
var defaultClient = EstuaryClient.ApiClient.instance;

// Configure API key authorization: bearerAuth
var bearerAuth = defaultClient.authentications['bearerAuth'];
bearerAuth.apiKey = 'YOUR API KEY';
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//bearerAuth.apiKeyPrefix = 'Token';

var apiInstance = new EstuaryClient.ContentApi();

var content = "content_example"; // String | Content ID


var callback = function(error, data, response) {
if (error) {
console.error(error);
} else {
console.log('API called successfully.');
}
};
apiInstance.contentBwUsageContentGet(content, callback);

Parameters

NameTypeDescriptionNotes
contentStringContent ID

Return type

null (empty response body)

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json
# **contentCreatePost** > contentCreatePost(req, opts)

Add a new content

This endpoint adds a new content

Example

var EstuaryClient = require('estuary-client');
var defaultClient = EstuaryClient.ApiClient.instance;

// Configure API key authorization: bearerAuth
var bearerAuth = defaultClient.authentications['bearerAuth'];
bearerAuth.apiKey = 'YOUR API KEY';
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//bearerAuth.apiKeyPrefix = 'Token';

var apiInstance = new EstuaryClient.ContentApi();

var req = new EstuaryClient.UtilContentCreateBody(); // UtilContentCreateBody | Content

var opts = {
'ignoreDupes': "ignoreDupes_example" // String | Ignore Dupes
};

var callback = function(error, data, response) {
if (error) {
console.error(error);
} else {
console.log('API called successfully.');
}
};
apiInstance.contentCreatePost(req, opts, callback);

Parameters

NameTypeDescriptionNotes
reqUtilContentCreateBodyContent
ignoreDupesStringIgnore Dupes[optional]

Return type

null (empty response body)

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json
# **contentDealsGet** > contentDealsGet(opts)

Content with deals

This endpoint lists all content with deals

Example

var EstuaryClient = require('estuary-client');
var defaultClient = EstuaryClient.ApiClient.instance;

// Configure API key authorization: bearerAuth
var bearerAuth = defaultClient.authentications['bearerAuth'];
bearerAuth.apiKey = 'YOUR API KEY';
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//bearerAuth.apiKeyPrefix = 'Token';

var apiInstance = new EstuaryClient.ContentApi();

var opts = {
'limit': 56, // Number | Limit
'offset': 56 // Number | Offset
};

var callback = function(error, data, response) {
if (error) {
console.error(error);
} else {
console.log('API called successfully.');
}
};
apiInstance.contentDealsGet(opts, callback);

Parameters

NameTypeDescriptionNotes
limitNumberLimit[optional]
offsetNumberOffset[optional]

Return type

null (empty response body)

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json
# **contentEnsureReplicationDatacidGet** > contentEnsureReplicationDatacidGet(datacid)

Ensure Replication

This endpoint ensures that the content is replicated to the specified number of providers

Example

var EstuaryClient = require('estuary-client');
var defaultClient = EstuaryClient.ApiClient.instance;

// Configure API key authorization: bearerAuth
var bearerAuth = defaultClient.authentications['bearerAuth'];
bearerAuth.apiKey = 'YOUR API KEY';
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//bearerAuth.apiKeyPrefix = 'Token';

var apiInstance = new EstuaryClient.ContentApi();

var datacid = "datacid_example"; // String | Data CID


var callback = function(error, data, response) {
if (error) {
console.error(error);
} else {
console.log('API called successfully.');
}
};
apiInstance.contentEnsureReplicationDatacidGet(datacid, callback);

Parameters

NameTypeDescriptionNotes
datacidStringData CID

Return type

null (empty response body)

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json
# **contentFailuresContentGet** > 'String' contentFailuresContentGet(content)

List all failures for a content

This endpoint returns all failures for a content

Example

var EstuaryClient = require('estuary-client');
var defaultClient = EstuaryClient.ApiClient.instance;

// Configure API key authorization: bearerAuth
var bearerAuth = defaultClient.authentications['bearerAuth'];
bearerAuth.apiKey = 'YOUR API KEY';
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//bearerAuth.apiKeyPrefix = 'Token';

var apiInstance = new EstuaryClient.ContentApi();

var content = "content_example"; // String | Content ID


var callback = function(error, data, response) {
if (error) {
console.error(error);
} else {
console.log('API called successfully. Returned data: ' + data);
}
};
apiInstance.contentFailuresContentGet(content, callback);

Parameters

NameTypeDescriptionNotes
contentStringContent ID

Return type

'String'

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json
# **contentIdGet** > contentIdGet(id)

Content

This endpoint returns a content by its ID

Example

var EstuaryClient = require('estuary-client');
var defaultClient = EstuaryClient.ApiClient.instance;

// Configure API key authorization: bearerAuth
var bearerAuth = defaultClient.authentications['bearerAuth'];
bearerAuth.apiKey = 'YOUR API KEY';
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//bearerAuth.apiKeyPrefix = 'Token';

var apiInstance = new EstuaryClient.ContentApi();

var id = 56; // Number | Content ID


var callback = function(error, data, response) {
if (error) {
console.error(error);
} else {
console.log('API called successfully.');
}
};
apiInstance.contentIdGet(id, callback);

Parameters

NameTypeDescriptionNotes
idNumberContent ID

Return type

null (empty response body)

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json
# **contentImportdealPost** > contentImportdealPost(body)

Import a deal

This endpoint imports a deal into the shuttle.

Example

var EstuaryClient = require('estuary-client');
var defaultClient = EstuaryClient.ApiClient.instance;

// Configure API key authorization: bearerAuth
var bearerAuth = defaultClient.authentications['bearerAuth'];
bearerAuth.apiKey = 'YOUR API KEY';
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//bearerAuth.apiKeyPrefix = 'Token';

var apiInstance = new EstuaryClient.ContentApi();

var body = new EstuaryClient.MainImportDealBody(); // MainImportDealBody | Import a deal


var callback = function(error, data, response) {
if (error) {
console.error(error);
} else {
console.log('API called successfully.');
}
};
apiInstance.contentImportdealPost(body, callback);

Parameters

NameTypeDescriptionNotes
bodyMainImportDealBodyImport a deal

Return type

null (empty response body)

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json
# **contentListGet** > ['String'] contentListGet()

List all pinned content

This endpoint lists all content

Example

var EstuaryClient = require('estuary-client');
var defaultClient = EstuaryClient.ApiClient.instance;

// Configure API key authorization: bearerAuth
var bearerAuth = defaultClient.authentications['bearerAuth'];
bearerAuth.apiKey = 'YOUR API KEY';
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//bearerAuth.apiKeyPrefix = 'Token';

var apiInstance = new EstuaryClient.ContentApi();

var callback = function(error, data, response) {
if (error) {
console.error(error);
} else {
console.log('API called successfully. Returned data: ' + data);
}
};
apiInstance.contentListGet(callback);

Parameters

This endpoint does not need any parameter.

Return type

['String']

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json
# **contentReadContGet** > contentReadContGet(cont)

Read content

This endpoint reads content from the blockstore

Example

var EstuaryClient = require('estuary-client');
var defaultClient = EstuaryClient.ApiClient.instance;

// Configure API key authorization: bearerAuth
var bearerAuth = defaultClient.authentications['bearerAuth'];
bearerAuth.apiKey = 'YOUR API KEY';
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//bearerAuth.apiKeyPrefix = 'Token';

var apiInstance = new EstuaryClient.ContentApi();

var cont = "cont_example"; // String | CID


var callback = function(error, data, response) {
if (error) {
console.error(error);
} else {
console.log('API called successfully.');
}
};
apiInstance.contentReadContGet(cont, callback);

Parameters

NameTypeDescriptionNotes
contStringCID

Return type

null (empty response body)

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json
# **contentStagingZonesGet** > contentStagingZonesGet()

Get staging zone for user

This endpoint is used to get staging zone for user.

Example

var EstuaryClient = require('estuary-client');
var defaultClient = EstuaryClient.ApiClient.instance;

// Configure API key authorization: bearerAuth
var bearerAuth = defaultClient.authentications['bearerAuth'];
bearerAuth.apiKey = 'YOUR API KEY';
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//bearerAuth.apiKeyPrefix = 'Token';

var apiInstance = new EstuaryClient.ContentApi();

var callback = function(error, data, response) {
if (error) {
console.error(error);
} else {
console.log('API called successfully.');
}
};
apiInstance.contentStagingZonesGet(callback);

Parameters

This endpoint does not need any parameter.

Return type

null (empty response body)

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json
# **contentStatsGet** > contentStatsGet(limit, offset)

Get content statistics

This endpoint is used to get content statistics. Every content stored in the network (estuary) is tracked by a unique ID which can be used to get information about the content. This endpoint will allow the consumer to get the collected stats of a conten

Example

var EstuaryClient = require('estuary-client');
var defaultClient = EstuaryClient.ApiClient.instance;

// Configure API key authorization: bearerAuth
var bearerAuth = defaultClient.authentications['bearerAuth'];
bearerAuth.apiKey = 'YOUR API KEY';
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//bearerAuth.apiKeyPrefix = 'Token';

var apiInstance = new EstuaryClient.ContentApi();

var limit = "limit_example"; // String | limit

var offset = "offset_example"; // String | offset


var callback = function(error, data, response) {
if (error) {
console.error(error);
} else {
console.log('API called successfully.');
}
};
apiInstance.contentStatsGet(limit, offset, callback);

Parameters

NameTypeDescriptionNotes
limitStringlimit
offsetStringoffset

Return type

null (empty response body)

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json
# **contentStatusIdGet** > contentStatusIdGet(id)

Content Status

This endpoint returns the status of a content

Example

var EstuaryClient = require('estuary-client');
var defaultClient = EstuaryClient.ApiClient.instance;

// Configure API key authorization: bearerAuth
var bearerAuth = defaultClient.authentications['bearerAuth'];
bearerAuth.apiKey = 'YOUR API KEY';
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//bearerAuth.apiKeyPrefix = 'Token';

var apiInstance = new EstuaryClient.ContentApi();

var id = 56; // Number | Content ID


var callback = function(error, data, response) {
if (error) {
console.error(error);
} else {
console.log('API called successfully.');
}
};
apiInstance.contentStatusIdGet(id, callback);

Parameters

NameTypeDescriptionNotes
idNumberContent ID

Return type

null (empty response body)

Authorization

bearerAuth

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json