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

# Sync asset usage

`POST /api/media/usage/sync`

## Request

- Base URL: `https://{your-bynder-domain}`
- URL: `https://{your-bynder-domain}/api/media/usage/sync`
- 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`

Sync all usage from a single integration.

## Request body

- object
  - `integration_id` string: Integration id.
  - `uris` string[]: An array of URIs that are part of your integration.
  - `usages` object[]
    - `asset_id` string
    - `uri` string
    - `additional` string

## Response `200`

Successful response

- object
  - `accepted` object[]
    - `additional` string
    - `asset_id` string
    - `uri` string
  - `new` object[]
    - `additional` string
    - `asset_id` string
    - `id` string
    - `integration` object
      - `description` string
      - `id` string
    - `timestamp` string, date-time
    - `uri` string
  - `rejected` object[]
    - `asset_id` string
    - `reason` string
    - `uri` string
  - `removed` object[]
    - `asset_id` string
    - `uri` 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)