Get Asset Usage

curl --request GET \
  --url https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/components/{componentId}/assets/{assetId}/usage

import requests

url = "https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/components/{componentId}/assets/{assetId}/usage"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/components/{componentId}/assets/{assetId}/usage', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/components/{componentId}/assets/{assetId}/usage",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/components/{componentId}/assets/{assetId}/usage"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/components/{componentId}/assets/{assetId}/usage")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/components/{componentId}/assets/{assetId}/usage")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

GET

app

organizations

{organizationId}

projects

{projectId}

components

{componentId}

assets

{assetId}

usage

Get Asset Usage

curl --request GET \
  --url https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/components/{componentId}/assets/{assetId}/usage

import requests

url = "https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/components/{componentId}/assets/{assetId}/usage"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/components/{componentId}/assets/{assetId}/usage', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/components/{componentId}/assets/{assetId}/usage",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/components/{componentId}/assets/{assetId}/usage"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/components/{componentId}/assets/{assetId}/usage")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/app/v1/organizations/{organizationId}/projects/{projectId}/components/{componentId}/assets/{assetId}/usage")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

Returns information about where a component asset is referenced, including components, content, and packages.

Path Parameters

organizationId

string

required

Organization ID

projectId

string

required

Project ID

componentId

string

required

Component ID

assetId

string

required

Asset ID

Response

{
  "data": {
    "inComponents": ["c123", "c456"],
    "inPackages": ["pkg-1.0.0", "pkg-1.1.0"],
    "inContent": ["cont123"],
    "totalUsage": 5
  }
}

Response Fields

Field	Type	Description
inComponents	string[]	Component IDs referencing this asset
inPackages	string[]	Package IDs containing this asset
inContent	string[]	Content IDs referencing this asset
totalUsage	number	Total number of references

Assets referenced in published packages cannot be deleted. Use this endpoint to check usage before attempting deletion.

Code Examples

curl -X GET "https://api.metabind.ai/app/v1/organizations/org123/projects/proj456/components/c123/assets/asset123/usage" \
  -H "Authorization: Bearer YOUR_JWT"

const response = await fetch(
  'https://api.metabind.ai/app/v1/organizations/org123/projects/proj456/components/c123/assets/asset123/usage',
  {
    headers: {
      'Authorization': 'Bearer YOUR_JWT'
    }
  }
);

const result = await response.json();
const usage = result.data;

if (usage.usedInPackages.length > 0) {
  console.log('Asset is used in packages and cannot be deleted');
} else {
  console.log('Asset can be safely deleted');
}

Update Asset Status Optimize Asset

​Path Parameters

​Response

​Response Fields

​Code Examples

Path Parameters

Response

Response Fields

Code Examples