---
title: "Create asset usage"
method: POST
path: "/api/media/usage"
tags: ["Asset Usage"]
---

# Create asset usage

`POST /api/media/usage`

## Request

- Base URL: `https://{your-bynder-domain}`
- URL: `https://{your-bynder-domain}/api/media/usage`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://{your-auth-url}`
    - Client credentials
    - Token URL: `https://{your-bynder-domain}/v6/authentication/oauth2/token` scopes: `STATISTICS`
  - API key in header `Authorization`

Create a new asset usage entry.

## Request body `application/x-www-form-urlencoded`

- object
  - `integration_id` string: Integration id.
  - `asset_id` string: Asset id.
  - `timestamp` string, date-time: Datetime in ISO8601 format yyyy-mm-ddThh:mm:ssZ.
  - `uri` string: Location.
  - `additional` string: Additional information.

## Response `200`

Successful response

- object
  - `id` string
  - `uri` string
  - `additional` string
  - `asset_id` string
  - `timestamp` string, date-time
  - `integration` object
    - `id` string
    - `description` string

## Other responses

- `400`: Invalid request

---

[API](https://skmtc.dev/bynder/apis/asset-usage-api.md) - [All operations](https://skmtc.dev/bynder/apis/asset-usage-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bynder/apis/asset-usage-api/revisions/84b7da938753?raw)