> ## 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="components" type="object[]">
  Components that reference this asset

  <Expandable title="component properties">
    <ResponseField name="id" type="string">
      Component ID
    </ResponseField>

    <ResponseField name="name" type="string">
      Component name
    </ResponseField>

    <ResponseField name="version" type="number">
      Component version
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="packages" type="object[]">
  Packages that include this asset

  <Expandable title="package properties">
    <ResponseField name="version" type="string">
      Package version (semantic version)
    </ResponseField>

    <ResponseField name="componentId" type="string">
      Component ID that references the asset in this package
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="content" type="object[]">
  Content items that use this asset

  <Expandable title="content properties">
    <ResponseField name="id" type="string">
      Content ID
    </ResponseField>

    <ResponseField name="name" type="string">
      Content name
    </ResponseField>

    <ResponseField name="version" type="number">
      Content version
    </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 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>