---
title: "Asset Usage API"
url: "https://earlyaccess.developers.bynder.com/apis/asset-usage-api-1/versions/159163ba-c9a9-4c4d-a1ea-74c80ec6dea1"
---

# Asset Usage API

OpenAPI specification document.

```json
{"components":{"securitySchemes":{"OAuth2":{"flows":{"authorizationCode":{"authorizationUrl":"https://{your-auth-url}","scopes":{"STATISTICS":""},"tokenUrl":"https://{your-bynder-domain}/v6/authentication/oauth2/token"},"clientCredentials":{"scopes":{"STATISTICS":""},"tokenUrl":"https://{your-bynder-domain}/v6/authentication/oauth2/token"}},"type":"oauth2"},"permanentToken":{"in":"header","name":"Authorization","type":"apiKey"}}},"info":{"description":"These calls allow you to keep track of assets being exported from Bynder and imported into a third party application. In order to get started or find an existing integration id you should check out this [Bynder support](https://help.bynder.com/en/216226-track-asset-usage.html#UUID-5db586ff-9502-8e5b-4355-ca3630fceee3_N1579707153615_body) article. If you want to register a new third party application please contact us at [support@bynder.com](mailto:support@bynder.com).\n","title":"Asset Usage API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/api/media/usage":{"delete":{"description":"Delete an asset usage entry.","parameters":[{"description":"Integration id.","in":"query","name":"integration_id","schema":{"type":"string"}},{"description":"Asset id.","in":"query","name":"asset_id","schema":{"type":"string"}},{"description":"Asset location.","in":"query","name":"uri","schema":{"type":"string"}}],"responses":{"204":{"description":"No Content"},"400":{"content":{"application/json":{"schema":{"properties":{"asset_id":{"type":"string"},"integration_id":{"type":"string"}},"type":"object"}}},"description":"Invalid request"}},"summary":"Delete asset usage","tags":["Asset Usage"]},"get":{"description":"Retrieve asset usage information.","parameters":[{"description":"Asset id.","in":"query","name":"asset_id","schema":{"type":"string"}},{"description":"Integration id.","in":"query","name":"integration_id","schema":{"type":"string"}},{"description":"URI.","in":"query","name":"uri","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"properties":{"additional":{"type":"string"},"asset_id":{"type":"string"},"id":{"type":"string"},"integration":{"properties":{"description":{"type":"string"},"id":{"type":"string"}},"type":"object"},"timestamp":{"format":"date-time","type":"string"},"uri":{"type":"string"}},"type":"object"},"type":"array"}}},"description":"Successful response"},"400":{"content":{"application/json":{"schema":{"properties":{"asset_id":{"type":"string"}},"type":"object"}}},"description":"Invalid request"}},"summary":"Retrieve asset usage","tags":["Asset Usage"]},"post":{"description":"Create a new asset usage entry.","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"properties":{"additional":{"description":"Additional information.","type":"string"},"asset_id":{"description":"Asset id.","type":"string"},"integration_id":{"description":"Integration id.","type":"string"},"timestamp":{"description":"Datetime in ISO8601 format yyyy-mm-ddThh:mm:ssZ.","format":"date-time","type":"string"},"uri":{"description":"Location.","type":"string"}},"type":"object"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"additional":{"type":"string"},"asset_id":{"type":"string"},"id":{"type":"string"},"integration":{"properties":{"description":{"type":"string"},"id":{"type":"string"}},"type":"object"},"timestamp":{"format":"date-time","type":"string"},"uri":{"type":"string"}},"type":"object"}}},"description":"Successful response"},"400":{"content":{"application/json":{"schema":{"properties":{"asset_id":{"type":"string"},"integration_id":{"type":"string"}},"type":"object"}}},"description":"Invalid request"}},"summary":"Create asset usage","tags":["Asset Usage"]}},"/api/media/usage/sync":{"post":{"description":"Sync all usage from a single integration.","requestBody":{"content":{"application/json":{"schema":{"properties":{"integration_id":{"description":"Integration id.","type":"string"},"uris":{"description":"An array of URIs that are part of your integration.","items":{"type":"string"},"type":"array"},"usages":{"items":{"properties":{"additional":{"type":"string"},"asset_id":{"type":"string"},"uri":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"accepted":{"items":{"properties":{"additional":{"type":"string"},"asset_id":{"type":"string"},"uri":{"type":"string"}},"type":"object"},"type":"array"},"new":{"items":{"properties":{"additional":{"type":"string"},"asset_id":{"type":"string"},"id":{"type":"string"},"integration":{"properties":{"description":{"type":"string"},"id":{"type":"string"}},"type":"object"},"timestamp":{"format":"date-time","type":"string"},"uri":{"type":"string"}},"type":"object"},"type":"array"},"rejected":{"items":{"properties":{"asset_id":{"type":"string"},"reason":{"type":"string"},"uri":{"type":"string"}},"type":"object"},"type":"array"},"removed":{"items":{"properties":{"asset_id":{"type":"string"},"uri":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"}}},"description":"Successful response"},"400":{"content":{"application/json":{"schema":{"properties":{"asset_id":{"type":"string"},"integration_id":{"type":"string"}},"type":"object"}}},"description":"Invalid request"}},"summary":"Sync asset usage","tags":["Asset Usage Sync"]}}},"security":[{"OAuth2":["STATISTICS"]},{"permanentToken":["STATISTICS"]}],"servers":[{"url":"https://{your-bynder-domain}/"}],"tags":[{"description":"These calls allow you to keep track of assets being exported from Bynder and imported into a third party application. In order to get started or find an existing integration id you should check out this Bynder support article. If you want to register a new third party application please contact us at [support@bynder.com](mailto:support@bynder.com).\n\n__Warning:__ Requires the STATISTICS security role.\n","name":"Asset Usage"},{"description":"This alternative API call allows you to sync all your usage from a single integration.\n* A usage will be created when there is no existing usage on the specified asset\n* A usage will be updated when adding additional info\n* A usage will be deleted when specifying a URI but not using that URI in a usage\n\n__Warning:__ Requires the STATISTICS security role.\n","name":"Asset Usage Sync"}]}
```