Assets

Create an asset

Register a new asset after uploading via signed URL. Triggers metadata extraction and embedding generation.

post/api/v1/assets

Request

  • Base URL: https://numonic.ai
  • URL: https://numonic.ai/api/v1/assets
  • Auth: API key in header x-api-key

Headers

X-Tenant-IDstring uuid required

Target tenant UUID. Required when API key has access to multiple tenants.

Example:fd32351e-ddfc-4800-9182-cb16e0bc5f5b

Request body

storagePathstring required
filenamestring required
mimeTypestring required
titlestring
descriptionstring
tagsstring[]
collectionHstring
folderIdstring uuid
uploadOrigin'human_initiated' | 'agent_generated'
uploadRoute'node' | 'watcher' | 'browser-import'
sourceFileLastModifiedstring date-time
posterStoragePathstring
posterMimeType'image/png' | 'image/jpeg' | 'image/webp'

Response

Asset created

assetHstring required

Hash of the newly created asset

interactionHstring required

Hash of the creation interaction (provenance record)

extractedMetadataunknown

Example response

{
  "assetH": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4"
}

Changes

No recorded changes to this operation across all 1 revision of this API.