> ## Documentation Index
> Fetch the complete documentation index at: https://docs.metabind.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Asset Usage

> Retrieve usage information showing where an asset is referenced

Get detailed information about where an asset is used across components, packages, and content items. Use this to understand dependencies before modifying or deleting an asset.

## Path Parameters

<ParamField path="organizationId" type="string" required>
  The unique identifier of the organization
</ParamField>

<ParamField path="projectId" type="string" required>
  The unique identifier of the project
</ParamField>

<ParamField path="id" type="string" required>
  The unique identifier of the asset
</ParamField>

## Response

<ResponseField name="data" type="object">
  Asset usage

  <Expandable title="data properties">
    <ResponseField name="components" type="string[]">
      IDs of components that reference this asset
    </ResponseField>

    <ResponseField name="packages" type="string[]">
      Versions of packages that include this asset
    </ResponseField>

    <ResponseField name="content" type="string[]">
      IDs of content items that use this asset
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.metabind.ai/app/v1/organizations/org123/projects/proj456/assets/asset789/usage" \
    -H "Authorization: Bearer YOUR_JWT"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://api.metabind.ai/app/v1/organizations/org123/projects/proj456/assets/asset789/usage',
    {
      headers: {
        'Authorization': 'Bearer YOUR_JWT'
      }
    }
  );
  const { data: usage } = await response.json();

  if (usage.packages.length > 0 || usage.components.length > 0) {
    console.log('Asset is in use and cannot be deleted');
  }
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": {
      "components": ["comp123"],
      "packages": ["1.0.0", "1.1.0"],
      "content": ["cont456"]
    }
  }
  ```

  ```json Empty Usage theme={null}
  {
    "data": {
      "components": [],
      "packages": [],
      "content": []
    }
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.