File Selector

Reporting Usage

To help you keep track of how and where files are used, Mediaflow provides a way to report usage via the API. This includes reporting when a file is in use on a page or project, as well as when it’s no longer in use. Reported usage appears inside Mediaflow, giving editors and admins better visibility and control over asset usage across your platform.

This guide explains how to authenticate, format usage data, and send it to the correct API endpoint.

Authentication

Before you can report usage, you’ll need to obtain an access token from the API. See the Authentication page for details.

Send usage

With the access_token obtained through authentication, you can now send requests to the API by including it in the Authorization header:

Authorization: Bearer YOUR_ACCESS_TOKEN

Send a POST request to the following endpoint along with the usage data:

POST https://api.mediaflow.com/1/files/multiple/usages

Usage object

Field	Type	Description
id	int array	Array of File ID’s
contact	string	Person responsible
date	string	Publication date
amount	string	Amount
description	string	Information about the usage
project	string	Name of the project it’s used in
types	string array	Type of publication
removed	string	Indicates if the usage should be removed or not.
web	object	This is an object with details about the page the file is used on. More details are specified below.

Web object

Field	Type	Description
page	string	URL to the page.
pageName	string	Name of the page.

JSON example

{
     "id":[1000],
     "types":["web"],
     "date": "2025-05-23",
     "contact ": "Name Nameson",
     "amount": "1",
     "project": "Umbraco",
     "description":"",
     "web": {
          "page": "https://www.mediaflow.com>",
          "pageName": "Mediaflow"
     },
     "removed": "false"
}