Asset (Beta)

Asset API (Beta)

1.0.0-betaOAS 3.1

Beta. The Asset API lets you ingest, enrich, and manage assets on api.bynder.com. Endpoints are grouped by the stage of the asset lifecycle: ingestion (create → upload → publish), enrichment (metadata, tags, embargoes, rights, relations), and general retrieval/management.

API Base URL
  • Server 1:https://{your-bynder-domain}/
Security
httpAuth (http)

Provide your bearer token in the Authorization header when making requests to protected resources.

Example: Authorization: Bearer 123

Asset ingestion

Create an asset, upload its file in resumable chunks, and publish it. After the file is uploaded you can enrich the asset - see the Asset enrichment section - before publishing. Retrieval of the asset during ingestion uses Get asset in the General endpoints section.

Upload file chunks

IMPORTANT NOTE
These APIs do not replace the existing v4 APIs yet, and currently only applies to newly uploaded assets still in Draft state (before publishing). Cannot be yet used for Assets that are in Asset Bank and Waiting room.

The request target is the Location response header returned by Upload file initialization. Carry the relevant header information across calls as shown below. After the last chunk is uploaded, the file is automatically finalized.

The Location Header Value URL is a placeholder for the Location header from the previous call.

patch
https://{your-bynder-domain}/

Headers

tus-resumablestringrequired

Default:1.0.0

upload-offsetstringrequired

The combined length of the previously uploaded chunks. This value can be taken from the Upload-Offset response header of each preceding chunk request.

content-typestringrequired

Default:application/offset+octet-stream

fileidstringrequired
filenamestringrequired
reasonstringrequired

Body

application/offset+octet-stream
string(binary)

Response

Chunk accepted.

patch/

Body

No file selected