API ReferenceStorage

Create Asset Metadata

Create asset metadata, including its object reference.

Headers

AuthorizationstringRequired

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

Request

This endpoint expects an object.
lifetime_hoursintegerRequired>=1<=24

Asset lifetime in hours (1–24).

mime_typestringOptional

MIME type of the asset (e.g., ‘application/json’).

contentsstringOptional

Base64-encoded contents of the asset (optional).

namestringOptional

Optional human-readable name for the asset.

Response

Successful Response
asset_idstringformat: "uuid4"
Unique identifier of the asset.
sizeinteger
Size of the asset in bytes.
checksumstring

SHA-256 checksum of the asset content.

expires_atstringformat: "date-time"
Datetime when the asset will expire.
created_atstringformat: "date-time"
Datetime when the asset was created.
updated_atstringformat: "date-time"
Datetime when the asset was last updated.
mime_typestring or null

MIME type of the asset (if known).

referencestring or null
Storage reference URI for the asset.
protocolstring or null

Protocol-formatted reference URI (auto-generated).

Errors