Jump to Content
Guides
API Reference
Changelog
v1.0
Log In
API Reference
Log In
v1.0
Guides
API Reference
Changelog
Create asset usage
All
Pages
Start typing to search…
JUMP TO
OAuth 2.0
Authorize endpoint
Authorize endpoint
get
Token endpoint
Using an authorization code
post
Using a refresh token
post
Using client credentials
post
Scopes
Retrieve scopes
get
Security Roles
Retrieve security profiles
Retrieve security profiles
get
Retrieve specific security profile
Retrieve specific security profile
get
Users
Users
Retrieve users
get
Create user
post
Users ID
Retrieve specific user
get
Modify user
post
Delete user
del
Current User
Retrieve current user
get
Groups
Groups
Retrieve groups
get
Asset Usage API
Asset Usage
Retrieve asset usage
get
Create asset usage
post
Delete asset usage
del
Asset Usage Sync
Sync asset usage
post
Asset Management API
Media
Retrieve assets
get
Media ID
Retrieve specific asset
get
Modify asset
post
Delete asset
del
Media options
Add metaproperty options
post
Delete metaproperty options
del
Dynamic Asset Transformations API
/transform/{id}/{name}
Generate dynamic asset transformation
get
Group Upload Assets API Steps
Step 1 Get closest AmazonS3 upload endpoint
GetclosestAmazonS3uploadendpoint
get
Step 2 Initialise upload
initialiseUpload
post
Step 3A Upload file in chunks
Uploadfileinchunks
post
Step 3B Register uploaded chunk
registerUploadedChunk
post
Step 4A Finalise uploaded file
Step4AFinaliseanuploadedfile
post
Step 4B Finalize and save an additional uploaded file as a new asset.
finalizeAdditionalFile
post
Step 5 Poll for processing status
Retrievepollstate
get
Step 6A Save as a new asset
Saveasanewasset
post
Step 6B Save uploaded file to existing asset
Saveuploadedfiletoexistingasset
post
Download API
Media download
Retrieve asset download location
get
Retrieve asset version download location
get
Retrieve specific asset item download location
get
Metaproperty Options and Dependencies API
Metaproperty options operations
Retrieve metaproperty options (New)
get
Retrieve metaproperty options by ids
get
Retrieve metaproperty options
get
Create metaproperty option
post
Specific metaproperty option operations
Modify metaproperty option
post
Delete metaproperty option
del
Retrieve all metaproperty option dependencies globally
Retrieve global option dependencies
get
Retrieve all metaproperty option dependencies for a metaproperty
Retrieve metaproperty option dependencies
get
Retrieve options a metaproperty option depends on
Retrieve specific metaproperty option dependencies
get
Manage ungrouped metaproperty option dependencies
Add a dependency
post
Delete a dependency
del
Create metaproperty option dependency group
Create dependency group
post
Specific metaproperty option dependency group operations
Modify dependency group
post
Manage option dependency in dependency group
Add a dependency option to a group
post
Remove a dependency option from a group
del
Metaproperty Operations
Metaproperty operations
Retrieve metaproperties
get
Create metaproperty
post
Specific metaproperty operations
Retrieve specific metaproperty
get
Modify metaproperty
post
Delete metaproperty
del
Smartfilters API
Smartfilters
Retrieve smartfilters
get
Tags API
Tags
Retrieve tags
get
Add tag to assets
post
Remove tag from assets
del
Account API
Account
Retrieve account information
get
Retrieve derivatives
get
Access Rights API
Access rights
Retrieve metaproperty access
get
Create metaproperty access
post
Delete metaproperty access
del
Collections API
Collections
Retrieve collections
get
Create collection
post
Collections ID
Retrieve specific collection
get
Modify collection
post
Delete collection
del
Share collection
Share collection
post
Collections assets
Retrieve the assets of a specific collection
get
Add assets to a collection
post
Remove assets from a collection
del
Modern Stack File Upload
Step 1
Prepare the upload
post
Step 2
Upload a file chunk
post
Step 3
Finalize the upload
post
Trash API
Trash
Retrieve recently removed assets
get
Workflow Users and Groups API
Users
Retrieve users
get
Retrieve specific user
get
Groups
Retrieve groups
get
Create group
post
Retrieve specific group
get
Modify group
put
Delete group
del
Workflow Metaproperties API
Metaproperties
Retrieve metaproperties
get
Retrieve specific metaproperty
get
Workflow Jobs API
Presets
Retrieve specific job preset
get
Jobs
Retrieve jobs
get
Create job
post
Retrieve specific job
get
Modify job
put
Delete job
del
Campaign jobs
Retrieve the jobs of a specific campaign
get
Job media
Retrieve media of specific job
get
File upload
Upload a file to a workflow job
post
Finish
Finish job
patch
Job stages
Retrieve stages of specific job
get
Workflow Campaigns API
Campaigns
Retrieve campaigns
get
Create campaign
post
Retrieve specific campaign
get
Modify campaign
put
Delete campaign
del
Close campaign
post
Product Layer Metaproperties API
Metaproperties
Retrieve metaproperties
get
Retrieve specific metaproperty
get
Options
Retrieve metaproperty options
get
Modify metaproperty option
put
Adaptive Video Streaming API
Public links
Get public links for an asset
get
Similar Assets Search
/api/1/assets/similarity-search/
Search for similar assets
post
Brandstore API
/api/store/order/
Retrieve orders
get
/api/store/order/{id}/
Retrieve specific order info
get
/api/store/order/{id}/products
Retrieve specific order by id
get
Modify order
post
/api/store/orderproducts/{id}
Retrieve specific orderline
get
Modify orderline
patch
Analytics API
Asset Usage V2
Retrieve asset views
get
Asset Usage V1
Retrieve asset view events
get
Retrieve asset download events
get
Retrieve asset download events1
get
Retrieve asset creation events
get
Retrieve asset archive events
get
Retrieve removed asset events
get
Retrieve all events performed in a given asset
get
Search Usage
Retrieve search execution events
get
Retrieve search keyword events
get
Retrieve search keyword events in CSV format
get
User Usage
User Login
get
User Activity
get
Collection Usage
Retrieve collection view events
get
Retrieve collection view events in CSV format
get
Reporting
Retrieve asset reports
get
Retrieve specific asset report
get
Historical Data
Retrieve historical data in CSV format
get
Antivirus API
/v7/quarantine/v1/assets
Retrieve a list of quarantined assets
get
/v7/quarantine/v1/assets/{asset_id}
Retrieve a quarantined asset by id
get
Update review status by id
put
/v7/quarantine/v1/antivirus-audit
Update review status by list of asset Ids
post
Webhooks API
/v7/webhooks/public/api/subscriptions/{id}
Create a Webhook Configuration
post
Update a Webhook Configuration
put
Patch a Webhook Configuration
patch
Delete a Webhook Configuration
del
Powered by
Create asset usage
post
https://{your-bynder-domain}/api/media/usage
Create a new asset usage entry.
Language
Shell
Node
Ruby
PHP
Python
Credentials
OAuth2
Bearer
URL
Base URL
https://
your-bynder-domain
/api/media/usage
Response
Click
Try It!
to start a request and see the response here!