HomeGuidesAPI Reference
API Reference

Ingest asset data

post
https://example.com/data/assets/ingest

Unified endpoint for ingesting asset data from any source:

  • Manual push from API consumers
  • Adapter subscription callbacks (push mode)
  • Adapter async pull responses

Supports single or batch. Asset identifiers are in the request body.

Body Params
string

Correlation ID from async fetch (202 response)

string

Correlation ID from subscription

string
Defaults to manual

Source identifier. Examples: provider name, "manual".

assets
array of objects
required
length ≥ 1

Array of asset data items (single item or batch)

assets*
identifier
object
required
data
array of objects
required
length ≥ 1
data*
string
enum
required
Allowed:
uri

URI to JSON schema for validation of the data object

data
object
required

The actual data payload conforming to the referenced schema

string

Data source identifier

int64

Provider timestamp (epoch milliseconds)

Headers
string

32 bytes buffer (24 randomly generated bytes by the client + 8 bytes epoch timestamp seconds) encoded to hex:

const nonce = Buffer.alloc(32); nonce.fill(crypto.randomBytes(24), 0, 24);

const nowEpochSeconds = Math.floor(new Date().getTime() / 1000); const t = BigInt(nowEpochSeconds); nonce.writeBigInt64BE(t, 24);

Responses

Updated 12 days ago

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 12 days ago