Skip to main content
GET
/
app
/
v1
/
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
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

FieldTypeDescription
inComponentsstring[]Component IDs referencing this asset
inPackagesstring[]Package IDs containing this asset
inContentstring[]Content IDs referencing this asset
totalUsagenumberTotal 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"